infoDetox · 信息解毒器

看到一条消息，先别急着转发——先让 AI 帮你把它「解一解毒」。 三行结论：它在说什么 / 哪要警惕 / 我该咋办。

这是什么

信息爆炸的年代，我们每天被标题党、带节奏、伪科学轰炸。infoDetox 是一个浏览器插件，让你在读到信息的当下就拿到一份三行解毒结论：

1. 它在说什么 —— 一句话概括，不被花哨包装带偏
2. 哪要警惕 —— 语气、立场、夸大、话术，帮你看穿套路
3. 我该咋办 —— 一句可操作的建议，而不是空喊"理性思考"

功能

• 🐦 X（推特）专属：每条推文操作栏多一个 🤔 按钮，点击即出结论
• ⌨️ 全局快捷键：任意网页选中文字，按 Ctrl+Shift+D，同样弹出三行结论
• 🔑 自带钥匙（BYOK）：你在插件设置页填自己的 DeepSeek API Key，Key 只存浏览器本地，不经过任何中间服务器

工作原理

┌──────────┐  文字  ┌─────────────┐  API  ┌──────────┐
│ 浏览器插件 │ ─────► │  DeepSeek    │ ───► │ 三行结论  │
│  (前台)   │ ◄───── │  大模型      │ ◄──── │ 回到眼前  │
└──────────┘ 结论   └─────────────┘       └──────────┘

• 插件直连 DeepSeek API，无需本地服务、无需服务器
• 你的 API Key 只存在浏览器本地（chrome.storage），只用于向 DeepSeek 发起请求
• 另有可选的本地服务模式（见文末"进阶玩法"），适合喜欢自己掌控一切的玩家

快速开始（三步）

1. 安装插件

• 商店版：从 Edge Add-ons 或 Chrome Web Store 搜索 "infoDetox"（上架后可用）
• 开发版：打开 chrome://extensions → 开启"开发者模式" → 点"加载已解压的扩展程序" → 选择 extension 文件夹

2. 填 Key

点插件图标 → 在设置页粘贴你的 DeepSeek API Key（在 platform.deepseek.com 免费创建，sk- 开头）→ 点保存

3. 开用

打开 x.com，点推文旁的 🤔；或在任意网页选中文字按 Ctrl+Shift+D。三行结论 10 秒后自动收起。

进阶玩法：本地服务模式（可选）

直连模式已足够日常使用。如果你希望 Key 不放在浏览器里、或想做批量处理，也可以跑本地 Python 服务：

Windows（PowerShell）：

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r server\requirements.txt
copy server\config.example.json server\config.json   # 填入你的 Key
.\.venv\Scripts\python.exe server\app.py

服务运行在 http://127.0.0.1:8787 （插件 0.2.0 起默认直连模式，本地服务模式作为进阶功能保留）。

目录结构

infoDetox/
├── README.md              # 项目说明书（就是本文件）
├── PRIVACY.md             # 隐私政策（商店审核要求）
├── LICENSE                # MIT 开源许可
├── .gitignore             # 保密闸门：密钥、缓存、虚拟环境不上传
├── .gitattributes         # 换行符交通规则
├── extension/             # 浏览器插件（前台服务员）
│   ├── manifest.json      # 插件身份证：权限、入口、图标
│   ├── content.js         # 卧底脚本：加 🤔 按钮、监听快捷键
│   ├── background.js      # 大管家：直连 DeepSeek
│   ├── popup.html/js      # 设置小窗（填 API Key）
│   └── icons/             # 应用图标
├── server/                # （可选）本地服务（后厨）
│   ├── app.py             # Flask 主程序
│   ├── requirements.txt   # 依赖清单
│   └── config.example.json# 配置模板（复制为 config.json 后填密钥）
└── tests/                 # 考试卷（自动化测试，施工中）

隐私与安全

详见 PRIVACY.md。要点：Key 只存本地浏览器；分析文字只发给 DeepSeek；无追踪、无广告、代码全开源。

技术栈

• 浏览器插件：Chrome Extension Manifest V3（原生 JS，零构建工具）
• AI 模型：DeepSeek deepseek-chat
• （可选）本地服务：Python + Flask

贡献

欢迎提 Issue 和 PR。提交信息请遵循 Conventional Commits 约定（feat: / fix: / docs: / chore:）。

许可

MIT © 2025 LianbinZhou