使用文档
安装
- 下载 WordStitch.dmg
- 双击打开 DMG，将 WordStitch 拖入 Applications
- 首次打开：右键点击 WordStitch → 选择「打开」→ 在弹窗中再次点击「打开」
macOS 会对未签名的应用弹出安全提示，这是正常的。右键打开一次后，后续双击即可启动。
快速开始
安装 WordStitch 后，首次启动会引导你完成两个系统权限的授权：
- 辅助功能（Accessibility）：让 WordStitch 能够读取你选中的文本
- 输入监控（Input Monitoring）：让 WordStitch 能够监听键盘输入，实现实时翻译
授权完成后，菜单栏会出现 WS 图标。翻译功能立即可用。
快捷键翻译
选中任意中文文本，按 ⌥D，英文翻译会替换到原文位置。
这个模式适合翻译已经写好的段落。选中、按键、替换——三步完成。
自定义快捷键
在设置面板 → 首页，点击快捷键区域，按下你想要的组合键即可。支持 ⌥、⌘、⇧ 的任意组合。
实时翻译（自动替换）
开启后，用拼音输入中文时，输入触发符后自动替换为英文，无需按快捷键。
触发符模式
在设置面板 → 其他 → 触发符中切换：
- 全面：空格、英文标点、回车都会触发自动替换
- 谨慎：仅
.!?会触发自动替换
历史记录
菜单栏 → 历史记录。查看所有翻译记录，支持按关键词搜索。点击条目右侧的星标可收藏，收藏的条目会进入生词本。
生词本
菜单栏 → 生词本。收藏的翻译条目集中查看，方便复习和回顾常用表达。
额度与百分比
使用内置免费额度时，菜单栏图标旁会显示剩余额度百分比。
额度用完后不会自动刷新，一般由开发者每周统一刷新。如需提前重置，可联系开发者申请。也可以通过自定义配置接入自己的 API key 绕过额度限制。
联系方式：862325259@qq.com
设备 ID
菜单栏 → WordStitch → About WordStitch，可查看设备 ID 后 6 位（可选中复制）。联系开发者排查问题时可能需要提供。
什么是自定义配置
默认情况下，WordStitch 使用内置的免费额度（由开发者维护的 API）。如果你想用自己的 API key（如 DeepSeek、OpenAI），需要新建一个自定义配置。
自定义配置意味着翻译请求直接发到你指定的 API 端点，不经过开发者的代理服务。
新建配置
设置面板 → 配置 → 右上角「新建」按钮。填写以下字段：
- 提供商：自动填充
- 模型名称：如
deepseek-v4-flash、gpt-5.4-nano - API Key：你的密钥，存储在本地钥匙串中
- 接口地址：自动填充，一般无需修改
API Key 获取
DeepSeek
访问 platform.deepseek.com 注册账号 → 左侧「API Keys」页面 → 创建新 key。新用户通常有免费额度。
OpenAI
访问 platform.openai.com 注册账号 → Settings → API Keys → Create new secret key。需要绑定支付方式。
其他兼容提供商
WordStitch 兼容所有 OpenAI 格式的 API（如 Moonshot、智谱、火山引擎等）。获取 key 后，手动填写接口地址即可。
接口地址
选择提供商后会自动填入，一般不需要手动修改。如需自定义，填写 API 的 base URL 即可（不含 /v1/chat/completions 等路径后缀，WordStitch 会自动拼接）。
模型名称
填写你希望使用的模型 ID，如 deepseek-v4-flash、gpt-5.4-nano。翻译任务通常用轻量模型即可。
多配置切换
可以创建多个配置（如一个 DeepSeek、一个 OpenAI）。在配置列表中点击某个配置，它就成为当前激活的配置。
切换配置后立即生效，不需要重启 app。