aiconductor-cli 1.7.0 → 1.8.0

package/README.md

@@ -302,13 +302,30 @@ aiconductor-cli douyin link-to-text <视频URL> [选项]
 aiconductor-cli douyin link-to-text "https://www.douyin.com/video/xxxxx"
 ```
 
+#### 视频下载（普通清晰度）
+
+```bash
+aiconductor-cli douyin download <视频URL|分享文案|作品ID> [选项]
+```
+
+一次返回多档媒体直链（通常 4 条：`hd_no_watermark` / `no_watermark` / `watermark` / `audio`），带高清无水印、普通无水印、带水印与纯音频，各自带清晰度标签与文件大小。
+
+```bash
+aiconductor-cli douyin download "https://www.douyin.com/video/7696718696647036223" -f text
+aiconductor-cli douyin download "https://v.douyin.com/xxxxx/"
+```
+
+返回路径：`data.medias[]`（`url` / `quality` / `type` / `extension` / `data_size`，音频条目额外带 `duration` 秒），另有 `author` / `title` / `thumbnail` / `duration`。
+
+> **备用方案不等于失败**：上游主链路失败时会走兜底，此时 `medias` 只剩 2 条（`No Watermark` + `Audio`）、`data_size` 为 0、`message` 含「(备用方案)」。
+
 #### 原画下载
 
 ```bash
 aiconductor-cli douyin video-original <视频URL|分享文案|作品ID> [选项]
 ```
 
-拿最高画质（原画）直链与文件大小，和普通清晰度的 `Get_Download_Url` 是两个档位。
+拿最高画质（原画）直链与文件大小，和普通清晰度的 `download` 是两个档位。
 
 ```bash
 aiconductor-cli douyin video-original "https://www.douyin.com/video/7669664934044795354" -f text

package/bin/aiconductor-cli.js

@@ -20,6 +20,7 @@ const {
   linkToTextCommand,
   topicRadarCommand,
   videoOriginalCommand,
+  downloadCommand,
 } = require("../src/commands/douyin");
 const {
   hotListCommand: xhsHotListCommand,
@@ -245,9 +246,19 @@ douyinCmd
   .option("-f, --format <format>", "输出格式：json 或 text", "json")
   .action((keyword, options) => { videoSearchCommand(keyword, options); });
 
+douyinCmd
+  .command("download")
+  .description("抖音视频下载：普通清晰度多档直链（原画请用 video-original）")
+  .argument("<video-url>", "抖音链接、分享文案或作品 ID")
+  .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
+  .option("-f, --format <format>", "输出格式：json 或 text", "json")
+  .action((videoUrl, options) => {
+    downloadCommand(videoUrl, options);
+  });
+
 douyinCmd
   .command("video-original")
-  .description("抖音原画下载：取最高画质播放直链（普通清晰度请用 Get_Download_Url）")
+  .description("抖音原画下载：取最高画质播放直链（普通清晰度请用 download）")
   .argument("<video-url>", "抖音链接、分享文案或作品 ID")
   .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
   .option("-f, --format <format>", "输出格式：json 或 text", "json")

package/package.json

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

package/src/api.js

@@ -23,6 +23,7 @@ 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";
@@ -570,6 +571,20 @@ async function douyinVideoOriginal(apiKey, 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
@@ -1042,6 +1057,7 @@ module.exports = {
   douyinHotTopics,
   douyinRisingTopics,
   douyinVideoOriginal,
+  douyinVideoDownload,
   r2Upload,
   xhsNotePublish,
   xhsNoteInfo,

package/src/api.test.js

@@ -16,6 +16,7 @@ const {
   xhsPgyAudience,
   xhsPgyPerformance,
   douyinVideoOriginal,
+  douyinVideoDownload,
 } = require("./api");
 const {
   xhsNoteInfo,
@@ -51,6 +52,8 @@ const {
   buildTopicRadarResult,
   formatTopicRadarText,
   formatVideoOriginalText,
+  buildDownloadResult,
+  formatDownloadText,
 } = require("./commands/douyin");
 const {
   wxArticleData,
@@ -1063,3 +1066,68 @@ test("formatDarenReportText renders profile, audience, performance and score", (
   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/);
+});

package/src/commands/douyin.js

@@ -10,6 +10,7 @@ const {
   douyinHotTopics,
   douyinRisingTopics,
   douyinVideoOriginal,
+  douyinVideoDownload,
 } = require("../api");
 const { outputResult, resolveKeyOrExit, handleApiError, safeParseInt } = require("../lib/cli-utils");
 
@@ -250,6 +251,79 @@ async function videoOriginalCommand(videoUrl, options = {}) {
   } catch (err) { handleApiError(err, format); process.exit(1); }
 }
 
+async function downloadCommand(videoUrl, options = {}) {
+  const format = options.format || "json";
+  const apiKey = resolveKeyOrExit(options.apiKey, format);
+  try {
+    const result = buildDownloadResult(await douyinVideoDownload(apiKey, videoUrl));
+    outputResult(result, format, formatDownloadText);
+    process.exit(0);
+  } catch (err) { handleApiError(err, format); process.exit(1); }
+}
+
+/**
+ * 业务失败（success:false，HTTP 200）要变成 api_error，否则会被当成退出码 0。
+ * @param {object} resp
+ * @returns {object}
+ */
+function buildDownloadResult(resp) {
+  if (resp && resp.success === false) {
+    throw Object.assign(
+      new Error(resp.message || "视频下载解析失败"),
+      { type: "api_error", body: resp }
+    );
+  }
+  return resp;
+}
+
+/**
+ * 字节数转人类可读；0 / 空值（备用方案拿不到大小）返回空串，不打印 "0 B"。
+ * @param {number} bytes
+ * @returns {string}
+ */
+function formatFileSize(bytes) {
+  const n = Number(bytes);
+  if (!Number.isFinite(n) || n <= 0) return "";
+  if (n >= 1024 * 1024) return `${(n / 1024 / 1024).toFixed(1)} MB`;
+  if (n >= 1024) return `${(n / 1024).toFixed(1)} KB`;
+  return `${n} B`;
+}
+
+/**
+ * text 输出：视频下载直链（多档媒体列表）
+ * @param {object} result
+ * @returns {string}
+ */
+function formatDownloadText(result = {}) {
+  const medias = Array.isArray(result.medias) ? result.medias : [];
+  const lines = ["✓ 抖音视频下载直链"];
+  if (result.message) lines.push(`  ${result.message}`);
+
+  const meta = [];
+  if (result.author) meta.push(`作者: ${result.author}`);
+  if (result.source) meta.push(`平台: ${result.source}`);
+  if (meta.length) lines.push(`  ${meta.join(" · ")}`);
+  if (result.title) lines.push(`  标题: ${result.title}`);
+
+  lines.push(`  共 ${medias.length} 个文件:`);
+  medias.forEach((item = {}, index) => {
+    const parts = [item.quality || "unknown"];
+    const kind = [item.type, item.extension].filter(Boolean).join("/");
+    if (kind) parts.push(kind);
+    const size = formatFileSize(item.data_size);
+    if (size) parts.push(size);
+    lines.push(`    ${index + 1}. ${parts.join(" · ")}`);
+    if (item.url) lines.push(`       ${item.url}`);
+  });
+
+  const fallback = typeof result.message === "string" && result.message.includes("备用方案");
+  if (fallback) {
+    lines.push("  提示: 备用方案只给无水印视频与音频，拿不到文件大小");
+  }
+  lines.push("  提示: 直链有时效，请立即下载");
+  return lines.join("\n");
+}
+
 /**
  * text 输出：原画直链
  * @param {object} result
@@ -280,4 +354,8 @@ module.exports = {
   formatTopicRadarText,
   videoOriginalCommand,
   formatVideoOriginalText,
+  downloadCommand,
+  buildDownloadResult,
+  formatDownloadText,
+  formatFileSize,
 };