装好插件后，后台会多出「AI 上下文翻译」菜单，下面五个页面：翻译设置、语言管理、页面翻译、译文数据、使用说明。配置顺序就按这个来。
第一步：告诉插件原文是什么语言
翻译设置页最上面的「默认语言（原文语言）」，指的是站点内容原本的语言，翻译以它为源。这一项不选，任何翻译都跑不起来。
第二步：配 AI 服务
同一页往下是 AI 服务，几个字段的实际作用：
- 模型：下拉里是库内置的模型，也可以直接手填中转站给的模型名。
- 协议格式：决定按哪套请求格式跟接口通信。
gpt-、claude-、gemini-、deepseek-开头的模型名能自动认出来；认不出的（中转站自定名、私有部署）在这里手选。 - 接口地址：默认填的是所选模型或协议的官方地址，换模型、换协议会自动跟着变。接自建网关时改成对方的地址即可——填完整端点（
…/v1/chat/completions）就原样请求，只填到…/v1这类根地址时会自动补上所选协议的对话路径。字段下方会显示实际请求地址，所见即所发。 - API Key：对应平台的密钥。
- 代理：留空直连。位于中国的服务器访问 OpenAI/Claude/Gemini 通常需要填，支持
http://与socks5://。 - 最大输出 token：限的是 AI 单次回复的长度，不是模型的上下文长度。模型支持 1M 上下文，不等于允许一次输出 1M——各模型的输出上限差很远，填超会被平台直接拒绝。填 0 表示不传这个参数、跟随所选模型的内置值，换模型也不用改，推荐这么填。
- 请求超时：一次 AI 请求的等待上限，整页翻译时建议给足。
第三步：添加目标语言
「语言管理」里每加一种语言，就多一份可配置项：
- URL 前缀：译文页面挂在哪个目录下，例如填
ja，译文地址就是/ja/…。 - hreflang 与地区变体：输出到页面
<head>里告诉搜索引擎语言对应关系，需要区分地区时（如zh-Hant配TW）在这里填。 - 排序：语言切换菜单里的先后顺序。
- 展示对象：所有访客、仅搜索引擎、仅普通用户三选一。做灰度或只想让搜索引擎先收录时用得上。
- 字符串替换规则：AI 译完之后再做一轮定向替换，支持模糊替换、完全匹配、正则替换三种。品牌名被译错、某个术语要统一成行业叫法，用这个兜底最省事。
第四步：翻第一页
进「页面翻译」，选语言和页面，界面左右并排：左边是从这一页提取出来的原文 JSON，右边是对应的译文。点「AI 翻译」，插件抓取页面、提取、分批送 AI、结果入库并回填到右侧，过程中可以看到进度。
几个容易忽略的细节：
- 工具栏的「AI 翻译时跳过已有译文」默认勾着，已经有译文的条目不会重复消耗额度。想整页重译就取消勾选。
- 右侧译文可以直接改，保存后这条会被标记为人工来源。
- 「全部翻译」会依次处理当前语言下所有待翻译页面，带进度条和停止按钮，中途停下已完成的部分不会丢。
翻完打开 /ja/（或你设的前缀）就能看到译文页。日常维护在「译文数据」页：全库检索、行内改译文、单条删除、按搜索条件批量删除都在那里。
