小红书私信
先运行 xhs-hunter check,会话缺失或失效走 xhs-hunter login。本工具归 expert-bd,复用 xhs-hunter 保存的 PC 会话,不混用 Creator Cookie。
读取
xhs-im list --limit 30 --cursor 0
xhs-im groups --limit 30 --cursor 0
xhs-im history --conversation 用户ID --limit 30 --cursor 0
xhs-im history --conversation group:群ID --limit 30 --cursor 0
xhs-im unread
xhs-im listen --seconds 60 --max-events 100
列表 cursor 是页码,历史 cursor 是上一页真实 store_id。保留原始响应,不猜游标或字段。群聊仅支持列表和历史,字段需用真实返回核对。监听逐行输出 JSON,每次最多 3600 秒、1000 条。
写操作
以下命令默认只预览;已有用户授权时,在同一命令加 --confirm。
xhs-im send 用户ID "用户授权的文本"
xhs-im read --conversation 用户ID
xhs-im revoke --conversation 用户ID --message 真实消息ID
xhs-im delete --conversation 用户ID
仅支持单聊文本发送。read 使用真实会话游标(含实际返回的 max_store_id)和独立未读接口状态;缺会话、目标未读数或必要统计时安全停止,不用默认零伪造回执,不清空其他会话计数。revoke 撤回指定消息,delete 删除本账号的会话,不能解释为替对方删除消息。群聊拒绝发送、已读、撤回和删除。
已读请求按网页 IM 客户端的实际构造逻辑生成:目标游标来自 max_store_id,目标 unread_count=0 表示标记后的剩余未读;单聊类型按真实 info.is_friend / info.is_mute 区分普通、免打扰、陌生会话。全局计数在本地把目标未读置零后计算,保留其他单聊计数,不把群聊未读混入单聊统计;字段来源或列表覆盖不完整时安全停止。协议证据见仓库 docs/xhs-im-read-protocol-2026-10-24.md,不要把通知接口的赞、关注、提及未读数代入,也不要让 agent 手填全局计数。
WebSocket send 返回 submitted 与 mid 只代表向连接提交,不能当作送达或已读。提交结果不明先查历史,不直接重发。只有确认未提交时才用 HTTP 发送:
xhs-im call send_short_link_message --kwargs '{"receiver":"用户ID","content":"已授权正文"}' --confirm
methods 列出底层接口;call 的写方法同样默认预览,加 --confirm 执行。只传真实接口字段,不猜捕获帧或加密消息。
自动回复前置判断(本地,不联网发送)
已授权的私信自动回复流程可使用 _shared/xhs_im_reply_guard.py(相对本技能目录为 ../../../_shared/xhs_im_reply_guard.py):
python3 <guard路径> check --conversation 用户ID --history-file <原始history响应JSON> --ledger <本workspace账本路径>
python3 <guard路径> record --conversation 用户ID --incoming-id <真实客户消息ID> --outcome unknown --ledger <账本路径>
- 只有
ok=true且should_reply=true才能生成新回复;unknown意图应在发送前写入,且记录结果必须ok=true、already_recorded=false才可发送;已被预占则停止。已提交则记submitted,查历史确认存在后才记confirmed。按会话和消息 ID 跨天防重,不按日期清空。 - 平台提示可能沿用客户
sender_id。以结构化messageSource/ 模板等字段识别,不把风控提示当新客户咨询,不靠“微信”等普通关键词误判真人内容。 - 有平台风控提示时,用
record --outcome platform_notice --incoming-id <last_notice_id>保存提示标志。suppress_external_guidance=true时停止自动发送联系方式、contact 链接和站外交易引导;即使以后有真实新问题,也只能在平台内答复,不改用暗语或短链绕过限制。 - 检查坏账本、未知消息类型或缺少真实标识时停止发送并报告;旧版仅按日期的账本记录不能自动丢弃或到期重发。
这些私信写操作与实时监听仍需真实账号验收,离线回归通过不等于平台已送达。私信材料只存当前任务受控目录,不写入代码仓。