@vocmarket/voc-skill 0.3.36 → 0.3.37
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "voc-intelligence",
|
|
3
|
-
"description": "VOC intelligence skills for Claude Code: end-to-end VOC business workflows, Xiaohongshu and
|
|
4
|
-
"version": "0.3.
|
|
3
|
+
"description": "VOC intelligence skills for Claude Code: end-to-end VOC business workflows, Xiaohongshu/Douyin/WeChat Channels collection and 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.",
|
|
4
|
+
"version": "0.3.37",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "nkkj-BrainHack"
|
|
7
7
|
}
|
package/SKILL.md
CHANGED
|
@@ -2430,3 +2430,19 @@ Studio 已有 `/balance`、Token 免登录、NewAPI 余额、支付二维码、
|
|
|
2430
2430
|
1. `nova-server` 实际宿主加载撤销版本后的生产支付到账、Balance 刷新和 checkpoint 续跑，仍需后端发布与账户级小额支付回归。
|
|
2431
2431
|
2. 跨会话自动唤醒仍需 Agent runtime/callback/持久任务队列提供执行租约和支付事件唤醒；技能包继续提供 checkpoint、`usageTraceId` 和恢复参数，不在本包伪造后台执行能力。
|
|
2432
2432
|
3. 更多采集入口的媒体覆盖依赖各入口把原始响应交给统一本地媒体流水线；当前通用 `voc_api_call`、小红书、抖音入口已覆盖，新增入口按同一契约接入。
|
|
2433
|
+
|
|
2434
|
+
### 21.35 2026-09-06 技能包 0.3.36 发布闭环
|
|
2435
|
+
|
|
2436
|
+
`@vocmarket/voc-skill@0.3.36` 已正式发布并完成线上指定版本验收。本版本包含历史批处理报价适配、预计/实际成本校准以及显式通道计费模型映射修复；充值仍沿用 Token 免登录 Balance 链接或 Agent 生成二维码，任务执行仍按每次实际 NewAPI 调用扣费，媒体仍只写本地任务目录。
|
|
2437
|
+
|
|
2438
|
+
| 检查项 | 结果 | 证据/结论 |
|
|
2439
|
+
| --- | --- | --- |
|
|
2440
|
+
| npm registry 版本 | 通过 | `npm view @vocmarket/voc-skill@0.3.36 version --registry=https://registry.npmjs.org/` 返回 `0.3.36`。 |
|
|
2441
|
+
| 指定版本线上安装 | 通过 | `npm exec --yes --package @vocmarket/voc-skill@0.3.36 -- claude-voc workspace --smoke` 完成临时目录安装、样例、MCP 和 workspace 检查。 |
|
|
2442
|
+
| 当前源码验收 | 通过 | `npm --prefix claude-code/claude-code-voc-intelligence run acceptance` 通过，覆盖包级 smoke、MCP、安装器和成本校准。 |
|
|
2443
|
+
| 索引结构审计 | 通过 | `npm --prefix claude-code/claude-code-voc-intelligence run audit:index` 返回 `issues=[]`，11 个 Skill、19 个 MCP 工具；仅提示需由发布构建排除的本地 catalog 备份文件。 |
|
|
2444
|
+
| 发布产物元数据 | 通过 | `dist/npm/claude-code-voc-npm-package-manifest.json` 的版本为 `0.3.36`，`published=true`、`tested=true`、`npxTested=true`、`workspaceTested=true`。 |
|
|
2445
|
+
|
|
2446
|
+
#### 技能包交付结论
|
|
2447
|
+
|
|
2448
|
+
技能包已达到可发布和可安装使用的状态。P1 的报价、用量报告、接口频次/额度拆分、成本校准、余额不足充值引导、本地媒体缓存和索引审计均已在包内闭环。生产侧仍需由后端团队独立完成实际应用宿主的版本发布，以及使用余额正常测试账户完成原有支付回调、NewAPI 到账、Balance 刷新和 checkpoint 续跑回归；这些不阻塞 npm 技能包发布，但属于整体生产闭环的外部门禁。
|
package/mcp/src/server.js
CHANGED
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vocmarket/voc-skill",
|
|
3
|
-
"version": "0.3.
|
|
4
|
-
"description": "Claude Code VOC intelligence skills for Xiaohongshu and
|
|
3
|
+
"version": "0.3.37",
|
|
4
|
+
"description": "Claude Code VOC intelligence skills for Xiaohongshu, Douyin and WeChat Channels trend/content collection, live social VOC, Fmode image analysis, single-issue deep dives, boss/operator action plans, and multi-turn memory.",
|
|
5
5
|
"type": "commonjs",
|
|
6
6
|
"bin": {
|
|
7
7
|
"claude-voc": "bin/claude-voc.js"
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "claude-code-voc-intelligence",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.37",
|
|
4
4
|
"capabilities": {
|
|
5
|
-
"summary": "
|
|
5
|
+
"summary": "三类情报源同源接入：①社媒内容（含抖音/小红书/微信视频号等）②国内电商+创作者情报 ③海外选品。统一 search→doc→call、鉴权计费一致。",
|
|
6
6
|
"channels": [
|
|
7
7
|
{
|
|
8
8
|
"key": "social",
|
|
@@ -56,7 +56,7 @@
|
|
|
56
56
|
"apis": 1344
|
|
57
57
|
}
|
|
58
58
|
},
|
|
59
|
-
"description": "Claude Code native VOC intelligence package for cross-industry social VOC workflows. Includes Xiaohongshu and
|
|
59
|
+
"description": "Claude Code native VOC intelligence package for cross-industry social VOC workflows. Includes Xiaohongshu, Douyin and WeChat Channels collection/intelligence, live token checks, evidence-card reports, single-issue VOC deep dives, boss/operator action plans, and scoped multi-turn memory.",
|
|
60
60
|
"changelogUrl": "https://www.npmjs.com/package/@vocmarket/voc-skill?activeTab=versions",
|
|
61
61
|
"plugin": "voc-intelligence",
|
|
62
62
|
"skills": [
|
|
@@ -19,18 +19,18 @@ VOC 后端是一个**通用转发网关**（`https://server.fmode.cn/api/voc-soc
|
|
|
19
19
|
|
|
20
20
|
清单里每个接口都带 `channel` 字段，`voc_api_call` 据此**自动**选用对应网关，你通常无需关心：
|
|
21
21
|
|
|
22
|
-
- `channel="social"`（默认）：走社媒中转网关 `https://server.fmode.cn/api/voc-social
|
|
22
|
+
- `channel="social"`（默认）：走社媒中转网关 `https://server.fmode.cn/api/voc-social`。覆盖抖音、小红书、**微信视频号**、TikTok、微博、B站、快手、知乎、Instagram、YouTube、Twitter/X 等 18 个平台的内容搜索、评论、用户/笔记/作品详情等 VOC 口碑采集。遇到 `weixin.qq.com/sph/...` 视频号分享短链时，优先查 `wechat` / `视频号` 清单，用 `wechat_channels.v2.fetch_video_detail`（`share_url`）取作品详情与媒体地址，不要误判为「无视频号能力」。
|
|
23
23
|
- `channel="ecommerce"`：走电商与创作者数据网关 `https://server.fmode.cn/api/voc-e-commerce`，覆盖三块：
|
|
24
24
|
1. **国内电商商品**：京东、淘宝/天猫、1688、抖音电商、TikTok Shop、闲鱼、得物 等平台的商品搜索、商品详情、价格、商品评论、店铺商品列表等——用户问「京东/淘宝/天猫某商品、某品类选品、商品评论」时就用这里（注意：上游暂无拼多多接口，遇拼多多需求可用京东/淘宝/天猫/1688 替代，并如实说明）。
|
|
25
25
|
2. **创作者侧情报**：抖音星图、小红书蒲公英（PGY）的创作者搜索、画像、受众/粉丝分布、内容与评论关键词、笔记/视频绩效与性价比等，服务创作者生态理解、竞对达人布局、受众匹配与内容方向验证（不是替用户做投放采买决策）。
|
|
26
|
-
3.
|
|
26
|
+
3. **内容平台**：微信公众号、微信视频号（`weixin_channels.*` 基础信息/下载链/搜索等）、微博、B站、知乎、快手、今日头条、豆瓣、IMDb 等的结构化内容数据。
|
|
27
27
|
- `channel="overseas"`：走海外电商选品网关 `https://server.fmode.cn/api/voc-ecom`。亚马逊海外站点的类目树 / Best Seller Top100 榜单、产品详情与子体销量、ABA 关键词与搜索排名、产品评论实时采集、ASIN/榜单/卖家数据监控等选品数据走这条。
|
|
28
28
|
|
|
29
29
|
三套网关**鉴权、计费、错误处理完全同源**（同一把 `sk-`/`r:` token、同样的 401/402/403 语义、同样的回退逻辑），只是根地址不同。调用清单里**没有**的接口时，传 `rawPath` 的同时显式带对应 `channel`（`ecommerce` / `overseas`）即可路由（社媒接口不传 channel 默认 social）。
|
|
30
30
|
|
|
31
31
|
## 工具
|
|
32
32
|
|
|
33
|
-
- `voc_api_search`：检索接口清单。入参 `query`（关键词，可选）、`platform`（如 douyin /
|
|
33
|
+
- `voc_api_search`：检索接口清单。入参 `query`（关键词，可选）、`platform`（如 douyin / xiaohongshu / wechat / weixin_channels / tiktok / instagram / youtube / twitter / linkedin 等平台 key，可选）、`tag`（可选）。返回接口 id、标题、method、proxyPath、必填参数。搜视频号时可用 `platform=wechat` 或关键词「视频号 / sph / share_url」。
|
|
34
34
|
- `voc_api_doc`：读取单个接口的完整参数文档。入参 `id`（或 `proxyPath`）。返回参数表 + 可直接复制的调用模板。
|
|
35
35
|
- `voc_api_call`：发起真实调用。入参：
|
|
36
36
|
- `id`：清单里的接口 id（推荐），或
|
|
@@ -107,7 +107,7 @@ VOC 后端是一个**通用转发网关**（`https://server.fmode.cn/api/voc-soc
|
|
|
107
107
|
- 禁止输出「某行业不可用 / 系统只支持某类目」这类结论——**任何行业、任何关键词都能采集**，前提只是 token 类型正确且有额度。
|
|
108
108
|
- 失败时禁止退回 web search / yt-dlp / ffmpeg / 让用户手动传媒体文件来「绕过」采集。
|
|
109
109
|
- **接口第一次调用失败，禁止立刻转 WebSearch / 公开网页搜索来「代替」采集**。正确动作：先按工具返回的 `status` / `assistantMessage` 对照 `references/error-codes.md` 判定错误类型——若是 `upstream_unstable`（5xx / 超时 / fetch failed）**直接重试该接口**（上游抖动重试即恢复，实测重试数次即 200）；若是 `needs_input` 用 `voc_api_doc` 核对参数后重试；若是 `needs_token`/`needs_valid_token` 取 `sk-` 重试。只有在确认接口本身不存在该能力、且清单与 `rawPath` 都无法覆盖时，才考虑其它来源，并如实说明原因。
|
|
110
|
-
- **禁止因为「我以为没有这个能力」就跳过清单直接 WebSearch**。京东/淘宝/天猫/1688/抖音电商/闲鱼/得物 的商品与评论、亚马逊海外选品都在 `channel=ecommerce`/`overseas` 里——先 `voc_api_search`
|
|
110
|
+
- **禁止因为「我以为没有这个能力」就跳过清单直接 WebSearch**。京东/淘宝/天猫/1688/抖音电商/闲鱼/得物 的商品与评论、亚马逊海外选品都在 `channel=ecommerce`/`overseas` 里；**微信视频号短链采集**在 `channel=social` 的 `wechat`（如 `wechat_channels.v2.fetch_video_detail`）以及 `channel=ecommerce` 的 `weixin_channels` 里——先 `voc_api_search` 查清单确认，再下结论。不要默认改成「保存到相册发 mp4」。
|
|
111
111
|
|
|
112
112
|
## 状态码含义（详表见 `references/error-codes.md`）
|
|
113
113
|
|