使用说明

录音模式

长按模式（默认）

按住 右 Alt（或你在设置里捕获的键）说话，松开即停止录音并进入转写（及可选润色）。

按下右 Alt ──→ 开始录音
   │
   │  说话中…
   │
松开右 Alt ──→ 停止录音 → 转写 →（润色）→ 写入剪贴板 + 悬浮窗展示

连续模式

适合较长发言：双击触发键进入连续录音，再单击一次停止。

双击右 Alt ──→ 连续录音
   │
   │  持续录音中…
   │
单击右 Alt ──→ 停止 → 转写 →（润色）→ 剪贴板 + 悬浮窗

:::tip 提示 连续模式下不必一直按住键，可停顿思考；停止时单击即可。 :::

处理流程

录音结束后，后台会依次：

1. 转写 — 本地 whisper-cli 或 Whisper API
2. 润色（若级别不是 none）— 通过 LLM 优化文本
3. 输出 — 写入系统剪贴板、弹出悬浮窗、可选桌面通知

若剪贴板工具不可用，仍可在悬浮窗内点击复制；历史页也会保留文本记录（仅文本，不存音频）。

润色级别

级别	适用场景
none	需要原话、低延迟
light	标点与错别字
medium	日常写作、语序通顺
heavy	正式文档、结构化重写

输出与界面

• 剪贴板：成功后默认写入，可在任意支持粘贴的应用中使用快捷键粘贴（Ctrl+V）。
• 悬浮窗：展示当前结果，可再次复制或关闭。
• 主窗口：首页状态、历史（查看/删除/单条再润色）、设置。
• 系统托盘：显示/隐藏主窗口、退出。

历史数据默认位于 ~/.config/altgo/history.json。

开发者：本地运行 GUI

cd frontend && npm install && cd ..
cargo tauri dev

完整发布链路（含捆绑 ffmpeg / whisper-cli）请以仓库根目录的 make build 为准，与 CI 一致。

命令行（若已安装 altgo 可执行文件）

altgo                              # 默认配置启动
altgo --config /path/to/altgo.toml # 指定配置
altgo --version
altgo --help