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

更新时间：2026-05-22

目标

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

第一阶段目标：

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

用户入口

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

已建立文件

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：

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

已暴露工具：

voc_xiaohongshu_token_check
voc_xiaohongshu_trend_run
voc_xiaohongshu_preference_update

已新增 live provider 骨架：

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

本地验证

已验证：

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，并生成：

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 后再做真实采集验收。

打包交付

已新增独立打包脚本：

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

根目录命令：

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

npm 安装交付脚本：

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

用户侧支持两种 npm 入口：

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

或：

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

两种方式都会安装到：

~/.claude/plugins/voc-intelligence

claude-voc:build 会执行：

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

已验证通过，产物：

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

上传命令需要环境变量：

QINIU_AK
QINIU_SK

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

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

node install.js

如需现场自检：

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
报告正文新增“数据口径”，避免客户不知道样本来自哪里。
报告正文新增“证据样本”，把高互动笔记和高赞评论直接展示出来。
校准反馈回复从“工具更新成功”改为“已保存本次校准”，更贴近业务用户。

claude-code-native-xiaohongshu-trend-p0.md 6.3 KB Link permanente Histórico Em bruto