@vocmarket/voc-skill 0.3.25 → 0.3.26

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, 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.25",
+  "version": "0.3.26",
   "author": {
     "name": "nkkj-BrainHack"
   }

package/bin/claude-voc.js

@@ -308,7 +308,7 @@ function workspaceTrendSkillText(options) {
     '- If the user asks for live collection, real collection, or entering live mode, run the local VOC tool in live mode.',
     '- Do not answer that you cannot fetch external data. The local VOC tool is the approved collection entry.',
     '- If the tool returns `needs_token`, `needs_recharge`, or `needs_valid_token`, paste its `assistantMessage` to the user verbatim.',
-    '- `needs_token` is recoverable: an `sk-` fmode key (Claude Code `ANTHROPIC_AUTH_TOKEN`) lets collection run — guide self-rescue first, do not push recharge. Only on a real `402` show the fmode-api recharge link `https://app.fmode.cn/dev/studio/?balance=fmodeapi`.',
+    '- `needs_token` is recoverable: an `sk-` fmode key (Claude Code `ANTHROPIC_AUTH_TOKEN`) lets collection run — guide self-rescue first, do not push recharge. Only a real `402` needs recharge. 完整口径见下方「充值 / 计费口径」。',
     '',
     '## sample 命令',
     '',
@@ -330,20 +330,11 @@ function workspaceTrendSkillText(options) {
     `node ${quotedPath(preferenceUpdater)} --message "<用户反馈原文>" --memory ${quotedPath(defaultMemoryPath)} --result-prefix ${options.resultPrefix}`,
     '```',
     '',
-    '## 充值 / 计费口径',
+    '## 充值 / 计费口径（简版；完整对照见 voc-api-catalog 技能的「错误码速查」references/error-codes.md）',
     '',
-    '- **缺 token（`needs_token`）不是没钱，不要直接给充值链接**：先自救——读 `~/.claude/settings.json` 的 `env.ANTHROPIC_AUTH_TOKEN`（`sk-` 开头的 fmode key），或 `~/.fmode/config.json` / `~/.claude/voc-credentials.json`。',
-    '- **只有真正 `402 余额不足` 才引导充值**；本技能走 NewAPI（fmode-api）计费，充值入口用 fmode-api：',
-    '',
-    '```text',
-    'https://app.fmode.cn/dev/studio/?balance=fmodeapi',
-    '```',
-    '',
-    '- `apig-pay` 仅用于「VOC 数据服务会话 token（`r:` 开头）余额」这一特定场景的补充，不是缺 token / 默认充值入口：',
-    '',
-    '```text',
-    'https://app.fmode.cn/dev/apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF',
-    '```',
+    '- 缺 token（`needs_token`）= 可恢复、不是没钱：先自救读 `~/.claude/settings.json` 的 `sk-` fmode key（或 `~/.fmode/config.json` / `~/.claude/voc-credentials.json`），用 `FMODE_API_KEY=sk-…` 重试，不要劝充值。',
+    '- 只有真 `402 余额不足` 才充值，入口 `https://app.fmode.cn/dev/studio/?balance=fmodeapi`（NewAPI/fmode-api 计费）；`401`=token、`403`=权限，都不充值。`apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF` 仅限 `r:` 会话 token 余额补充。',
+    '- 实际充值/自救链接以工具返回的 `assistantMessage` / `nextActions` 为准，不要写死。',
     ''
   ].join('\n');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vocmarket/voc-skill",
-  "version": "0.3.25",
+  "version": "0.3.26",
   "description": "Claude Code VOC intelligence skills for Xiaohongshu and Douyin trend reports, live social VOC collection, Fmode image analysis, single-issue deep dives, boss/operator action plans, and multi-turn memory.",
   "type": "commonjs",
   "bin": {

package/skill-package-manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-voc-intelligence",
-  "version": "0.3.25",
+  "version": "0.3.26",
   "description": "Claude Code native VOC intelligence package for cross-industry social VOC workflows. Includes Xiaohongshu and Douyin trend intelligence, live token checks, evidence-card reports, single-issue VOC deep dives, boss/operator action plans, and scoped multi-turn memory.",
   "plugin": "voc-intelligence",
   "skills": [

package/skills/douyin-trend-intelligence/SKILL.md

@@ -22,7 +22,7 @@ allowed-tools: Read Write Bash(node *)
 - If the user asks for live collection, real collection, or entering live mode, run the local VOC tool in live mode.
 - Do not answer that you cannot fetch external data. The local VOC tool is the approved collection entry.
 - If the tool returns `needs_token`, `needs_recharge`, or `needs_valid_token`, paste its `assistantMessage` to the user verbatim, including whatever self-rescue/recharge link the tool returns.
-- `needs_token` is recoverable: an `sk-` fmode newapi key (Claude Code's `ANTHROPIC_AUTH_TOKEN` in `~/.claude/settings.json`, or `~/.fmode/config.json` / `~/.claude/voc-credentials.json`) lets collection run — guide self-rescue first, do not push the user to recharge. Only on a real `402` (insufficient balance) show the fmode-api recharge link `https://app.fmode.cn/dev/studio/?balance=fmodeapi`.
+- `needs_token` is recoverable: an `sk-` fmode newapi key (Claude Code's `ANTHROPIC_AUTH_TOKEN` in `~/.claude/settings.json`, or `~/.fmode/config.json` / `~/.claude/voc-credentials.json`) lets collection run — guide self-rescue first, do not push recharge. Only a real `402` needs recharge. 完整口径见下方「充值 / 计费口径」。
 
 ## 禁止事项（Hard Guardrails）
 
@@ -71,20 +71,11 @@ node "<插件目录>/mcp/src/tools/douyin-trend-run.js" --collection-mode live -
 
 运行后把命令输出正文直接发给用户。不要展示 JSON、summary、data、files 或调试日志。
 
-## 充值 / 计费口径
+## 充值 / 计费口径（简版；完整对照见 voc-api-catalog 技能的「错误码速查」references/error-codes.md）
 
-- **缺 token（`needs_token`）不是没钱，不要直接给充值链接**：先自救——读 `~/.claude/settings.json` 的 `env.ANTHROPIC_AUTH_TOKEN`（`sk-` 开头的 fmode key），或 `~/.fmode/config.json` / `~/.claude/voc-credentials.json` 里的 fmode key，用 `FMODE_API_KEY=sk-…` 重试即可。
-- **只有真正 `402 余额不足` 才引导充值**；本技能走 NewAPI（fmode-api）计费，充值入口用 fmode-api：
-
-```text
-https://app.fmode.cn/dev/studio/?balance=fmodeapi
-```
-
-- `apig-pay` 仅用于「VOC 数据服务会话 token（`r:` 开头）余额」这一特定场景的补充，不是缺 token / 默认充值入口：
-
-```text
-https://app.fmode.cn/dev/apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF
-```
+- 缺 token（`needs_token`）= 可恢复、不是没钱：先自救读 `~/.claude/settings.json` 的 `sk-` fmode key（或 `~/.fmode/config.json` / `~/.claude/voc-credentials.json`），用 `FMODE_API_KEY=sk-…` 重试，不要劝充值。
+- 只有真 `402 余额不足` 才充值，入口 `https://app.fmode.cn/dev/studio/?balance=fmodeapi`（NewAPI/fmode-api 计费）；`401`=token、`403`=权限，都不充值。`apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF` 仅限 `r:` 会话 token 余额补充。
+- 实际充值/自救链接以工具返回的 `assistantMessage` / `nextActions` 为准，不要写死。
 
 ## 推荐用户启动话术
 

package/skills/douyin-trend-intelligence/references/live-mode.md

@@ -3,8 +3,7 @@
 ## 默认规则
 
 - 样本量保持小
-- 缺 token 时先自救：读 `~/.claude/settings.json` 的 `ANTHROPIC_AUTH_TOKEN`（`sk-` 开头的 fmode key），或 `~/.fmode/config.json` / `~/.claude/voc-credentials.json`，用 `FMODE_API_KEY=sk-…` 重试；不要直接甩充值链接，也不要暴露 403
-- 只有真正余额不足（402）才给充值链接，且用 fmode-api 入口 `https://app.fmode.cn/dev/studio/?balance=fmodeapi`，不要暴露底层错误
+- 计费/充值口径走简版：缺 token 先自救（读 `~/.claude/settings.json` 的 `sk-` fmode key 重试），不要直接甩充值链接、不要暴露 401/403；只有真 `402` 才给充值链接 `https://app.fmode.cn/dev/studio/?balance=fmodeapi`。**完整口径（401/402/403 对照、回退、apig-pay `r:` 补充链）见 voc-api-catalog 技能的「错误码速查」references/error-codes.md**
 - 用户只需要看到“怎么继续”
 
 ## 推荐默认参数

package/skills/voc-api-catalog/references/error-codes.md

@@ -4,7 +4,7 @@
 > **401 = token 问题**（缺失/失效/类型不对），**403 = 账号禁用/无权限**，都**不是没钱**，不要引导充值。
 > **缺 token / 401 是可恢复的**：NewAPI 计费用的 `sk-` 就是 Claude Code 的 `ANTHROPIC_AUTH_TOKEN`（在 `~/.claude/settings.json` 的 `env` 里），取出来用 `FMODE_API_KEY=sk-…` 传入重试即可，**别当成「这个技能不能用」而放弃或去点充值**。
 
-适用范围：`voc_api_call` / `voc_api_doc`（voc-social 通用转发网关 `https://server.fmode.cn/api/voc-social/<proxyPath>`）。
+适用范围：`voc_api_call` / `voc_api_doc`，**两条通道同源**——社媒网关 `https://server.fmode.cn/api/voc-social/<proxyPath>`（`channel=social`，默认）与创作者数据网关 `https://server.fmode.cn/api/voc-e-commerce/<proxyPath>`（`channel=ecommerce`）的鉴权、计费、错误码语义完全一致，下表对两者通用。本速查也是各 trend / 采集技能充值计费口径的**单一权威来源**，技能里只放简版摘要并指回这里。
 
 ## 一、总览表（HTTP 状态 → 含义 → 工具返回 → 给客户的话术 → Agent 动作）
 
@@ -55,6 +55,12 @@ HTTP 403  {"code":403,"mess":"用户禁用或无权限"}
    - 若工具报 `needs_token`/`needs_valid_token`：先去 `~/.claude/settings.json` 取 `env.ANTHROPIC_AUTH_TOKEN`，用 `FMODE_API_KEY=sk-…` 传入重试——**这是缺 token 的标准自救，不是去点充值**。
 2. 若 `sk-` token **鉴权失败（kind=auth / 401，含「未入仓」类报错）** 且存在平台 `r:` sessionToken，**自动回退** sessionToken 重试一次。这正是规避「用户拿 token 请求时遇到入仓错误」的方式——不再因为 token 是 `sk-` 就直接拒绝。
 3. **402（余额不足）/ 403（无权限）不回退**——它们是终态，按上表处理。
+
+> **充值入口分两条链（按实际走哪条计费而定）**：
+> - `sk-` NewAPI / fmode-api 计费链（默认，绝大多数缺额场景）→ `https://app.fmode.cn/dev/studio/?balance=fmodeapi`
+> - `r:` 会话 token 链（仅当走 `r:` sessionToken 回退路径、该 token 余额不足时）→ `https://app.fmode.cn/dev/apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF`
+>
+> 运行时以工具返回的 `assistantMessage` / `nextActions` 链接为准转述，不要在话术里写死某一条。
 4. 底层「未入仓」/鉴权原始报错**不甩给用户**，对外只给上表的友好提示。
 
 ## 四、判定规则摘要（`classifyApiError`）

package/skills/xiaohongshu-trend-intelligence/SKILL.md

@@ -22,7 +22,7 @@ allowed-tools: Read Write Bash(node *)
 - If the user asks for live collection, real collection, or entering live mode, run the local VOC tool in live mode.
 - Do not answer that you cannot fetch external data. The local VOC tool is the approved collection entry.
 - If the tool returns `needs_token`, `needs_recharge`, or `needs_valid_token`, paste its `assistantMessage` to the user verbatim, including whatever self-rescue/recharge link the tool returns.
-- `needs_token` is recoverable: an `sk-` fmode newapi key (Claude Code's `ANTHROPIC_AUTH_TOKEN` in `~/.claude/settings.json`, or `~/.fmode/config.json` / `~/.claude/voc-credentials.json`) lets collection run — guide self-rescue first, do not push the user to recharge. Only on a real `402` (insufficient balance) show the fmode-api recharge link `https://app.fmode.cn/dev/studio/?balance=fmodeapi`.
+- `needs_token` is recoverable: an `sk-` fmode newapi key (Claude Code's `ANTHROPIC_AUTH_TOKEN` in `~/.claude/settings.json`, or `~/.fmode/config.json` / `~/.claude/voc-credentials.json`) lets collection run — guide self-rescue first, do not push recharge. Only a real `402` needs recharge. 完整口径见下方「充值 / 计费口径」。
 
 ## 禁止事项（Hard Guardrails）
 
@@ -54,20 +54,11 @@ node "<插件目录>/mcp/src/tools/xiaohongshu-trend-run.js" --collection-mode l
 
 运行后把命令输出正文直接发给用户。不要展示 JSON、summary、data、files 或调试日志。
 
-## 充值 / 计费口径
+## 充值 / 计费口径（简版；完整对照见 voc-api-catalog 技能的「错误码速查」references/error-codes.md）
 
-- **缺 token（`needs_token`）不是没钱，不要直接给充值链接**：先自救——读 `~/.claude/settings.json` 的 `env.ANTHROPIC_AUTH_TOKEN`（`sk-` 开头的 fmode key），或 `~/.fmode/config.json` / `~/.claude/voc-credentials.json` 里的 fmode key，用 `FMODE_API_KEY=sk-…` 重试即可。
-- **只有真正 `402 余额不足` 才引导充值**；本技能走 NewAPI（fmode-api）计费，充值入口用 fmode-api：
-
-```text
-https://app.fmode.cn/dev/studio/?balance=fmodeapi
-```
-
-- `apig-pay` 仅用于「VOC 数据服务会话 token（`r:` 开头）余额」这一特定场景的补充，不是缺 token / 默认充值入口：
-
-```text
-https://app.fmode.cn/dev/apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF
-```
+- 缺 token（`needs_token`）= 可恢复、不是没钱：先自救读 `~/.claude/settings.json` 的 `sk-` fmode key（或 `~/.fmode/config.json` / `~/.claude/voc-credentials.json`），用 `FMODE_API_KEY=sk-…` 重试，不要劝充值。
+- 只有真 `402 余额不足` 才充值，入口 `https://app.fmode.cn/dev/studio/?balance=fmodeapi`（NewAPI/fmode-api 计费）；`401`=token、`403`=权限，都不充值。`apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF` 仅限 `r:` 会话 token 余额补充。
+- 实际充值/自救链接以工具返回的 `assistantMessage` / `nextActions` 为准，不要写死。
 
 ## 推荐用户启动话术
 

package/skills/xiaohongshu-trend-intelligence/references/live-mode.md

@@ -27,8 +27,8 @@ live 模式默认保持小规模：
 
 不要直接把底层报错甩给用户：
 
-- 缺 token：先自救——读 `~/.claude/settings.json` 的 `ANTHROPIC_AUTH_TOKEN`（`sk-` 开头的 fmode key），或 `~/.fmode/config.json` / `~/.claude/voc-credentials.json`，用 `FMODE_API_KEY=sk-…` 重试；不要直接给充值链接。
-- 只有真正余额不足（402）才给充值链接 + 下一步操作。
+- 缺 token：先自救——读 `~/.claude/settings.json` 的 `sk-` fmode key（或 `~/.fmode/config.json` / `~/.claude/voc-credentials.json`）用 `FMODE_API_KEY=sk-…` 重试，不要直接给充值链接。
+- 只有真正余额不足（`402`）才给充值链接 + 下一步操作。完整口径见下方「充值入口」与 voc-api-catalog 的「错误码速查」。
 
 不要把 `403`、授权失败文案、原始响应体直接暴露给用户。
 
@@ -41,19 +41,11 @@ live 模式默认保持小规模：
 
 保留 `xsec_token`，否则网页端可能打不开。
 
-## 充值入口（仅 402 余额不足时）
+## 充值入口（仅 402 余额不足时，简版）
 
-本技能走 NewAPI（fmode-api）计费，充值入口用 fmode-api：
-
-```text
-https://app.fmode.cn/dev/studio/?balance=fmodeapi
-```
-
-`apig-pay` 仅用于「VOC 数据服务会话 token（`r:` 开头）余额」这一特定场景的补充：
-
-```text
-https://app.fmode.cn/dev/apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF
-```
+- `sk-` NewAPI/fmode-api 计费链（默认）：`https://app.fmode.cn/dev/studio/?balance=fmodeapi`
+- `apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF` 仅限 `r:` 会话 token 余额补充。
+- 完整 401/402/403 对照与回退逻辑见 **voc-api-catalog 技能的「错误码速查」references/error-codes.md**（单一权威来源）。
 
 ## 结论