执行流程

1. 搜索笔记

用户: 搜索电动车相关笔记
↓
识别意图: explore (内容发现)
↓
确认参数: keyword=电动车, max=20
↓
执行: xhs explore search -k 电动车 -m 20
↓
返回: 笔记列表 + 摘要统计

2. 批量互动

用户: 给这10篇笔记点赞
↓
识别意图: interact (互动操作)
↓
确认参数: note_ids=[...], action=add
↓
[强制确认] 显示目标范围，等待用户回复确认
↓
执行: xhs interact batch-like -n id1,id2,... --delay 2.0
↓
返回: 操作结果汇总

安全约束

执行前检查

1. 1. [ ] 已确认操作目标（笔记ID/用户ID）
2. [ ] 已确认登录状态（xhs auth status）
3. [ ] 已确认批量操作范围

强制确认（必须用户明确回复确认）

1. 1. 发表评论 - 显示评论内容，等待确认
2. 批量互动 (>5) - 显示目标范围，等待确认
3. 关注用户 - 显示用户信息，等待确认

禁止事项

1. 1. 禁止使用通用浏览器技能（如browseruse）操作小红书
2. 禁止硬编码选择器 - 必须使用 INITIAL_STATE 解析
3. 禁止跳过登录检查 - 所有操作前验证登录态
4. 禁止静默失败 - 任何错误必须给出可操作的提示

常见问题

Q: 被检测/签名失败怎么办？

签名算法是反爬核心，当前SDK使用简化版SHA256签名。
生产环境建议：

1. 1. 使用浏览器模式（auth login）获取真实Cookie
2. 使用Selenium注入真实签名
3. 降低请求频率

Q: 如何处理验证码？

触发验证时，提示用户手动在浏览器完成验证，然后重试。

Q: Cookie过期了怎么办？

运行 xhs auth login 重新扫码登录。

技术栈

验证清单

• - [ ] xhs auth status 返回正确登录状态
• [ ] xhs explore search 返回结构化笔记列表
• [ ] xhs explore detail 返回笔记详情和评论
• [ ] xhs interact like 成功点赞
• [ ] xhs interact comment 成功评论
• [ ] xhs interact batch-like 批量操作正常

项目结构

~/.openclaw/workspace/skills/xhs-expert/
├── SKILL.md # 本文件（主路由）
├── scripts/
│ ├── init.py
│ ├── chrome_launcher.py # Chrome启动器
│ ├── xhs_client.py # API客户端
│ ├── stateparser.py # INITIALSTATE解析
│ ├── feed_collector.py # 内容采集器
│ ├── interaction_handler.py # 互动处理器
│ ├── cookie_manager.py # Cookie管理器
│ └── cli.py # CLI入口
└── pyproject.toml

下一步

遇到具体任务时：

1. 1. 确认用户意图（搜索/互动/批量操作）
2. 检查登录状态
3. 执行对应CLI命令
4. 返回结构化结果