# Claude Code 原生版小红书趋势情报官 P0 设计

更新时间：2026-05-22

## 目标

先做 Claude Code 原生版的小红书趋势情报官，不依赖 OpenClaw 的技能外壳。

第一阶段目标：

- 新用户可以用自然语言启动。
- sample 模式不用 token 也能跑通教学和演示。
- 输出第一轮样本观察和待确认问题，而不是只给文件路径。
- 后续可以平滑接入 MCP live 模式。

## 用户入口

```text
帮我做一份家装全屋定制行业的小红书趋势情报。
重点看女性客户下季度可能关注的设计元素、风格和消费顾虑。
先在聊天里给我第一轮样本观察和待确认问题，不要只给文件路径。
```

## 已建立文件

```text
claude-code-voc-intelligence/
  .claude-plugin/plugin.json
  docs/customer-quickstart.md
  docs/demo-runbook.md
  docs/npm-packaging-notes.md
  bin/claude-voc.js
  skills/xiaohongshu-trend-intelligence/SKILL.md
  skills/xiaohongshu-trend-intelligence/references/user-workflow.md
  skills/xiaohongshu-trend-intelligence/references/output-format.md
  skills/xiaohongshu-trend-intelligence/references/live-mode.md
  skill-package-manifest.json
  install.js
  package.json
  package-lock.json
  memory-templates/xiaohongshu-trend-profile.json
  scripts/smoke-mcp.js
  scripts/smoke-package.js
  mcp/src/server.js
  mcp/src/tools/xiaohongshu-trend-run.js
  mcp/src/tools/xiaohongshu-preference-update.js
  mcp/src/core/memory-store.js
  mcp/src/features/xiaohongshu-trend/preference-memory.js
  mcp/src/features/xiaohongshu-trend/sample-data.js
  mcp/src/features/xiaohongshu-trend/report.js
  mcp/src/core/result-envelope.js
```

## P0 能力

- 读取行业 profile。
- 使用 sample 小红书笔记和评论。
- 生成趋势判断、用户顾虑、内容选题、门店话术。
- 在聊天正文里展示数据口径、证据样本和下一步可回复话术。
- 返回统一 result envelope。
- 写入 markdown 和 json 归档。
- 把 `assistantMessage` 作为聊天里的主要交付内容。

## 下一步 P1

- 写 MCP server。
- 接入真实小红书搜索、详情、评论。
- 增加 VOC token 检查。
- 增加偏好记忆。
- 增加 live 小规模 smoke test。

## P1 已推进

已新增 MCP server：

```text
claude-code-voc-intelligence/mcp/src/server.js
claude-code-voc-intelligence/.mcp.json
```

已暴露工具：

```text
voc_xiaohongshu_token_check
voc_xiaohongshu_trend_run
voc_xiaohongshu_preference_update
```

已新增 live provider 骨架：

```text
claude-code-voc-intelligence/mcp/src/core/credentials.js
claude-code-voc-intelligence/mcp/src/providers/xiaohongshu-api.js
claude-code-voc-intelligence/mcp/src/features/xiaohongshu-trend/live-collector.js
```

当前 live 行为：

- 没有小红书/TikHub token 时返回 `needs_token`。
- 不再误用 OpenClaw 的 `VOC_TOKEN` / `OPENCLAW_VOC_TOKEN`。
- provider 层会对错误信息做 token 脱敏。
- 用户校准反馈会写入 `xiaohongshu-trend-memory.json`。
- 生成下一份报告时可读取偏好记忆，并在报告中展示“已读取偏好”。
- 有 token 后按小规模参数采集：
  - `keywordLimit=1`
  - `notesPerKeyword=1`
  - `maxCommentPages=1`

## 本地验证

已验证：

```bash
npm --prefix claude-code-voc-intelligence run xhs:sample
npm --prefix claude-code-voc-intelligence run xhs:preference-smoke
npm --prefix claude-code-voc-intelligence run xhs:sample-with-memory
npm --prefix claude-code-voc-intelligence run mcp:smoke
node claude-code-voc-intelligence/mcp/src/tools/xiaohongshu-trend-run.js --collection-mode live --profile claude-code-voc-intelligence/memory-templates/xiaohongshu-trend-profile.json
```

sample / preference / MCP smoke 返回 `status=ok`，并生成：

```text
outputs/claude-code-xhs-sample/xiaohongshu-trend-report.md
outputs/claude-code-xhs-sample/xiaohongshu-trend-report.json
outputs/claude-code-xhs-memory-smoke/xiaohongshu-trend-memory.json
outputs/claude-code-xhs-memory-smoke/report/xiaohongshu-trend-report.md
outputs/claude-code-xhs-memory-smoke/report/xiaohongshu-trend-report.json
outputs/claude-code-xhs-mcp-smoke/xiaohongshu-trend-report.md
outputs/claude-code-xhs-mcp-smoke/xiaohongshu-trend-report.json
```

live 无 token 检查返回 `status=needs_token`，这是预期行为；需要有效小红书/TikHub token 后再做真实采集验收。

## 打包交付

已新增独立打包脚本：

```text
scripts/deploy/claude-code-voc-intelligence-suite.js
```

根目录命令：

```bash
npm run claude-voc:build
npm run claude-voc:upload
```

npm 安装交付脚本：

```bash
npm run claude-voc:npm-pack
npm run claude-voc:npm-publish
```

用户侧支持两种 npm 入口：

```bash
npm install -g @gangvy/claude-code-voc-intelligence
claude-voc install
```

或：

```bash
npx @gangvy/claude-code-voc-intelligence install
```

两种方式都会安装到：

```text
~/.claude/plugins/voc-intelligence
```

`claude-voc:build` 会执行：

1. 校验 Claude Code 插件文件、Skill 文件、MCP server 和 manifest。
2. 排除 `node_modules/`、`memory/`、`.env` 后生成 zip。
3. 解压到临时目录，运行 `node install.js --smoke`。
4. 在解压后的包里自动跑：
   - `npm run xhs:sample`
   - `npm run xhs:preference-smoke`
   - `npm run xhs:sample-with-memory`
   - `npm run mcp:smoke`

已验证通过，产物：

```text
dist/claude-code-voc-intelligence.zip
dist/claude-code-voc-intelligence-suite-manifest.json
```

上传命令需要环境变量：

```text
QINIU_AK
QINIU_SK
```

当前本机未检测到上传环境变量，因此本轮只完成本地打包和解压验证，未上传 CDN。

用户拿到 zip 后的推荐安装命令：

```bash
node install.js
```

如需现场自检：

```bash
node install.js --smoke
```

`--smoke` 使用 `scripts/smoke-package.js` 做安静自检，只输出状态、工具列表、报告预览和产物路径，适合客户现场验证。

## 最近一轮交付体验优化

- 新增客户快速说明：`claude-code-voc-intelligence/docs/customer-quickstart.md`
- 新增录屏脚本：`claude-code-voc-intelligence/docs/demo-runbook.md`
- 报告正文新增“数据口径”，避免客户不知道样本来自哪里。
- 报告正文新增“证据样本”，把高互动笔记和高赞评论直接展示出来。
- 校准反馈回复从“工具更新成功”改为“已保存本次校准”，更贴近业务用户。