x-ai-auto-translator

项目概述

X AI Translator 是一款给 X（Twitter）自动翻译的外语帖子浏览器扩展，支持 Chrome 与 Edge，Manifest V3、零依赖、免构建。翻译由你自己部署的 OpenAI 兼容 AI 服务完成，译文以克隆原帖 DOM 的方式贴在原文下方，排版与原帖完全一致。

用你自己的 AI，把 X 刷成中文界面。

主要功能

• 覆盖全面：时间线、帖子详情、评论、引用、个人主页简介与资料卡都能翻译
• 双模式：自动模式滚入视口即翻并提前预取；手动模式在帖子底部点「翻译」逐条按需
• 自带引擎：支持任意 OpenAI 兼容接口，vLLM、Ollama、DeepSeek、智谱、OpenAI、Gemini 网关皆可
• 排版克隆：克隆原帖 DOM 只替换文字节点，链接、换行、加粗、字号与原帖相同
• 占位符保护：emoji、URL、@提及、#话题不进模型，由代码原位复刻，模型吞掉也会补回
• 省 Token：按文本节点切片段批量合并请求，同一文本会话内只翻一次
• 图片解读：视觉模型解读任意图片内容，黑底白字面板覆图显示，再点切回
• 隐私本地化：API Key 只存本地 chrome.storage，请求由扩展后台直连你的服务

适用人群

• 刷 X 看外语推的中文用户
• 自建了 AI 推理服务的开发者
• 在意数据不经第三方的隐私用户
• 想要原排版译文体验的读者

快速上手

1. 克隆仓库或从 Releases 下载 zip 解压
2. 打开 chrome://extensions（Edge 为 edge://extensions），开启开发者模式，点「加载已解压的扩展程序」
3. 打开 x.com，点工具栏图标填入服务地址、API Key 与模型即可使用

核心优势

• 零中转：翻译请求从扩展后台直连你的服务，不经任何第三方
• 免构建：拿到源码目录就能直接加载为扩展
• 原帖观感：译文与原文排版像素级一致，阅读不割裂

系统要求

项目	要求
浏览器	桌面版 Chrome 或 Edge（Chromium 内核）
AI 服务	一个可访问的 OpenAI 兼容服务（如自建 vLLM）

注意事项

• X 前端改版频繁，极端情况下需等扩展更新选择器
• API 费用自理，调用量由批量合并与会话缓存缓解
• 会话缓存内换模型译文可能不变，重启浏览器即清空
• 本地 http 地址的服务由扩展后台直连，不受页面跨域限制