沉浸式翻译接入 kukuai.fyi

浏览器沉浸式翻译扩展通过 OpenAI 兼容接口接入 kukuai.fyi 的逐步教程。

网页全文翻译。
技术文档中英互译。
论文、博客、产品文档的分段翻译。
需要比普通机器翻译更自然的表达。

准备工作

checklisttext

1. 已安装沉浸式翻译浏览器扩展
2. 已准备 kukuai.fyi API Key
3. 已确认要使用的聊天模型
4. 浏览器可以访问目标网页
5. 先准备一个短网页或短段落测试

第一步：填写服务配置

在沉浸式翻译的 AI 服务配置里选择 OpenAI 兼容服务，然后按下面填写。

setuptext

服务类型: OpenAI Compatible / 自定义 OpenAI
API Key: sk-你的-kukuai-api-key
API URL / Base URL: https://www.kukuai.fyi/api-proxy/china/v1
Model: gpt-5-2-chat-latest
Temperature: 0.2 - 0.5

第二步：逐步操作

flowtext

1. 打开浏览器扩展管理页
2. 进入沉浸式翻译设置
3. 找到 AI 翻译服务 / OpenAI 设置
4. 选择 OpenAI Compatible 或自定义 OpenAI
5. 填入 API Key
6. Base URL 填 https://www.kukuai.fyi/api-proxy/china/v1
7. 模型名填 gpt-5-2-chat-latest
8. 保存配置
9. 打开一篇短网页测试翻译

第三步：优化翻译提示词

如果扩展支持自定义系统提示词，可以使用更稳定的翻译约束。技术文档建议保留术语，不要让模型自由发挥。

translation-prompttext

你是专业翻译助手。
请把用户提供的文本翻译成简体中文。
要求：
1. 保留原文段落结构
2. 技术术语保持准确
3. 不要添加解释
4. 不要输出与翻译无关的内容

第四步：验证翻译效果

verifytext

测试文本：
The model supports streaming responses and tool calls.

预期结果：
模型应翻译为自然中文，并保留 streaming responses、tool calls 等技术含义。

先用一段短英文测试。
确认翻译不会添加额外解释。
再打开长网页测试分段翻译。
如果成本较高，降低单次段落长度或切换轻量模型。

排障清单

troubleshootingtext

1. 翻译按钮没反应
   - 检查扩展是否启用
   - 检查当前网页是否允许扩展运行

2. API 报 401
   - 检查 API Key 是否完整
   - 确认 Key 没有复制多余空格

3. API 报 404
   - Base URL 应为 https://www.kukuai.fyi/api-proxy/china/v1
   - 模型 ID 必须是真实可用模型

4. 翻译太慢
   - 换更轻的模型
   - 减小单次翻译段落长度

5. 翻译风格不稳定
   - 降低 Temperature
   - 使用固定系统提示词

沉浸式翻译接入 kukuai.fyi ​

准备工作 ​

第一步：填写服务配置 ​

第二步：逐步操作 ​

第三步：优化翻译提示词 ​

第四步：验证翻译效果 ​

排障清单 ​

下一步 ​