本地大模型网页翻译 Autor: moccot-zheng

中文 (简体)
一、简介
本地大模型网页翻译是一款 Firefox 浏览器扩展，支持使用本地或云端大模型对网页进行全文翻译或选中文字翻译。v2.0.0 新增中英双语界面、API Key 加密存储、翻译测试、可配置系统提示词等功能。

二、安装与首次配置
首次使用时，系统会请求数据收集授权。
本地模型：数据不会离开你的设备。
云端 API：数据仅用于实时翻译，不会被存储。
在选项页面选择翻译后端：
本地模型：填写本地服务地址，通常为 http://127.0.0.1:8080。
云端服务：选择服务商并填写 API Key 与模型名称。

三、翻译方式
翻译整页：点击工具栏图标选择“翻译整页”，或使用右键菜单。
翻译选中文字：选中文本后点击“翻译选中文字”，或使用右键菜单。
停止翻译：点击“停止翻译”，或页面跳转时自动停止。
重新翻译：翻译完成后可点击“重新翻译”。

四、选项设置
语言设置：可手动切换简体中文或英文界面。
API Key 管理：自动加密存储，无需手动处理。
系统提示词：可自定义翻译风格，支持恢复默认。
思考模式：可关闭以降低延迟，适合纯翻译场景。
代码块处理：可选择是否跳过 code / pre 标签内容。

五、常见问题
为什么翻译没有反应？
请检查模型是否正常运行，或 API Key 是否正确。
是否支持 Chrome 或 Edge？
当前仅支持 Firefox。
会影响网页布局吗？
不会，翻译采用原地文本替换。
翻译失败怎么办？
插件会自动重试两次，仍失败则保留原文并提示错误。

六、核心功能
多翻译后端支持：本地模型、DeepSeek、通义千问、智谱 GLM、Moonshot、百川及自定义 OpenAI 兼容 API。
中英双语界面：自动识别浏览器语言，支持手动切换。
API Key 加密存储：采用 AES-GCM 加密，密钥仅存在于 Background Script 内存中。
翻译测试面板：支持预设例句与自定义输入，显示耗时与字符数。
可配置系统提示词：用户可自定义发送给大模型的系统提示。
思考模式控制：可关闭思考链，降低 60%–80% 延迟。
两阶段可见优先翻译：先翻译视口内内容，再处理隐藏内容。
数据收集同意机制：未授权时禁止所有对外请求。
文本智能处理：混合粒度拆分、智能跳过特定内容与标签。
多种翻译触发方式：整页、选中文字、停止、重翻、连接检测。
动态内容支持：IntersectionObserver 与 MutationObserver 自动处理新内容。
进度与状态指示：右下角浮动角标实时显示进度。
错误处理与可靠性：超时跳过、自动重试、异常保护。