安装与首次使用¶
Rill 的主要用途是把说话转成可找回、可复用的文字。先完成本地听写，再按需要开启智能整理、 剪贴板采集或语义搜索；这些可选能力不影响开始使用基本听写。
安装¶
需要 Apple Silicon Mac、macOS 14.0 或更高版本。首次准备语音模型需要联网； 0.6B 模型约 1.01 GB，1.7B 模型约 2.46 GB，还需预留下载缓存和可选模型空间。 模型准备完成后，本地识别无需网络。
到 GitHub Releases 查看适用版本与说明。 如有安装包，将 Rill 放入“应用程序”后打开。若尚无适用安装包，开发者可按 贡献指南构建。 不要把本地开发签名包当成已经通过公证的正式发行版。
运行打包后的 App 无需 Python、uv 或开发工具。macOS 拒绝打开时先核对下载来源、 版本与签名说明，不通过关闭 Gatekeeper 绕过检查。
第一次听写¶
- 打开 Rill，在“活动”页查看语音设置清单。
- 授予麦克风、输入监控权限。要直接向其他 App 输入文字时，再授予辅助功能权限。
- 按 ⌘, 打开设置，在“语音与模型”准备并启用本地语音模型。
- 保持“语音识别”工作流启用，将光标放到目标 App 的文本输入框。
- 按住 Fn 说话，松开结束。最终文字先保存为记录，再尝试输入。
- 到“全部记录”找回文字；到“活动”查看本次运行及失败原因。
如果 Fn 被配置成切换式录音，按设置中的触发方式结束录音。无法开始时参见 排查问题，不要反复开启多个 Rill 实例。
接下来¶
| 需求 | 操作入口 |
|---|---|
| 修正错字、标点与段落 | 智能整理 |
| 找回之前复制或听写的内容 | 记录与搜索 |
| 设置个人词汇和替换 | 词汇与记忆 |
| 自定义保存、复制、输入或朗读 | 工作流 |
| 减少留存、关闭云端或删除内容 | 隐私与数据 |
主窗口默认显示全部记录。⌘F 搜索记录、记录集、历史、工作流和设置； ⌘, 打开独立设置窗口。完整位置表见参考。
升级与卸载¶
Rill 尚未提供自动更新。先退出正在运行的 App，再替换为受信任的新版本。 升级前保留需要的数据；已迁移的数据不保证被旧版读取，降级前应阅读版本说明。
卸载前可在“设置 → 数据”分类清理历史和恢复数据，在“词汇与记忆”管理长期记忆， 并在 API 服务中清除凭据。退出后移除 App。
仅删除 App 不会清除模型缓存、工作流、用户数据或 Keychain 项。工作流默认位于 ~/.config/rill/workflows/，备份位于 ~/.local/state/rill/workflows/； 完整位置和删除边界见 隐私说明。