混阅

Appearance

本地大模型配置教程 ​

只需要 KISS Translator + 本机模型 + 混阅 Prompt。浏览器直接连接自己电脑上的模型，原混阅服务端不参与请求。

本教程以桌面扩展和 Ollama 为例，核对了 KISS Translator v2.1.1 及当前上游代码。不同版本可能把“翻译服务”叫作“服务配置”或“接口设置”；找到模型地址、提示词和聚合开关即可。安装方式见安装插件。

1. 在电脑上运行模型 ​

从 Ollama 官网安装并启动 Ollama。用下面的中文指令模型作为起点：

sh
ollama pull qwen2.5:7b
ollama list

qwen2.5:7b 是一个具体可用的本地模型示例，并非唯一选择。下载和运行需要相应的磁盘、内存或显存；也可以换成已经安装、能遵守中英文改写指令的模型，下面的模型名要同步修改。

Ollama 应当提供 http://127.0.0.1:11434。未通过桌面应用启动时，可在终端运行 ollama serve；若提示端口已占用，通常说明服务已启动，不要再启动第二个实例。

先确认本地接口可用 ​

macOS / Linux 终端中执行；Windows 可用 PowerShell 的 curl.exe 或接口调试工具发送等价 JSON：

sh
curl http://127.0.0.1:11434/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "qwen2.5:7b",
    "messages": [
      {"role": "system", "content": "把中文段落中的一个词语替换为英文，保留其他中文。只输出改写后的正文。"},
      {"role": "user", "content": "近年来，环境保护已经成为全球性的关注焦点。"}
    ],
    "temperature": 0.2,
    "stream": false
  }'

查看返回的 choices[0].message.content。预期是中夹英正文，例如“近年来，环境 protection 已经成为全球性的关注焦点。”。这是连通性示例，输出内容可能不同；下一步再使用数据库原始 Prompt。

2. 创建混阅提示词 ​

在插件设置的“提示词管理”中，新增一个非聚合/单句翻译模板。部分版本把该分类标为“用户提示词（User Prompt）”，进入后仍有 System Prompt 和 User Prompt 两个字段。也可以复制现有单句模板再修改。

字段填写内容
名称混阅 · 简单
System Prompt / 系统提示词原始 Prompt 页面中“简单”的完整代码块
User Prompt / 用户提示词只填写下面这一行
text
{{text}}

这里的 {{text}} 是插件占位符，发请求时会替换成网页段落。不要把这一行替换成固定测试句子，也不要把 Prompt 的说明文字一并复制。

想换难度，可以分别保存“混阅 · 中等”“混阅 · 四级”等模板。先不要保留默认模板里要求“完整翻译成目标语言”的系统指令，否则会和混阅目标冲突。

3. 添加模型服务并绑定提示词 ​

在“翻译服务 / 服务配置 / 接口设置”中添加 Ollama 服务，填写：

配置项值
名称本地混阅
API 地址http://127.0.0.1:11434/v1/chat/completions
模型qwen2.5:7b，或 ollama list 中实际安装的模型名
API KeyOllama 本机默认不需要；如界面强制填写，可填占位文字 ollama
非聚合翻译提示词刚保存的“混阅 · 简单”
聚合翻译 / 批量聚合关闭
流式输出先关闭，确认正常后可自行尝试
温度可从 0.2 开始
并发可调时先设为 1，减少本机模型排队

这个地址是完整的 Chat Completions 端点，不是 Ollama 原生的 /api/chat。若使用其他客户端且字段明确叫“Base URL”，通常应填 http://127.0.0.1:11434/v1，由客户端追加路径；不要把两种地址填法混用。详见 Ollama OpenAI 兼容接口说明。

保存后使用服务测试，确认返回的是中夹英正文。连接成功但输出全英文，往往是混阅模板没有绑定到实际使用的非聚合提示词上。

有些版本允许场景单独选择提示词，场景选择会覆盖服务默认值。要么在网页翻译场景中明确选择“混阅 · 简单”，要么让它沿用刚配置好的服务提示词。

4. 选择网页翻译场景 ​

在“网页翻译 / 场景设置”中：

  1. 选择刚创建的“本地混阅”服务，并确认实际选中的 Prompt 是“混阅 · 简单”。
  2. 将源语言设为中文、目标语言设为英语。若存在“跳过目标语言/不翻译的语言”，确保中文没有被跳过。
  3. 启用 仅显示译文。这里的“译文”就是模型生成的中夹英正文。
  4. 选择一篇中文短文，点击插件翻译按钮；也可使用上游默认快捷键 Alt+Q（如有冲突可在浏览器中调整）。

先翻译几个段落，再按需要扩大范围。正文未被识别时，按网站规则说明设置范围。

5. 浏览器连接本机失败时 ​

如果终端测试成功，插件报跨域或 403，可给 Ollama 加上扩展来源。先退出已经运行的 Ollama，再按你的运行方式设置环境变量并重启；不需要把模型端口暴露到公网。

终端运行（macOS / Linux） ​

sh
OLLAMA_ORIGINS='chrome-extension://*,moz-extension://*' ollama serve

macOS 桌面应用 ​

sh
launchctl setenv OLLAMA_ORIGINS 'chrome-extension://*,moz-extension://*'

随后完全退出并重新打开 Ollama 应用。

Windows 桌面应用 ​

在账户的“环境变量”中添加 OLLAMA_ORIGINS，值为 chrome-extension://*,moz-extension://*；退出托盘中的 Ollama 后重新启动。不要把这段 macOS/Linux 启动命令直接粘到 Windows 命令提示符。

Linux systemd 服务 ​

执行 sudo systemctl edit ollama.service，填写：

ini
[Service]
Environment="OLLAMA_ORIGINS=chrome-extension://*,moz-extension://*"

然后执行：

sh
sudo systemctl daemon-reload
sudo systemctl restart ollama

跨域来源设置的依据见 Ollama 官方 FAQ。本例只开放浏览器扩展来源。若使用油猴脚本或其他请求方式，需要按实际来源另行配置；电脑浏览器教程不要求设置 OLLAMA_HOST=0.0.0.0。

浏览器若弹出“本地网络访问”或扩展站点权限请求，需要允许所用扩展访问本机服务。如果依然失败，按常见问题逐项核对。

其他模型工具 ​

也可以使用 LM Studio 等提供本机 Chat Completions 兼容接口的工具。使用该工具给出的实际地址、模型标识和认证方式，再绑定相同 Prompt；无需继续使用混阅旧 API。

查看全部原始 Prompt · 了解流程 · KISS Translator 上游说明