50 lines
2.8 KiB
Markdown
50 lines
2.8 KiB
Markdown
# B站评论助手（BiliKeywordComment）
|
||
|
||
Chrome/Edge 浏览器插件（Manifest V3）：按**搜索关键词**找 B站视频，自动生成评论逐条发布。直接使用你浏览器里的 B站登录态，**不需要手动填 Cookie**。
|
||
|
||
## 功能
|
||
|
||
- 🔍 关键词搜索：综合/最多播放/最多弹幕/最多收藏/最新 五种排序
|
||
- 💬 两种评论内容：固定模板（零配置可用）/ AI 生成（OpenAI 兼容接口，失败自动降级并提示）
|
||
- 🛡 防重复：评论成功的视频记入本地历史，下次自动跳过
|
||
- ⏸ 可中断：运行中随时 ⏹ 停止，停止标记跨页面刷新保留，发送前二次检查
|
||
- 🖥 过程可见：真实 B站标签页置前 + 页面右上角浮层逐步显示，侧边栏有计时、成功列表和执行日志
|
||
- 🔁 双通道网络：页面 fetch 优先，被 CORS/CSP 拦截时自动走后台代理兜底
|
||
|
||
## 安装
|
||
|
||
1. 解压 zip（或直接用解压后的目录）
|
||
2. 打开 `chrome://extensions` → 打开右上角「开发者模式」
|
||
3. 「加载已解压的扩展程序」→ 选 `BiliKeywordComment` 目录
|
||
|
||
## 使用
|
||
|
||
1. 登录 B站网页版（登录态直接复用，插件不存 Cookie）
|
||
2. 点工具栏图标打开右侧边栏
|
||
3. 填搜索关键词，设置「最多 N 条 / 每隔 X 秒 / 播放量门槛 / 评论方式」（自动保存）
|
||
4. 点 **▶ 开始执行** → 页面自动置前，右上角浮层显示每一步；⏹ 停止随时可中断
|
||
|
||
AI 模式需填 LLM 配置（默认已预填 `https://ai.88531.cn/v1` + `mimo-v2.6-flash`，填 API Key 即可）；不填也能跑，走固定模板。
|
||
|
||
## 风控提醒
|
||
|
||
- 默认「最多 3 条、间隔 90 秒」，请勿调得过于激进
|
||
- 评论不含外链/广告，纯内容型；触发验证码（12045）或今日上限（12008）会自动停止
|
||
- 建议每天 ≤ 10 条，宁可少发
|
||
|
||
## 文件结构
|
||
|
||
| 文件 | 作用 |
|
||
|------|------|
|
||
| `manifest.json` | MV3 清单（侧边栏 + 内容脚本 + host 权限） |
|
||
| `background.js` | Service worker：LLM 代理、API 兜底、评论历史、运行编排 |
|
||
| `content.js` / `content.css` | 页面内执行：搜索 → 生成 → 发布 + 进度浮层 |
|
||
| `sidepanel.html` / `sidepanel.js` | 侧边栏 UI |
|
||
| `icons/` | 16/32/48/128 图标 |
|
||
|
||
## 已验证
|
||
|
||
- 面板 harness：初始化填值、测试连接、空关键词拦截、启动/停止/完成生命周期、行内警告、零 JS 错误、零 alert
|
||
- 真实扩展加载（Chromium + `--load-extension`）：SW 启动、内容脚本 ping、B站搜索/评论接口页面源可达（CORS 通过）、bgFetch 兜底 200、未登录分支浮层与提示正确、重复注入仅一个浮层
|
||
- 后台 LLM 真代码分支：真实 200 取正文、400 去 thinking 重试、空内容提额重试、无关 400 不盲试、异常可读报错、URL 归一化
|