v1.6.6: 使用说明+官网页链接、下载改夸克网盘、评论3字下限、AI读取视频真实内容、模拟真人逐字评论

README.md

@@ -0,0 +1,49 @@
+# 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 归一化