为 AI 时代打造的桌面终端管理器
多项目 · 多标签 · 递归分屏 · AI 状态感知 · SSH 远程 · Git Worktree · 手机远程看 AI
简体中文 · English
GPUI 原生实现：Rust 原生渲染、单进程、不依赖 WebView2。
早期的 Tauri + React 实现已于 v1.0.0-beta 后从仓库移除并停止发布（历史版本安装包仍可在旧 Release 下载，源码看 git 历史）。
你同时开着 4 个 Claude Code 会话，分散在 3 个项目里。哪个跑完了？哪个卡在等你确认？ 系统终端不会告诉你，只能一个个点开看；为这点事去开 VS Code / IDEA，又是几百兆内存换一个终端窗口。
Mini-Term 就是为这件事做的：项目列表上的状态灯实时跳动，AI 一跑完立刻弹提醒、任务栏闪烁、响一声；出门在外掏出手机，看到的是同一份现场，还能直接发下一条指令。
不靠猜进程名——直接接入 Claude Code / Codex / Grok Build / oh-my-pi 官方 Hook API（oh-my-pi 走它的进程内扩展机制），事件实时上报，比轮询更准更快（进程轮询作为降级兜底保留）。设置里按 CLI 勾选注册 / 卸载 Hook，只用其中一家就不会被写入其它几家的配置，写入时合并而不是覆盖。
状态从「面板 → 标签页 → 项目」逐层聚合，任务转为完成的瞬间触发三件事，每一项都能单独开关：
- 右下角 Toast 通知
- 项目列表 DONE 徽章
- 任务栏闪烁（Windows）/ Dock 跳动（macOS），仅窗口失焦时触发
顶栏「移动端」面板填好中转地址 → 保存并连接 → 生成配对二维码，手机相机一扫就进 PWA 自动配对。之后你在外面能：
- 看按项目分组的活跃 AI 会话列表，状态灯与桌面端实时同步
- 点进任一会话实时看对话镜像，Markdown 渲染，往上滚分页加载更早的消息
- 在底部输入框直接发指令，等价于你本人在桌面键盘上敲下并回车，带即时回执
- agent 提问直接在手机上点选作答——Claude / Codex / Grok 的提问以卡片出现在镜像里，点选项即替你在桌面 TUI 里选中回车；等你处理（提问待答、等待授权）的会话在列表里亮琥珀点
- 从手机发起一个全新会话：选项目 → 选 AI 启动器，桌面端后台把 agent 拉起来
前提：中转要跑在你自己的服务器上（1C1G 足够，Docker 一条命令起，另需一个解析到它的域名做 TLS）。这是刻意的设计——没有任何第三方服务掺在中间。见部署文档。
顶栏「统计」打开使用统计面板：Claude Code / Codex / Grok 的成本、调用、会话数多维聚合，按日 / 按小时趋势图，模型、项目排行与 Top 会话，范围和口径随手切。
数据计算方式参考 ccusage 项目 ccusage/ccusage: npx ccusage
项目右键「关联 SSH」勾选连接即按项目启用，可见范围就限定在你勾的那几个。启用时生成 Claude / Codex 两份 SKILL.md（内嵌 CLI 绝对路径与该项目的随机能力令牌）——agent 按需加载 skill，不再有一份工具 schema 常驻上下文；调用的是普通命令行，可以和 grep、管道、重定向自由组合。
- SSH 远程项目 — 服务器上的目录直接添加成项目：文件树经 SFTP 懒加载，终端
ssh -t直连并自动落到项目目录，断线后覆盖层一键重连，远程机器上的 Claude / Codex 历史会话也能读出正文。远程缓存键掺入连接 id，两台服务器上的同名路径不会串数据 - 密码加密保存 — SSH 连接保存的密码以 AES-256-GCM 加密落盘，主密钥经 Windows DPAPI 按当前用户保护（macOS / Linux 靠文件权限）；旧版本留下的明文在升级后首次启动时自动加密清扫。密码框还带「显示 / 隐藏」切换
- 远程文件管理 — 远程文件树支持复制 / 粘贴 / 上传 / 下载，从资源管理器拖文件进来就是上传，文件栏顶部还有上传文件 / 文件夹、粘贴、新建文件 / 文件夹的快捷按钮；同名冲突可跳过、覆盖或生成副本，弹窗列出具体文件名。下载默认进系统下载目录、可在设置中自选；添加远程项目时可用远程目录选择器直接浏览挑目录，右键还能在终端打开远程目录
- WSL 支持 —
\\wsl$\<distro>\<path>直接当项目根，自动改用wsl.exe --cd启动，pwd真的落在 WSL 里而不是C:\Windows；Windows 下还能直接读 WSL 发行版内的 Claude / Codex 会话历史
- 左侧项目列表管理多个工作区，支持最多 3 级嵌套分组、拖拽排序、从资源管理器拖文件夹直接添加
- 横竖任意嵌套的递归分屏，拖拽调比例；标签 / 分屏 / 窗口大小位置全部持久化，重启原样恢复
- 项目级终端面板——终端区右缘的图标竖条给同一项目开多个独立终端工作面，各自持有整套分屏与标签互不影响（跑 AI 的一面、跑前后端的一面，点图标整面切换）；按钮带 AI 进度呼吸灯与终端数角标，双击改名，全部随重启还原
- 新建终端即启 agent——三处「新建终端」入口(标签栏 +、空态按钮、终端面板)的菜单里除了各类 shell,还列着 AI 启动器(预置 Claude / Codex,可自行增删):选中即开出新终端并自动敲入启动命令,AI 状态感知随之建立;与移动端「发起新会话」共用同一份启动器配置(SSH 远程项目不出此段——连接初期的口令交互会把预写命令吃掉)
- 换场动画——切标签 / 切面板按方向推入推出，最大化从终端所在格子展开到整幅、还原反向收回；不喜欢动画的，设置里一个开关整体关掉
- pane 拖拽重排与最大化——tab 拖到别的分组并入，拖到终端区四边分出新屏，落点实时高亮预览；双击 tab 栏空白处把当前分组临时铺满，终端内容全程不丢
- AI 任务标记——会话里每次按 Enter 自动打点，
Ctrl+Shift+↑/↓在历史提交之间跳转
VS Code 风格的 Changes 面板（Staged / Changes / Untracked 分组，单文件或全量 stage / discard，Ctrl+Enter 提交），并排 / 内联双视图 Diff（长行横向滚动、两栏纵向同步、@@ hunk 分隔与「上一处 / 下一处改动」跳转，配对上的删 / 增行再做词级高亮），游标分页的提交历史，以及手绘 SVG 分支拓扑图。Git 面板为上下两个可折叠区块——更改在上、提交历史在下，同屏可见、中缝拖拽调比例；顶部仓库栏下拉切换仓库（monorepo 里一串同名 api 会各自带上父级路径区分），分支徽章一键切换历史查看分支（不 checkout），刷新 / Pull / Push 也收在栏上。
Worktree 管理对多 Agent 并行开发特别有用：项目根目录本身不是仓库时会向下扫描子仓库并按主工作区归并，组头可勾选多选 / 全选，一次为每个勾选的仓库各建一个 worktree。建好的 worktree 可以一键「设为项目」挂到主项目下面，或者直接开个终端进去。AI agent 在终端里把 worktree 删掉之后，回到窗口时列表会自动把目录已消失的子项目连同终端资源一起收掉，不留失效条目。
| 长文本粘贴 | 剪贴板 ≥10 行或 ≥2000 字符时自动转存临时 .txt，粘贴带引号的路径——AI 工具不必硬吞超长内容 |
| 图片粘贴 | 剪贴板里有截图自动检测，存成临时 PNG 并粘路径，兼容 PinPix 等非标准格式 |
| 远程自动落地 | 上面两种粘贴在 SSH 远程项目里会经 SFTP 传到远端再粘远端路径；WSL 项目自动把 C:\... 换算成 /mnt/c/... |
| 文件拖拽 | 从文件树或资源管理器拖文件到终端，插入带引号的绝对路径，精准落到目标分屏 |
| 文件树内移动 | 文件树里拖拽或右键「移动到 ▸」把文件 / 目录挪到别的目录，本地与远程一样；松手先确认，Esc 随时取消正在进行的拖拽 |
| 文件工作区 | 文件树点开的本地 / 远程文件在主区页签里查看、编辑、保存，与终端并列切换：tree-sitter 语法高亮（30+ 语言），查找替换，Ctrl+S 原子落盘，外部改动自动感知；Tab 缩进按制表位展开显示（Go 这类文件不再整篇顶格），保存时逐行还原原始字节；远程文件经 SFTP 读写，保存前比对基线，冲突时可重载或强制覆盖，也能直接下载 |
| 文档预览 | Markdown / HTML 预览里的图片真的会显示——相对路径按文件所在目录解析，网络图直接拉回来（10s 超时 + 32MB 上限，其余协议一律拒）。远程文件的 Markdown 先清洗再渲染：原始 HTML 按源码显示、外链图片点击才加载、file:// 之类的链接降级为纯文本；远程 HTML 只提供源码查看。HTML 另有一个「用浏览器打开」，走 https 协议关联而不是 .html 的文件关联 |
| 全局搜索 | Ctrl+Shift+F 唤起，文件名 / 内容双模式（文件名含 / 即按路径匹配），子串或正则，后端流式推送随时可取消 |
| 项目级环境变量 | 按项目注入 PTY 子进程，严格 POSIX 校验，Rust 端二次防御，WSL 下经 WSLENV 透传 |
| 智能 Ctrl+C/V | 可选开启：有选区时复制、无选区时中断程序；Windows 大段粘贴自动分块防 ConPTY 丢行 |
| 拖选停留自动复制 | 拖选后按住鼠标静止超过设定时长自动复制选区并弹「已复制」气泡，时长可调（0 = 关闭） |
| Alt+单击定位光标 | 按住 Alt（macOS ⌥）单击命令行任意位置，光标直接挪过去——同一行内按列差合成方向键；跨行一律不动，免得触发行编辑器的历史召回。shell 提示符下逐格准确，Claude CLI 这类 Ink TUI 不保证 |
| 启动零网络请求 | 原生渲染无 Web 资源，启动不发任何网络请求（价格表按天拉取，拉不到用缓存） |
| 刷屏不卡界面 | PTY 字节在后台线程直喂 VT 状态机、UI 按帧取格子渲染——单进程零 IPC，没有中间缓冲可堆积，cat 大文件也拖不垮界面 |
| 外置主题包 | 兼容 Dream Skin 格式的皮肤：文件夹或 zip 导入、manifest 的 sha256 校验、改文件即热重载；皮肤可自带背景图，终端随之透明化压在氛围层上。外链一律走同一道闸（禁 @import，指向包外的引用全拒）。点「更多皮肤」直达仓库 theme/ 皮肤库，挑一份下载后导入即用；想自己做一份，字段说明在 docs/theme-pack-example/ |
| 项目行悬停预览 | 悬停 250ms 弹出该项目正在运行的 AI Session 终端区 |
| 设置面板分组 | 侧栏两级菜单：终端、外观、AI、系统，每页只剩一屏，不用滚半页找开关 |
整套应用为 Rust 原生实现：
| 层 | 实现 |
|---|---|
| 壳 / 渲染 | GPUI 0.2（Zed 同源框架，GPU 原生渲染，单进程、无 WebView） |
| UI | 纯 Rust：gpui-component + 自绘组件 |
| 终端 | alacritty_terminal（进程内 VT 解析，零 IPC、零序列化）· portable-pty |
| 状态 / 布局 | 单一 Store · 递归 SplitNode 分屏树 |
| 配置 / 布局持久化 | rusqlite（config.db 配置本体 · layout.db 界面布局） |
| Git / 文件 | git2（libgit2）· notify + ignore |
| 用量统计 | rusqlite 本地账本 · 自绘趋势图 |
| 移动端中转 | axum + tokio WebSocket（relay-server/）· React + Vite PWA（mobile/） |
| 测试 | 1757 个 Rust 测试（29 个测试目标） |
前往 Releases 下载，三平台产物：
- Windows x64（主要支持平台） —
Mini-Term_*_x64-setup.exe安装包（NSIS，用户级安装免管理员；装过旧版的默认原目录升级，且先卸载旧版再装而不是文件覆盖写） - macOS arm64（Apple Silicon） —
Mini-Term_*_aarch64.dmg - macOS x64（Intel） —
Mini-Term_*_x64.dmg - Linux x64 —
Mini-Term_*_amd64.deb或Mini-Term_*_amd64.tar.gz
平台支持
- Windows — 主要支持平台，保证可用性，日常开发与测试都在 Windows 上
- macOS / Linux — 代码层面已支持，但可用性欠佳、未经充分打磨，欢迎提 Issue
macOS 首次打开若提示 "is damaged and can't be opened"，是因为 Release 产物没有 Apple Developer ID 签名被 Gatekeeper 拦下，不是文件真的坏了。拖进 /Applications 后执行一次即可：
xattr -cr /Applications/Mini-Term.app需要 Rust >= 1.95；构建 sidecar 就位脚本需要 Node.js >= 20（仅标准库，无 npm 依赖）。
git clone https://github.com/dreamlonglll/mini-term.git
cd mini-term
node scripts/stage-sidecars.mjs # 构建三个 sidecar 并连同便携 ConPTY 就位到 target/debug/
cargo run -p mt-app # 开发
cargo build --release -p mt-app # 产物 target/release/mini-term(.exe)hook 上报与便携 ConPTY 按「与 exe 同目录」定位 sidecar 与资源，发布包已带齐；源码运行要完整体验，先跑一次
stage-sidecars.mjs（release 构建对应--release，就位到target/release/）。
- 📖 完整功能清单 — 每一项功能的详细说明、架构概览与边界条件
- 📱 中转服务部署文档 — 手机远程功能所需的自托管中转
- 🐛 提 Issue / PR — 外部贡献会经过功能验证和安全审查后合并
本项目基于 MIT 协议 开源。
学 AI，上 L 站 — LinuxDO