使用文档

快速开始

安装 WordStitch 后，首次启动会引导你完成两个系统权限的授权：

• 辅助功能（Accessibility）：让 WordStitch 能够读取你选中的文本
• 输入监控（Input Monitoring）：让 WordStitch 能够监听键盘输入，实现实时翻译

授权完成后，菜单栏会出现 WS 图标。翻译功能立即可用。

快捷键翻译

选中任意中文文本，快速按两次 Command（⌘⌘），英文翻译会替换到原文位置。

这个模式适合翻译已经写好的段落。选中、按键、替换——三步完成。

自定义快捷键

在设置面板首页的「触发方式」中，可以改成其他双击修饰键或按键组合。

实时翻译（自动替换）

使用英文输入法输入拼音，连续按两次空格，WordStitch 会翻译当前句，并在原输入框中逐字符替换为英文。

你也可以在设置面板的「空格手势」中改为双击翻译刚输入的拼音词、三击翻译当前句。

历史记录

菜单栏 → 历史记录。查看所有翻译记录，支持按关键词搜索。点击条目右侧的星标可收藏，收藏的条目会进入生词本。

生词本

菜单栏 → 生词本。收藏的翻译条目集中查看，方便复习和回顾常用表达。

什么是自定义配置

WordStitch 默认提供内置额度。如果你希望使用自己的兼容 API 服务，可以新建一个自定义配置。

自定义配置意味着翻译请求直接发到你指定的 API 端点，不经过开发者的代理服务。

新建配置

设置面板 → 配置 → 右上角「新建」按钮。填写以下字段：

• 提供商：选择接口使用的兼容格式
• 模型名称：填写 API 服务提供的模型标识
• API Key：你的密钥，存储在本地钥匙串中
• 接口地址：填写 API 服务提供的 base URL

API Key 获取

请在你所使用的 API 服务控制台创建密钥，并按照该服务的说明填写模型名称和接口地址。WordStitch 支持兼容常见对话补全请求格式的接口。

接口地址

填写 API 服务提供的 base URL。是否包含完整请求路径以该服务的接入说明和 App 内测试结果为准。

模型名称

填写 API 服务提供的模型标识。具体名称以该服务的控制台或开发文档为准。

多配置切换

可以为不同接口创建多个配置。在配置列表中点击某个配置，它就成为当前激活的配置。

切换配置后立即生效，不需要重启 app。