@vocmarket/voc-skill 0.3.15 → 0.3.16

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "voc-intelligence",
-  "description": "VOC intelligence skills for Claude Code: end-to-end VOC business workflows, Xiaohongshu and Douyin trend reports, live social VOC collection, token/recharge checks, evidence-card outputs, prioritized issue pools, single-problem deep dives, competitor maps, 7-day content plans, VOC-backed speaking script co-creation, boss/operator action plans, and multi-turn memory.",
-  "version": "0.3.15",
+  "description": "VOC intelligence skills for Claude Code: end-to-end VOC business workflows, Xiaohongshu and Douyin trend reports, live social VOC collection, Fmode Doubao image analysis, token/recharge checks, evidence-card outputs, prioritized issue pools, single-problem deep dives, competitor maps, 7-day content plans, VOC-backed speaking script co-creation, boss/operator action plans, and multi-turn memory.",
+  "version": "0.3.16",
   "author": {
     "name": "nkkj-BrainHack"
   }

package/.mcp.json

@@ -3,9 +3,9 @@
     "voc": {
       "command": "node",
       "args": [
-        "E:\\workspace\\openclaw-voc-skill\\claude-code-voc-intelligence\\mcp\\src\\server.js"
+        "E:\\workspace\\openclaw-voc-skill\\claude-code\\claude-code-voc-intelligence\\mcp\\src\\server.js"
       ],
-      "cwd": "E:\\workspace\\openclaw-voc-skill\\claude-code-voc-intelligence"
+      "cwd": "E:\\workspace\\openclaw-voc-skill\\claude-code\\claude-code-voc-intelligence"
     }
   }
 }

package/README.md

@@ -110,6 +110,7 @@ npx --yes @vocmarket/voc-skill@latest workspace --smoke
 .claude/skills/voc-speaking-script/SKILL.md
 .claude/skills/voc-competitor-map/SKILL.md
 .claude/skills/voc-business-workflow/SKILL.md
+.claude/skills/fmode-image-analysis/SKILL.md
 .claude/plugins/voc-intelligence
 ```
 
@@ -186,9 +187,11 @@ npx --yes @vocmarket/voc-skill@latest install --smoke
 - `voc-speaking-script`
 - `voc-competitor-map`
 - `voc-business-workflow`
+- `fmode-image-analysis`
 
 MCP 工具：
 
+- `fmode_image_analysis`
 - `voc_business_workflow_run`
 - `voc_xiaohongshu_trend_run`
 - `voc_xiaohongshu_preference_update`
@@ -207,6 +210,8 @@ MCP 工具：
 ```powershell
 npm --prefix claude-code-voc-intelligence run xhs:sample
 npm --prefix claude-code-voc-intelligence run dy:sample
+npm --prefix claude-code-voc-intelligence run fmode:image:smoke
+claude-voc image --image-path E:\workspace\example\screenshot.png --prompt "识别截图里的文字、主体和风险点"
 npm --prefix claude-code-voc-intelligence run voc:issue-pool
 npm --prefix claude-code-voc-intelligence run voc:deep-dive
 npm --prefix claude-code-voc-intelligence run voc:business-workflow

package/bin/claude-voc.js

@@ -15,6 +15,7 @@ const EXCLUDED_DIRS = new Set([
   'node_modules',
   'memory',
   'outputs',
+  '.npm-cache-acceptance',
   '.tmp',
   '.git',
   '.claude'
@@ -36,6 +37,7 @@ function usage() {
     '  claude-voc install --workspace --smoke',
     '  claude-voc check',
     '  claude-voc smoke',
+    '  claude-voc image --image-path <file> --prompt <text>',
     '  claude-voc path',
     '',
     'npx:',
@@ -181,6 +183,8 @@ function assertInstalled(targetDir) {
     'skills/voc-speaking-script/SKILL.md',
     'skills/voc-competitor-map/SKILL.md',
     'skills/voc-business-workflow/SKILL.md',
+    'skills/fmode-image-analysis/SKILL.md',
+    'mcp/src/tools/fmode-image-analysis.js',
     'mcp/src/server.js'
   ];
   const missing = required.filter(rel => !fs.existsSync(path.join(targetDir, rel)));
@@ -641,6 +645,7 @@ function writeWorkspaceSkillEntries(targetDir) {
   const speakingScriptSkillDir = path.join(WORKSPACE_ROOT, '.claude', 'skills', 'voc-speaking-script');
   const competitorMapSkillDir = path.join(WORKSPACE_ROOT, '.claude', 'skills', 'voc-competitor-map');
   const businessWorkflowSkillDir = path.join(WORKSPACE_ROOT, '.claude', 'skills', 'voc-business-workflow');
+  const fmodeImageSkillDir = path.join(WORKSPACE_ROOT, '.claude', 'skills', 'fmode-image-analysis');
   ensureDir(xhsSkillDir);
   ensureDir(douyinSkillDir);
   ensureDir(issuePoolSkillDir);
@@ -649,6 +654,7 @@ function writeWorkspaceSkillEntries(targetDir) {
   ensureDir(speakingScriptSkillDir);
   ensureDir(competitorMapSkillDir);
   ensureDir(businessWorkflowSkillDir);
+  ensureDir(fmodeImageSkillDir);
   fs.writeFileSync(path.join(xhsSkillDir, 'SKILL.md'), workspaceSkillText(targetDir), 'utf8');
   fs.writeFileSync(path.join(douyinSkillDir, 'SKILL.md'), workspaceDouyinSkillText(targetDir), 'utf8');
   fs.writeFileSync(path.join(issuePoolSkillDir, 'SKILL.md'), workspaceIssuePoolSkillText(targetDir), 'utf8');
@@ -657,6 +663,7 @@ function writeWorkspaceSkillEntries(targetDir) {
   fs.writeFileSync(path.join(speakingScriptSkillDir, 'SKILL.md'), workspaceSpeakingScriptSkillText(targetDir), 'utf8');
   fs.writeFileSync(path.join(competitorMapSkillDir, 'SKILL.md'), workspaceCompetitorMapSkillText(targetDir), 'utf8');
   fs.writeFileSync(path.join(businessWorkflowSkillDir, 'SKILL.md'), workspaceBusinessWorkflowSkillText(targetDir), 'utf8');
+  fs.copyFileSync(path.join(targetDir, 'skills', 'fmode-image-analysis', 'SKILL.md'), path.join(fmodeImageSkillDir, 'SKILL.md'));
 }
 
 function writeWorkspaceActivation(targetDir) {
@@ -672,6 +679,7 @@ function writeWorkspaceActivation(targetDir) {
   console.log('Wrote workspace skill entry: .\\.claude\\skills\\voc-speaking-script\\SKILL.md');
   console.log('Wrote workspace skill entry: .\\.claude\\skills\\voc-competitor-map\\SKILL.md');
   console.log('Wrote workspace skill entry: .\\.claude\\skills\\voc-business-workflow\\SKILL.md');
+  console.log('Wrote workspace skill entry: .\\.claude\\skills\\fmode-image-analysis\\SKILL.md');
 }
 
 function printNextSteps(targetDir) {
@@ -692,6 +700,7 @@ function printNextSteps(targetDir) {
     console.log('  .\\.claude\\skills\\voc-speaking-script\\SKILL.md');
     console.log('  .\\.claude\\skills\\voc-competitor-map\\SKILL.md');
     console.log('  .\\.claude\\skills\\voc-business-workflow\\SKILL.md');
+    console.log('  .\\.claude\\skills\\fmode-image-analysis\\SKILL.md');
     console.log('  .\\.claude\\plugins\\voc-intelligence');
     console.log('');
     console.log('Restart the VSCode Claude Code session if it was already open.');
@@ -769,6 +778,12 @@ function printPath(opts) {
 }
 
 function main() {
+  const directCommand = process.argv[2];
+  if (directCommand === 'image' || directCommand === 'fmode-image') {
+    run(process.execPath, ['mcp/src/tools/fmode-image-analysis.js', ...process.argv.slice(3)], SOURCE_ROOT);
+    return;
+  }
+
   const opts = parseArgs(process.argv.slice(2));
   if (opts.help || opts.command === 'help') {
     console.log(usage());

package/docs/capability-map.md

@@ -22,6 +22,12 @@
 | 选中一条内容继续改口播 | `voc-speaking-script` | `voc_speaking_script_run` | 60 秒稿、30 秒稿、提词器版、改稿反馈、定稿记忆 |
 | 下轮继续优化 | 同一 skill | 带同一 `memory`，或带 project/industry/scenario/audience 让工具自动分桶 | 应用历史记忆，避免从零开始 |
 
+## Fmode Image Analysis Add-on
+
+| 能力 | 推荐入口 | MCP 工具 | 输出重点 |
+| --- | --- | --- | --- |
+| 图片识别/截图分析 | `fmode-image-analysis` | `fmode_image_analysis` | 使用平台用户 token 调用 Fmode Doubao vision，默认模型 `doubao-seed-2-0-pro-260215` |
+
 ## 技能入口
 
 ### `voc-business-workflow`

package/docs/npm-packaging-notes.md

@@ -1,93 +1,228 @@
-# Claude Code VOC 技能包 npm 打包经验
+# Claude Code VOC 技能包 npm 打包与发布说明
 
-## 目标
+## 当前包名
 
-同一个技能包同时支持两种交付：
+VOC 技能包当前对外 npm 包名：
 
-- 链接下载 zip：适合不会 npm 的客户，解压后执行 `node install.js`。
-- npm/npx 安装：适合教学、远程交付和批量升级。
+```bash
+@vocmarket/voc-skill
+```
 
-推荐命令：
+CLI 命令保持不变：
 
 ```bash
-npm install -g @vocmarket/voc-skill
-claude-voc install
+claude-voc
 ```
 
-免全局安装：
+插件安装目录也保持不变：
 
-```bash
-npx @vocmarket/voc-skill install
+```text
+voc-intelligence
 ```
 
-## 关键设计
+这样做的目的：对外包名更短、更适合课程和市场传播；同时不破坏已经沉淀好的 Claude Code 插件目录、MCP server 名称和 skill 入口。
 
-`npx` 下载的包可能在临时缓存里，不能直接让 Claude Code 长期加载这个临时目录。
+## 用户安装方式
 
-所以 `claude-voc install` 会把包复制到固定目录：
+推荐给 VSCode Claude Code 使用工作区安装：
+
+```powershell
+npx --yes @vocmarket/voc-skill@latest workspace --smoke
+```
+
+工作区安装会写入：
 
 ```text
-~/.claude/plugins/voc-intelligence
+.\.mcp.json
+.\.claude\plugins\voc-intelligence
+.\.claude\skills\xiaohongshu-trend-intelligence\SKILL.md
+.\.claude\skills\douyin-trend-intelligence\SKILL.md
+.\.claude\skills\voc-issue-pool\SKILL.md
+.\.claude\skills\voc-problem-deep-dive\SKILL.md
+.\.claude\skills\voc-content-plan\SKILL.md
+.\.claude\skills\voc-speaking-script\SKILL.md
+.\.claude\skills\voc-competitor-map\SKILL.md
+.\.claude\skills\voc-business-workflow\SKILL.md
 ```
 
-然后在该目录安装运行依赖，并输出：
+全局安装：
 
-```bash
-claude --plugin-dir "<安装目录>"
+```powershell
+npm install -g @vocmarket/voc-skill
+claude-voc install
 ```
 
-这样全局安装和 npx 安装的结果一致，后续也便于升级。
+npx 免全局安装：
 
-## package.json 要点
+```powershell
+npx --yes @vocmarket/voc-skill@latest install
+```
 
-- npm 包名使用 scoped package：`@vocmarket/voc-skill`
-- CLI 入口：
+## package.json 要点
 
 ```json
 {
+  "name": "@vocmarket/voc-skill",
   "bin": {
     "claude-voc": "bin/claude-voc.js"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }
 ```
 
-- `files` 必须显式包含：
-  - `.claude-plugin/`
-  - `.mcp.json`
-  - `bin/`
-  - `skills/`
-  - `mcp/`
-  - `memory-templates/`
-  - `docs/`
-  - `install.js`
-  - `skill-package-manifest.json`
+`files` 必须显式包含：
+
+- `.claude-plugin/`
+- `.mcp.json`
+- `bin/`
+- `docs/`
+- `install.js`
+- `mcp/`
+- `memory-templates/`
+- `package.json`
+- `scripts/`
+- `skill-package-manifest.json`
+- `skills/`
+
+不要发布：
+
+- `.env`
+- `.env.local`
+- `.npmrc`
+- `node_modules/`
+- `memory/`
+- `outputs/`
+- 本地 smoke 临时目录
+
+## 发布前验证
+
+在仓库根目录执行：
+
+```powershell
+npm --prefix claude-code/claude-code-voc-intelligence run mcp:smoke
+npm --prefix claude-code/claude-code-voc-intelligence run smoke:package
+npm run claude-voc:acceptance
+npm run claude-voc:build
+npm run claude-voc:npm-pack
+```
 
-## 验证命令
+`npm run claude-voc:npm-pack` 会做三类验证：
 
-根目录执行：
+1. 校验 npm package metadata、CLI 入口和必要文件。
+2. 生成 `dist/npm/vocmarket-voc-skill-<version>.tgz`。
+3. 在临时目录模拟 npm install、npx install、workspace install，并执行 `--smoke`。
 
-```bash
-npm run claude-voc:npm-pack
-```
+`npm run claude-voc:acceptance` 是更完整的发布前验收，会额外断言 workspace 安装后的：
 
-这个命令会做三件事：
+- `.mcp.json` 已生成
+- 8 个 `.claude/skills/*/SKILL.md` 入口已生成
+- MCP server 路径是安装后插件目录里的绝对路径
+- `npm pack --dry-run` 能看到关键文件
 
-1. 校验 npm package metadata 和 CLI 入口。
-2. 生成 `dist/npm/*.tgz`。
-3. 在临时目录里模拟 npm 安装，并执行 `claude-voc install --smoke`。
+## 正式发布
 
-发布命令：
+推荐使用 release 脚本：
 
-```bash
+```powershell
+powershell -ExecutionPolicy Bypass -File release/npm/claude-code-voc-intelligence/publish.ps1
+```
+
+也可以直接执行：
+
+```powershell
 npm run claude-voc:npm-publish
 ```
 
-发布前需要完成 `npm login`，或在 CI/部署环境配置 npm token。
+发布脚本会读取以下位置的 token：
+
+```text
+release/npm/claude-code-voc-intelligence/.env.local
+```
+
+文件内容格式：
+
+```text
+NPM_TOKEN=你的 npm automation token
+```
+
+也支持环境变量：
+
+```powershell
+$env:NPM_TOKEN="你的 npm automation token"
+```
+
+不要提交 `.env.local`、npm token、VOC session token、模型 API key 或任何真实用户凭证。
+
+## 发布后验证
+
+确认 npm latest：
+
+```powershell
+npm view @vocmarket/voc-skill name version dist-tags.latest --registry=https://registry.npmjs.org/
+```
+
+线上安装 smoke：
+
+```powershell
+$test = Join-Path $env:TEMP ("vocmarket-online-smoke-" + [guid]::NewGuid())
+New-Item -ItemType Directory -Path $test | Out-Null
+Push-Location $test
+npm exec --yes --package @vocmarket/voc-skill@latest -- claude-voc workspace --smoke
+Pop-Location
+```
+
+## npm 发布假失败处理
+
+有时 `npm publish` 已经返回成功，例如：
+
+```text
++ @vocmarket/voc-skill@0.3.15
+```
+
+但脚本紧接着执行 `npm view` 时，registry 还没同步完成，会短暂返回 404。
+
+处理方式：
+
+1. 等 20-60 秒后重新执行：
+
+```powershell
+npm view @vocmarket/voc-skill@0.3.15 version --registry=https://registry.npmjs.org/
+```
+
+2. 如果返回版本号，说明发布已经成功，不要重复发布同一个版本。
+3. 如果持续 404，再检查 npm 组织权限、token 权限和包名 scope。
+
+当前发布脚本已经把后置校验等待次数从 6 次增加到 12 次，减少这种假失败。
+
+## 当前发布记录
+
+- 2026-06-05：已发布 `@vocmarket/voc-skill@0.3.15`。
+- `npm view @vocmarket/voc-skill name version dist-tags.latest` 返回 `0.3.15`。
+- 线上 `npm exec --yes --package @vocmarket/voc-skill@latest -- claude-voc workspace --smoke` 已通过。
+- 旧包 `@gangvy/claude-code-voc-intelligence@*` 已标记为 deprecated，安装旧包时会提示改用 `@vocmarket/voc-skill`。
+- 已新增 `npm run claude-voc:acceptance` 一键发布前验收，覆盖包级 smoke、MCP smoke、npm pack dry-run 和 workspace 安装断言。
+- 包内包含 8 个 skill、12 个 MCP tools。
+- smoke 覆盖 sample report、证据卡、图片缓存、xsec URL 规范化、偏好记忆、no-token 充值提示、祖先 `.env.local` token 读取、抖音搜索入参错误保护、跨行业样例和 MCP tool discovery。
+
+## 后续版本同步
+
+升级版本时同步修改：
+
+- `claude-code/claude-code-voc-intelligence/package.json`
+- `claude-code/claude-code-voc-intelligence/package-lock.json`
+- `claude-code/claude-code-voc-intelligence/skill-package-manifest.json`
+- `claude-code/claude-code-voc-intelligence/.claude-plugin/plugin.json`
+- 如涉及 MCP server 或记忆 schema，同步对应版本字段
+- `dist/npm/claude-code-voc-npm-package-manifest.json`
+- `dist/claude-code-voc-intelligence-suite-manifest.json`
+- `release/npm/claude-code-voc-intelligence/README.md`
+- `release/npm/claude-code-voc-intelligence/release-checklist.md`
 
-## 注意点
+## 体验原则
 
-- zip 包和 npm 包共用同一套源码，但验证脚本分开。
-- npm 包不要发布 `node_modules/`、`memory/`、`outputs/`、`.env`。
-- `install.js` 不强依赖 `package-lock.json`，因为 npm publish 后 package-lock 不一定随包安装。
-- 用户侧不要暴露 profile、output、collectionMode 这类参数；安装完成后仍然用自然语言启动。
-
+- 用户侧不要暴露 `profile`、`output`、`collectionMode` 等底层参数。
+- 用户用自然语言触发 VOC 采集、问题池、单点深挖、内容计划和口播脚本。
+- 第一轮真实采集只输出“初步判断 / 机会假设 / 待校准”，不要包装成最终结论。
+- 无 token、余额不足、业务权限未开通时，返回开通/充值引导，不直接暴露底层 403、余额接口或 stack trace。

package/install.js

@@ -111,6 +111,8 @@ function checkFiles() {
     'skills/voc-speaking-script/SKILL.md',
     'skills/voc-competitor-map/SKILL.md',
     'skills/voc-business-workflow/SKILL.md',
+    'skills/fmode-image-analysis/SKILL.md',
+    'mcp/src/tools/fmode-image-analysis.js',
     'mcp/src/server.js'
   ].forEach(assertFile);
 

package/mcp/src/core/evidence-quality.js

@@ -87,7 +87,7 @@ function buildNoSampleFallbackMessage({ platformLabel, profile, examples = [] })
   return [
     `本次 live 模式没有采到可用于分析的${platformLabel}样本。`,
     '',
-    '这不代表行业没有机会，更可能是关键词过窄、平台内容表达不一样，或本轮上游没有返回可用内容。',
+    '说明：这不是类目限制，也不是“系统只支持某些行业”——任何行业（含律师、法律、医美、教育、专业服务等）都能采集。更可能是关键词过窄、平台内容表达不一样，或本轮上游没有返回可用内容。',
     '',
     '建议按这三步继续：',
     `1. 先保留当前方向：${keywords}`,

package/mcp/src/core/payment-links.js

@@ -105,6 +105,24 @@ function buildRechargeRequiredMessage(paymentUrl, recharge = {}, options = {}) {
   ].join('\n');
 }
 
+function buildWrongTokenTypeMessage(paymentUrl, recharge = {}, options = {}) {
+  const platformLabel = options.platformLabel || '小红书';
+  const packageUrl = recharge.recommendedPackageUrl || recharge.workshopUrl || paymentUrl;
+  return [
+    `检测到配置的是 sk- 开头的 AIGate API Key，这不是 ${platformLabel} 数据采集所需的 token，暂时不能进行真实采集。`,
+    '',
+    '这不是关键词或类目问题：任何关键词（含律师、法律、专业服务等）都可以采集，只要 token 类型正确并已开通额度。',
+    '',
+    `${platformLabel} 采集需要从充值/开通页复制的、以 r: 开头的会话 token（session token），不是 sk- 开头的 AIGate Key。`,
+    '',
+    `请打开充值/开通链接：${paymentUrl}`,
+    '',
+    `课程或工作坊用户也可以打开套餐入口：${packageUrl}`,
+    '',
+    '把以 r: 开头的 session token 配置到当前工作区 `.env.local` 或 `~/.claude/voc-credentials.json`（键名 vocToken / VOC_TOKEN），再重新运行 live 采集。'
+  ].join('\n');
+}
+
 module.exports = {
   VOC_SOCIAL_APIG_ID,
   VOC_RECHARGE_FUN_ID,
@@ -113,5 +131,6 @@ module.exports = {
   buildVocRechargeUrl,
   buildVocWorkshopUrl,
   buildMissingTokenMessage,
-  buildRechargeRequiredMessage
+  buildRechargeRequiredMessage,
+  buildWrongTokenTypeMessage
 };

package/mcp/src/features/douyin-trend/live-collector.js

@@ -318,7 +318,7 @@ async function collectLiveDataset({ profile, token, options = {} }) {
     errors.push({
       stage: 'search_videos',
       kind: 'invalid_keyword',
-      message: '请提供至少一个可用于抖音搜索的关键词，例如“茶饮 18元 22元”或“茶饮 性价比 新客”。',
+      message: '请提供至少一个可用于抖音搜索的关键词（任何行业都可以，例如“<品类/服务> <人群> <场景>”这种自然短语）。',
       httpStatus: 0
     });
     return { videos, comments, warnings, errors, keywords };