@vocmarket/voc-skill 0.3.22 → 0.3.24

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

package/README.md

@@ -266,22 +266,33 @@ voc_business_workflow_run
 
 ## token 和充值口径
 
-sample 模式不需要 token。live 模式需要 VOC-AI 数据服务 token。
+sample 模式不需要 token。live 模式需要一把可用的 token——**两条链任一可用即可采集**：
 
-允许读取 token 的位置：
+1. **NewAPI（fmode-api）计费 SK**（`sk-` 开头，优先）：就是 Claude Code 的 `ANTHROPIC_AUTH_TOKEN`，装好技能包后通常**已经具备**，不必手动再配。读取来源：
+   - 本次请求参数 `newapiToken` / `fmodeApiKey`
+   - `.env.local` / 环境变量 `FMODE_API_KEY`、`NEWAPI_TOKEN`
+   - `~/.claude/voc-credentials.json` 的 `fmodeApiKey`
+   - `~/.fmode/config.json`（FmodeStudio 保存路径）的 `newapiToken` / `fmodeApiKey`
+   - `~/.claude/settings.json` 的 `env.ANTHROPIC_AUTH_TOKEN`（`sk-` 开头、且 `ANTHROPIC_BASE_URL` 指向 fmode）
+2. **VOC-AI 数据服务会话 token**（`r:` 开头，回退）：读取来源——本次请求参数、`.env.local` / 环境变量 `VOC_TOKEN`·`VOC_SOCIAL_TOKEN`、`~/.claude/voc-credentials.json` 的 `vocToken`·`token`
 
-- 本次请求参数
-- 当前工作区 `.env.local`
-- 系统环境变量
-- `~/.claude/voc-credentials.json`
+同一网关 `server.fmode.cn/api/voc-social` 对上述任一有效 token 都接受 `Bearer`，**`sk-` 不是「类型错误」**。`voc_*_token_check` 与实际采集（`voc_api_call` / `voc_*_trend_run`）口径一致，会识别以上**全部**来源；不必在采集前强制先跑检测。
 
 Claude Code 技能包不读取 `~/.openclaw/voc-credentials.json`。
 
-如果没有 token 或余额不足，应给用户充值/开通链接，不要暴露底层接口 403、权限堆栈或上游响应体：
+缺 token 多数是**配置/读取**问题，不是余额不足：应先引导自救（从上述来源读 SK、用 `FMODE_API_KEY` 重试），**只有确认确实是 402 余额不足时**才给充值/开通链接，且不要暴露底层接口 403、权限堆栈或上游响应体。两条链对应**两个不同的充值入口**，不要搭错：
 
-```text
-https://app.fmode.cn/dev/apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF
-```
+- **NewAPI（fmode-api）计费 SK**（`sk-` 开头，多数缺 token 场景走这条）→ fmode-api 余额充值：
+
+  ```text
+  https://app.fmode.cn/dev/studio/?balance=fmodeapi
+  ```
+
+- **VOC-AI 数据服务会话 token**（`r:` 开头）→ apig-pay 充值：
+
+  ```text
+  https://app.fmode.cn/dev/apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF
+  ```
 
 ## 记忆能力
 

package/docs/capability-map.md

@@ -13,7 +13,7 @@
 | 一次跑完整经营闭环 | `voc-business-workflow` | `voc_business_workflow_run` | 市场声音、问题池、Top 问题动作、7 天内容计划、第一条口播稿 |
 | 先演示流程，不真实采集 | 小红书/抖音趋势 skill | `voc_xiaohongshu_trend_run` / `voc_douyin_trend_run`，`collectionMode=sample` | 第一轮样本观察、机会假设、待确认问题 |
 | 真实采集行业趋势 | 小红书/抖音趋势 skill | `voc_xiaohongshu_trend_run` / `voc_douyin_trend_run`，`collectionMode=live` | 真实笔记/视频、评论证据、趋势假设 |
-| 检查 token 是否可用 | 平台趋势 skill | `voc_xiaohongshu_token_check` / `voc_douyin_token_check` | 是否已配置、无 token 时给充值链接 |
+| 检查 token 是否可用 | 平台趋势 skill | `voc_xiaohongshu_token_check` / `voc_douyin_token_check` | 是否已配置（识别 SK/会话 token 全部来源）；缺 token 多是配置/读取问题，先按来源自救读 SK，确认 402 余额不足才给充值 |
 | 用户回答校准问题 | 平台趋势 skill | `voc_xiaohongshu_preference_update` / `voc_douyin_preference_update` | 保存偏好、屏蔽方向、下一轮聚焦 |
 | 把评论整理成问题池 | `voc-issue-pool` | `voc_issue_pool_run` | 问题优先级、状态、证据、影响环节、建议动作 |
 | 判断哪些问题最影响生意 | `voc-issue-pool` | `voc_issue_pool_run` | 本周优先推进的问题和下一步深挖入口 |