# 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`（单文件无依赖）。 ```powershell # 或用本地服务器（preview-reports.js 留在 openclaw-voc-skill，需要的话从那边跑） cd E:\workspace\openclaw-voc-skill node scripts\tools\preview-reports.js # 然后访问 http://localhost:8787 ``` ### 场景 2：重新渲染报告（不重新采集） ```powershell 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 项目 跟着方法论跑： ```powershell # 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` 仓库中配置）。 ```powershell # 前置验证 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 ← 会找到 ``` 如果想要真正独立，可以在本仓库根跑： ```powershell 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） ```powershell # 一键全量迁回 $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） **建议后续**： 1. 本仓库 `git init` 成独立仓库（如果要版本控制） 2. 加 `package.json` 管理 Node 依赖（目前靠继承 openclaw-voc-skill 的 node_modules） 3. 删除死引用版本 `voc-validation-*.js`（扁平 V2，保留 `voc-validation/` 子目录 V3）