Skip to content

v0.3.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 25 Oct 03:56
· 10 commits to main since this release
v0.3.0
05469fc

新增：WebUI（浏览器 / 局域网）

模型跑在一台机器上（建议 Linux + NVIDIA），Mac / 手机 / 另一台电脑只用浏览器：

mt3-transcriber --web --lan              # deb/rpm 装好后（桌面里也有「MT3 转谱服务（局域网）」）
./gui/run.sh --web --lan                 # 源码目录
open -a "/Applications/MT3 Transcriber.app" --args --web --lan   # macOS 应用

启动后终端会打印带令牌的地址（macOS 写在 ~/Library/Logs/mt3-transcriber.log）：

  本机：    http://127.0.0.1:8765/?t=…
  局域网：  http://192.168.1.201:8765/?t=…

把局域网那条发到手机/Mac 上打开即可；首次访问会把令牌换成 cookie，之后页面里不再带
?t=。

这一版能做什么

  • 拖拽/多选上传，上传进度与转谱进度分开显示；任务队列（单 worker 串行）、可取消
  • 每个任务单独选模型、后处理开关与四个阈值（毫秒）
  • 下载原始 MIDI 与 .rearranged.mid
  • 令牌持久化在 ~/.config/mt3-transcriber/web_token，--new-token 重新生成
  • --device auto|cuda|cpu 决定算力（页面只读显示）；GPU 上默认只缓存一个模型
  • 上限：单文件 1 GiB、时长 30 分钟、队列 8（--max-bytes / --max-minutes / --queue）；
    超过上限会在传输前直接用 413 拒绝
  • 结果放在 ~/.cache/mt3-transcriber/web/（macOS 为 ~/Library/Caches/…），默认保留 24 小时；
    服务重启会清空，想要的文件请先下载

安全边界（请读一下）

  • 强制令牌，连 127.0.0.1 也要：否则任意网页都能用表单 POST 打本机（CSRF / DNS rebinding）
  • 明文 HTTP，只用于家里/工作室的局域网，不要做端口转发或 DMZ
  • 拿到令牌的人可以上传音频、占用算力、下载自己任务的 MIDI；读不到服务器上的其它文件，
    也改不了设备和配置

防火墙

sudo firewall-cmd --add-port=8765/tcp --permanent && sudo firewall-cmd --reload   # Fedora / RHEL
sudo ufw allow 8765/tcp                                                          # Debian / Ubuntu

下载

Linux：deb / rpm / AppImage（x86_64 离线包，约 1.1GB）。下载慢可以在 URL 前加
https://gh-proxy.com/。

# Fedora / RHEL
curl -LO https://gh-proxy.com/https://github.com/404-GCross/mt3/releases/download/v0.3.0/mt3-transcriber-0.3.0-1.x86_64.rpm
sudo dnf install ./mt3-transcriber-0.3.0-1.x86_64.rpm

# Debian / Ubuntu
curl -LO https://gh-proxy.com/https://github.com/404-GCross/mt3/releases/download/v0.3.0/mt3-transcriber_0.3.0_amd64.deb
sudo apt install ./mt3-transcriber_0.3.0_amd64.deb

macOS（Apple Silicon，macOS 12+，纯 CPU）：mt3-transcriber-0.3.0-arm64.dmg。
未做 Apple 签名/公证，用浏览器下载首次打开需要右键 →「打开」（macOS 15+ 去
「系统设置 → 隐私与安全性」点「仍要打开」）；用 curl 下载就没有隔离标记，
装上直接双击即可：

curl -fL -o /tmp/mt3.dmg https://gh-proxy.com/https://github.com/404-GCross/mt3/releases/download/v0.3.0/mt3-transcriber-0.3.0-arm64.dmg
hdiutil attach /tmp/mt3.dmg -nobrowse -mountpoint /tmp/mt3vol
cp -a "/tmp/mt3vol/MT3 Transcriber.app" /Applications/
hdiutil detach /tmp/mt3vol

校验：SHA256SUMS 随包发布（sha256sum -c SHA256SUMS --ignore-missing）。

其它

  • 桌面 GUI 保留不变；WebUI 是第二种用法，两者共用同一份运行时与权重
  • 运行时新增 fastapi / uvicorn / python-multipart（纯 Python，约 15 MB）
  • 自检：python gui/webui/selftest.py（35 项，不需要模型）；macOS 的 CI 会真起服务
    上传/转谱/下载一遍
  • 说明见仓库 PACKAGING.md 的「WebUI（浏览器 / 局域网）」一节

Full Changelog: v0.2.0...v0.3.0

Assets 8
Loading