安装方式
手动下载安装
下载 ZIP 后解压到技能目录即可安装。若在桌面客户端 WebView中直接下载出现异常，本站会改为提示页 + 原始链接，请按页内说明操作。
下载 ZIP (shub-xhs-sentry-v1.0.0.zip)触发指令
/xhs-sentry
跨平台安装指引
该技能声明兼容以下 1 个平台，将 ZIP 解压到对应目录即可被识别。
unzip shub-xhs-sentry-v1.0.0.zip -d ~/.claude/skills/
目录不存在时请先
mkdir -p 创建；启用 Skill 后请重启对应 Agent 让配置生效。
使用指南
小红书场景 Sentry
围绕 小红书场景 Sentry：在相关业务或客户端形态下接入 Sentry 的提示（以包内 SKILL.md 与平台政策为准）。 无需在每次任务前把零散英文说明手工拼进上下文，也 减少 与客户端默认行为脱节的试错；具体命令、钩子与 JSON 参数仍以 ZIP 包内 SKILL.md 为权威。下文结构与站内 MCP CLI 类专题稿相同：何时用、前置、流程、速查与故障。
何时使用
- 在相关业务或客户端形态下接入 Sentry 的提示（以包内 SKILL.md 与平台政策为准）
- 已获取本技能 ZIP，并准备在 Claude Code / OpenClaw 中按 SKILL.md 挂载。
- 希望用中文专题稿快速判断「该不该启用」，再深入英文 SKILL 查参数与边界。
- 需要与团队对齐同一套触发方式、目录约定或回调格式时。
前置条件
- 通用：可运行 Claude Code 或文档要求的客户端；有可读写的项目工作区（或 SKILL.md 指定的沙箱目录）。
- 权威细节：API Key / OAuth、钩子路径、环境变量以 ZIP 内 SKILL.md 为准。
典型流程
- 从 ClawHub / 站内分发获取技能 ZIP，校验版本与校验和（若提供）。
- 阅读 SKILL.md 的安装段落：目录落点、客户端类型（Claude Code / OpenClaw / 脚本）。
- 用文档中的最小示例完成第一次调用（单文件修改、单次查询或单次委派）。
- 确认工作目录、权限边界与输出路径后，再处理多文件或长耗时任务。
- 需要回调 / Webhook / 通知时，按 SKILL.md 配置端点并在测试环境先验通。
与 ZIP / SKILL.md 的关系
站内专题稿与 MCP CLI 类 oss 稿同样：概括何时用、怎么接、怎么排错；命令模板、钩子名、JSON 字段、版本矩阵一律以 ZIP 内 SKILL.md 与 ClawHub 上游为准。
命令示例（摘自包内 SKILL.md）
以下为从上游 SKILL.md（或入库正文）自动抽取的终端/脚本片段；路径、环境变量与参数以当前 ZIP 与官方说明为准。
ClawHub slug：xhs-sentry（安装命令以 SKILL.md / claw CLI 为准）。
NODE_PATH=$(npm root -g) node {baseDir}/scripts/monitor.js "<关键词>" <数量> {baseDir}/tmp
export CHANNEL="telegram"
export TARGET_ID="telegram:YOUR_TELEGRAM_ID"
export CHANNEL="wecom"
export TARGET_ID="wecom:YOUR_WECOM_ID"
站内入库时的触发命令（完整语义见 ZIP）：
# 使用本技能时可在对话中引用或执行上述指令；完整参数与示例见下载包内 SKILL.md。
/xhs-sentry
最佳实践
- 先 SKILL.md 再猜参数；站内专题稿不替代 schema 与必填字段说明。
- 委派任务时写清验收标准（命令、文件路径、测试命令），减少来回追问。
- 长任务用文档推荐的回调 / 日志落盘代替高频轮询，省 Token 也省机器负载。
- 多技能同时启用时，注意钩子加载顺序与重复工具调用（以 SKILL.md 冲突说明为准）。
调试与排错
- 打开 stderr 与客户端日志；PTY/tmux 场景同时看面板最后几十行输出。
- 参数错误时对照 SKILL.md 中的 JSON/CLI 示例（引号、转义、工作目录）。
- 网络类失败：查代理、防火墙、MCP 传输方式（stdio / HTTP / SSE）。
速查
| 动作 | 说明 |
|------|------|
| 获取技能包 | ClawHub / 站内 ZIP，核对版本 |
| 权威步骤 | 优先阅读 ZIP 内 SKILL.md |
| 首次试跑 | 使用 SKILL.md 最小示例 |
| 验收 | 对照路径、测试命令或回调负载 |
常见故障
- 无输出或立即退出 → 工作目录错误、依赖未装、或 Claude Code 未登录；按 SKILL.md 自检清单执行。
- 权限被拒绝 → 检查沙箱路径、
--permission-mode与工具白名单。 - 与简介不符 → 以英文 SKILL 与上游仓库为准，站内稿仅作结构化导读。
# 小红书舆情哨兵
用于快速查看某个关键词在小红书上的讨论现场。输出内容包括：
- 页面状态判断（正常 / 登录墙 / 验证码 / 空结果）
- 结构化笔记信息（标题、作者、点赞、日期、链接、封面）
- 热度 / 风险 / 竞品信号
- 现场截图
适合用于：品牌口碑监控、竞品观察、热点追踪、内容研究。
注意：这是**快速巡检型技能**，核心价值是“现场取证 + 初步判断”，不是严格的情感分析模型。
## 执行
```bash
NODE_PATH=$(npm root -g) node {baseDir}/scripts/monitor.js "<关键词>" <数量> {baseDir}/tmp
```
## 读结果
优先读取这些字段：
- `status.auth_mode`
- `status.needsLogin`
- `status.captcha`
- `status.noResult`
- `notes`
- `analysis.overall`
- `analysis.summary`
- `analysis.top_hot`
- `analysis.top_risk`
- `diagnostics.body_preview`
## 登录态
默认优先复用已有小红书登录态：
- 先读环境变量 `XHS_COOKIE`
- 若没有，再回退读取现有脚本中的 `export XHS_COOKIE="..."`
因此这个 Skill 会自动兼容你已有的 `xhs-monitor` cookie 配置。`status.auth_mode` 会标明当前使用的是：
- `env-cookie`
- `script-cookie:<script>`
- `anonymous`
## 消息接收渠道
`xhs-sentry` 本身负责巡检与输出结构化结果；如果要把结果自动发到聊天工具，还需要配置消息接收渠道。
常见示例：
### Telegram
```bash
export CHANNEL="telegram"
export TARGET_ID="telegram:YOUR_TELEGRAM_ID"
```
### 企业微信（WeCom）
```bash
export CHANNEL="wecom"
export TARGET_ID="wecom:YOUR_WECOM_ID"
```
说明：
- Telegram 数字 ID 可通过 `@userinfobot` 获取
- 企业微信接收 ID 需与你当前 OpenClaw / wecom 通道配置一致
- 所有真实 ID 都不应写入公开仓库，应使用占位符
## 输出规则
### 1. 先判断页面状态，再下业务结论
- 若 `needsLogin=true` 或 `captcha=true`，明确说明这是平台拦截，**不是无舆情**。
- 若 `noResult=true` 且截图一致，可判断当前关键词结果为空。
- 若 `notes.length===0` 但无明确空结果提示，说明更可能是页面结构漂移或风控侧拦截。
### 2. 有结果时输出舆情摘要
**格式要求**：直接输出报告正文，绝对不需要任何聊天语气、打招呼或上下文废话。
**重要规则**：提到任何笔记时，必须使用 Markdown 格式附上真实的超链接，格式如：`[《笔记标题》](真实URL)`，绝对不能只放文本。
【特别注意：输出结果禁止寒暄，禁止说“任务已重跑”、“以下是报告”等废话，直接给出报告正文。任何引用笔记必须加上真实超链接 [《标题》](URL)】
至少回答：
- 总体倾向：`analysis.overall`
- 摘要：`analysis.summary`
- 最值得关注的热度笔记 1-3 条
- 最值得关注的风险笔记 1-3 条
### 3. 信号定义
- `risk-watch`：负面/避雷/翻车/维权类信号较多
- `hot-trend`：爆款/高赞/刷屏类信号较多
- `competitive-discussion`：对比/平替/测评类内容较多
- `neutral-chatter`：有讨论，但没有明显风险或爆点
- `insufficient-data`：没抓到足够内容，不能下结论
### 4. 必须附截图
始终附上现场截图：
```text
MEDIA: {baseDir}/tmp/xhs_sentry_*.png
MEDIA: {baseDir}/tmp/xhs_login_*.png
MEDIA: {baseDir}/tmp/xhs_captcha_*.png
MEDIA: {baseDir}/tmp/xhs_empty_*.png
MEDIA: {baseDir}/tmp/xhs_error_*.png
```
## 注意
- 这是一层**启发式舆情哨兵**，适合快速巡检，不等于严肃情感分析模型。
- 不要把空数组直接解释成“没有讨论”，必须结合状态和截图。
- 小红书结构变动频繁；若结果异常，优先信截图和 `body_preview`。