Jelajahi Sumber

chore(voc): release 0.3.46 with catalog 1.9.0 preferred relations

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
gangvy 1 hari lalu
induk
melakukan
ce1c4b3fe9

+ 1 - 1
claude-code/claude-code-voc-intelligence/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
 {
   "name": "voc-intelligence",
   "name": "voc-intelligence",
   "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.",
   "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.",
-  "version": "0.3.45",
+  "version": "0.3.46",
   "author": {
   "author": {
     "name": "nkkj-BrainHack"
     "name": "nkkj-BrainHack"
   }
   }

+ 1 - 1
claude-code/claude-code-voc-intelligence/mcp/src/server.js

@@ -66,7 +66,7 @@ function normalizeToolResult(result = {}) {
 function createServer() {
 function createServer() {
   const server = new McpServer({
   const server = new McpServer({
     name: 'voc-intelligence',
     name: 'voc-intelligence',
-    version: '0.3.45'
+    version: '0.3.46'
   });
   });
 
 
   server.registerTool(
   server.registerTool(

+ 2 - 2
claude-code/claude-code-voc-intelligence/package-lock.json

@@ -1,12 +1,12 @@
 {
 {
   "name": "@vocmarket/voc-skill",
   "name": "@vocmarket/voc-skill",
-  "version": "0.3.45",
+  "version": "0.3.46",
   "lockfileVersion": 3,
   "lockfileVersion": 3,
   "requires": true,
   "requires": true,
   "packages": {
   "packages": {
     "": {
     "": {
       "name": "@vocmarket/voc-skill",
       "name": "@vocmarket/voc-skill",
-      "version": "0.3.45",
+      "version": "0.3.46",
       "dependencies": {
       "dependencies": {
         "@modelcontextprotocol/sdk": "^1.29.0",
         "@modelcontextprotocol/sdk": "^1.29.0",
         "zod": "^4.4.3"
         "zod": "^4.4.3"

+ 1 - 1
claude-code/claude-code-voc-intelligence/package.json

@@ -1,6 +1,6 @@
 {
 {
   "name": "@vocmarket/voc-skill",
   "name": "@vocmarket/voc-skill",
-  "version": "0.3.45",
+  "version": "0.3.46",
   "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.",
   "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.",
   "type": "commonjs",
   "type": "commonjs",
   "bin": {
   "bin": {

+ 1 - 1
claude-code/claude-code-voc-intelligence/skill-package-manifest.json

@@ -1,6 +1,6 @@
 {
 {
   "name": "claude-code-voc-intelligence",
   "name": "claude-code-voc-intelligence",
-  "version": "0.3.45",
+  "version": "0.3.46",
   "capabilities": {
   "capabilities": {
     "summary": "三类情报源同源接入:①社媒内容(含抖音/小红书/微信视频号等)②国内电商+创作者情报 ③海外选品。统一 search→doc→call、鉴权计费一致。",
     "summary": "三类情报源同源接入:①社媒内容(含抖音/小红书/微信视频号等)②国内电商+创作者情报 ③海外选品。统一 search→doc→call、鉴权计费一致。",
     "channels": [
     "channels": [

+ 24 - 24
claude-code/claude-code-voc-intelligence/skills/voc-api-catalog/references/platforms.md

@@ -1,8 +1,8 @@
 # 平台与接口索引
 # 平台与接口索引
 
 
-> 由接口目录自动生成(目录 v1.8.0,2026-11-10)。不要手改,目录变更后重新生成。
+> 由接口目录自动生成(目录 v1.9.0,2026-11-13)。不要手改,目录变更后重新生成。
 
 
-共 1283 个可用接口。本文件每个平台只列最常用的几个,完整清单用 `voc_api_search` 传 `platform` 查。
+共 1272 个可用接口。本文件每个平台只列最常用的几个,完整清单用 `voc_api_search` 传 `platform` 查。
 
 
 用法:在下面找到平台 key 和接口 id → `voc_api_doc` 传 id 读参数 → `voc_api_call` 调用。
 用法:在下面找到平台 key 和接口 id → `voc_api_doc` 传 id 读参数 → `voc_api_call` 调用。
 带 ✓ 的接口在目录更新当天做过真实调用验证。没有 ✓ 不代表不可用,只是没有逐个实测。
 带 ✓ 的接口在目录更新当天做过真实调用验证。没有 ✓ 不代表不可用,只是没有逐个实测。
@@ -112,12 +112,12 @@
 
 
 ### 微信/视频号 `wechat`(23 个)
 ### 微信/视频号 `wechat`(23 个)
 
 
-- `wechat_channels.v2.fetch_video_detail` 获取视频号作品详情。必填:无
-- `wechat_channels.v2.fetch_video_comments` 获取视频号作品评论。必填:object_id
-- `wechat_channels.v2.fetch_live_detail` 获取视频号直播间详情。必填:live_id
-- `wechat_channels.v2.fetch_search_channel_videos` 视频号号内搜索。必填:username, keyword
-- `wechat_mp.v2.fetch_article_detail` 获取公众号文章详情。必填:url
-- `wechat_mp.v2.fetch_article_comments` 获取公众号文章评论。必填:url
+- `wechat_search.v2.fetch_search` ✓ 微信综合搜索(搜一搜)。必填:keyword
+- `wechat_search.v2.fetch_search_videos` ✓ 搜视频号视频(时长/排序/时间筛选)。必填:keyword
+- `wechat_channels.v2.fetch_video_detail` ✓ 获取视频号作品详情。必填:无
+- `wechat_mp.v2.fetch_article_detail` ✓ 获取公众号文章详情。必填:url
+- `wechat_channels.v2.fetch_channel_info` ✓ 获取视频号账号信息。必填:username
+- `wechat_channels.v2.fetch_user_videos` ✓ 获取视频号用户作品列表。必填:username
 
 
 ### 皮皮虾 `pipixia`(17 个)
 ### 皮皮虾 `pipixia`(17 个)
 
 
@@ -175,25 +175,25 @@
 
 
 ## 国内电商 + 创作者情报(channel=ecommerce)
 ## 国内电商 + 创作者情报(channel=ecommerce)
 
 
-29 个平台,252 个接口。
+29 个平台,241 个接口。
 
 
 ### 抖音 `douyin`(41 个)
 ### 抖音 `douyin`(41 个)
 
 
 - `douyin.xingtu.creator_search` ✓ 抖音星图·创作者搜索。必填:无
 - `douyin.xingtu.creator_search` ✓ 抖音星图·创作者搜索。必填:无
 - `douyin.xingtu.creator_profile` ✓ 抖音星图·创作者资料。必填:oAuthorId
 - `douyin.xingtu.creator_profile` ✓ 抖音星图·创作者资料。必填:oAuthorId
-- `douyin.xingtu.comment_keyword_analysis` 抖音星图·评论关键词分析。必填:oAuthorId
-- `douyin.xingtu.creator_search_light` 抖音星图·创作者搜索轻量版。必填:keyword, platformSource, page
-- `douyin.xingtu.video_details` 抖音星图·视频详情。必填:itemId
-- `douyin.search_video_v4` 抖音·视频搜索。必填:keyword
+- `douyin.xingtu.comment_keyword_analysis` ✓ 抖音星图·评论关键词分析。必填:oAuthorId
+- `douyin.xingtu.audience_distribution` ✓ 抖音星图·受众分布。必填:oAuthorId
+- `douyin.xingtu.content_keyword_analysis` ✓ 抖音星图·内容关键词分析。必填:oAuthorId
+- `douyin.xingtu.cost_performance_analysis` ✓ 抖音星图·性价比分析。必填:oAuthorId
 
 
-### 小红书 `xiaohongshu`(40 个)
+### 小红书 `xiaohongshu`(29 个)
 
 
+- `xiaohongshu.get_note_detail_v6` ✓ 小红书·笔记详情(V6)。必填:无
+- `xiaohongshu.search_note_v2` ✓ 小红书·笔记搜索。必填:keyword
+- `xiaohongshu.get_user_note_list_v4` ✓ 小红书·用户发布笔记。必填:userId
+- `xiaohongshu.get_note_comment_v2` ✓ 小红书·笔记评论。必填:noteId
 - `xiaohongshu.pgy.creator_search` ✓ 小红书蒲公英·创作者搜索。必填:无
 - `xiaohongshu.pgy.creator_search` ✓ 小红书蒲公英·创作者搜索。必填:无
-- `xiaohongshu.pgy.creator_profile` ✓ 小红书蒲公英·创作者资料。必填:userId
-- `xiaohongshu.get_user_note_list_v1` 小红书·用户发布笔记。必填:userId
-- `xiaohongshu.pgy.creator_note_list` 小红书蒲公英·创作者笔记列表。必填:userId
-- `xiaohongshu.pgy.creator_note_list_pro` 小红书蒲公英·创作者笔记列表 Pro。必填:kolId, adSwitch, orderType
-- `xiaohongshu.pgy.note_details` 小红书蒲公英·笔记详情。必填:noteId
+- `xiaohongshu.search_note_v4` ✓ 小红书·笔记搜索。必填:keyword
 
 
 ### 微信公众号 `weixin`(24 个)
 ### 微信公众号 `weixin`(24 个)
 
 
@@ -224,12 +224,12 @@
 
 
 ### 微信视频号 `weixin_channels`(14 个)
 ### 微信视频号 `weixin_channels`(14 个)
 
 
-- `weixin_channels.search_video_v1` 微信视频号·视频搜索。必填:keyword
-- `weixin_channels.search_video_v2` 微信视频号·视频搜索。必填:keyword
-- `weixin_channels.search_account_v1` 微信视频号·账号搜索。必填:keyword
-- `weixin_channels.search_account_v2` 微信视频号·账号搜索。必填:keyword
-- `weixin_channels.search_account_v3` 微信视频号·账号搜索。必填:keyword
 - `weixin_channels.get_video_comment_v1` 微信视频号·视频评论。必填:objectId
 - `weixin_channels.get_video_comment_v1` 微信视频号·视频评论。必填:objectId
+- `weixin_channels.get_video_sub_comment_v1` 微信视频号·视频子评论。必填:objectId, rootCommentId
+- `weixin_channels.get_video_basic_info_v1` 微信视频号·视频基本信息。必填:feedInfo
+- `weixin_channels.get_video_title_v1` 微信视频号·视频标题。必填:objectId
+- `weixin_channels.convert_export_id_v1` 微信视频号·导出 ID 转换。必填:exportId
+- `weixin_channels.get_video_download_url_v1` 微信视频号·视频下载链接。必填:objectId
 
 
 ### 微博 `weibo`(11 个)
 ### 微博 `weibo`(11 个)
 
 

+ 1 - 1
release/npm发布管理文档/NPM技能包发布管理.md

@@ -25,7 +25,7 @@
 
 
 | 技能包 | npm 包名 | 当前版本 | 状态 | 本地目录 | npm 链接 |
 | 技能包 | npm 包名 | 当前版本 | 状态 | 本地目录 | npm 链接 |
 |---|---|---:|---|---|---|
 |---|---|---:|---|---|---|
-| Claude Code VOC Intelligence | `@vocmarket/voc-skill` | `0.3.45` | 已发布;结构整理与瘦身:检索工具不再返回整份目录、支持中文问法,调用结果落盘并限制内联体积,新增平台索引 `references/platforms.md`,实测并清理失效接口(目录 1.8.0),内部报告不再随包发布;registry `latest=0.3.45`,shasum `fc703ccc41a4118a823d397e9ec497dc46cc65d9` | `claude-code/claude-code-voc-intelligence/` | https://www.npmjs.com/package/@vocmarket/voc-skill |
+| Claude Code VOC Intelligence | `@vocmarket/voc-skill` | `0.3.46` | 已发布;接口目录 1.9.0:新增首选关系,微信 18 个、星图 19 个、小红书 12 个接口调整推荐顺序,微信与小红书链路实测走通;registry `latest=0.3.46`,shasum `8d7d5b85575ac349469f7c75eedf60c3fce39a4f` | `claude-code/claude-code-voc-intelligence/` | https://www.npmjs.com/package/@vocmarket/voc-skill |
 | 提号 SOP 博主名单 | `@vocmarket/tihao` | `1.0.19` | 已发布 | `E:\workspace\tihao-ai\claude-code-tihao-sourcing\` | https://www.npmjs.com/package/@vocmarket/tihao |
 | 提号 SOP 博主名单 | `@vocmarket/tihao` | `1.0.19` | 已发布 | `E:\workspace\tihao-ai\claude-code-tihao-sourcing\` | https://www.npmjs.com/package/@vocmarket/tihao |
 | fmode 视觉分析 | `fmode-vision` | `0.1.1` | 已发布 | `claude-code/fmode-vision/`(如有) | https://www.npmjs.com/package/fmode-vision |
 | fmode 视觉分析 | `fmode-vision` | `0.1.1` | 已发布 | `claude-code/fmode-vision/`(如有) | https://www.npmjs.com/package/fmode-vision |
 | fmode 音视频处理 | `fmode-ffmpeg` | `0.1.1` | 已发布 | `claude-code/fmode-ffmpeg/` | https://www.npmjs.com/package/fmode-ffmpeg |
 | fmode 音视频处理 | `fmode-ffmpeg` | `0.1.1` | 已发布 | `claude-code/fmode-ffmpeg/` | https://www.npmjs.com/package/fmode-ffmpeg |

+ 13 - 0
release/npm发布管理文档/变更记录/voc-skill.md

@@ -3,6 +3,19 @@
 > 当前版本号见 [`../NPM技能包发布管理.md`](../NPM技能包发布管理.md) 的「发布状态总览」。本文按版本号倒序记录每次更新的简要内容。
 > 当前版本号见 [`../NPM技能包发布管理.md`](../NPM技能包发布管理.md) 的「发布状态总览」。本文按版本号倒序记录每次更新的简要内容。
 > 本地目录:`claude-code/claude-code-voc-intelligence/`。
 > 本地目录:`claude-code/claude-code-voc-intelligence/`。
 
 
+## 0.3.46(2026-11-13)
+
+接口目录 1.9.0:把同类接口里的首选关系写进目录,让 Agent 在检索、读参数、调用时都能看到建议;同时清理失效版本号。
+
+- **新增目录字段 `preferred` / `preferredNote`**,表示「这个接口能用,但同类任务有更合适的入口」。检索结果里有首选的接口排到同类首选之后,行尾标「→ 同类首选 `某接口`」;`voc_api_doc` 和成功调用后的回复也会给出同样的建议。首选接口连续失败时,Agent 会用同类其它接口兜底。
+- **微信**:18 个电商通道接口标首选,指向社媒通道的 `wechat_search.v2.fetch_search`(`business_type` 取 account / article / video)、`wechat_search.v2.fetch_search_videos`、`wechat_mp.v2.fetch_account_profile` 等。链路实测走通:搜账号(拿 `gh_` / `v2_` 开头的 userName)→ 视频号资料 / 作品列表 → 公众号资料 / 文章列表 → 文章正文 / 互动数据。
+- **小红书**:12 个旧版本号下架并指向现行版本(详情 → `get_note_detail_v1` / `v6`、评论 → `get_note_comment_v2`、主页 → `get_user_note_list_v4`、用户 → `get_user_v3`、搜索 → `search_note_v2`),新登记 `xiaohongshu.get_note_detail_v6`。现行 7 个版本各测 2 次全部成功。
+- **抖音星图**:19 个重复接口标首选,指向另一组(`creator_search` / `creator_profile` / `audience_distribution` 等),16 个目标接口逐个实测通过。
+- **文档**:`voc-api-catalog/SKILL.md` 新增「同一类数据有多个接口时」和「微信」两节,写清选择顺序、微信从搜索到详情的完整链路、以及 `exportId` 会过期等约束。文案只说明接口能力和实测结论,不涉及上游与成本。
+- **平台索引**:`references/platforms.md` 重新生成(目录 1.9.0,1272 个在售接口)。
+- 验证:`smoke:catalog`(含「文档点名的接口必须存在且在售」)、`mcp:smoke`、`smoke:package`、`smoke:cross-industry`、`smoke:request`、`smoke:media`、`smoke:cost`、`smoke:cost-calibration`、`smoke:budget`、`smoke:trend-budget`、`audit:index`、`acceptance` 全部通过;pack + 三种安装 smoke 通过;从 registry 安装后用 MCP 客户端验证检索排序、首选提示和已下架接口的替代提示。
+- 正式发布:registry `latest=0.3.46`,shasum `8d7d5b85575ac349469f7c75eedf60c3fce39a4f`。`fmode-skills` 已手动同步到 0.3.46(从已发布包生成 dist,未跑全量 build)。
+
 ## 0.3.45(2026-11-10)
 ## 0.3.45(2026-11-10)
 
 
 结构整理 + 接口实测 + 瘦身。目标:Agent 下载后第一眼就能找到接口索引,查接口、调接口的过程不撑爆上下文。
 结构整理 + 接口实测 + 瘦身。目标:Agent 下载后第一眼就能找到接口索引,查接口、调接口的过程不撑爆上下文。