Xuanwo/cida · 上手攻略
- 仓库：Xuanwo/cida
- 链接：https://github.com/Xuanwo/cida
- 分类：效率工具 · macOS · LLM 应用
- 作者：Tom
- 更新：2026-09-30
一、是什么
辞达（Cida，取自《论语》"辞达而已矣"）是一个 macOS 菜单栏应用，用你选择的大模型在 Mac 的任何地方翻译和润色文字。它不是一个独立的翻译引擎，而是一个调用层——支持 OpenAI Chat Completions、Responses API、Anthropic Messages 三种接口，以及任何兼容 OpenAI 协议的本机模型（如 http://127.0.0.1:8080）。免费安装，模型调用按服务商定价收费。
核心定位：让翻译和润色融入日常操作流，不打断工作，不用复制粘贴到网页。
二、解决什么问题
日常痛点：
- 读外文文档要复制粘贴到 DeepL/Google，破坏阅读流
- 截图里的外文无法选中，只能靠肉眼猜
- 润色英文邮件要找 ChatGPT 网页版，切换成本高
- 系统级翻译（如 Apple Translate）质量不够，尤其专业术语
辞达把这四件事都收进四个全局快捷键，在任何应用里都能用。
三、快速安装
系统要求
- macOS 15（Sequoia）或更新版本 ⚠️ macOS 版本要求严格，macOS 14 及更早版本无法运行
- 一个大模型服务（OpenAI / Anthropic / 本机模型）
安装步骤
- 下载 DMG：https://cida-releases.xuanwo.io/latest/Cida.dmg
- 打开 DMG，将辞达拖入「应用程序」
- 从启动台或聚焦搜索打开辞达（只在菜单栏显示图标，不占 Dock）
- 按
⌘ ,打开设置 → 点「复制配置提示词」 - 将提示词交给 Claude Code、Codex 等 AI 助手完成配置（或手动配置）
- 按提示将 API Key 存入钥匙串
API Key 配置（手动）
# 找到命令行入口
cida=/Applications/Cida.app/Contents/MacOS/Cida
# 查看全部配置字段
$cida config schema
# 查看当前配置
$cida config show
# 设置模型（以 DeepSeek 为例）
$cida config set model=deepseek-chat
# 将 API Key 存入钥匙串（不经过助手）
pbpaste | $cida config set api-key --stdin
# 验证配置是否有效（实际发一次请求）
$cida check --verbose
⚠️ API Key 不接受命令行明文参数，只从 --stdin、--file 或 --env 读取，防止泄露。
可选权限
| 权限 | 开启后 | 不开启时 |
|---|---|---|
| 辅助功能 | ⌥ A 自动带入选中文字；⌥ D 原处翻译可用 |
先 ⌘ C 再在面板里 ⌘ V；原处翻译不可用 |
| 屏幕录制 | ⌥ S 截图翻译可用 |
截图翻译不可用 |
在设置的「快捷键」页点「去授权」开启。
四、核心用法
快捷键一览
| 按键 | 作用 |
|---|---|
⌥ A |
显示/隐藏面板，翻译选中的文字 |
⌥ S |
截图翻译（框出区域，本机 OCR + 模型翻译） |
⌥ D |
原处翻译：指针下段落就地换成译文，再按换回；加 ⇧ 翻译整个窗口 |
⌥ ⇧ D |
连续翻译整个窗口（实时监测新内容出现） |
Tab |
在「翻译」和「改进」（润色）之间切换 |
Return |
执行（⇧ Return 换行） |
Esc |
隐藏面板（请求在后台继续完成，下次唤出结果还在） |
五种场景用法
1. 翻译选中文字（最常用）
选中任意文本 → ⌥ A → 面板出现，译文随即流出。中文译成英文（默认），其他语言译成中文（默认），可在设置里改成任意语言、方言或文体（如粤语、英式英语）。
2. 润色改进
⌥ A 选中文字 → 面板里按 Tab 切换到「改进」→ Return → 润色后的文字保持原语言，复制回原应用。
3. 截图翻译
⌥ S → 框出要翻译的图片/视频/界面区域 → Apple Vision 在本机识别文字 → 模型翻译。图片不离开 Mac，隐私安全。
4. 原处读一段
指着某段外文按 ⌥ D → 这段就地换成译文，前后上下文还是原文 → 再按一次换回。适合读长文时偶尔查一段。
5. 连续翻译整个窗口
⌥ ⇧ D 翻译整个窗口（如 Slack 频道、长文网页）。新内容出现自动翻译，再按一次停止；代码块保持原样；点击和滚动照常落到原应用。
五、典型适用场景
- 程序员：读英文文档、issue、commit message，不用切出 IDE
- 写作者：润色英文邮件、Slack 消息、GitHub 评论
- 研究者：翻译论文段落、arXiv摘要，保持上下文连贯
- 多语言办公：在原应用内中英互译，不破坏工作流
- 设计师/产品：截图翻译设计界面上的外文
六、坑与注意
- macOS 15 强制要求：macOS 14 及更早版本无法运行，安装时会直接报错。若 macOS 版本不足，需要先升级系统。
- 快捷键冲突：四个全局快捷键（
⌥ A/S/D/⇧D）可能与其他应用冲突，可在设置里重新录制。 - API Key 安全：Key 只存 macOS 钥匙串，不经过 AI 助手，但助手配置过程需要你手动复制 Key 并运行一条命令，注意防范 shoulder surfing。
- 本机模型不支持 Key：在本机运行的模型（如
http://127.0.0.1:8080）不需要 Key，但需要模型本身支持 OpenAI 兼容协议。 - 原处翻译依赖辅助功能：若不开启辅助功能权限，
⌥ D原处翻译不可用，只能退而用⌥ A面板模式。 - 连续翻译窗口有局限：
⌥ ⇧ D适合简单场景，复杂动态页面（如 React SPAs）可能出现翻译延迟或遗漏。 - 版本确认：官网显示 1.2.1 可安装、当前 1.2.0，若安装后提示更新属正常行为。
七、与同类对比
| 辞达 | Apple Translate | DeepL | ChatGPT/App | |
|---|---|---|---|---|
| 系统级全局翻译 | ✅ 全局快捷键 | ✅ 系统级 | ❌ 需复制粘贴 | ❌ 需切换 App |
| 截图翻译 | ✅ | ❌ | ❌ | ❌ |
| 原处翻译 | ✅ | ❌ | ❌ | ❌ |
| 润色功能 | ✅ | ❌ | ✅（DeepL Write） | ✅ |
| LLM 可选 | ✅（任意 provider） | ❌（Apple Intelligence） | ❌ | ✅ |
| 本机模型 | ✅ | ❌ | ❌ | ✅ |
| 隐私（不保存历史） | ✅ | ✅ | ⚠️ | ⚠️ |
| macOS 版本要求 | ⚠️ macOS 15+ | macOS 15+ | 无 | 无 |
| 价格 | 免费（模型自付） | 免费 | 免费/Pro | 免费/Plus |
核心差异：辞达是唯一一个把 LLM 翻译做成 macOS 全局快捷键的工具，支持任意 OpenAI 兼容模型（包括本机模型），且同时具备截图翻译和原处翻译能力。Apple Translate 质量好但封闭，DeepL 需要复制粘贴，ChatGPT 需要切换 App。
八、一句话推荐结论
若你在 Mac 上频繁需要翻译/润色外文，选一个 LLM provider，装上辞达，四个快捷键覆盖所有场景——是目前 macOS 上体验最无缝的 LLM 翻译润色工具。
⚠️ 注意：必须是 macOS 15+，否则无法安装。