v2ex-comment-distribution-chrome-extension

一个自动展示 V2EX 评论观点分布的 Chrome 扩展。

已实现功能

1. 当用户浏览某个 V2EX 帖子（https://www.v2ex.com/t/*）时，自动在主贴区域下方注入「评论观点分布」面板。
2. 扩展会通过 V2EX 官方 API 拉取帖子内容与评论（按帖子 ID），再结合主贴问题提炼观点。
3. 支持可配置参数：
   • V2EX API Base URL
   • OpenAI Base URL
   • OpenAI API Key
   • 模型
   • temperature
   • 最大观点数量
   • 分析阈值（原始评论数 ≤ 该值时跳过分析）
4. 内部 LLM 调用使用 OpenAI Chat Completions 兼容协议（可用于 OpenAI 及兼容 API 的服务）。
5. 分布结果以颜色条 + 图例方式展示：
   • 颜色条：每段代表一个观点占比
   • 图例：观点名称、评论数和比例

安装指导

方式一：直接下载项目目录（推荐）

1. 下载本仓库代码并解压到本地目录。
2. 打开 Chrome，访问 chrome://extensions。
3. 打开右上角「开发者模式」。
4. 点击「加载已解压的扩展程序」，选择本项目根目录（包含 manifest.json 的目录）。
5. 安装成功后，在扩展卡片中点击「详情」→「扩展程序选项」进入配置页面。

方式二：通过 Git 克隆

git clone <your-repo-url>
cd v2ex-comment-distribution-chrome-extension

然后重复「方式一」中的第 2~5 步进行加载。

使用方式

1. 打开扩展选项页，填写并保存以下参数：
   • V2EX API Base URL（默认 https://www.v2ex.com/api）
   • OpenAI Base URL（默认 https://api.openai.com/v1）
   • OpenAI API Key
   • 模型（默认 gpt-4o-mini）
   • temperature（默认 0.2）
   • 最大观点数量（默认 5）
   • 分析阈值（默认 10，原始评论数 ≤ 该值时跳过分析）
2. 访问 V2EX 帖子页面，例如测试帖：
   • https://www.v2ex.com/t/1195026
3. 页面加载后，主贴区域下方会自动出现「评论观点分布」面板。
4. 仅当原始评论数量大于你配置的「分析阈值」时才会调用模型进行观点分析。
5. 若出现报错，请优先检查 API Key、Base URL 和模型名是否可用。

如何更新插件

当前 README 介绍的是「加载已解压扩展」方式，因此更新插件也很简单：

1. 先更新本地项目代码（任选一种）：
   • 如果你是下载 ZIP：重新下载最新代码并覆盖原目录。
   • 如果你是 Git 克隆：在项目目录执行 git pull。
2. 打开 Chrome，进入 chrome://extensions。
3. 找到本插件卡片，点击「刷新」（圆形箭头图标）。
4. 回到 V2EX 帖子页面强制刷新（Ctrl + F5 或 Cmd + Shift + R）以确保注入脚本更新生效。

说明：

• 你在「扩展程序选项」里保存的配置（API Key、模型等）通常会保留，不需要每次重填。
• 如果更新后行为异常，可以尝试「移除扩展」后重新按安装步骤加载一次。

V2EX API 说明

• 当前实现使用以下官方接口获取数据：
  • /topics/show.json?id=<topicId>（获取主贴）
  • /replies/show.json?topic_id=<topicId>（获取评论）
• 根据官方文档，默认 API Rate Limit 为每 IP 每小时 120 次；扩展会读取返回头中的 X-Rate-Limit-* 并在页面状态中显示剩余额度。
• 为减少请求消耗，扩展对同一帖子做了 10 分钟内存缓存（命中缓存时会提示“命中缓存”）。
• 若 V2EX 后续升级 API，请在设置中更新 V2EX API Base URL，并按官方文档调整字段映射。