使用指南

安装

从 Chrome 应用商店或 Edge 加载项商店添加译枭即可，安装后会自动打开设置页。已经打开的网页需要刷新一次才能划词。

开发者模式手动安装

商店还没上架时，可以用安装包手动安装：

1. 下载安装包并解压到一个固定的文件夹，之后不要删除或移动它。
2. 打开 chrome://extensions（Edge 为 edge://extensions），右上角打开「开发者模式」。
3. 点「加载已解压的扩展程序」，选择刚才的文件夹。

手动安装不会自动更新。有新版本时，回到发布页下载，解压后覆盖原文件夹，再在扩展页点「重新加载」。上架商店后如果改用商店版，请先导出单词本，手动安装版的数据不会自动带过去。

选择服务商并填写 Key

译枭不提供 AI，由你自带。点工具栏的译枭图标打开设置页，在「AI 服务」里选一家服务商，粘贴 Key，点「测试连接」确认可用；失败时会显示原因（Key 无效、网络、额度不足等）。

支持的服务商：DeepSeek（默认）、OpenAI、Anthropic、Google Gemini、OpenRouter，以及自定义的 OpenAI 兼容接口。模型由你选择或填写。费用由你和服务商直接结算，译枭不经手。

DeepSeek

1. 登录 DeepSeek 开放平台，进入 API Keys 页面。
2. 创建一个新的 Key，复制保存（通常只显示一次）。
3. 回到译枭设置页，选择 DeepSeek，粘贴到 Key 一栏。

OpenAI

在 OpenAI 开发者控制台创建 API Key，并确认账户里有可用额度；之后的步骤与上面相同。

Anthropic

在 Anthropic 控制台创建 API Key，并确认账户里有可用额度；在译枭设置页选择 Anthropic 后粘贴。

Google Gemini

在 Google AI Studio 创建 API Key，在译枭设置页选择 Gemini 后粘贴。

OpenRouter

在 OpenRouter 创建 Key，并在账户里充值或设置额度；在译枭设置页选择 OpenRouter 后粘贴，再填写你要用的模型名称。

自定义接口

任何兼容 OpenAI 格式的接口都可以接入。填写接口地址和模型后，浏览器会请你授权访问该域名，这是预期行为；译枭不会预先申请任何你没有用到的网站权限。

# 示例：接口地址
https://api.example.com/v1

主密码（可选）

在设置页的「安全与隐私」里可以设置主密码，用它加密保存在本机的 Key。启用后，每次重新打开浏览器需要先解锁。

第一次划词

打开任意一个有外文的网页，用鼠标选中一个词，卡片会出现在选区旁边。卡片上有读音、词性、这句话里的意思，以及一句原文释义；变形词会附上原形，例如 ran → run。英语有 US 和 UK 两种读音，可以在卡片上一键切换。

按 Esc 或点击卡片以外的地方关闭。

浏览器的内部页面（如 chrome://）和扩展商店页面不允许扩展运行，在那里划词没有反应是正常的。

划词方式、右键菜单与快捷键

在设置页的「划词方式」里选择触发方式，也可以关掉自动划词，或把某些网站加入黑名单。

右键菜单和快捷键是你明确要求翻译，所以不受触发方式、黑名单和自动划词开关的限制，总会响应：

• 右键菜单：选中文字后右键，点「用译枭翻译」。设置里可以关掉这个菜单项。
• 快捷键：按 Alt + Shift + L（macOS：Option + Shift + L）翻译选中的内容，用键盘（Shift + 方向键）选中的文字也可以。
• 改键：打开 chrome://extensions/shortcuts。那里还能给「开关自动划词」设一个快捷键，默认没有。

自动划词关闭时，工具栏图标上会显示 OFF 角标。

单词本与导出

• 在卡片上点「加入单词本」收藏。同一个词（按原形和原文语言算）的不同例句会合并，每个词最多保留 5 条例句。
• 单词本只保存在本机，不同步、不上传。每个词记录读音、例句、释义，以及来源网页的标题和去掉查询参数的网址。
• 在单词本页面可以搜索、删除单个词或清空。页面入口在工具栏弹窗和设置页。
• 导出 CSV 可直接导入 Anki，也可以导出 JSON 备份或按日期分组的 Markdown 笔记。导入只接受译枭自己导出的 JSON，会与现有内容合并，不覆盖。
• 本机存储空间用到 80% 以上时会提示你导出或清理。

常见报错