personal82555
98170e6d8a
成功评论后把笔记 ID 写入本机「已评论索引」（上限5000条，自动淘汰最旧），列表流程与直接打开笔记页两条路径评论前都查索引，命中即跳过；进度条新增「已跳过已评论」实时统计，侧边栏评论记录新增「已去重」；进度条统计行加 flex-wrap+nowrap 防窄窗口文字挤压。
199 lines
12 KiB
Markdown
199 lines
12 KiB
Markdown
# 📕 小红书自动评论助手
|
||
|
||
> 一键搜索 · 自动点击 · 智能评论 —— 小红书运营引流的效率神器
|
||
|
||
[](https://dl.88531.cn/xhs.html)
|
||
[](#安装方法)
|
||
[](#开发说明)
|
||
|
||
一个专注于自动评论功能的浏览器插件：在浏览器**右侧侧边栏常驻**，输入关键词即可自动搜索小红书、逐篇点开笔记、发表评论，全程无需人工干预。
|
||
|
||
---
|
||
|
||
## 🌟 为什么选择我们
|
||
|
||
| 亮点 | 说明 |
|
||
|---|---|
|
||
| 🚀 **全流程自动化** | 输入关键词 → 自动开搜 → 自动点开每篇笔记 → 自动写评论 → 自动提交，一条龙跑完 |
|
||
| 🤖 **3 种评论方式** | 固定评论池 / 自定义文字库 / **AI 按笔记生成**，随心切换 |
|
||
| 🧠 **AI 智能评论** | 接入任意 OpenAI 兼容接口，每篇笔记结合内容生成不同评论，告别复读机 |
|
||
| 📍 **按地区搜索** | 选「上海」「杭州西湖区」自动拼进关键词，精准触达同城流量 |
|
||
| 📊 **评论数据统计** | 今日/本月/总计成功数一目了然，每条记录带标题+评论内容，**点击直达笔记** |
|
||
| 🔐 **免费试用 3 天 · 100 条** | 72 小时 + 100 条评论额度，先到先停；到期**不锁死**：每天还能体验 3 条、记录全保留，24 小时内下单享限时优惠 |
|
||
| 📢 **公告推送** | 官方公告实时下发（弹窗/列表），运营消息不错过 |
|
||
| 🛡️ **稳定可靠** | 元素检测+备用方案、失败自动重试、内存自动防护、页面结构变化可快速适配 |
|
||
| 🔒 **数据本地存储** | 评论库、图片、记录全部存在你自己的浏览器里，不上传第三方 |
|
||
|
||
## 📦 功能总览
|
||
|
||
- **🔍 智能搜索**：关键词搜索 + 地区筛选（18 个主要城市 + 自定义到区/商圈级）
|
||
- **🤖 自动点击**：精确定位笔记卡片链接，支持「展开内容」或「简单点击」两种模式，自动滚动加载更多
|
||
- **💬 评论方式**：
|
||
- 固定评论池：循环发预设短评（👍 赞！/💯 太棒了！…）
|
||
- 自定义文字：侧边栏文字库一行一条，循环发送
|
||
- AI 按笔记生成：提示词可自定义（`{{content}}` 占位符），失败自动降级
|
||
- **📊 评论记录**：成功评论自动记录，今日/本月/总计统计，点击记录打开对应笔记
|
||
- **🔐 授权体系**：72 小时试用 + 100 条额度（先到先停）、到期降级每天 3 条、卡密激活、插件内购买自动发卡
|
||
- **🧪 元素检测**：一键测试页面元素识别情况，方便小红书改版后快速排查
|
||
|
||
## 🚀 安装方法
|
||
|
||
1. 下载插件文件到本地（或 `git clone` 本仓库）
|
||
2. 打开 Chrome / Edge，进入扩展程序页面（`chrome://extensions/` 或 `edge://extensions/`）
|
||
3. 开启「开发者模式」
|
||
4. 点击「加载已解压的扩展程序」，选择插件文件夹
|
||
5. 工具栏出现红色「小红书」图标，点击即在右侧打开侧边栏
|
||
|
||
## 📖 使用方法
|
||
|
||
### 打开侧边栏
|
||
- 点击工具栏图标，界面**固定在浏览器右侧**，切换标签页不会关闭，方便边看边操作
|
||
- 再点一次图标可收起
|
||
|
||
### 授权与购买
|
||
1. 安装后自动进入 **72 小时免费试用**（含 100 条评论额度，侧边栏顶部倒计时精确到秒、额度实时显示）
|
||
2. 试用结束后**不硬锁**：自动转为体验模式（评论记录与配置全保留，每天 3 条额度，用完次日恢复）；此时点「购买授权」下单自动带 24 小时限时优惠码（`XHS24H`，8 折），也可输入卡密点「激活」
|
||
3. 购买流程：点购买 → 选支付宝/微信 → 新页面完成支付 → **支付成功自动发卡并激活生效**，无需手动输卡密
|
||
4. 已购用户也可在 [购买中心](https://auth.88531.cn/shop) 用订单号查询卡密，回来手动激活
|
||
5. 授权绑定本机浏览器，换设备请联系管理员重置
|
||
|
||
### 自动搜索评论
|
||
1. 输入搜索关键词
|
||
2. （可选）选择地区：如「北京」「自定义… 杭州西湖区」
|
||
3. 点击「🔍 搜索」→ 自动打开搜索结果页并开始评论流程，状态实时显示在面板内
|
||
|
||
> 说明：小红书网页版没有原生地区筛选，地区以关键词形式参与搜索（实际搜索词为「关键词 地区」）。
|
||
|
||
### 评论方式（三选一，改完立即生效）
|
||
- **固定评论池**：循环发预设短评，不调用模型
|
||
- **自定义文字**：文字库一行一条，循环发送
|
||
- **AI 按笔记生成**：每篇笔记调用模型按内容生成
|
||
|
||
未配置对应内容时（如选了文字模式但库是空的），选项下方会给出橙色提示。
|
||
|
||
### ⏱️ 评论间隔（防风控）
|
||
- 每条评论之间随机等待设定范围（默认 1~2 分钟，可改为任意范围，支持小数）
|
||
- 例如填 1 和 2：每篇笔记评论完后随机等 60~120 秒再处理下一篇
|
||
- 填 0 和 0 则不等待（不推荐）
|
||
- 等待期间进度条实时倒计时，点「⏹️ 停止」随时中断
|
||
|
||
### 手动触发 / 元素检测
|
||
- 在小红书页面点「🤖 自动点击笔记」立即开始；点「🧪 测试元素检测」排查页面识别问题
|
||
|
||
### 配置 AI 评论（自定义模型）
|
||
1. 侧边栏「AI评论生成」处填写（改动即时保存）：
|
||
- **API密钥**：服务商的 key（`sk-...`），没有？[👉 免费获取模型 KEY](https://ai.88531.cn)
|
||
- **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.8.3**
|
||
|
||
<details>
|
||
<summary>展开查看完整变更记录（v1.2.0 ~ v1.8.3）</summary>
|
||
|
||
### 1.8.3
|
||
- **评论去重：评过的笔记不再重复评论**。每次成功评论后把笔记 ID 写入「已评论索引」（本机保存，最多 5000 条），之后任何时候再刷到同一篇（同关键词、不同关键词、换个时间重新跑都一样）都会**自动跳过**，不会给同一篇笔记发第二条评论——避免重复评论触发平台风控限流
|
||
- 运行时进度条新增「**已跳过已评论**」一栏，实时显示本轮跳过了几篇；侧边栏评论记录统计新增「**已去重**」，显示累计跳过的笔记总数
|
||
- 即使不是从列表进入（比如直接打开某篇笔记页），评论前也会先查索引，已评过就直接跳过
|
||
|
||
### 1.8.2
|
||
- **未授权时显示机器码**：卡密输入框下方常驻展示本机机器码 + 一键复制，去商城购买或手动激活时直接粘贴，不用再翻文档问客服怎么找
|
||
|
||
### 1.8.1
|
||
- **订单轮询 12 小时自动停止**：超过 12 小时仍未完成支付的订单不再后台追问，避免永久占用后台定时任务（与 B站评论助手行为一致）
|
||
|
||
### 1.8.0
|
||
- **购买流程重做**：点「购买授权」不再原地展开支付方式，而是**打开新页面** → ① 展示本项目全部在售套餐供选择 → ② 选套餐后才出现支付方式（支付宝/微信）→ ③ 下单支付，支付成功**自动发卡并激活本机**
|
||
- **支付后必定自动激活**：订单轮询从侧边栏搬到后台定时任务，**关掉侧边栏、关掉购买页、甚至重启浏览器**都能在支付完成后自动完成激活，不再出现「付了钱还显示未授权」
|
||
- **修复「点击购买授权没反应」**：支付方式选择行此前被 CSS 常驻显示（`display:flex` 压过了 `hidden` 属性），点击后视觉上毫无变化；现已修复，选择行默认隐藏、按需展开
|
||
- 套餐与价格实时读取服务端在售列表（不再写死金额），购买页会跳过 0 元测试套餐
|
||
|
||
### 1.7.9
|
||
- **试用策略升级「72 小时 + 100 条」**：时间与条数先到先停——拉长试用必须配用量上限，避免长时间白嫖评论量
|
||
- **到期不再硬锁，改降级体验**：自动转为体验模式，评论记录/文字库/模型配置全部保留，每天仍可发 3 条（用完次日恢复）
|
||
- **24 小时限时优惠**：到期后侧边栏出现限时优惠条（码 `XHS24H`，8 折，倒计时精确到秒），一键复制；点「购买授权」下单自动抵扣，优惠码异常时自动按原价下单、绝不挡购买
|
||
- 试用倒计时新增「额度剩 N 条」实时显示；剩余 ≤10 条时页面会提示
|
||
|
||
### 1.7.8
|
||
- **移除图片回复模式**：小红书网页版评论框本身不支持发图片（仅手机 App 支持），该模式一直无法真正发送，已从侧边栏选项、配置面板与发送逻辑中整体移除；评论方式精简为「固定评论池 / 自定义文字 / AI 按笔记生成」三种，旧版本残留的 image 模式会自动回退为固定评论池
|
||
|
||
### 1.7.7
|
||
- **明确图片评论限制**：小红书网页版评论框不支持发图片（仅手机 App 支持）。图片模式发送失败时页面弹出明确提示（只弹一次），侧边栏选项下方同步橙色警告，建议改用「自定义文字」或「AI」模式
|
||
|
||
### 1.7.6
|
||
- **评论间隔随机化**：每条评论之间在设定范围内随机等待（默认 1~2 分钟，可自定义），进度条实时倒计时，模拟真人浏览节奏更安全
|
||
|
||
### 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地址/模型名/密钥），请求改由后台发出规避跨域
|
||
|
||
</details>
|
||
|
||
## 🛠 开发说明
|
||
|
||
纯 JavaScript 开发，**无任何外部依赖**，代码结构清晰，便于二次开发：
|
||
|
||
```
|
||
manifest.json # 扩展清单（MV3）
|
||
background.js # 后台服务：AI请求代理、授权/公告/心跳
|
||
content.js # 内容脚本：笔记点击、评论输入与提交、记录
|
||
sidepanel.html/js/css# 侧边栏 UI（搜索/评论配置/授权/记录）
|
||
icons/ # 16/32/48/128 小红书风格图标
|
||
```
|
||
|
||
## 📄 免责声明
|
||
|
||
本插件仅供学习与效率研究使用。使用本插件产生的一切行为（评论内容、频率等）由使用者自行负责，请遵守小红书平台规范及相关法律法规。
|
||
|
||
---
|
||
|
||
**⬇️ [获取最新版本](https://dl.88531.cn/xhs.html)** · 反馈与合作请提 Issue
|