xhs-auto-comment/README.md

📕 小红书自动评论助手

一键搜索 · 自动点击 · 智能评论 —— 小红书运营引流的效率神器

一个专注于自动评论功能的浏览器插件：在浏览器右侧侧边栏常驻，输入关键词即可自动搜索小红书、逐篇点开笔记、发表评论，全程无需人工干预。

---

🌟 为什么选择我们

亮点	说明
🚀 全流程自动化	输入关键词 → 自动开搜 → 自动点开每篇笔记 → 自动写评论 → 自动提交，一条龙跑完
🤖 4 种评论方式	固定评论池 / 自定义文字库 / 图片回复 / AI 按笔记生成，随心切换
🧠 AI 智能评论	接入任意 OpenAI 兼容接口，每篇笔记结合内容生成不同评论，告别复读机
🖼️ 图片评论	上传表情包/图片，每篇笔记自动发一张，多张循环，互动更自然
📍 按地区搜索	选「上海」「杭州西湖区」自动拼进关键词，精准触达同城流量
📊 评论数据统计	今日/本月/总计成功数一目了然，每条记录带标题+评论内容，点击直达笔记
🔐 免费试用 1 天	装完即用，满意再买；插件内支付宝/微信购买，支付成功自动发卡自动激活
📢 公告推送	官方公告实时下发（弹窗/列表），运营消息不错过
🛡️ 稳定可靠	元素检测+备用方案、失败自动重试、内存自动防护、页面结构变化可快速适配
🔒 数据本地存储	评论库、图片、记录全部存在你自己的浏览器里，不上传第三方

📦 功能总览

• 🔍 智能搜索：关键词搜索 + 地区筛选（18 个主要城市 + 自定义到区/商圈级）
• 🤖 自动点击：精确定位笔记卡片链接，支持「展开内容」或「简单点击」两种模式，自动滚动加载更多
• 💬 评论方式：
  • 固定评论池：循环发预设短评（👍 赞！/💯 太棒了！…）
  • 自定义文字：侧边栏文字库一行一条，循环发送
  • 图片回复：上传图片自动压缩存本地，预览/删除管理
  • AI 按笔记生成：提示词可自定义（{{content}} 占位符），失败自动降级
• 📊 评论记录：成功评论自动记录，今日/本月/总计统计，点击记录打开对应笔记
• 🔐 授权体系：1 天试用（倒计时精确到秒）、卡密激活、插件内购买自动发卡
• 🧪 元素检测：一键测试页面元素识别情况，方便小红书改版后快速排查

🚀 安装方法

1. 下载插件文件到本地（或 git clone 本仓库）
2. 打开 Chrome / Edge，进入扩展程序页面（chrome://extensions/ 或 edge://extensions/）
3. 开启「开发者模式」
4. 点击「加载已解压的扩展程序」，选择插件文件夹
5. 工具栏出现红色「小红书」图标，点击即在右侧打开侧边栏

📖 使用方法

打开侧边栏

• 点击工具栏图标，界面固定在浏览器右侧，切换标签页不会关闭，方便边看边操作
• 再点一次图标可收起

授权与购买

1. 安装后自动进入 1 天免费试用（侧边栏顶部显示精确到秒的倒计时）
2. 试用结束后需激活：输入卡密点「激活」，或点「购买授权」
3. 购买流程：点购买 → 选支付宝/微信 → 新页面完成支付 → 支付成功自动发卡并激活生效，无需手动输卡密
4. 已购用户也可在 购买中心 用订单号查询卡密，回来手动激活
5. 授权绑定本机浏览器，换设备请联系管理员重置

自动搜索评论

1. 输入搜索关键词
2. （可选）选择地区：如「北京」「自定义… 杭州西湖区」
3. 点击「🔍 搜索」→ 自动打开搜索结果页并开始评论流程，状态实时显示在面板内

说明：小红书网页版没有原生地区筛选，地区以关键词形式参与搜索（实际搜索词为「关键词 地区」）。

评论方式（四选一，改完立即生效）

• 固定评论池：循环发预设短评，不调用模型
• 自定义文字：文字库一行一条，循环发送
• 图片回复：每篇笔记发一张图片，多张循环
• AI 按笔记生成：每篇笔记调用模型按内容生成

未配置对应内容时（如选了文字模式但库是空的），选项下方会给出橙色提示。

手动触发 / 元素检测

• 在小红书页面点「🤖 自动点击笔记」立即开始；点「🧪 测试元素检测」排查页面识别问题

配置 AI 评论（自定义模型）

1. 侧边栏「AI评论生成」处填写（改动即时保存）：
   • API密钥：服务商的 key（sk-...），没有？👉 免费获取模型 KEY
   • API地址：任意 OpenAI 兼容接口（未带 /v1 自动补全）
   • 模型名：如 mimo-v2.6-flash、deepseek-ai/DeepSeek-R1
2. 点「测试AI」验证连通，状态显示 🟢 已启用即可用

🔧 自动点击调试

1. 控制台日志：F12 → Console 查看完整操作日志
2. 元素检测：侧边栏点「🧪 测试元素检测」查看识别详情
3. 常见问题：
   • 页面未完全加载 → 等加载完成再启动
   • 小红书改版 → 用元素检测确认选择器，更新 content.js 中的 CSS 选择器
   • 评论没发出去 → 检查网络/登录状态，观察控制台报错

⚠️ 注意事项

• 需要在小红书官网 (xiaohongshu.com) 登录状态下使用
• 评论内容请遵守平台规范，建议合理控制频率，避免账号风控
• 页面结构变化可能导致兼容性问题，欢迎提 Issue 反馈

📜 版本历史

当前版本：1.7.5

展开查看完整变更记录（v1.2.0 ~ v1.7.5）

1.7.5

• 试用倒计时精确到秒（HH:MM:SS 每秒刷新，归零自动锁定）

1.7.4

• 移除「发现新版本」提示条；底部新增「⬇️ 获取最新版本」大按钮直达官方下载页

1.7.3

• 修复更新提示残留；公告按「标题+内容+时间」展示

1.7.2

• 「AI评论生成」上方新增橙色发光横幅「免费获取模型KEY → ai.88531.cn」

1.7.1

• 图标改为小红书风格 PNG（品牌红底 + 白色「小红书」字样），工具栏一眼可认

1.7.0

• 接入 CardAuth 授权系统：1 天试用、卡密激活、插件内购买自动发卡自动激活
• 公告推送（弹窗每条一次 + 列表）、安装统计、30 分钟心跳

1.6.0

• 新增「自定义文字」「图片回复」两种评论方式（评论方式扩展为四选一）

1.5.0

• 新增「按地区搜索」（地区下拉 + 自定义，自动拼进关键词）

1.4.x

• 侧边栏常驻、评论方式开关、图标识别小字

1.3.x

• 侧边栏（Side Panel）改版；修复思考型模型 AI 正文为空的问题

1.2.0

• AI 模型自定义配置（API地址/模型名/密钥），请求改由后台发出规避跨域

🛠 开发说明

纯 JavaScript 开发，无任何外部依赖，代码结构清晰，便于二次开发：

manifest.json        # 扩展清单（MV3）
background.js        # 后台服务：AI请求代理、授权/公告/心跳
content.js           # 内容脚本：笔记点击、评论输入与提交、记录
sidepanel.html/js/css# 侧边栏 UI（搜索/评论配置/授权/记录）
icons/               # 16/32/48/128 小红书风格图标

📄 免责声明

本插件仅供学习与效率研究使用。使用本插件产生的一切行为（评论内容、频率等）由使用者自行负责，请遵守小红书平台规范及相关法律法规。

---

⬇️ 获取最新版本 · 反馈与合作请提 Issue