xiaohongshufabu/extension/README.md

千帆发布助手 - Chrome Extension

小红书千帆店铺矩阵发布工具的浏览器插件端。

安装

1. 打开 Chrome，访问 chrome://extensions/
2. 打开右上角「开发者模式」
3. 点击「加载已解压的扩展程序」
4. 选择此 extension 目录

配置

1. 点击插件图标，在弹窗中填写：
   • 店铺 ID：对应网页版管理端中创建的店铺
   • 本地服务地址：默认 http://localhost:3000
2. 点击「测试连接」确认服务正常
3. 打开千帆发布页面（ark.xiaohongshu.com）
4. 点击「启动」开始自动发布

工作流程

1. 在网页管理端创建店铺、添加商品、生成并审核笔记
2. 将审核通过的笔记创建为发布任务（笔记管理页 → 生成任务）
3. 插件自动轮询领取任务 → 在千帆页面执行发布
4. 发布结果自动回调到服务端

防风控策略

• 每次发布间隔随机 30~90 秒（可配置）
• 单账号单日发布上限（默认 20 条/天）
• 连续失败 3 次自动暂停
• 每日计数自动重置

注意事项

• 首次使用请确认千帆页面 DOM 结构，必要时在「高级设置」中调整选择器
• 本地服务必须保持运行状态
• API Key 仅存储在本地服务端，插件不直接持有