跳转到内容
mtty.dev

安装 / 构建 mtty

mtty(原名 miaotty)是原生 winit/wgpu 应用，只提供一个 GUI 主程序和一个 CLI。 命名与迁移见 APP-IDENTITY.zh-CN.md。

从源码运行

Section titled “从源码运行”
终端窗口
cargo run --release -p mtty-app
cargo build --release -p mtty-app -p mtty-cli
./target/release/mtty --version

需要 Rust stable 和对应平台的 wgpu/窗口系统库；首次编译 wgpu/glyphon 可能需要数分钟。

macOS

Section titled “macOS”
终端窗口
scripts/package-macos.sh
python3 scripts/smoke-hosts.py --bundle dist/mtty.app
bash scripts/install-macos.sh

只生成一个 ad-hoc 签名的 dist/mtty.app，包内有 mtty、mtty-cli、图标及 URL schemes。 安装时压缩备份身份匹配的旧应用，安装 mtty 并移除旧 native 入口，保留用户配置。 PROFILE=debug scripts/package-macos.sh 可生成开发包。 安装的 app 使用 macOS 系统菜单栏；裸跑二进制使用窗口内菜单。

发布包

Section titled “发布包”

release.yml 要求 Apple Silicon macOS、Intel macOS、 Linux、Windows 四个 runner 成功。v* 标签触发发布，手动 dispatch 演练打包而不发布。

  • macOS：zip 只包含 mtty.app。
  • Linux：tar、DEB、AppImage，包含 mtty 和 mtty-cli。
  • Windows：zip、MSI，包含 mtty.exe 和 mtty-cli.exe。

Apple Developer ID 签名/公证、Windows MSI 签名和 minisign 产物签名使用 RELEASE.zh-CN.md 说明的可选 secrets。 dist-workspace.toml 仍为 cargo-dist 脚手架，不是当前发布流水线。

配置与深链接

Section titled “配置与深链接”

配置位于 ~/.config/mtty/config.toml 或 $XDG_CONFIG_HOME/mtty/config.toml;Windows 上为 %APPDATA%\mtty\config.toml(保存的状态在 %LOCALAPPDATA%\mtty;若在 Git Bash 设置的 HOME 下已有 ~/.config/mtty,则继续使用它)。 Ghostty/Alacritty 配置导入及 zsh ZDOTDIR 集成保持原有行为，旧 native/eframe 会话格式 通过兼容迁移读取。

macOS/Linux 注册 mtty://、ssh://、x-man-page://；Windows MSI 只注册 mtty://。 后续启动通过已有的控制 socket/inbox 转发到正在运行的实例，mtty:// 身份保持不变。

Synced from oxdingzg/mtty@b65a3d1.