文档

小红书自动评论 开发文档

这个项目是什么

xhs-auto-comment 是一款开源、免费的 Chrome 浏览器扩展，帮助用户在小红书平台实现自动评论：按关键词批量寻找笔记、在搜索页/主页/标签页/首页猜你喜欢等入口自动评论，支持按最新/最热筛选隐藏评论、仅粉丝/仅女生笔记过滤、每条间隔与确认弹窗控制，并内置 AI 评论接口与自定义 AI 提示词。

技术上它是纯 JavaScript 的 MV3 扩展：无构建步骤、无 package.json，改完文件刷新扩展即可运行，适合当作 MV3 + Side Panel + 购买/授权链路的最小参考实现。产品页：https://dl.88531.cn/xhs.html ；AI 页：https://ai.88531.cn/ ；购买/授权中心：https://auth.88531.cn （订单查询、兑换中心）。

技术栈与仓库结构

领域 说明
扩展规范 Manifest V3（side_panel、storage、unlimitedStorage、activeTab、scripting、tabs、alarms）
语言 原生 JavaScript（无框架、无打包器）
UI 侧边栏面板（sidepanel.html + 原生 CSS/JS） + 注入内容脚本
AI API 地址 + API Key + 模型名的通用 OpenAI 兼容调用
授权 自建卡密/激活码体系（授权中心 auth.88531.cn） 
xhs-auto-comment/
├── manifest.json        # MV3 清单：权限、Side Panel、入口
├── background.js        # Service Worker：任务调度、授权校验、AI 与评论动作
├── content.js           # 内容脚本：页面抓取、笔记识别、自动评论执行
├── content.css          # 注入样式
├── sidepanel.html / sidepanel.js / sidepanel.css   # 控制面板 UI
├── buy.html             # 购买/授权页
├── icons/               # 图标与右上角版本号徽章
└── xhs-auto-comment-1.7.7-store.zip   # Chrome 应用商店上架包（打包产物）

本地运行

  1. 下载或克隆仓库（或解压商店包）。
  2. chrome://extensions → 开发者模式 →「加载已解压的扩展程序」→ 选择本目录。
  3. 打开 sidepanel.html 对应的扩展面板配置任务。
  4. 修改 background.js / content.js / sidepanel.js 后在扩展页点「重新加载」即生效，无需构建。

打包上架时参考 xhs-auto-comment-1.7.7-store.zip 的结构：manifest.json 必须在 zip 根目录。

配置项说明

配置 位置 说明
API 地址 / API Key / 模型名 面板「AI 评论接口」 OpenAI 兼容接口；「测试 AI」验证连通性；AI 回复内容做了随机化（v1.2.1）
每条评论间隔 面板任务设置 10–999 秒区间自选，条与条之间随机等待（模拟真人节奏防风控）
总条数上限 面板任务设置 仅限制本次会话的评论数量
逐条确认 面板任务设置 开启后每条都弹确认窗 + 倒计时，由人最终拍板
去重 面板任务设置 v1.8.3 起自动记录已评论内容并去重（最多记录 5000 条），统计栏显示「已去重」
授权 面板「激活」 卡密/激活码激活；正式版内置试用 72 小时 + 最多 100 条，到期后每日少量额度；卡密到期自动停用，续费后恢复

二次开发要点

更新记录（摘自 README「更新日志」，仓库 CHANGELOG.md 另有购买流程等补充记录）

相关链接