@9000ai/cli 0.5.5 → 0.6.1

package/dist/commands/transcribe.js

@@ -1,15 +1,54 @@
 import { request, printJson, pollUntilDone } from "../client.js";
 import { loadJsonFile } from "../utils/format.js";
+/** Extract unique video_ids from monitor task output */
+function extractVideoIdsFromMonitorOutput(output) {
+    const data = (output.data ?? output);
+    const creators = (data.creators ?? []);
+    const seen = new Set();
+    for (const creator of creators) {
+        const vids = (creator.videos ?? []);
+        for (const v of vids) {
+            const vid = v.video_id;
+            if (vid)
+                seen.add(vid);
+        }
+    }
+    return [...seen];
+}
 export function registerTranscribeCommands(parent) {
     const cmd = parent.command("transcribe").description("Video / audio transcription");
     cmd
         .command("submit")
-        .description("Submit batch video-to-text task")
-        .requiredOption("--json-file <path>", "JSON file with video task details")
+        .description("Submit video-to-text task (by video IDs or JSON file)")
+        .option("--video-ids <ids>", "Comma-separated video IDs (backend resolves URLs from cache)")
+        .option("--json-file <path>", "JSON file with video task details (legacy, includes URLs)")
+        .option("--group-label <label>", "Batch group label for tracking")
+        .option("--webhook <url>", "Webhook URL for completion callback")
         .option("--wait", "Poll until task completes then print results")
         .option("--fields <list>", "Comma-separated fields to extract (used with --wait)")
         .option("--compact", "One JSON object per line (used with --wait)")
         .action(async (opts) => {
+        if (!opts.videoIds && !opts.jsonFile) {
+            console.error("Error: must provide --video-ids or --json-file");
+            process.exit(1);
+        }
+        // ── --video-ids: 新流程，后端自己查 URL + 去重 ──
+        if (opts.videoIds) {
+            const ids = opts.videoIds.split(",").map((s) => s.trim()).filter(Boolean);
+            const payload = { video_ids: ids };
+            if (opts.groupLabel)
+                payload.group_label = opts.groupLabel;
+            if (opts.webhook)
+                payload.webhook = opts.webhook;
+            const data = await request({
+                method: "POST",
+                path: "/api/v1/media/transcribe-by-video-ids",
+                payload,
+            });
+            printJson(data, { fields: opts.fields, compact: opts.compact });
+            return;
+        }
+        // ── --json-file: 兼容老流程 ──
         const payload = loadJsonFile(opts.jsonFile);
         const data = await request({
             method: "POST",
@@ -23,7 +62,6 @@ export function registerTranscribeCommands(parent) {
             printJson(data);
             return;
         }
-        // --wait: poll then fetch results
         console.error(`Batch submitted → ${batchId}, waiting...`);
         await pollUntilDone(`/api/v1/tasks/batch/${batchId}`);
         const resultData = await request({
@@ -73,4 +111,71 @@ export function registerTranscribeCommands(parent) {
             clearTimeout(timer);
         }
     });
+    // ────────────────────────────────────────────
+    // from-monitor: 监控结果 → 提取 video_id → 后端处理
+    // ────────────────────────────────────────────
+    cmd
+        .command("from-monitor")
+        .description("Extract video IDs from monitor results, send to backend for dedup + transcribe")
+        .option("--task-id <id>", "Monitor task ID to extract videos from")
+        .option("--sec-user <ids>", "Comma-separated sec_user_id list (fetches videos, caches URLs)")
+        .option("--group-label <label>", "Batch group label for tracking")
+        .option("--count <n>", "Videos per user (with --sec-user)", "20")
+        .option("--webhook <url>", "Webhook URL for completion callback")
+        .action(async (opts) => {
+        if (!opts.taskId && !opts.secUser) {
+            console.error("Error: must provide --task-id or --sec-user");
+            process.exit(1);
+        }
+        // ── Step 1: Collect video_ids ──
+        console.error("Step 1: Collecting video IDs...");
+        const allVideoIds = new Set();
+        if (opts.taskId) {
+            const taskResp = await request({ method: "GET", path: `/api/v1/tasks/${opts.taskId}` });
+            const taskData = (taskResp.data ?? taskResp);
+            if (taskData.status !== "SUCCESS") {
+                console.error(`Task status: ${taskData.status ?? "unknown"} (need SUCCESS)`);
+                process.exit(1);
+            }
+            const output = (typeof taskData.output === "string" ? JSON.parse(taskData.output) : taskData.output);
+            for (const vid of extractVideoIdsFromMonitorOutput(output)) {
+                allVideoIds.add(vid);
+            }
+        }
+        if (opts.secUser) {
+            // fetch 会同时写入后端 video_url_cache，所以只需收集 video_id
+            const secUsers = opts.secUser.split(",").map((s) => s.trim()).filter(Boolean);
+            for (const secId of secUsers) {
+                const params = new URLSearchParams({ sec_user_id: secId, count: opts.count ?? "20", sort_type: "0" });
+                console.error(`  Fetching ${secId}...`);
+                const resp = await request({ method: "GET", path: `/api/v1/douyin/monitor/user-posts?${params}` });
+                const data = (resp.data ?? resp);
+                const items = (data.items ?? data.videos ?? []);
+                for (const v of items) {
+                    const vid = v.video_id;
+                    if (vid)
+                        allVideoIds.add(vid);
+                }
+            }
+        }
+        const videoIds = [...allVideoIds];
+        console.error(`  Collected ${videoIds.length} unique video IDs`);
+        if (videoIds.length === 0) {
+            printJson({ total_videos: 0, already_transcribed: 0, newly_submitted: 0 });
+            return;
+        }
+        // ── Step 2: 调后端统一处理（去重 + 查缓存 + 转写） ──
+        console.error("Step 2: Sending to backend for dedup + transcribe...");
+        const payload = { video_ids: videoIds };
+        if (opts.groupLabel)
+            payload.group_label = opts.groupLabel;
+        if (opts.webhook)
+            payload.webhook = opts.webhook;
+        const data = await request({
+            method: "POST",
+            path: "/api/v1/media/transcribe-by-video-ids",
+            payload,
+        });
+        printJson(data);
+    });
 }

package/dist/index.js

@@ -14,7 +14,7 @@ const program = new Command();
 program
     .name("9000ai")
     .description("9000AI Toolbox CLI — unified interface for 9000AI platform")
-    .version("0.5.5");
+    .version("0.6.1");
 registerConfigCommands(program);
 registerAuthCommands(program);
 registerSearchCommands(program);

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@9000ai/cli",
-  "version": "0.5.5",
+  "version": "0.6.1",
   "description": "9000AI Toolbox CLI — unified command-line interface for 9000AI platform",
   "type": "module",
   "bin": {
-    "9000ai": "./dist/index.js"
+    "9000ai": "dist/index.js"
   },
   "scripts": {
     "build": "tsc",

package/skills/9000AI-hub/SKILL.md

@@ -39,8 +39,8 @@ output-format: routing-only
 }
 
 # 有依赖，串行
-9000ai search keyword "xxx" --wait --fields desc,video_url,likes
-→ 拿 video_url → 9000ai transcribe submit --json-file ... --wait
+9000ai search keyword "xxx" --wait --fields desc,video_id,likes
+→ 拿 video_id → 9000ai transcribe submit --video-ids <id1,id2,...>
 ```
 
 ## 模块目录

package/skills/douyin-monitor/references/endpoints.md

@@ -12,12 +12,6 @@ http://127.0.0.1:8025
 X-API-Key: <你的 key>
 ```
 
-本地固定配置文件：
-
-```text
-douyin-monitor-9000AI/local/config.json
-```
-
 ## 鉴权与能力
 
 ```text

package/skills/douyin-topic-discovery/references/endpoints.md

@@ -12,12 +12,6 @@ http://127.0.0.1:8025
 X-API-Key: <你的 key>
 ```
 
-本地固定配置文件：
-
-```text
-douyin-topic-discovery-9000AI/local/config.json
-```
-
 ## 查看当前调用方
 
 ```text

package/skills/video-transcription/SKILL.md

@@ -19,11 +19,23 @@ output-format: task-oriented
 ## 适用范围
 
 用于：
-- 提交批量视频转文字任务
-- 查询转写任务状态
-- 查询转写任务结果
+- 按 video_id 提交转写（推荐）
+- 从监控结果一键转写（from-monitor）
+- 提交批量视频转文字任务（传 JSON 文件，兼容老流程）
+- 查询转写任务状态和结果
 - 只提取原文文案
-- 查看当前 key 是否已开通视频转文字能力
+
+## 三种提交方式
+
+| 方式 | 命令 | 适用场景 |
+|------|------|----------|
+| **按 video_id**（推荐） | `transcribe submit --video-ids <id1,id2,...>` | 只传短 ID，简洁高效 |
+| **从监控结果** | `transcribe from-monitor --task-id <id>` | 监控任务完成后一键转写所有视频 |
+| **按 JSON 文件** | `transcribe submit --json-file <path>` | 需要自定义参数（超时、webhook 等） |
+
+**优先用 `--video-ids`**：不需要接触 video_url，简洁省 token。
+
+使用 `--video-ids` 前需要先通过 `monitor fetch` 或 `monitor run` 获取过视频列表。
 
 ## 工作方式
 
@@ -55,33 +67,13 @@ output-format: task-oriented
 
 不要把整份转写 JSON 原样塞进上下文。
 
-如果只需要原文文案，优先这样做：
-1. 先查 `9000ai task status --task-id <task_id>`
-2. 从 `data.output.json_url` 拿到转写 JSON 地址
-3. 直接提取 JSON 根字段：
-
-```text
-text
-```
-
-句子级文本在：
-
-```text
-timecodes.sentences[*].text
-```
-
-已经提供了直接提原文的命令：
+如果只需要原文文案：
 
 ```bash
 9000ai transcribe text --task-id <task_id>
 ```
 
-这个命令会直接返回：
-- `text_field = "text"`
-- `sentence_field = "timecodes.sentences[*].text"`
-- `text`
-
-所以后续如果 AI 只想拿原文文案，优先用 `text`，不要把整份 JSON 全读进上下文。
+返回 `text` 字段即可，不要读全量 JSON。
 
 ## 命令
 
@@ -94,12 +86,21 @@ timecodes.sentences[*].text
 常用命令：
 
 ```bash
-9000ai config set --base-url http://127.0.0.1:8025 --api-key <key>
-9000ai auth whoami
-9000ai auth capabilities
+# 按 video_id 转写（推荐）
+9000ai transcribe submit --video-ids 7582142740935970054,7576959070901930987 --group-label "竞品分析"
+
+# 从监控结果一键转写
+9000ai transcribe from-monitor --task-id <monitor_task_id> --group-label "对标分析-20260403"
+9000ai transcribe from-monitor --sec-user <sec_user_id1>,<sec_user_id2> --group-label "竞品监控"
+
+# JSON 文件提交（兼容老流程）
 9000ai transcribe submit --json-file video_tasks.json
+
+# 查询状态和结果
 9000ai task status --task-id <task_id>
 9000ai task results --task-id <task_id>
+
+# 只提取原文
 9000ai transcribe text --task-id <task_id>
 ```
 
@@ -107,7 +108,7 @@ timecodes.sentences[*].text
 
 ### 数据精简
 
-任务结果支持 `--fields` 和 `--compact`。**默认必须用 `--fields` 只取需要的字段，禁止全量读取。**
+**默认必须用 `--fields` 只取需要的字段，禁止全量读取。**
 
 ```bash
 # 错误 — 返回全量转写 JSON，浪费上下文
@@ -116,26 +117,14 @@ timecodes.sentences[*].text
 # 正确 — 只取需要的字段
 9000ai task results --task-id <id> --fields status,output,video_url
 
-# 只要原文 — 用专用命令，不要读全量 JSON
+# 只要原文 — 用专用命令
 9000ai transcribe text --task-id <task_id>
 ```
 
-常用字段组合：
-- 状态检查：`--fields status,progress,message`
-- 结果提取：`--fields status,output,video_url`
-
 ### 并行执行
 
 独立操作必须并行，不要串行等待。
 
-可以并行：
-- 查多个 task_id 的状态
-- 提取多个任务的原文（多个 `transcribe text` 并行）
-- 写文件 + 提交下一批转写任务
-
-不能并行：
-- 提交任务 → 查结果（需要 task_id，且任务需时间完成）
-
 ### 不暴露中间过程
 
 拿到转写结果后直接输出文案或执行下一步，不要把原始 JSON 全量展示给用户。

package/skills/video-transcription/references/endpoints.md

@@ -12,25 +12,23 @@ http://127.0.0.1:8025
 X-API-Key: <你的 key>
 ```
 
-本地固定配置文件：
+## 按 video_id 转写（推荐）
 
 ```text
-video-transcription/local/config.json
+POST /api/v1/media/transcribe-by-video-ids
 ```
 
-## 查看当前调用方
+请求体：
 
-```text
-GET /api/v1/auth/me
-```
-
-## 查看当前已开通能力
-
-```text
-GET /api/v1/auth/capability-permissions
+```json
+{
+  "video_ids": ["7582142740935970054", "7576959070901930987"],
+  "group_label": "竞品分析",
+  "webhook": "https://example.com/callback"
+}
 ```
 
-## 提交批量视频转文字
+## 提交批量视频转文字（传 URL）
 
 ```text
 POST /api/v1/media/batch-video-to-text
@@ -45,7 +43,9 @@ POST /api/v1/media/batch-video-to-text
       "video_url": "https://example.com/video.mp4",
       "third_party_task_id": "demo-001"
     }
-  ]
+  ],
+  "group_label": "批次标签",
+  "webhook": "https://example.com/callback"
 }
 ```