README.md 12 KB
fmode-voc-projects
江中 VOC 深度洞察报告 · 3 品类交付物仓库
从
openclaw-voc-skill分离而来（2026-04-20）· 业务项目 ⇄ Skill 平台 解耦
📦 仓库定位
这个仓库装什么：
- ✅ 江中大健康 3 个品类 VOC 深度洞察项目（肝纯片 / 猴菇饮 / 乳酸菌素片儿童版）
- ✅ VOC 深度洞察工作流方法论（6 阶段 + 精美 HTML 升级）
- ✅ 项目特定的采集/分析/渲染脚本、数据、报告、审计日志
这个仓库不装什么：
- ❌ OpenClaw Skill 本体（
xiaohongshu-*/tikhub-*/ API 探测 / 凭据管理）→ 留在openclaw-voc-skill/ - ❌ 通用
preview-reports.js/voc-token-preflight.js/setup-fonts.js→ 留在 skill - ❌ 抖音/TikTok/小红书 API probe 日志 → 留在 skill（skill 调试资产）
🗂️ 目录结构
fmode-voc-projects/
├── README.md ← 本文件
├── docs/ ← 159 文件 · 17.2 MB
│ ├── compound-product-directions.md 江中 3 品类复方产品方向（67 hits 江中关键词）
│ ├── jiangzhong/ 肝纯片 DMY 项目（40 文件）
│ ├── jiangzhong-houguyin/ 猴菇饮项目（34 文件）
│ ├── 乳酸菌/ 乳酸菌素片儿童版项目（52 文件）
│ └── _methodology/
│ └── voc-deep-insight-workflow/ ⭐ 方法论（32 文件）
│ ├── 00-workflow-overview.md
│ ├── 01-06-phase*.md 6 阶段详解
│ ├── 07-beautiful-html-aesthetics.md 精美 HTML 设计语言
│ ├── case-studies/ 3 个实战复盘
│ ├── prompts/ P1-P6 六段式启动 prompt
│ └── templates/ 4 份 md + 7 份 JS 模板 + 精美 patterns
│
├── reports/ ← 25 文件 · 8.6 MB
│ ├── jiangzhong-liver-voc-insight-report.html 肝纯片最终报告（549 KB）
│ ├── jiangzhong-liver-voc-validation-report.html 肝纯片 V2 验证版（755 KB）
│ ├── jiangzhong-liver-voc-report.html 肝纯片初版（293 KB）
│ ├── jiangzhong-liver-compound-report.html 肝纯片复方版（565 KB）
│ ├── jiangzhong-houguyin-voc-insight-report.html 猴菇饮最终报告（676 KB）
│ ├── jiangzhong-lactic-children-voc-insight-report.html 乳酸菌儿童版（512 KB）
│ ├── jiangzhong-monkey-voc-report.html 猴头菇初版（291 KB）
│ ├── jiangzhong-probiotic-voc-report.html 益生菌初版（282 KB）
│ └── assets/fonts/ 17 个本地字体文件（部分旧报告引用）
│
├── scripts/
│ └── tools/ ← 82 文件 · 2.5 MB
│ ├── liver-*.js (13) 肝纯片模块（analyze + render + components + ch1-8）
│ ├── houguyin-*.js (15) 猴菇饮模块（+ ch1-9 + seed-gen/patterns）
│ ├── lactic-*.js (12) 乳酸菌模块（+ ch1-8）
│ ├── voc-validation-*.js (11) 肝纯片 V2 验证版模块（+ chapters/ch2-7）
│ ├── voc-validation/ (3) voc-validation v3 子目录（collect/gen/render）
│ ├── compound-liver-*.js (3) 肝纯片复方旧版
│ ├── gen-{liver,houguyin,lactic,compound-liver,voc-report}.js 入口脚本
│ ├── _audit-{liver,lactic}-voc.js 品类专用审计
│ ├── voc-{analyze,render,scripts,styles,self-audit}.js V1 通用框架（江中初期）
│ ├── collect-{amazon,douyin,tiktok,market-intel}{,-only}.js V1 采集模块
│ ├── dump-voc-summary{,-v2}.js VOC 摘要导出
│ ├── jiangzhong-voc-collect.js 江中总采集入口
│ ├── _smoke-jiangzhong-apis.js 江中采集前 API 烟测
│ ├── read-product-docs.js 产品 docx 读取器
│ ├── inspect-voc-data.js 数据检查工具
│ ├── collect-jiangzhong-liver-deep.js 肝纯片深度采集
│ └── houguyin-collect.js / lactic-collect.js 品类专用采集
│
├── data/ ← 12 文件 · 21 MB
│ ├── jiangzhong-liver-voc.json 4.1 MB 肝纯片主数据
│ ├── jiangzhong-liver-voc-extended.json 13.1 MB 肝纯片扩展数据（含 Amazon/抖音）
│ ├── jiangzhong-monkey-voc.json 1.6 MB 猴头菇数据
│ ├── jiangzhong-probiotic-voc.json 1.6 MB 益生菌数据
│ ├── meiyoutong-docx-extracted.txt 217 KB 美佑童竞品资料提取（249 hits 江中）
│ ├── voc-summary-for-product-dev.txt 26 KB VOC 产品开发摘要
│ ├── voc-self-audit.txt 7 KB VOC 自审输出
│ ├── product-docs/
│ │ ├── monkey-产品资料.txt 6 KB
│ │ └── probiotic-背景需求.txt 1 KB
│ ├── collection-liver.log / tiktok-liver-run.log / voc-validation-collect.log 采集日志
│
└── audit-logs/ ← 4 文件 · 77 KB（根目录零散审计输出）
├── _audit-lactic.txt 25 KB
├── _audit-output.txt 17 KB
├── _audit-output2.txt 18 KB
└── _audit-output3.txt 18 KB
总计：282 文件 · 48.3 MB
🚀 快速启动
场景 1：查看现有报告
直接用浏览器打开 reports/*.html（单文件无依赖）。
# 或用本地服务器（preview-reports.js 留在 openclaw-voc-skill，需要的话从那边跑）
cd E:\workspace\openclaw-voc-skill
node scripts\tools\preview-reports.js
# 然后访问 http://localhost:8787
场景 2：重新渲染报告（不重新采集）
cd E:\workspace\fmode-voc-projects
node scripts\tools\gen-liver.js # 肝纯片
node scripts\tools\gen-houguyin.js # 猴菇饮
node scripts\tools\gen-lactic.js # 乳酸菌
node scripts\tools\gen-compound-liver.js # 肝纯片复方
注意：脚本默认从 data/ 读数据、往 reports/ 输出。路径都是相对 cwd，所以必须在本仓库根目录跑。
场景 3：启动新品类 VOC 项目
跟着方法论跑：
# 1. 精读
code docs\_methodology\voc-deep-insight-workflow\README.md
code docs\_methodology\voc-deep-insight-workflow\00-workflow-overview.md
code docs\_methodology\voc-deep-insight-workflow\07-beautiful-html-aesthetics.md
# 2. 用 P1-P6 六段式 prompt 启动 AI 协作
# 3. 从 templates/ 复制骨架
场景 4：重新采集数据（需要 openclaw-voc-skill 凭据）
采集脚本依赖 ~/.openclaw/skills/xiaohongshu-search-notes/api-config.json 等凭据（在 openclaw-voc-skill 仓库中配置）。
# 前置验证
cd E:\workspace\openclaw-voc-skill
node scripts\tools\voc-token-preflight.js
# 回本仓库跑采集
cd E:\workspace\fmode-voc-projects
node scripts\tools\_smoke-jiangzhong-apis.js # API 烟测
node scripts\tools\jiangzhong-voc-collect.js # 总采集入口
🔗 与 openclaw-voc-skill 的关系
运行时依赖
本仓库的采集脚本依赖 openclaw-voc-skill 提供的：
| 依赖项 | 路径 |
|---|---|
| TikHub 凭据 | ~/.openclaw/skills/xiaohongshu-search-notes/api-config.json |
| VOC skill 凭据 | ~/.openclaw/voc-credentials.json |
| Token 预飞脚本 | openclaw-voc-skill/scripts/tools/voc-token-preflight.js |
| 预览服务器 | openclaw-voc-skill/scripts/tools/preview-reports.js |
| 字体安装 | openclaw-voc-skill/scripts/tools/setup-fonts.js |
Node 依赖
本仓库目前没有独立 package.json。执行 JS 脚本时 Node 会自动向上查找 node_modules：
E:\workspace\fmode-voc-projects\scripts\tools\gen-liver.js
需要 adm-zip（从 read-product-docs.js）
↓ Node 向上查找
E:\workspace\openclaw-voc-skill\node_modules\adm-zip ← 会找到
如果想要真正独立，可以在本仓库根跑：
npm init -y
npm install adm-zip # 按需
⚠️ 已知问题
1. voc-validation-render.js 有死引用
scripts/tools/voc-validation-render.js（V2 扁平版）引用：
./analyze.js（不存在）./render.js（不存在）./chapters/ch2-package.js..ch7-action.js（不存在）
原因：这是肝纯片验证版 V2 的早期扁平文件，后被重构为 scripts/tools/voc-validation/ 子目录（V3，3 文件）。V2 文件迁移前就已经是死引用（原 openclaw-voc-skill 也没有这些依赖）。
推荐做法：用 voc-validation/ 子目录版本（gen.js + render.js + collect.js），忽略 V2 扁平文件。或者直接删除死引用版本。
2. 字体文件
4 份旧版报告（jiangzhong-liver-compound-report.html / jiangzhong-liver-voc-report.html / jiangzhong-monkey-voc-report.html / jiangzhong-probiotic-voc-report.html）引用 reports/assets/fonts/ 下的本地字体文件。字体已跟随迁过，相对路径保持完整。
4 份新版报告（*-voc-insight-report.html / *-voc-validation-report.html）字体已 base64 内嵌，无外部依赖。
🔄 恢复路径（如果想迁回 openclaw-voc-skill）
# 一键全量迁回
$src = 'E:\workspace\fmode-voc-projects'
$dst = 'E:\workspace\openclaw-voc-skill'
# docs/
Move-Item "$src\docs\jiangzhong" "$dst\docs\"
Move-Item "$src\docs\jiangzhong-houguyin" "$dst\docs\"
Move-Item "$src\docs\乳酸菌" "$dst\docs\"
Move-Item "$src\docs\_methodology\voc-deep-insight-workflow" "$dst\docs\_methodology\"
Move-Item "$src\docs\compound-product-directions.md" "$dst\docs\"
# reports/
Move-Item "$src\reports\*" "$dst\reports\"
# scripts/tools/
Move-Item "$src\scripts\tools\*" "$dst\scripts\tools\"
# data/
Move-Item "$src\data\*" "$dst\data\"
# audit-logs (回到根目录)
Move-Item "$src\audit-logs\*.txt" "$dst\"
📊 迁移清单（2026-04-20）
| 类目 | 来源 | 文件数 |
|---|---|---|
| docs/ 项目文档 | openclaw-voc-skill/docs/{jiangzhong,jiangzhong-houguyin,乳酸菌}/ |
126 |
| docs/ 方法论 | openclaw-voc-skill/docs/_methodology/voc-deep-insight-workflow/ |
32 |
| docs/ 根级江中 md | openclaw-voc-skill/docs/compound-product-directions.md |
1 |
| reports/ HTML | openclaw-voc-skill/reports/jiangzhong-*.html |
8 |
| reports/ 字体 | openclaw-voc-skill/reports/assets/fonts/ |
17 |
| scripts/tools/ 项目模块 | liver/houguyin/lactic/voc-validation/compound-liver | 60 |
| scripts/tools/ 通用框架+江中工具 | voc-analyze/render/scripts/styles + collect-{amazon,douyin,tiktok,market-intel} + dump-voc-summary + 等 | 17 |
| scripts/tools/ 遗漏江中工具 | _smoke-jiangzhong-apis.js + read-product-docs.js |
2 |
| scripts/tools/voc-validation/ | 子目录 V3 | 3 |
| data/ 项目 JSON + log | jiangzhong-*.json + collection-liver.log 等 | 7 |
| data/ 文本资料 | meiyoutong + voc-self-audit + voc-summary-for-product-dev | 3 |
| data/product-docs/ | monkey-产品资料 + probiotic-背景需求 | 2 |
| audit-logs/ | 根目录 _audit-*.txt |
4 |
| 合计 | 282 |
版本：v1.0 · 2026-04-20
迁出仓库：E:\workspace\openclaw-voc-skill（Git 仓库，迁移不影响）
迁入位置：E:\workspace\fmode-voc-projects（独立目录，非 Git）
建议后续：
- 本仓库
git init成独立仓库（如果要版本控制） - 加
package.json管理 Node 依赖（目前靠继承 openclaw-voc-skill 的 node_modules） - 删除死引用版本
voc-validation-*.js（扁平 V2，保留voc-validation/子目录 V3）