aiconductor-cli 1.6.0 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiconductor-cli",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "AIConductor CLI 工具箱",
   "keywords": [
     "aiconductor",

package/src/api.js

@@ -11,6 +11,7 @@ const DELETE_PUBLISHED_WEBPAGE_API_PATH = "/api/delete_published_webpage";
 const SEARCH_API_PATH = "/api/doubao_search";
 const HOT_LIST_API_PATH = "/api/hot_list_mixed";
 const XHS_HOT_LIST_API_PATH = "/api/xhs_hot_list";
+const URL_TO_MARKDOWN_API_PATH = "/api/url_to_markdown";
 const DOUYIN_VIDEO_INFO_PATH = "/api/douyin_video_info";
 const DOUYIN_VIDEO_COMMENTS_PATH = "/api/douyin_video_comments";
 const DOUYIN_USER_VIDEOS_PATH = "/api/douyin_user_videos";
@@ -18,13 +19,21 @@ const DOUYIN_USER_DETAIL_PATH = "/api/douyin_user_detail";
 const DOUYIN_USER_SEARCH_PATH = "/api/douyin_user_search";
 const DOUYIN_VIDEO_SEARCH_PATH = "/api/douyin_video_search";
 const DOUYIN_LINK_TO_TEXT_PATH = "/api/douyin_link_to_text_v2";
+const DOUYIN_HOT_WORDS_PATH = "/api/douyin_hot_words";
+const DOUYIN_HOT_TOPICS_PATH = "/api/douyin_hot_topics";
+const DOUYIN_RISING_TOPICS_PATH = "/api/douyin_rising_topics";
+const DOUYIN_VIDEO_ORIGINAL_PATH = "/api/douyin_video_original";
+const VIDEO_DOWNLOAD_URL_PATH = "/api/video_download_url";
 const XHS_NOTE_PUBLISH_PATH = "/api/xhs_note_publish";
 const XHS_NOTE_INFO_PATH = "/api/xhs_note_info_v3";
 const XHS_NOTE_COMMENTS_PATH = "/api/xhs_note_comments_fast";
 const XHS_NOTE_SEARCH_PATH = "/api/xhs_note_search_v3";
 const XHS_USER_INFO_PATH = "/api/xhs_user_info_v2";
-// 刻意打 v2：v3 已于 2026-11-05 迁到同一上游且同输出，但 v2 是历史真实流量所在（api_docs 两篇一致）。
+// 刻意打 v2：v3 已于 2026-11-05 迁到同一上游且同输出，但 v2 是历史真实流量所在（backend/api_docs 两篇一致）。
 const XHS_USER_NOTES_PATH = "/api/xhs_user_notes_v2";
+const XHS_PGY_BLOGGER_PATH = "/api/xhs_pgy_blogger";
+const XHS_PGY_AUDIENCE_PATH = "/api/xhs_pgy_audience";
+const XHS_PGY_PERFORMANCE_PATH = "/api/xhs_pgy_performance";
 
 // 本地校验区间，命中就在发请求前拦截，不产生计费
 const XHS_MAX_PAGES_LIMIT = 5;
@@ -197,7 +206,7 @@ function throwOnBusinessFailure(resp) {
 
 /**
  * wx_history_articles 把上游失败塞在 HTTP 200 + success:true 的 data.code 里
- * （api_docs：data.code 为 0 才算成功，平台侧并不改写成 success:false）。
+ * （backend/api_docs：data.code 为 0 才算成功，平台侧并不改写成 success:false）。
  * 不认这个码，就会把「上游挂了」当成「这个号没有文章」。
  * @param {object} resp
  * @returns {object}
@@ -432,7 +441,7 @@ async function hotList(apiKey, params) {
   }
 
   const limit = validatePositiveInt(params.limit === undefined ? 30 : params.limit, "limit", 30);
-  // The hot-list service is currently served over HTTP; see api_docs/hot_list_mixed.md.
+  // The hot-list service is currently served over HTTP; see backend/api_docs/hot_list_mixed.md.
   const resp = await httpPost(API_HOST, HOT_LIST_API_PATH, {
     source_ids: sourceIds,
     latest: true,
@@ -548,6 +557,67 @@ async function douyinVideoComments(apiKey, videoUrl, maxCount) {
   return stripBilling(resp);
 }
 
+/**
+ * 抖音原画下载（最高画质直链）
+ * @param {string} apiKey
+ * @param {string} videoUrl 链接、分享文案或作品 ID
+ * @returns {Promise<object>}
+ */
+async function douyinVideoOriginal(apiKey, videoUrl) {
+  const resp = await httpPost(API_HOST, DOUYIN_VIDEO_ORIGINAL_PATH, {
+    api_key: apiKey,
+    video_url: videoUrl,
+  });
+  return stripBilling(resp);
+}
+
+/**
+ * 抖音视频下载（普通清晰度，多档媒体列表）
+ * @param {string} apiKey
+ * @param {string} videoUrl 链接、分享文案或作品 ID
+ * @returns {Promise<object>}
+ */
+async function douyinVideoDownload(apiKey, videoUrl) {
+  const resp = await httpPost(API_HOST, VIDEO_DOWNLOAD_URL_PATH, {
+    api_key: apiKey,
+    video_url: videoUrl,
+  });
+  return stripBilling(resp);
+}
+
+/**
+ * 抖音热词榜（原子接口）
+ * @param {string} apiKey
+ * @returns {Promise<object>}
+ */
+async function douyinHotWords(apiKey) {
+  const resp = await httpPost(API_HOST, DOUYIN_HOT_WORDS_PATH, { api_key: apiKey });
+  return stripBilling(resp);
+}
+
+/**
+ * 抖音热点榜（原子接口，一次返回 current + rocketing）
+ * @param {string} apiKey
+ * @returns {Promise<object>}
+ */
+async function douyinHotTopics(apiKey) {
+  const resp = await httpPost(API_HOST, DOUYIN_HOT_TOPICS_PATH, { api_key: apiKey });
+  return stripBilling(resp);
+}
+
+/**
+ * 抖音飙升热点榜（原子接口）
+ * @param {string} apiKey
+ * @param {number} [limit] 1~20，越界时后端回退为 10
+ * @returns {Promise<object>}
+ */
+async function douyinRisingTopics(apiKey, limit) {
+  const body = { api_key: apiKey };
+  if (limit !== undefined && limit !== null) body.limit = limit;
+  const resp = await httpPost(API_HOST, DOUYIN_RISING_TOPICS_PATH, body);
+  return stripBilling(resp);
+}
+
 /**
  * 获取抖音用户视频列表
  * @param {string} apiKey
@@ -645,6 +715,23 @@ async function wxArticleData(apiKey, url) {
   return throwOnBusinessFailure(stripBilling(resp));
 }
 
+/**
+ * 将任意网页（含微信公众号文章）转成干净的 Markdown
+ * @param {string} apiKey
+ * @param {{ url: string, timeout?: number|string }} params
+ * @returns {Promise<object>} `markdown` 在顶层，不在 data 下
+ */
+async function urlToMarkdown(apiKey, params = {}) {
+  const body = { url: requireText(params.url, "url（网页链接）") };
+  if (params.timeout !== undefined && params.timeout !== null && params.timeout !== "") {
+    body.timeout = validatePositiveInt(params.timeout, "timeout");
+  }
+  const resp = await httpPost(API_HOST, URL_TO_MARKDOWN_API_PATH, body, {
+    Authorization: `Bearer ${apiKey}`,
+  });
+  return throwOnBusinessFailure(stripBilling(resp));
+}
+
 /**
  * 获取微信公众号历史文章列表（按成功翻页次数计费）
  * @param {string} apiKey
@@ -827,6 +914,58 @@ async function xhsUserInfo(apiKey, userId) {
   return throwOnXhsFailure(stripBilling(resp));
 }
 
+/**
+ * 蒲公英三件套的公共请求体：24 位小写十六进制当 user_id，其余当主页链接。
+ * @param {string} apiKey
+ * @param {string} input user_id 或主页链接
+ * @returns {object}
+ */
+function pgyRequestBody(apiKey, input) {
+  const text = input === undefined || input === null ? "" : String(input).trim();
+  if (!text) {
+    throw Object.assign(new Error("请提供小红书 user_id 或达人主页链接"), {
+      type: "validation_error",
+    });
+  }
+  const body = { api_key: apiKey };
+  if (/^[0-9a-f]{24}$/.test(text)) body.user_id = text;
+  else body.profile_url = text;
+  return body;
+}
+
+/**
+ * 小红书达人详情（蒲公英）
+ * @param {string} apiKey
+ * @param {string} input user_id 或主页链接
+ * @returns {Promise<object>}
+ */
+async function xhsPgyBlogger(apiKey, input) {
+  const resp = await httpPost(API_HOST, XHS_PGY_BLOGGER_PATH, pgyRequestBody(apiKey, input));
+  return stripBilling(resp);
+}
+
+/**
+ * 小红书达人粉丝画像（蒲公英）
+ * @param {string} apiKey
+ * @param {string} input user_id 或主页链接
+ * @returns {Promise<object>}
+ */
+async function xhsPgyAudience(apiKey, input) {
+  const resp = await httpPost(API_HOST, XHS_PGY_AUDIENCE_PATH, pgyRequestBody(apiKey, input));
+  return stripBilling(resp);
+}
+
+/**
+ * 小红书达人笔记性价比（蒲公英）
+ * @param {string} apiKey
+ * @param {string} input user_id 或主页链接
+ * @returns {Promise<object>}
+ */
+async function xhsPgyPerformance(apiKey, input) {
+  const resp = await httpPost(API_HOST, XHS_PGY_PERFORMANCE_PATH, pgyRequestBody(apiKey, input));
+  return stripBilling(resp);
+}
+
 /**
  * 获取小红书用户笔记列表。
  * @param {string} apiKey
@@ -914,6 +1053,11 @@ module.exports = {
   douyinUserSearch,
   douyinVideoSearch,
   douyinLinkToText,
+  douyinHotWords,
+  douyinHotTopics,
+  douyinRisingTopics,
+  douyinVideoOriginal,
+  douyinVideoDownload,
   r2Upload,
   xhsNotePublish,
   xhsNoteInfo,
@@ -922,6 +1066,10 @@ module.exports = {
   xhsUserInfo,
   xhsUserNotes,
   resolveXhsShortLink,
+  xhsPgyBlogger,
+  xhsPgyAudience,
+  xhsPgyPerformance,
   wxArticleData,
   wxHistoryArticles,
+  urlToMarkdown,
 };

package/src/api.test.js

@@ -4,7 +4,20 @@ const http = require("node:http");
 const https = require("node:https");
 const test = require("node:test");
 
-const { hotList, webSearch, xhsHotList } = require("./api");
+const {
+  hotList,
+  webSearch,
+  xhsHotList,
+  urlToMarkdown,
+  douyinHotWords,
+  douyinHotTopics,
+  douyinRisingTopics,
+  xhsPgyBlogger,
+  xhsPgyAudience,
+  xhsPgyPerformance,
+  douyinVideoOriginal,
+  douyinVideoDownload,
+} = require("./api");
 const {
   xhsNoteInfo,
   xhsNoteComments,
@@ -28,7 +41,20 @@ const {
   DEFAULT_HOT_LIST_SOURCES,
 } = require("./commands/content");
 const { formatSearchText } = require("./commands/web_search");
-const { hotListTextFormatter, notePublishTextFormatter } = require("./commands/xhs");
+const { formatToMdText, readFrontmatter } = require("./commands/web");
+const {
+  hotListTextFormatter,
+  notePublishTextFormatter,
+  buildDarenReportResult,
+  formatDarenReportText,
+} = require("./commands/xhs");
+const {
+  buildTopicRadarResult,
+  formatTopicRadarText,
+  formatVideoOriginalText,
+  buildDownloadResult,
+  formatDownloadText,
+} = require("./commands/douyin");
 const {
   wxArticleData,
   wxHistoryArticles,
@@ -450,7 +476,7 @@ test("wx endpoints turn HTTP 200 business failures into api_error", async () =>
 });
 
 test("wx history treats an upstream code inside a successful response as a failure", async () => {
-  // 2026-11-05 线上实测：平台仍回 success:true，把上游失败塞进 data.code（api_docs：code 0 为成功），
+  // 2026-11-05 线上实测：平台仍回 success:true，把上游失败塞进 data.code（backend/api_docs：code 0 为成功），
   // 文章数组为空。若照 success 判断，会把「上游挂了」报成「这个号最近没发文」。
   const upstreamFailure = {
     success: true,
@@ -532,7 +558,7 @@ test("wx article-data formatter labels the fields the live endpoint returns", ()
 
 // ---------------------------------------------------------------------------
 // 小红书（xhs）数据命令组
-// 依据：api_docs/xhs_*.md 的请求字段 + 2026-11-05 线上真实响应
+// 依据：backend/api_docs/xhs_*.md 的请求字段 + 2026-11-05 线上真实响应
 // ---------------------------------------------------------------------------
 
 test("xhsNoteInfo posts note_id to the v3 note detail endpoint over http", async () => {
@@ -775,3 +801,333 @@ test("xhs text formatters: 评论按赞排序并展开楼内回复，搜索按
   const noteText = noteTextFormatter({ note_data: { title: "T", type: "normal", time: 1793578330 } });
   assert.match(noteText, /2026-11-02 08:12:10/);
 });
+
+test("urlToMarkdown posts the url with a Bearer header and strips billing", async () => {
+  const request = await captureRequest(
+    () => urlToMarkdown("test-key", { url: " https://mp.weixin.qq.com/s?__biz=M1 " }),
+    {
+      success: true,
+      message: "转换成功",
+      markdown: "# 标题\n\n正文段落",
+      billing: { service_fee: 0.02, transaction_id: 9 },
+    }
+  );
+
+  assert.equal(request.options.path, "/api/url_to_markdown");
+  assert.equal(request.options.port, 443);
+  assert.equal(request.options.headers.Authorization, "Bearer test-key");
+  assert.deepEqual(request.body, { url: "https://mp.weixin.qq.com/s?__biz=M1" });
+  assert.equal(request.result.billing, undefined);
+  assert.equal(request.result.markdown, "# 标题\n\n正文段落");
+});
+
+test("urlToMarkdown rejects a blank url without calling the endpoint", async () => {
+  await assert.rejects(() => urlToMarkdown("test-key", { url: "   " }), { type: "validation_error" });
+  await assert.rejects(() => urlToMarkdown("test-key", {}), { type: "validation_error" });
+});
+
+test("urlToMarkdown only forwards an explicit timeout", async () => {
+  const withTimeout = await captureRequest(
+    () => urlToMarkdown("test-key", { url: "https://example.com/a", timeout: "45" }),
+    { success: true, markdown: "x", billing: {} }
+  );
+  assert.deepEqual(withTimeout.body, { url: "https://example.com/a", timeout: 45 });
+
+  const withoutTimeout = await captureRequest(
+    () => urlToMarkdown("test-key", { url: "https://example.com/a" }),
+    { success: true, markdown: "x", billing: {} }
+  );
+  assert.deepEqual(withoutTimeout.body, { url: "https://example.com/a" });
+});
+
+test("formatToMdText previews frontmatter and truncates long bodies", () => {
+  const body = Array.from({ length: 30 }, (_, i) => `第${i + 1}行`).join("\n");
+  const text = formatToMdText({
+    markdown: `---\ntitle: "测试标题"\nword_count: 1120\n---\n${body}`,
+  });
+  assert.match(text, /✓ 已转换为 Markdown/);
+  assert.match(text, /标题: 测试标题/);
+  assert.match(text, /字数: 1120/);
+  assert.match(text, /第1行/);
+  assert.doesNotMatch(text, /第25行/, "超过 20 行应被截断");
+  assert.match(text, /省略/);
+});
+
+test("formatToMdText handles empty and frontmatter-less markdown", () => {
+  assert.equal(formatToMdText({ markdown: "   " }), "✗ 未取到 Markdown 内容");
+  const plain = formatToMdText({ markdown: "# 只有正文" });
+  assert.match(plain, /字符: 6/);
+  assert.doesNotMatch(plain, /标题:/);
+});
+
+test("readFrontmatter returns empty for malformed blocks", () => {
+  assert.equal(readFrontmatter("no frontmatter", "title"), "");
+  assert.equal(readFrontmatter("---\ntitle: 没闭合", "title"), "");
+  assert.equal(readFrontmatter('---\nauthor: "张三"\n---\n正文', "author"), "张三");
+});
+
+test("douyin hot endpoints post api_key in the body and map their paths", async () => {
+  const words = await captureRequest(() => douyinHotWords("test-key"), { success: true, data: {} });
+  assert.equal(words.options.path, "/api/douyin_hot_words");
+  assert.deepEqual(words.body, { api_key: "test-key" });
+
+  const topics = await captureRequest(() => douyinHotTopics("test-key"), { success: true, data: {} });
+  assert.equal(topics.options.path, "/api/douyin_hot_topics");
+  assert.deepEqual(topics.body, { api_key: "test-key" });
+
+  const rising = await captureRequest(() => douyinRisingTopics("test-key", 5), { success: true, data: {} });
+  assert.equal(rising.options.path, "/api/douyin_rising_topics");
+  assert.deepEqual(rising.body, { api_key: "test-key", limit: 5 });
+
+  const risingDefault = await captureRequest(() => douyinRisingTopics("test-key"), { success: true, data: {} });
+  assert.deepEqual(risingDefault.body, { api_key: "test-key" });
+});
+
+test("buildTopicRadarResult keeps whatever segment succeeded", () => {
+  const result = buildTopicRadarResult(
+    { status: "fulfilled", value: { data: { words: [{ keyword: "美食" }] } } },
+    { status: "rejected", reason: Object.assign(new Error("热点挂了"), { type: "api_error" }) },
+    { status: "fulfilled", value: { data: { items: [{ sentence: "卡点" }] } } }
+  );
+
+  assert.equal(result.success, true);
+  assert.deepEqual(result.data.hot_words, [{ keyword: "美食" }]);
+  assert.deepEqual(result.data.rising, [{ sentence: "卡点" }]);
+  assert.deepEqual(result.data.hot_topics, []);
+  assert.equal(result.data.failed_sources.length, 1);
+  assert.equal(result.data.failed_sources[0].service, "hot_topics");
+  assert.equal(result.data.failed_sources[0].message, "热点挂了");
+  assert.match(result.message, /部分数据源不可用/);
+});
+
+test("buildTopicRadarResult throws api_error only when every segment fails", () => {
+  const rejected = (message) => ({ status: "rejected", reason: new Error(message) });
+  assert.throws(
+    () => buildTopicRadarResult(rejected("a"), rejected("b"), rejected("c")),
+    (err) => err.type === "api_error" && /均获取失败/.test(err.message)
+  );
+});
+
+test("formatTopicRadarText renders every section and failed sources", () => {
+  const text = formatTopicRadarText({
+    message: "选题雷达已生成",
+    data: {
+      hot_words: [{ keyword: "美食", hot_index: 100, trend_label: "升温" }],
+      hot_topics: [{ topic_name: "开拓者惨败马刺", category: "体育", vv: 33860082, content_cnt: 15 }],
+      rocketing_topics: [{ topic_name: "卡点", vv: 3686735 }],
+      rising: [{
+        sentence: "卡点视频",
+        hot_score: 7620270,
+        video_count: 2,
+        rank_diff: 3,
+        trend: [
+          { datetime: "2026-11-08 10", hot_score: 7640313 },
+          { datetime: "2026-11-08 16", hot_score: 7638220 },
+        ],
+      }],
+      failed_sources: [{ service: "hot_topics", message: "超时" }],
+    },
+  });
+
+  assert.match(text, /抖音选题雷达/);
+  assert.match(text, /【热词】共 1 条/);
+  assert.match(text, /美食  热度 100 · 升温/);
+  assert.match(text, /【当前热点】共 1 条/);
+  assert.match(text, /\[体育\] 开拓者惨败马刺/);
+  assert.match(text, /【飙升话题】共 1 条/);
+  assert.match(text, /【飙升热点】共 1 条/);
+  assert.match(text, /趋势: 2026-11-08 10 7640313 → 2026-11-08 16 7638220/);
+  assert.match(text, /失败数据源:/);
+  assert.match(text, /hot_topics: 超时/);
+});
+
+test("douyinVideoOriginal posts video_url with api_key and strips billing", async () => {
+  const request = await captureRequest(
+    () => douyinVideoOriginal("test-key", "https://www.douyin.com/video/7669664934044795354"),
+    {
+      success: true,
+      message: "原画直链获取成功（219.1 MB）",
+      data: { video_id: "7669664934044795354", file_size_mb: 219.11 },
+      billing: { service_fee: 0.1 },
+    }
+  );
+  assert.equal(request.options.path, "/api/douyin_video_original");
+  assert.deepEqual(request.body, {
+    api_key: "test-key",
+    video_url: "https://www.douyin.com/video/7669664934044795354",
+  });
+  assert.equal(request.result.billing, undefined);
+  assert.equal(request.result.data.file_size_mb, 219.11);
+});
+
+test("formatVideoOriginalText renders size, link and expiry hint", () => {
+  const text = formatVideoOriginalText({
+    message: "原画直链获取成功（219.1 MB）",
+    data: {
+      video_id: "7669664934044795354",
+      url: "https://v5-dy-ov-experiment.zjcdn.com/orig.mp4",
+      file_size_mb: 219.11,
+      content_type: "video/mp4",
+    },
+  });
+  assert.match(text, /抖音原画直链/);
+  assert.match(text, /作品: 7669664934044795354/);
+  assert.match(text, /大小: 219\.11 MB/);
+  assert.match(text, /类型: video\/mp4/);
+  assert.match(text, /直链: https:\/\/v5-dy-ov-experiment/);
+  assert.match(text, /直链有时效/);
+});
+
+test("pgy endpoints switch between user_id and profile_url", async () => {
+  const byId = await captureRequest(
+    () => xhsPgyBlogger("test-key", "5c5f8f4c000000001801612c"),
+    { success: true, data: {} }
+  );
+  assert.equal(byId.options.path, "/api/xhs_pgy_blogger");
+  assert.deepEqual(byId.body, { api_key: "test-key", user_id: "5c5f8f4c000000001801612c" });
+
+  const byUrl = await captureRequest(
+    () => xhsPgyAudience("test-key", "  https://www.xiaohongshu.com/user/profile/5c5f8f4c000000001801612c  "),
+    { success: true, data: {} }
+  );
+  assert.equal(byUrl.options.path, "/api/xhs_pgy_audience");
+  assert.equal(byUrl.body.profile_url, "https://www.xiaohongshu.com/user/profile/5c5f8f4c000000001801612c");
+  assert.equal(byUrl.body.user_id, undefined);
+
+  const performance = await captureRequest(() => xhsPgyPerformance("test-key", "5c5f8f4c000000001801612c"), { success: true, data: {} });
+  assert.equal(performance.options.path, "/api/xhs_pgy_performance");
+});
+
+test("pgy endpoints reject a blank input before calling", async () => {
+  await assert.rejects(() => xhsPgyBlogger("test-key", "   "), { type: "validation_error" });
+  await assert.rejects(() => xhsPgyPerformance("test-key", undefined), { type: "validation_error" });
+});
+
+test("buildDarenReportResult merges two segments and scores them", () => {
+  const result = buildDarenReportResult(
+    { status: "fulfilled", value: { data: { name: "十七楼.", fans_count: 4205 } } },
+    { status: "rejected", reason: new Error("画像挂了") },
+    { status: "fulfilled", value: { data: { interaction_rate: 25.6, hundred_like_percent: 72.4 } } }
+  );
+
+  assert.equal(result.success, true);
+  assert.equal(result.data.profile.name, "十七楼.");
+  assert.equal(result.data.partial, true);
+  assert.equal(result.data.failed_sources.length, 1);
+  assert.equal(result.data.failed_sources[0].service, "audience");
+  // 粉丝 4205 → 10/40（≥1千 档）；互动率 25.6 → 30/30；百赞率 72.4 → 30/30 → 70/100
+  assert.equal(result.data.score.value, 70);
+  assert.equal(result.data.score.tier, "腰部");
+  assert.equal(result.data.score.basis.length, 3);
+});
+
+test("buildDarenReportResult fails when fewer than two segments succeed", () => {
+  const rejected = (message) => ({ status: "rejected", reason: new Error(message) });
+  assert.throws(
+    () => buildDarenReportResult(
+      { status: "fulfilled", value: { data: {} } },
+      rejected("b"),
+      rejected("c")
+    ),
+    (err) => err.type === "api_error" && /达人数据获取不完整/.test(err.message)
+  );
+});
+
+test("formatDarenReportText renders profile, audience, performance and score", () => {
+  const text = formatDarenReportText({
+    data: {
+      profile: { name: "十七楼.", red_id: "615758825", location: "江苏 南京", fans_count: 4205, business_note_count: 107 },
+      audience: {
+        gender: { male: 0.25147, female: 0.74853 },
+        ages: [{ group: "25-34", percent: 0.5076 }],
+        interests: [{ name: "美食", percent: 0.1339 }],
+      },
+      performance: {
+        note_number: 29,
+        hundred_like_percent: 72.4,
+        imp_median: 2690,
+        imp_median_beyond_rate: 88.4,
+        read_median: 341,
+        read_median_beyond_rate: 84.9,
+        interaction_rate: 25.6,
+        interaction_beyond_rate: 99.0,
+      },
+      score: { value: 78, tier: "腰部", partial: true, basis: [{ item: "粉丝数", got: 18, max: 40 }] },
+      failed_sources: [{ service: "audience", message: "超时" }],
+    },
+  });
+
+  assert.match(text, /小红书达人报告/);
+  assert.match(text, /达人: 十七楼\.（小红书号 615758825）/);
+  assert.match(text, /性别: 女 74\.9% \/ 男 25\.1%/);
+  assert.match(text, /年龄: 25-34 50\.8%/);
+  assert.match(text, /百赞率: 72\.4%/);
+  assert.match(text, /互动率: 25\.6%（超越 99%）/);
+  assert.match(text, /【评分】78 分 · 腰部（部分维度缺失，已归一）/);
+  assert.match(text, /失败数据源:/);
+});
+
+test("douyin download posts to the download endpoint and strips billing", async () => {
+  const request = await captureRequest(
+    () => douyinVideoDownload("test-key", "https://v.douyin.com/abc/"),
+    { success: true, message: "ok", medias: [{ url: "https://cdn/x.mp4" }], billing: { service_fee: 0.01 } }
+  );
+
+  assert.equal(request.options.path, "/api/video_download_url");
+  assert.equal(request.options.method, "POST");
+  assert.deepEqual(request.body, { api_key: "test-key", video_url: "https://v.douyin.com/abc/" });
+  assert.equal(request.result.billing, undefined);
+  assert.equal(request.result.medias.length, 1);
+});
+
+test("buildDownloadResult passes a successful payload through unchanged", () => {
+  const resp = { success: true, medias: [{ url: "https://cdn/x.mp4" }] };
+  assert.equal(buildDownloadResult(resp), resp);
+});
+
+test("buildDownloadResult turns a business failure into api_error with the upstream message", () => {
+  assert.throws(
+    () => buildDownloadResult({ success: false, message: "账户余额不足，当前余额：0.0，需要：0.01", medias: [] }),
+    (err) => err.type === "api_error" && /账户余额不足/.test(err.message)
+  );
+});
+
+test("formatDownloadText lists every media, sizes and the fallback caveat", () => {
+  const text = formatDownloadText({
+    success: true,
+    message: "获取视频下载URL成功",
+    source: "douyin",
+    author: "某作者",
+    title: "某条视频",
+    duration: 33000,
+    medias: [
+      { url: "https://cdn/hd.mp4", type: "video", quality: "hd_no_watermark", extension: "mp4", data_size: 19465218 },
+      { url: "https://cdn/audio.mp3", type: "audio", quality: "audio", extension: "mp3", duration: 33 },
+    ],
+  });
+
+  assert.match(text, /视频下载直链/);
+  assert.match(text, /作者: 某作者/);
+  assert.match(text, /标题: 某条视频/);
+  assert.match(text, /hd_no_watermark/);
+  assert.match(text, /18\.6 MB/);
+  assert.match(text, /https:\/\/cdn\/hd\.mp4/);
+  assert.match(text, /audio/);
+  assert.match(text, /https:\/\/cdn\/audio\.mp3/);
+  // 正常档音频本来就不带大小，不能误报成“备用方案”
+  assert.doesNotMatch(text, /备用方案/);
+});
+
+test("formatDownloadText explains the fallback shape instead of looking broken", () => {
+  const text = formatDownloadText({
+    success: true,
+    message: "获取视频下载URL成功(备用方案)",
+    medias: [
+      { url: "https://cdn/nw.mp4", type: "video", quality: "No Watermark", extension: "mp4", data_size: 0 },
+      { url: "https://cdn/a.mp3", type: "audio", quality: "Audio", extension: "mp3", duration: 15 },
+    ],
+  });
+
+  assert.match(text, /备用方案/);
+  assert.doesNotMatch(text, /0 B/);
+});