# 📕 小红书自动评论助手

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

[![版本](https://img.shields.io/badge/版本-1.7.9-ff2442.svg)](https://dl.88531.cn/xhs.html)
[![平台](https://img.shields.io/badge/平台-Chrome%20%7C%20Edge-4caf50.svg)](#安装方法)
[![语言](https://img.shields.io/badge/语言-纯%20JavaScript-2196f3.svg)](#开发说明)

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

---

## 🌟 为什么选择我们

| 亮点 | 说明 |
|---|---|
| 🚀 **全流程自动化** | 输入关键词 → 自动开搜 → 自动点开每篇笔记 → 自动写评论 → 自动提交，一条龙跑完 |
| 🤖 **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.7.9**

<details>
<summary>展开查看完整变更记录（v1.2.0 ~ v1.7.9）</summary>

### 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