@vocmarket/voc-skill 0.3.36 → 0.3.38

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
-{
-  "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.36",
-  "author": {
-    "name": "nkkj-BrainHack"
-  }
-}
+{
+  "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.",
+  "version": "0.3.38",
+  "author": {
+    "name": "nkkj-BrainHack"
+  }
+}

package/SKILL.md

@@ -20,6 +20,7 @@ description: 面向经营者的 VOC 用户经营洞察工作台。从社交媒
 
 ## 主要能力
 
+- 小红书、抖音和微信视频号等内容平台情报；视频号支持分享短链（`weixin.qq.com/sph/...`）解析、作品详情、评论和原片采集，与抖音/小红书一样先查清单再调用。
 - 小红书和抖音趋势情报，支持样例与小规模真实采集。
 - VOC 问题池、单点问题深挖、竞品图谱和 7 天内容计划。
 - 基于用户声音的口播脚本共创、修改和定稿。

package/docs/voc-cost-metering-and-balance-implementation-spec.md

@@ -2430,3 +2430,19 @@ Studio 已有 `/balance`、Token 免登录、NewAPI 余额、支付二维码、
 1. `nova-server` 实际宿主加载撤销版本后的生产支付到账、Balance 刷新和 checkpoint 续跑，仍需后端发布与账户级小额支付回归。
 2. 跨会话自动唤醒仍需 Agent runtime/callback/持久任务队列提供执行租约和支付事件唤醒；技能包继续提供 checkpoint、`usageTraceId` 和恢复参数，不在本包伪造后台执行能力。
 3. 更多采集入口的媒体覆盖依赖各入口把原始响应交给统一本地媒体流水线；当前通用 `voc_api_call`、小红书、抖音入口已覆盖，新增入口按同一契约接入。
+
+### 21.35 2026-09-06 技能包 0.3.36 发布闭环
+
+`@vocmarket/voc-skill@0.3.36` 已正式发布并完成线上指定版本验收。本版本包含历史批处理报价适配、预计/实际成本校准以及显式通道计费模型映射修复；充值仍沿用 Token 免登录 Balance 链接或 Agent 生成二维码，任务执行仍按每次实际 NewAPI 调用扣费，媒体仍只写本地任务目录。
+
+| 检查项 | 结果 | 证据/结论 |
+| --- | --- | --- |
+| npm registry 版本 | 通过 | `npm view @vocmarket/voc-skill@0.3.36 version --registry=https://registry.npmjs.org/` 返回 `0.3.36`。 |
+| 指定版本线上安装 | 通过 | `npm exec --yes --package @vocmarket/voc-skill@0.3.36 -- claude-voc workspace --smoke` 完成临时目录安装、样例、MCP 和 workspace 检查。 |
+| 当前源码验收 | 通过 | `npm --prefix claude-code/claude-code-voc-intelligence run acceptance` 通过，覆盖包级 smoke、MCP、安装器和成本校准。 |
+| 索引结构审计 | 通过 | `npm --prefix claude-code/claude-code-voc-intelligence run audit:index` 返回 `issues=[]`，11 个 Skill、19 个 MCP 工具；仅提示需由发布构建排除的本地 catalog 备份文件。 |
+| 发布产物元数据 | 通过 | `dist/npm/claude-code-voc-npm-package-manifest.json` 的版本为 `0.3.36`，`published=true`、`tested=true`、`npxTested=true`、`workspaceTested=true`。 |
+
+#### 技能包交付结论
+
+技能包已达到可发布和可安装使用的状态。P1 的报价、用量报告、接口频次/额度拆分、成本校准、余额不足充值引导、本地媒体缓存和索引审计均已在包内闭环。生产侧仍需由后端团队独立完成实际应用宿主的版本发布，以及使用余额正常测试账户完成原有支付回调、NewAPI 到账、Balance 刷新和 checkpoint 续跑回归；这些不阻塞 npm 技能包发布，但属于整体生产闭环的外部门禁。

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

@@ -231,17 +231,49 @@ function normalizeComment(raw, noteId, keyword) {
   };
 }
 
+function flattenSearchItem(item) {
+  if (!item || typeof item !== 'object') return null;
+  if (item.note) return item.note;
+  if (item.note_card) {
+    const interact = item.note_card.interact_info || {};
+    return {
+      id: item.id || item.note_id || item.note_card.note_id,
+      note_id: item.id || item.note_id || item.note_card.note_id,
+      title: item.note_card.display_title || item.note_card.title || '',
+      desc: item.note_card.desc || item.note_card.display_title || '',
+      type: item.note_card.type || item.model_type || '',
+      user: item.note_card.user || {},
+      liked_count: interact.liked_count,
+      collected_count: interact.collected_count,
+      comments_count: interact.comment_count || interact.comments_count,
+      shared_count: interact.share_count || interact.shared_count,
+      cover: item.note_card.cover,
+      xsec_token: item.xsec_token || item.note_card.xsec_token || '',
+      note_card: item.note_card,
+      share_info: item.note_card.share_info,
+      mini_program_info: item.note_card.mini_program_info
+    };
+  }
+  return item;
+}
+
 function extractSearchNotes(data) {
   const items = data.items || data.note_list || data.notes || [];
   if (!Array.isArray(items)) return [];
   return items
-    .map(item => item.note || item)
+    .map(flattenSearchItem)
     .filter(note => note && (note.id || note.note_id));
 }
 
 function extractDetailNote(data) {
-  const list = data.note_list || data.notes || [];
-  return Array.isArray(list) && list[0] ? list[0] : data.note || data;
+  if (Array.isArray(data) && data[0]) {
+    const first = data[0];
+    const nested = first.note_list || first.notes || [];
+    if (Array.isArray(nested) && nested[0]) return nested[0];
+    return first.note || first;
+  }
+  const list = data && (data.note_list || data.notes) || [];
+  return Array.isArray(list) && list[0] ? list[0] : (data && data.note) || data;
 }
 
 function extractComments(data) {
@@ -301,7 +333,10 @@ async function collectLiveDataset({ profile, token, fallbackToken, options = {}
       for (const rawNote of rawNotes) {
         let note = rawNote;
         try {
-          const detail = await api.getNoteDetail({ noteId: rawNote.id });
+          const detail = await api.getNoteDetail({
+            noteId: rawNote.id,
+            noteType: rawNote.type
+          });
           note = normalizeNote(rawNote, keyword, extractDetailNote(detail.data));
         } catch (error) {
           warnings.push({
@@ -318,7 +353,11 @@ async function collectLiveDataset({ profile, token, fallbackToken, options = {}
         let cursor = '';
         for (let page = 0; page < maxCommentPages; page++) {
           try {
-            const commentResult = await api.getNoteComments({ noteId: note.id, cursor });
+            const commentResult = await api.getNoteComments({
+              noteId: note.id,
+              cursor,
+              xsecToken: rawNote.xsec_token || note.xsec_token || ''
+            });
             extractComments(commentResult.data).forEach(rawComment => {
               comments.push(normalizeComment(rawComment, note.id, keyword));
             });
@@ -363,5 +402,7 @@ module.exports = {
   normalizeNote,
   pickWebUrl,
   extractImageUrls,
+  extractSearchNotes,
+  extractDetailNote,
   hasXsecToken
 };

package/mcp/src/providers/xiaohongshu-api.js

@@ -1,21 +1,89 @@
 const { callSocialGateway } = require('./voc-gateway');
 
 const VOC_SOCIAL_API_ROOT = 'https://server.fmode.cn/api/voc-social';
-const XIAOHONGSHU_APP_BASE_URL = `${VOC_SOCIAL_API_ROOT}/xiaohongshu/app`;
+const XIAOHONGSHU_API_ROOT = `${VOC_SOCIAL_API_ROOT}/xiaohongshu`;
+const XIAOHONGSHU_APP_BASE_URL = `${XIAOHONGSHU_API_ROOT}/app`;
+
+const SEARCH_APP_V2_PATH = 'app_v2/search_notes';
+const SEARCH_WEB_V3_PATH = 'web_v3/fetch_search_notes';
+const DETAIL_IMAGE_PATH = 'app_v2/get_image_note_detail';
+const DETAIL_VIDEO_PATH = 'app_v2/get_video_note_detail';
+const DETAIL_APP_FALLBACK_PATH = 'app/get_note_info';
+const COMMENTS_PATH = 'app_v2/get_note_comments';
+
+function normalizeXiaohongshuBaseUrl(baseUrl) {
+  const value = String(baseUrl || XIAOHONGSHU_API_ROOT).replace(/\/$/, '');
+  return value.replace(/\/(app_v2|app|web_v3|web_v2|web)$/i, '').replace(/\/$/, '') || XIAOHONGSHU_API_ROOT;
+}
+
+function isRetryableUpstream(error) {
+  if (!error) return false;
+  if (error.kind === 'upstream') return true;
+  const status = Number(error.httpStatus || 0);
+  return status === 0 || status >= 500 || status === 301;
+}
+
+function mapSortType(sort) {
+  const value = String(sort || 'popularity_descending').trim();
+  if (!value || value === '_0') return 'popularity_descending';
+  if (value === 'time_desc') return 'time_descending';
+  if (value === 'popularity') return 'popularity_descending';
+  return value;
+}
+
+function mapAppV2NoteType(noteType) {
+  const value = String(noteType == null ? '_0' : noteType).trim();
+  if (value === '_0' || value === '0' || value === '不限' || value === '') return '不限';
+  if (value === '_1' || value === '1' || value === '视频' || value === '视频笔记') return '视频笔记';
+  if (value === '_2' || value === '2' || value === '图文' || value === '普通笔记' || value === 'normal') return '普通笔记';
+  if (value === '直播' || value === '直播笔记') return '直播笔记';
+  return value;
+}
+
+function mapWebV3NoteType(noteType) {
+  const value = String(noteType == null ? '_0' : noteType).trim();
+  if (value === '_1' || value === '1' || value === '视频' || value === '视频笔记' || value === 'video') return 1;
+  if (value === '_2' || value === '2' || value === '图文' || value === '普通笔记' || value === 'normal') return 2;
+  return 0;
+}
+
+function extractSearchItems(data) {
+  if (!data || typeof data !== 'object') return [];
+  const candidates = [data.items, data.note_list, data.notes, data.data && data.data.items];
+  for (const list of candidates) {
+    if (Array.isArray(list)) return list;
+  }
+  return [];
+}
+
+function hasNotePayload(data) {
+  if (!data) return false;
+  if (Array.isArray(data)) return data.some(item => hasNotePayload(item));
+  if (Array.isArray(data.note_list) && data.note_list.length) return true;
+  if (Array.isArray(data.notes) && data.notes.length) return true;
+  if (data.note && (data.note.id || data.note.note_id)) return true;
+  return Boolean(data.id || data.note_id);
+}
 
 class XiaohongshuApi {
   constructor(options = {}) {
-    this.baseUrl = options.baseUrl || process.env.XIAOHONGSHU_API_BASE_URL || XIAOHONGSHU_APP_BASE_URL;
+    this.baseUrl = normalizeXiaohongshuBaseUrl(
+      options.baseUrl ||
+      process.env.XIAOHONGSHU_API_BASE_URL ||
+      process.env.VOC_XIAOHONGSHU_API_BASE_URL ||
+      XIAOHONGSHU_API_ROOT
+    );
     this.token = options.token;
     this.fallbackToken = options.fallbackToken || '';
     this.headers = options.headers || {};
   }
 
-  request(proxyPath, query) {
+  request(proxyPath, { method = 'GET', query = {}, body } = {}) {
     return callSocialGateway({
       proxyPath,
-      method: 'GET',
+      method,
       query,
+      body,
       token: this.token,
       fallbackToken: this.fallbackToken,
       baseUrl: this.baseUrl,
@@ -23,26 +91,125 @@ class XiaohongshuApi {
     });
   }
 
-  searchNotes({ keyword, page = 1, sort = 'popularity_descending', noteType = '_0' }) {
-    return this.request('search_notes', {
-      keyword,
-      page,
-      sort,
-      note_type: noteType
-    });
+  async searchNotes({
+    keyword,
+    page = 1,
+    sort = 'popularity_descending',
+    noteType = '_0',
+    searchId = '',
+    sessionId = ''
+  }) {
+    const sortType = mapSortType(sort);
+    let firstError;
+
+    try {
+      const result = await this.request(SEARCH_APP_V2_PATH, {
+        query: {
+          keyword,
+          page,
+          sort_type: sortType,
+          note_type: mapAppV2NoteType(noteType),
+          search_id: searchId,
+          search_session_id: sessionId
+        }
+      });
+      if (extractSearchItems(result.data).length > 0) {
+        return {
+          ...result,
+          endpoint: SEARCH_APP_V2_PATH,
+          fallbackUsedForEndpoint: false
+        };
+      }
+    } catch (error) {
+      if (!isRetryableUpstream(error)) throw error;
+      firstError = error;
+    }
+
+    try {
+      const result = await this.request(SEARCH_WEB_V3_PATH, {
+        query: {
+          keyword,
+          page,
+          sort: sortType,
+          note_type: mapWebV3NoteType(noteType)
+        }
+      });
+      return {
+        ...result,
+        endpoint: SEARCH_WEB_V3_PATH,
+        fallbackUsedForEndpoint: true
+      };
+    } catch (error) {
+      throw firstError || error;
+    }
   }
 
-  getNoteDetail({ noteId }) {
-    return this.request('get_note_info', { note_id: noteId });
+  async getNoteDetail({ noteId, noteType = '', shareText = '' }) {
+    const query = {
+      note_id: noteId,
+      share_text: shareText
+    };
+    const preferred = /video/i.test(String(noteType || ''))
+      ? [DETAIL_VIDEO_PATH, DETAIL_IMAGE_PATH]
+      : [DETAIL_IMAGE_PATH, DETAIL_VIDEO_PATH];
+
+    let lastError;
+    for (const proxyPath of preferred) {
+      try {
+        const result = await this.request(proxyPath, { query });
+        if (hasNotePayload(result.data)) {
+          return {
+            ...result,
+            endpoint: proxyPath,
+            fallbackUsedForEndpoint: false
+          };
+        }
+      } catch (error) {
+        if (!isRetryableUpstream(error)) throw error;
+        lastError = error;
+      }
+    }
+
+    try {
+      const result = await this.request(DETAIL_APP_FALLBACK_PATH, {
+        query: {
+          note_id: noteId,
+          share_text: shareText
+        }
+      });
+      return {
+        ...result,
+        endpoint: DETAIL_APP_FALLBACK_PATH,
+        fallbackUsedForEndpoint: true
+      };
+    } catch (error) {
+      throw lastError || error;
+    }
   }
 
-  getNoteComments({ noteId, cursor = '' }) {
-    return this.request('get_note_comments', { note_id: noteId, cursor });
+  getNoteComments({ noteId, cursor = '', shareText = '', xsecToken = '' }) {
+    return this.request(COMMENTS_PATH, {
+      query: {
+        note_id: noteId,
+        cursor,
+        share_text: shareText,
+        xsec_token: xsecToken
+      }
+    });
   }
 }
 
 module.exports = {
   VOC_SOCIAL_API_ROOT,
+  XIAOHONGSHU_API_ROOT,
   XIAOHONGSHU_APP_BASE_URL,
+  SEARCH_APP_V2_PATH,
+  SEARCH_WEB_V3_PATH,
+  DETAIL_IMAGE_PATH,
+  DETAIL_VIDEO_PATH,
+  COMMENTS_PATH,
+  normalizeXiaohongshuBaseUrl,
+  extractSearchItems,
+  hasNotePayload,
   XiaohongshuApi
 };

package/mcp/src/server.js

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

package/package.json

@@ -1,80 +1,80 @@
-{
-  "name": "@vocmarket/voc-skill",
-  "version": "0.3.36",
-  "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": {
-    "claude-voc": "bin/claude-voc.js"
-  },
-  "scripts": {
-    "install:check": "node install.js --check",
-    "install:smoke": "node install.js --smoke",
-    "smoke:package": "node scripts/smoke-package.js",
-    "smoke:cross-industry": "node scripts/smoke-cross-industry.js",
-    "fmode:image": "node mcp/src/tools/fmode-image-analysis.js",
-    "fmode:image:smoke": "node scripts/fmode-image-analysis-smoke.js",
-    "smoke:billing": "node scripts/billing-client-smoke.js",
-    "smoke:budget": "node scripts/smoke-budget-guard.js",
-    "smoke:trend-budget": "node scripts/smoke-trend-budget.js",
-    "smoke:cost": "node scripts/smoke-cost-estimate.js",
-    "smoke:cost-calibration": "node scripts/smoke-cost-calibration.js",
-    "smoke:media": "node scripts/smoke-media-pipeline.js",
-    "smoke:request": "node scripts/smoke-voc-request-shaping.js",
-    "audit:index": "node scripts/audit-index.js",
-    "xhs:sample": "node mcp/src/tools/xiaohongshu-trend-run.js --collection-mode sample --profile memory-templates/xiaohongshu-trend-profile.json --output ../outputs/claude-code-xhs-sample --result-prefix XHS_TREND_RESULT",
-    "xhs:preference-smoke": "node mcp/src/tools/xiaohongshu-preference-update.js --message \"保留奶油风和全屋定制翻车方向，不要纯风格美图，下一个版本更偏门店转化话术。\" --memory ../outputs/claude-code-xhs-memory-smoke/xiaohongshu-trend-memory.json --result-prefix XHS_PREF_RESULT",
-    "xhs:sample-with-memory": "node mcp/src/tools/xiaohongshu-trend-run.js --collection-mode sample --profile memory-templates/xiaohongshu-trend-profile.json --memory ../outputs/claude-code-xhs-memory-smoke/xiaohongshu-trend-memory.json --output ../outputs/claude-code-xhs-memory-smoke/report --result-prefix XHS_TREND_RESULT",
-    "xhs:live": "node mcp/src/tools/xiaohongshu-trend-run.js --collection-mode live --profile memory-templates/xiaohongshu-trend-profile.json --output ../outputs/claude-code-xhs-live --keyword-limit 1 --notes-per-keyword 1 --max-comment-pages 1 --result-prefix XHS_TREND_RESULT",
-    "dy:sample": "node mcp/src/tools/douyin-trend-run.js --collection-mode sample --profile memory-templates/douyin-trend-profile.json --output ../outputs/claude-code-douyin-sample --result-prefix DOUYIN_TREND_RESULT",
-    "dy:preference-smoke": "node mcp/src/tools/douyin-preference-update.js --message \"保留口播开头和评论区问题，不要只做纯素材剪辑，下一个版本更偏门店转化话术。\" --memory ../outputs/claude-code-douyin-memory-smoke/douyin-trend-memory.json --result-prefix DOUYIN_PREF_RESULT",
-    "dy:sample-with-memory": "node mcp/src/tools/douyin-trend-run.js --collection-mode sample --profile memory-templates/douyin-trend-profile.json --memory ../outputs/claude-code-douyin-memory-smoke/douyin-trend-memory.json --output ../outputs/claude-code-douyin-memory-smoke/report --result-prefix DOUYIN_TREND_RESULT",
-    "dy:live": "node mcp/src/tools/douyin-trend-run.js --collection-mode live --profile memory-templates/douyin-trend-profile.json --output ../outputs/claude-code-douyin-live --keyword-limit 1 --videos-per-keyword 1 --max-comment-pages 1 --result-prefix DOUYIN_TREND_RESULT",
-    "voc:issue-pool": "node mcp/src/tools/voc-issue-pool-run.js --project 示例品牌A --industry 家居定制 --scenario 线上获客 --audience 意向用户 --evidence \"第一次买不知道怎么选，怕踩雷。;价格有点高，不确定值不值。;咨询的时候没人理。\" --assistant-message-only",
-    "voc:deep-dive": "node mcp/src/tools/voc-problem-deep-dive-run.js --issue 怎么选 --industry 家居定制 --scenario 线上获客 --audience 意向用户 --assistant-message-only",
-    "voc:content-plan": "node mcp/src/tools/voc-content-plan-run.js --brand 示例品牌A --industry 家居定制 --issues \"第一次买怕踩雷;觉得价格贵;怕质量不稳定\" --assistant-message-only",
-    "voc:speaking-script": "node mcp/src/tools/voc-speaking-script-run.js --brand 示例品牌A --industry 家居定制 --topic \"第一次买怎么选不踩雷\" --user-issue \"第一次买怕选错\" --evidence \"第一次买不知道怎么选，怕踩雷\" --assistant-message-only",
-    "voc:competitor-map": "node mcp/src/tools/voc-competitor-map-run.js --brand 示例品牌A --city 本地 --category 家居定制 --assistant-message-only",
-    "voc:business-workflow": "node mcp/src/tools/voc-business-workflow-run.js --brand 示例品牌A --industry 家居定制 --platform douyin --collection-mode sample --keywords \"家居定制怎么选,第一次买怎么对比,售后\" --assistant-message-only",
-    "mcp:start": "node mcp/src/server.js",
-    "mcp:smoke": "node scripts/smoke-mcp.js",
-    "acceptance": "node scripts/acceptance.js",
-    "acceptance:installer": "node scripts/installer-acceptance.js"
-  },
-  "files": [
-    "SKILL.md",
-    ".claude-plugin/",
-    ".mcp.json",
-    "bin/",
-    "docs/",
-    "install.js",
-    "mcp/src/",
-    "mcp/catalog/params/",
-    "mcp/catalog/voc-social-endpoints.json",
-    "memory-templates/",
-    "package.json",
-    "README.md",
-    "scripts/",
-    "skill-package-manifest.json",
-    "skills/"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "claude-code",
-    "voc",
-    "voice-of-customer",
-    "xiaohongshu",
-    "douyin",
-    "trend-intelligence",
-    "customer-insights",
-    "mcp",
-    "openclaw",
-    "social-listening"
-  ],
-  "homepage": "https://www.npmjs.com/package/@vocmarket/voc-skill",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "zod": "^4.4.3"
-  }
-}
+{
+  "name": "@vocmarket/voc-skill",
+  "version": "0.3.38",
+  "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",
+  "bin": {
+    "claude-voc": "bin/claude-voc.js"
+  },
+  "scripts": {
+    "install:check": "node install.js --check",
+    "install:smoke": "node install.js --smoke",
+    "smoke:package": "node scripts/smoke-package.js",
+    "smoke:cross-industry": "node scripts/smoke-cross-industry.js",
+    "fmode:image": "node mcp/src/tools/fmode-image-analysis.js",
+    "fmode:image:smoke": "node scripts/fmode-image-analysis-smoke.js",
+    "smoke:billing": "node scripts/billing-client-smoke.js",
+    "smoke:budget": "node scripts/smoke-budget-guard.js",
+    "smoke:trend-budget": "node scripts/smoke-trend-budget.js",
+    "smoke:cost": "node scripts/smoke-cost-estimate.js",
+    "smoke:cost-calibration": "node scripts/smoke-cost-calibration.js",
+    "smoke:media": "node scripts/smoke-media-pipeline.js",
+    "smoke:request": "node scripts/smoke-voc-request-shaping.js",
+    "audit:index": "node scripts/audit-index.js",
+    "xhs:sample": "node mcp/src/tools/xiaohongshu-trend-run.js --collection-mode sample --profile memory-templates/xiaohongshu-trend-profile.json --output ../outputs/claude-code-xhs-sample --result-prefix XHS_TREND_RESULT",
+    "xhs:preference-smoke": "node mcp/src/tools/xiaohongshu-preference-update.js --message \"保留奶油风和全屋定制翻车方向，不要纯风格美图，下一个版本更偏门店转化话术。\" --memory ../outputs/claude-code-xhs-memory-smoke/xiaohongshu-trend-memory.json --result-prefix XHS_PREF_RESULT",
+    "xhs:sample-with-memory": "node mcp/src/tools/xiaohongshu-trend-run.js --collection-mode sample --profile memory-templates/xiaohongshu-trend-profile.json --memory ../outputs/claude-code-xhs-memory-smoke/xiaohongshu-trend-memory.json --output ../outputs/claude-code-xhs-memory-smoke/report --result-prefix XHS_TREND_RESULT",
+    "xhs:live": "node mcp/src/tools/xiaohongshu-trend-run.js --collection-mode live --profile memory-templates/xiaohongshu-trend-profile.json --output ../outputs/claude-code-xhs-live --keyword-limit 1 --notes-per-keyword 1 --max-comment-pages 1 --result-prefix XHS_TREND_RESULT",
+    "dy:sample": "node mcp/src/tools/douyin-trend-run.js --collection-mode sample --profile memory-templates/douyin-trend-profile.json --output ../outputs/claude-code-douyin-sample --result-prefix DOUYIN_TREND_RESULT",
+    "dy:preference-smoke": "node mcp/src/tools/douyin-preference-update.js --message \"保留口播开头和评论区问题，不要只做纯素材剪辑，下一个版本更偏门店转化话术。\" --memory ../outputs/claude-code-douyin-memory-smoke/douyin-trend-memory.json --result-prefix DOUYIN_PREF_RESULT",
+    "dy:sample-with-memory": "node mcp/src/tools/douyin-trend-run.js --collection-mode sample --profile memory-templates/douyin-trend-profile.json --memory ../outputs/claude-code-douyin-memory-smoke/douyin-trend-memory.json --output ../outputs/claude-code-douyin-memory-smoke/report --result-prefix DOUYIN_TREND_RESULT",
+    "dy:live": "node mcp/src/tools/douyin-trend-run.js --collection-mode live --profile memory-templates/douyin-trend-profile.json --output ../outputs/claude-code-douyin-live --keyword-limit 1 --videos-per-keyword 1 --max-comment-pages 1 --result-prefix DOUYIN_TREND_RESULT",
+    "voc:issue-pool": "node mcp/src/tools/voc-issue-pool-run.js --project 示例品牌A --industry 家居定制 --scenario 线上获客 --audience 意向用户 --evidence \"第一次买不知道怎么选，怕踩雷。;价格有点高，不确定值不值。;咨询的时候没人理。\" --assistant-message-only",
+    "voc:deep-dive": "node mcp/src/tools/voc-problem-deep-dive-run.js --issue 怎么选 --industry 家居定制 --scenario 线上获客 --audience 意向用户 --assistant-message-only",
+    "voc:content-plan": "node mcp/src/tools/voc-content-plan-run.js --brand 示例品牌A --industry 家居定制 --issues \"第一次买怕踩雷;觉得价格贵;怕质量不稳定\" --assistant-message-only",
+    "voc:speaking-script": "node mcp/src/tools/voc-speaking-script-run.js --brand 示例品牌A --industry 家居定制 --topic \"第一次买怎么选不踩雷\" --user-issue \"第一次买怕选错\" --evidence \"第一次买不知道怎么选，怕踩雷\" --assistant-message-only",
+    "voc:competitor-map": "node mcp/src/tools/voc-competitor-map-run.js --brand 示例品牌A --city 本地 --category 家居定制 --assistant-message-only",
+    "voc:business-workflow": "node mcp/src/tools/voc-business-workflow-run.js --brand 示例品牌A --industry 家居定制 --platform douyin --collection-mode sample --keywords \"家居定制怎么选,第一次买怎么对比,售后\" --assistant-message-only",
+    "mcp:start": "node mcp/src/server.js",
+    "mcp:smoke": "node scripts/smoke-mcp.js",
+    "acceptance": "node scripts/acceptance.js",
+    "acceptance:installer": "node scripts/installer-acceptance.js"
+  },
+  "files": [
+    "SKILL.md",
+    ".claude-plugin/",
+    ".mcp.json",
+    "bin/",
+    "docs/",
+    "install.js",
+    "mcp/src/",
+    "mcp/catalog/params/",
+    "mcp/catalog/voc-social-endpoints.json",
+    "memory-templates/",
+    "package.json",
+    "README.md",
+    "scripts/",
+    "skill-package-manifest.json",
+    "skills/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "claude-code",
+    "voc",
+    "voice-of-customer",
+    "xiaohongshu",
+    "douyin",
+    "trend-intelligence",
+    "customer-insights",
+    "mcp",
+    "openclaw",
+    "social-listening"
+  ],
+  "homepage": "https://www.npmjs.com/package/@vocmarket/voc-skill",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  }
+}

package/scripts/smoke-package.js

@@ -515,7 +515,7 @@ async function smokeBusinessStatusErrors() {
     global.fetch = makeBusinessErrorFetch();
     await new XiaohongshuApi({
       token: 'r:smoke-token',
-      baseUrl: 'https://example.test/xiaohongshu/app'
+      baseUrl: 'https://example.test/xiaohongshu'
     }).searchNotes({ keyword: 'smoke' });
     throw new Error('xiaohongshu business status 403 did not throw');
   } catch (error) {

package/skill-package-manifest.json

@@ -1,137 +1,137 @@
-{
-  "name": "claude-code-voc-intelligence",
-  "version": "0.3.36",
-  "capabilities": {
-    "summary": "三类情报源同源接入：①社媒内容 ②国内电商+创作者情报 ③海外选品。统一 search→doc→call、鉴权计费一致。",
-    "channels": [
-      {
-        "key": "social",
-        "label": "社媒内容",
-        "platforms": 18,
-        "apis": 1018,
-        "examples": [
-          "抖音",
-          "小红书",
-          "TikTok",
-          "YouTube",
-          "微博",
-          "哔哩哔哩",
-          "快手",
-          "知乎",
-          "Instagram",
-          "Reddit",
-          "Twitter/X",
-          "微信/视频号"
-        ]
-      },
-      {
-        "key": "ecommerce",
-        "label": "国内电商 + 创作者情报",
-        "platforms": 32,
-        "apis": 289,
-        "examples": [
-          "京东",
-          "淘宝天猫",
-          "1688",
-          "抖音电商",
-          "TikTok Shop",
-          "闲鱼",
-          "得物",
-          "抖音星图",
-          "小红书蒲公英"
-        ]
-      },
-      {
-        "key": "overseas",
-        "label": "海外选品",
-        "platforms": 1,
-        "apis": 37,
-        "examples": [
-          "亚马逊"
-        ]
-      }
-    ],
-    "totals": {
-      "platforms": 51,
-      "apis": 1344
-    }
-  },
-  "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.",
-  "changelogUrl": "https://www.npmjs.com/package/@vocmarket/voc-skill?activeTab=versions",
-  "plugin": "voc-intelligence",
-  "skills": [
-    "xiaohongshu-trend-intelligence",
-    "douyin-trend-intelligence",
-    "voc-issue-pool",
-    "voc-problem-deep-dive",
-    "voc-content-plan",
-    "voc-speaking-script",
-    "voc-competitor-map",
-    "voc-business-workflow",
-    "fmode-image-analysis",
-    "voc-api-catalog",
-    "voc-cost-controller"
-  ],
-  "mcpTools": [
-    "fmode_image_analysis",
-    "voc_business_workflow_run",
-    "voc_speaking_script_run",
-    "voc_issue_pool_run",
-    "voc_problem_deep_dive_run",
-    "voc_content_plan_run",
-    "voc_competitor_map_run",
-    "voc_xiaohongshu_token_check",
-    "voc_xiaohongshu_trend_run",
-    "voc_xiaohongshu_preference_update",
-    "voc_douyin_token_check",
-    "voc_douyin_trend_run",
-    "voc_douyin_preference_update",
-    "voc_api_search",
-    "voc_api_doc",
-    "voc_api_call",
-    "voc_billing_query",
-    "voc_cost_estimate",
-    "voc_usage_report"
-  ],
-  "apiCatalog": "mcp/catalog/voc-social-endpoints.json",
-  "entrySkill": "voc-business-workflow",
-  "capabilityMap": "docs/capability-map.md",
-  "taobaoV7Doc": "docs/taobao-item-detail-v7.md",
-  "bossPromptTemplates": "docs/boss-prompt-templates.md",
-  "liveAcceptanceChecklist": "docs/live-manual-acceptance-checklist.md",
-  "troubleshootingPlaybook": "docs/claude-code-troubleshooting-playbook.md",
-  "paymentLinksDoc": "docs/payment-package-links.md",
-  "contextBudgetDoc": "docs/context-budget-implementation-plan.md",
-  "costMeteringSpec": "docs/voc-cost-metering-and-balance-implementation-spec.md",
-  "apiErrorCodesDoc": "skills/voc-api-catalog/references/error-codes.md",
-  "primaryUseCases": [
-    "First-round Xiaohongshu or Douyin trend intelligence from sample or live collection",
-    "Evidence-first customer concern and opportunity reports",
-    "Prioritized VOC issue pools with status, evidence, impact, and next actions",
-    "Single VOC problem deep dive into boss/operator actions and 7-day validation plans",
-    "7-day VOC content plans with speaking scripts and validation metrics",
-    "VOC-backed speaking script co-creation with revision, finalization, and script memory",
-    "End-to-end VOC business workflow from market voices to issue, action, content, and script",
-    "Competitor maps and differentiated opportunity reports from VOC evidence",
-    "Interface catalog lookup and generic VOC gateway calls across social, ecommerce, and overseas channels",
-    "Preflight cost estimates, balance checks, budget controls, and post-run usage reports",
-    "Fmode Doubao vision image analysis for screenshots, product images, UI captures, charts, posters, and image text",
-    "Multi-turn preference and scoped memory so repeated use gets more tailored",
-    "Friendly token and recharge handling for live collection"
-  ],
-  "recommendedUserPrompts": [
-    "帮我做一份家装全屋定制行业的小红书趋势情报。先用演示样例跑通流程，不要真实采集。",
-    "帮我看下家居定制行业抖音上用户最近在吐槽什么，先小规模真实采集。",
-    "继续深挖“怎么选”这个问题，站在老板视角告诉我怎么解决。",
-    "监听 280 个账号并生成日报，先给我经济版、标准版和完整版的预计成本、余额风险和降本建议。",
-    "查一下这份报告实际调用了哪些接口、各调用多少次、分别消耗了多少额度。"
-  ],
-  "sampleCommand": "npm run xhs:sample",
-  "mcpSmokeCommand": "npm run mcp:smoke",
-  "installCommand": "node install.js",
-  "npmInstallCommand": "npm install -g @vocmarket/voc-skill && claude-voc install",
-  "npxInstallCommand": "npx @vocmarket/voc-skill install",
-  "workspaceInstallCommand": "npx @vocmarket/voc-skill workspace --smoke",
-  "workspaceInstallTarget": ".claude/plugins/voc-intelligence",
-  "installHint": "Supports three delivery modes: unzip and run node install.js, install globally into ~/.claude/plugins/voc-intelligence, or install into the current workspace. Workspace mode writes .mcp.json plus .claude/skills/* entries for trend intelligence, issue pool, deep dive, competitor map, content plan, speaking script, VOC business workflow, Fmode image analysis, API catalog, and cost controller so VSCode Claude Code can discover all workflows without relying only on --plugin-dir."
-}
+{
+  "name": "claude-code-voc-intelligence",
+  "version": "0.3.38",
+  "capabilities": {
+    "summary": "三类情报源同源接入：①社媒内容（含抖音/小红书/微信视频号等）②国内电商+创作者情报 ③海外选品。统一 search→doc→call、鉴权计费一致。",
+    "channels": [
+      {
+        "key": "social",
+        "label": "社媒内容",
+        "platforms": 18,
+        "apis": 1018,
+        "examples": [
+          "抖音",
+          "小红书",
+          "TikTok",
+          "YouTube",
+          "微博",
+          "哔哩哔哩",
+          "快手",
+          "知乎",
+          "Instagram",
+          "Reddit",
+          "Twitter/X",
+          "微信/视频号"
+        ]
+      },
+      {
+        "key": "ecommerce",
+        "label": "国内电商 + 创作者情报",
+        "platforms": 32,
+        "apis": 289,
+        "examples": [
+          "京东",
+          "淘宝天猫",
+          "1688",
+          "抖音电商",
+          "TikTok Shop",
+          "闲鱼",
+          "得物",
+          "抖音星图",
+          "小红书蒲公英"
+        ]
+      },
+      {
+        "key": "overseas",
+        "label": "海外选品",
+        "platforms": 1,
+        "apis": 37,
+        "examples": [
+          "亚马逊"
+        ]
+      }
+    ],
+    "totals": {
+      "platforms": 51,
+      "apis": 1344
+    }
+  },
+  "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.",
+  "changelogUrl": "https://www.npmjs.com/package/@vocmarket/voc-skill?activeTab=versions",
+  "plugin": "voc-intelligence",
+  "skills": [
+    "xiaohongshu-trend-intelligence",
+    "douyin-trend-intelligence",
+    "voc-issue-pool",
+    "voc-problem-deep-dive",
+    "voc-content-plan",
+    "voc-speaking-script",
+    "voc-competitor-map",
+    "voc-business-workflow",
+    "fmode-image-analysis",
+    "voc-api-catalog",
+    "voc-cost-controller"
+  ],
+  "mcpTools": [
+    "fmode_image_analysis",
+    "voc_business_workflow_run",
+    "voc_speaking_script_run",
+    "voc_issue_pool_run",
+    "voc_problem_deep_dive_run",
+    "voc_content_plan_run",
+    "voc_competitor_map_run",
+    "voc_xiaohongshu_token_check",
+    "voc_xiaohongshu_trend_run",
+    "voc_xiaohongshu_preference_update",
+    "voc_douyin_token_check",
+    "voc_douyin_trend_run",
+    "voc_douyin_preference_update",
+    "voc_api_search",
+    "voc_api_doc",
+    "voc_api_call",
+    "voc_billing_query",
+    "voc_cost_estimate",
+    "voc_usage_report"
+  ],
+  "apiCatalog": "mcp/catalog/voc-social-endpoints.json",
+  "entrySkill": "voc-business-workflow",
+  "capabilityMap": "docs/capability-map.md",
+  "taobaoV7Doc": "docs/taobao-item-detail-v7.md",
+  "bossPromptTemplates": "docs/boss-prompt-templates.md",
+  "liveAcceptanceChecklist": "docs/live-manual-acceptance-checklist.md",
+  "troubleshootingPlaybook": "docs/claude-code-troubleshooting-playbook.md",
+  "paymentLinksDoc": "docs/payment-package-links.md",
+  "contextBudgetDoc": "docs/context-budget-implementation-plan.md",
+  "costMeteringSpec": "docs/voc-cost-metering-and-balance-implementation-spec.md",
+  "apiErrorCodesDoc": "skills/voc-api-catalog/references/error-codes.md",
+  "primaryUseCases": [
+    "First-round Xiaohongshu or Douyin trend intelligence from sample or live collection",
+    "Evidence-first customer concern and opportunity reports",
+    "Prioritized VOC issue pools with status, evidence, impact, and next actions",
+    "Single VOC problem deep dive into boss/operator actions and 7-day validation plans",
+    "7-day VOC content plans with speaking scripts and validation metrics",
+    "VOC-backed speaking script co-creation with revision, finalization, and script memory",
+    "End-to-end VOC business workflow from market voices to issue, action, content, and script",
+    "Competitor maps and differentiated opportunity reports from VOC evidence",
+    "Interface catalog lookup and generic VOC gateway calls across social, ecommerce, and overseas channels",
+    "Preflight cost estimates, balance checks, budget controls, and post-run usage reports",
+    "Fmode Doubao vision image analysis for screenshots, product images, UI captures, charts, posters, and image text",
+    "Multi-turn preference and scoped memory so repeated use gets more tailored",
+    "Friendly token and recharge handling for live collection"
+  ],
+  "recommendedUserPrompts": [
+    "帮我做一份家装全屋定制行业的小红书趋势情报。先用演示样例跑通流程，不要真实采集。",
+    "帮我看下家居定制行业抖音上用户最近在吐槽什么，先小规模真实采集。",
+    "继续深挖“怎么选”这个问题，站在老板视角告诉我怎么解决。",
+    "监听 280 个账号并生成日报，先给我经济版、标准版和完整版的预计成本、余额风险和降本建议。",
+    "查一下这份报告实际调用了哪些接口、各调用多少次、分别消耗了多少额度。"
+  ],
+  "sampleCommand": "npm run xhs:sample",
+  "mcpSmokeCommand": "npm run mcp:smoke",
+  "installCommand": "node install.js",
+  "npmInstallCommand": "npm install -g @vocmarket/voc-skill && claude-voc install",
+  "npxInstallCommand": "npx @vocmarket/voc-skill install",
+  "workspaceInstallCommand": "npx @vocmarket/voc-skill workspace --smoke",
+  "workspaceInstallTarget": ".claude/plugins/voc-intelligence",
+  "installHint": "Supports three delivery modes: unzip and run node install.js, install globally into ~/.claude/plugins/voc-intelligence, or install into the current workspace. Workspace mode writes .mcp.json plus .claude/skills/* entries for trend intelligence, issue pool, deep dive, competitor map, content plan, speaking script, VOC business workflow, Fmode image analysis, API catalog, and cost controller so VSCode Claude Code can discover all workflows without relying only on --plugin-dir."
+}

package/skills/voc-api-catalog/SKILL.md

@@ -19,18 +19,18 @@ VOC 后端是一个**通用转发网关**（`https://server.fmode.cn/api/voc-soc
 
 清单里每个接口都带 `channel` 字段，`voc_api_call` 据此**自动**选用对应网关，你通常无需关心：
 
-- `channel="social"`（默认）：走社媒中转网关 `https://server.fmode.cn/api/voc-social`。抖音/小红书等 18 平台的内容搜索、评论、用户/笔记详情等 VOC 口碑采集走这条。
+- `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`）取作品详情与媒体地址，不要误判为「无视频号能力」。
 - `channel="ecommerce"`：走电商与创作者数据网关 `https://server.fmode.cn/api/voc-e-commerce`，覆盖三块：
   1. **国内电商商品**：京东、淘宝/天猫、1688、抖音电商、TikTok Shop、闲鱼、得物 等平台的商品搜索、商品详情、价格、商品评论、店铺商品列表等——用户问「京东/淘宝/天猫某商品、某品类选品、商品评论」时就用这里（注意：上游暂无拼多多接口，遇拼多多需求可用京东/淘宝/天猫/1688 替代，并如实说明）。
   2. **创作者侧情报**：抖音星图、小红书蒲公英（PGY）的创作者搜索、画像、受众/粉丝分布、内容与评论关键词、笔记/视频绩效与性价比等，服务创作者生态理解、竞对达人布局、受众匹配与内容方向验证（不是替用户做投放采买决策）。
-  3. **内容平台**：微信公众号/视频号、微博、B站、知乎、快手、今日头条、豆瓣、IMDb 等的结构化内容数据。
+  3. **内容平台**：微信公众号、微信视频号（`weixin_channels.*` 基础信息/下载链/搜索等）、微博、B站、知乎、快手、今日头条、豆瓣、IMDb 等的结构化内容数据。
 - `channel="overseas"`：走海外电商选品网关 `https://server.fmode.cn/api/voc-ecom`。亚马逊海外站点的类目树 / Best Seller Top100 榜单、产品详情与子体销量、ABA 关键词与搜索排名、产品评论实时采集、ASIN/榜单/卖家数据监控等选品数据走这条。
 
 三套网关**鉴权、计费、错误处理完全同源**（同一把 `sk-`/`r:` token、同样的 401/402/403 语义、同样的回退逻辑），只是根地址不同。调用清单里**没有**的接口时，传 `rawPath` 的同时显式带对应 `channel`（`ecommerce` / `overseas`）即可路由（社媒接口不传 channel 默认 social）。
 
 ## 工具
 
-- `voc_api_search`：检索接口清单。入参 `query`（关键词，可选）、`platform`（如 douyin / tiktok / xiaohongshu / instagram / youtube / twitter / linkedin 等 18 个平台 key，可选）、`tag`（可选）。返回接口 id、标题、method、proxyPath、必填参数。
+- `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」。
 - `voc_api_doc`：读取单个接口的完整参数文档。入参 `id`（或 `proxyPath`）。返回参数表 + 可直接复制的调用模板。
 - `voc_api_call`：发起真实调用。入参：
   - `id`：清单里的接口 id（推荐），或
@@ -107,7 +107,7 @@ VOC 后端是一个**通用转发网关**（`https://server.fmode.cn/api/voc-soc
 - 禁止输出「某行业不可用 / 系统只支持某类目」这类结论——**任何行业、任何关键词都能采集**，前提只是 token 类型正确且有额度。
 - 失败时禁止退回 web search / yt-dlp / ffmpeg / 让用户手动传媒体文件来「绕过」采集。
 - **接口第一次调用失败，禁止立刻转 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` 都无法覆盖时，才考虑其它来源，并如实说明原因。
-- **禁止因为「我以为没有这个能力」就跳过清单直接 WebSearch**。京东/淘宝/天猫/1688/抖音电商/闲鱼/得物 的商品与评论、亚马逊海外选品都在 `channel=ecommerce`/`overseas` 里——先 `voc_api_search` 查清单确认，再下结论。
+- **禁止因为「我以为没有这个能力」就跳过清单直接 WebSearch**。京东/淘宝/天猫/1688/抖音电商/闲鱼/得物 的商品与评论、亚马逊海外选品都在 `channel=ecommerce`/`overseas` 里；**微信视频号短链采集**在 `channel=social` 的 `wechat`（如 `wechat_channels.v2.fetch_video_detail`）以及 `channel=ecommerce` 的 `weixin_channels` 里——先 `voc_api_search` 查清单确认，再下结论。不要默认改成「保存到相册发 mp4」。
 
 ## 状态码含义（详表见 `references/error-codes.md`）
 

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

@@ -14,6 +14,14 @@ live 模式默认保持小规模：
 - `notesPerKeyword = 1`
 - `maxCommentPages = 1`
 
+## 接口优先级
+
+live 采集走可用链路，不再依赖已不稳定的旧 App 搜索/详情：
+
+- 搜索：`app_v2/search_notes` → 失败/空结果再降级 `web_v3/fetch_search_notes`
+- 详情：优先 `app_v2/get_image_note_detail` / `app_v2/get_video_note_detail`，再回退 `app/get_note_info`
+- 评论：`app_v2/get_note_comments`
+
 ## 媒体持久化
 
 响应中的图片、视频、音频、封面、买家秀和详情素材始终写入本地 `assets/`，并登记到 `media-manifest.json`。旧 `cacheAssets` 参数仅作兼容，传 `false` 也不会跳过持久化；报告只引用本地路径。