← Back
Xuanwo

Xuanwo/cida

辞达：用你选择的大模型，在 Mac 的任何地方翻译和润色文字。Translate and polish text anywhere on your Mac.

View on GitHub ↗https://cida.xuanwo.io ↗
llmmacosmenubar-appswiftuitranslation
Stars
129
Forks
6
Watchers
129
Open issues
5
Contributors
2
Language
Swift
License
Apache License 2.0
Default branch
main
Created Sep 25, 2026Updated Sep 30, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

辞达的图标：「辞」后跟一枚光标

辞达

用你选择的大模型，在 Mac 的任何地方翻译和润色文字。
官网 · 下载 · English

怎么用

  • 选中文字，按 ⌥ A。 面板带着选中的文字出现，译文随即开始流出。其他语言都译成你的语言，默认简体中文，可以在设置里写成任何语言、方言或文体，比如粤语；你的语言译成「翻译」旁边写着的外语，默认英文，要换就在那里直接写，比如日本語、英式英语。

    在 Chrome 里选中一段英文，按 ⌥A，面板里流出中文译文

  • 按 Tab 再按 Return，改成润色。 润色后的文字保持原来的语言。

    选中评论框里的英文回复，按 ⌥A 后按 Tab 和 Return，得到润色后的英文

  • 屏幕上的文字，按 ⌥ S。 框出要翻译的部分，辞达在本机识别后翻译。

    按 ⌥S 框选文章里的图表，辞达识别图里的文字并翻译

  • 在原处读外文，指着一段按 ⌥ D。 这一段就地换成译文，前后的消息还是原文，带着上下文读；再按一次换回。

    指着一段按 ⌥D，这一段就地换成译文；再按一次换回原文

  • 要连续读一门看不懂的语言，按 ⌥ ⇧ D 翻译整个窗口。 比如 Slack 的频道或一篇长文：新内容出现就翻译，再按一次停止；想看某一段的原文，指着它按 ⌥ D。译文写在辞达的纸上，代码保持原样；点击和滚动照常落到原来的应用。

    按 ⌥⇧D 整页换成译文；滚动时译文隐去，停下后接着翻译新出现的段落，代码与图片保持原样

按 Esc 回到原来的应用。面板隐藏后请求会继续完成，下次唤出时结果还在。

安装

需要 macOS 15 或更新版本，以及一个大模型服务。

  1. 下载 Cida.dmg。安装包经过 Developer ID 签名和 Apple 公证。
  2. 打开 DMG，把辞达拖进「应用程序」，再从启动台或聚焦搜索打开。辞达只在菜单栏显示图标，不占用 Dock。
  3. 按 ⌘ , 打开设置，点「复制配置提示词」，交给 Claude Code、Codex 等 AI 助手。它会问你用哪家服务，通过辞达的命令行写好配置，再用 check 确认能用。

API Key 不经过助手：它会请你复制 Key 后运行一条命令，Key 直接存进钥匙串。支持 OpenAI Chat Completions、Responses 与 Anthropic Messages 三种接口，在本机运行的模型（例如 http://127.0.0.1:8080）不需要 Key。辞达本身免费，模型调用按服务商的价格计费。

两个权限都是可选的，在设置的「快捷键」页点「去授权」即可开启：

权限 开启后 不开启时
辅助功能 按 ⌥ A 时自动带入选中的文字；⌥ D 原处翻译 先 ⌘ C，再在面板里 ⌘ V；原处翻译不可用
屏幕录制 用 ⌥ S 截图翻译 截图翻译不可用

隐私

  • API Key 只存在 macOS 的钥匙串里。
  • 不保存历史记录，不收集任何数据，翻译和润色的请求只发往你选择的服务商。
  • 截图在本机用 Apple 的 Vision 识别，图片不会离开你的 Mac。原处翻译只读取应用通过辅助功能提供的文字，不截取屏幕画面。

快捷键

按键 作用
⌥ A 显示或隐藏面板
⌥ S 截图翻译
⌥ D 原处翻译：指针下这一段换成译文，再按换回；加 ⇧ 翻译整个窗口
Tab 在翻译和改进之间切换
Return 执行（⇧ Return 换行）
Esc 隐藏面板

三个全局快捷键都可以在设置里重新录制。

命令行

应用里的可执行文件就是辞达的命令行，不需要另外安装。它与正在运行的辞达共用同一份配置，改完立即生效：

cida=/Applications/Cida.app/Contents/MacOS/Cida
$cida config schema                        # 全部字段、取值与说明
$cida config show
$cida config set model=deepseek-chat       # 一次可写多项，也有 unset 与 reset
pbpaste | $cida config set api-key --stdin
$cida check --verbose                      # 真的请求一次，失败时给出请求与响应

每个命令都可以加 --json。API Key 只从 --stdin、--file 或 --env 读取，写在命令行参数里会被拒绝。字段的完整说明见 Design/spec/configuration.md。

更新

辞达每天检查一次 https://cida-releases.xuanwo.io/appcast.xml，有新版本时在面板里给出更新说明，确认后自己下载并安装。检查不附带任何系统信息，可以在设置的「通用」页关掉。

卸载

退出辞达，把「应用程序」里的辞达移到废纸篓。想清掉全部痕迹，再删除「钥匙串访问」里名为 com.xuanwo.Cida 的条目和 ~/Library/Preferences/com.xuanwo.Cida.plist。

参与开发

git clone https://github.com/Xuanwo/cida.git
cd cida
swift run Cida

需要 Xcode 26 或更新版本。构建、测试和发版见 docs/development.md，设计稿在 Design/，提交改动前请阅读 AGENTS.md。

许可证

Apache-2.0。

名字取自《论语》「辞达而已矣」：言辞能把意思表达清楚就够了。