@9000ai/cli 0.2.0 → 0.4.0

package/dist/client.d.ts

@@ -7,4 +7,7 @@ export interface RequestOptions {
     timeout?: number;
 }
 export declare function request(opts: RequestOptions): Promise<unknown>;
-export declare function printJson(data: unknown): void;
+export declare function printJson(data: unknown, opts?: {
+    fields?: string;
+    compact?: boolean;
+}): void;

package/dist/client.js

@@ -40,6 +40,93 @@ export async function request(opts) {
         clearTimeout(timer);
     }
 }
-export function printJson(data) {
-    console.log(JSON.stringify(data, null, 2));
+export function printJson(data, opts) {
+    let output = data;
+    // --fields: extract specified fields from items/data
+    if (opts?.fields) {
+        const fieldList = opts.fields.split(",").map((f) => f.trim());
+        output = pickFields(output, fieldList);
+    }
+    // --compact: one-line-per-item for arrays
+    if (opts?.compact) {
+        const arr = extractArray(output);
+        if (arr) {
+            arr.forEach((item) => console.log(JSON.stringify(item)));
+            return;
+        }
+    }
+    console.log(JSON.stringify(output, null, 2));
+}
+/** Deep-pick fields from API response. Handles nested data.items / data.tasks structures. */
+function pickFields(data, fields) {
+    if (!data || typeof data !== "object")
+        return data;
+    const obj = data;
+    // If response has code/message/data wrapper, dig into data
+    if ("code" in obj && "data" in obj) {
+        const inner = obj.data;
+        if (!inner)
+            return obj;
+        return pickFieldsFromInner(inner, fields);
+    }
+    // Already unwrapped (e.g. inner passed directly)
+    return pickFieldsFromInner(obj, fields);
+}
+function pickFieldsFromInner(inner, fields) {
+    // If has items array, pick from each item
+    if (Array.isArray(inner.items)) {
+        return {
+            ...stripArrays(inner),
+            items: inner.items.map((item) => pick(item, fields)),
+        };
+    }
+    // If has tasks array with nested items
+    if (Array.isArray(inner.tasks)) {
+        return {
+            ...stripArrays(inner),
+            tasks: inner.tasks.map((task) => {
+                const t = { ...task };
+                if (Array.isArray(t.items)) {
+                    t.items = t.items.map((item) => pick(item, fields));
+                }
+                return t;
+            }),
+        };
+    }
+    // Flat data object
+    return pick(inner, fields);
+}
+function pick(obj, fields) {
+    const result = {};
+    for (const field of fields) {
+        if (field in obj) {
+            result[field] = obj[field];
+        }
+    }
+    return result;
+}
+function stripArrays(obj) {
+    const result = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (!Array.isArray(v))
+            result[k] = v;
+    }
+    return result;
+}
+function extractArray(data) {
+    if (Array.isArray(data))
+        return data;
+    if (!data || typeof data !== "object")
+        return null;
+    const obj = data;
+    // Wrapped response: { code, data: { items: [...] } }
+    if ("code" in obj && "data" in obj) {
+        const inner = obj.data;
+        if (inner && Array.isArray(inner.items))
+            return inner.items;
+    }
+    // Already unwrapped: { items: [...] }
+    if (Array.isArray(obj.items))
+        return obj.items;
+    return null;
 }

package/dist/commands/monitor.js

@@ -5,9 +5,11 @@ export function registerMonitorCommands(parent) {
     cmd
         .command("list-creators")
         .description("List all monitoring targets")
-        .action(async () => {
+        .option("--fields <list>", "Comma-separated fields to extract")
+        .option("--compact", "One JSON object per line")
+        .action(async (opts) => {
         const data = await request({ method: "GET", path: "/api/v1/douyin/monitor/creators" });
-        printJson(data);
+        printJson(data, { fields: opts.fields, compact: opts.compact });
     });
     cmd
         .command("create-creator")
@@ -83,19 +85,23 @@ export function registerMonitorCommands(parent) {
         .option("--page <n>", "Page number", "1")
         .option("--page-size <n>", "Items per page", "20")
         .option("--status <status>", "Filter by status")
+        .option("--fields <list>", "Comma-separated fields to extract")
+        .option("--compact", "One JSON object per line")
         .action(async (opts) => {
         const params = new URLSearchParams({ page: opts.page, page_size: opts.pageSize });
         if (opts.status)
             params.set("status", opts.status);
         const data = await request({ method: "GET", path: `/api/v1/douyin/monitor/runs?${params}` });
-        printJson(data);
+        printJson(data, { fields: opts.fields, compact: opts.compact });
     });
     cmd
         .command("run-detail")
         .description("View single run details")
         .requiredOption("--run-id <id>", "Run ID")
+        .option("--fields <list>", "Comma-separated fields to extract")
+        .option("--compact", "One JSON object per line")
         .action(async (opts) => {
         const data = await request({ method: "GET", path: `/api/v1/douyin/monitor/runs/${opts.runId}` });
-        printJson(data);
+        printJson(data, { fields: opts.fields, compact: opts.compact });
     });
 }

package/dist/commands/search.js

@@ -63,6 +63,8 @@ export function registerSearchCommands(parent) {
         .command("batch-result")
         .description("Query async search batch results")
         .requiredOption("--batch-id <id>", "Batch ID")
+        .option("--fields <list>", "Comma-separated fields to extract (e.g. desc,author_name,likes,video_url)")
+        .option("--compact", "One JSON object per line, no indentation")
         .action(async (opts) => {
         const data = await request({
             method: "GET",
@@ -79,7 +81,7 @@ export function registerSearchCommands(parent) {
             writeTsv(`latest_search_${slug}.tsv`, items);
             console.log(`${items.length} items → output/latest_search.json`);
         }
-        printJson(inner);
+        printJson(inner, { fields: opts.fields, compact: opts.compact });
     });
     cmd
         .command("list-output")

package/dist/commands/task.js

@@ -5,16 +5,20 @@ export function registerTaskCommands(parent) {
         .command("status")
         .description("Check task status")
         .requiredOption("--task-id <id>", "Task ID")
+        .option("--fields <list>", "Comma-separated fields to extract (e.g. desc,video_url,likes)")
+        .option("--compact", "One JSON object per line, no indentation")
         .action(async (opts) => {
         const data = await request({ method: "GET", path: `/api/v1/tasks/${opts.taskId}` });
-        printJson(data);
+        printJson(data, { fields: opts.fields, compact: opts.compact });
     });
     cmd
         .command("results")
         .description("Get task results")
         .requiredOption("--task-id <id>", "Task ID")
+        .option("--fields <list>", "Comma-separated fields to extract (e.g. desc,video_url,likes)")
+        .option("--compact", "One JSON object per line, no indentation")
         .action(async (opts) => {
         const data = await request({ method: "GET", path: `/api/v1/tasks/${opts.taskId}/results` });
-        printJson(data);
+        printJson(data, { fields: opts.fields, compact: opts.compact });
     });
 }

package/dist/index.d.ts

@@ -1 +1,2 @@
+#!/usr/bin/env node
 export {};

package/dist/index.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { Command } from "commander";
 import { registerConfigCommands } from "./commands/config.js";
 import { registerAuthCommands } from "./commands/auth.js";
@@ -11,7 +12,7 @@ const program = new Command();
 program
     .name("9000ai")
     .description("9000AI Toolbox CLI — unified interface for 9000AI platform")
-    .version("0.1.0");
+    .version("0.4.0");
 registerConfigCommands(program);
 registerAuthCommands(program);
 registerSearchCommands(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@9000ai/cli",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "9000AI Toolbox CLI — unified command-line interface for 9000AI platform",
   "type": "module",
   "bin": {

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

@@ -184,6 +184,49 @@ $env:PYTHONIOENCODING = 'utf-8'
    - 发现某个工作流可以改进或串联自动化
    - 用户表达了不满、困惑或明确的改进意见
 
+## 性能准则（必须遵守）
+
+### 数据精简
+
+所有查询命令都支持 `--fields` 和 `--compact` 参数。**默认必须用 `--fields` 只取需要的字段，禁止全量读取。**
+
+```bash
+# 错误 — 返回 83KB 全量数据，浪费上下文
+9000ai task results --task-id <id>
+
+# 正确 — 只取需要的 4 个字段
+9000ai task results --task-id <id> --fields desc,video_url,likes,author_name
+
+# 更紧凑 — 每条一行，适合批量处理
+9000ai task results --task-id <id> --fields desc,video_url,likes --compact
+```
+
+常用字段组合：
+- 搜索结果概览：`--fields desc,author_name,likes,duration`
+- 提取转写链接：`--fields video_url,download_url,play_url,desc`
+- 监控结果摘要：`--fields desc,author_name,likes,comments,create_time`
+
+### 并行执行
+
+独立的操作必须并行，不要串行等待。用 subagent 或并行工具调用。
+
+可以并行的场景：
+- 写 inbox 文件 + 提交转写任务
+- 多个关键词的搜索结果查询
+- 查多个 task_id 的状态
+
+不能并行的场景：
+- 搜索 → 等结果 → 筛选（有依赖关系）
+- 创建监控对象 → 提交监控任务（需要 creator_id）
+
+### 减少中间文件
+
+CLI 支持 `--json-file` 也支持直接传参。简单请求直接传参，不要写中间 JSON 文件。
+
+### 不暴露中间过程
+
+用户要的是结果，不是过程。拿到数据后直接输出摘要或执行下一步，不要把原始 JSON 展示给用户。
+
 ## 一句话总结
 
 中台只负责：

package/skills/douyin-monitor/SKILL.md

@@ -103,6 +103,48 @@ output-format: task-oriented
 9000ai task results --task-id <task_id>
 ```
 
+## 性能准则（必须遵守）
+
+### 数据精简
+
+任务结果和监控详情都支持 `--fields` 和 `--compact`。**默认必须用 `--fields` 只取需要的字段，禁止全量读取。**
+
+```bash
+# 错误 — 返回全量 JSON，浪费上下文
+9000ai task results --task-id <id>
+
+# 正确 — 只取监控摘要字段
+9000ai task results --task-id <id> --fields desc,author_name,likes,comments,create_time
+
+# 更紧凑 — 每条一行
+9000ai task results --task-id <id> --fields desc,author_name,likes --compact
+```
+
+常用字段组合：
+- 监控结果摘要：`--fields desc,author_name,likes,comments,create_time`
+- 提取视频链接：`--fields desc,video_url,download_url,play_url`
+- 运行状态检查：`--fields status,total,success,failed`
+
+### 并行执行
+
+独立操作必须并行，不要串行等待。
+
+可以并行：
+- 查多个 task_id 的状态或结果
+- 写 inbox 文件 + 提交转写任务
+
+不能并行：
+- 创建监控对象 → 提交监控任务（需要 creator_id）
+- 提交任务 → 查结果（需要 task_id）
+
+### 减少中间文件
+
+CLI 支持 `--json-file` 也支持直接传参。简单操作（启停、重置、删除）直接传参，不要写 JSON 文件。
+
+### 不暴露中间过程
+
+拿到监控结果后直接输出摘要或执行下一步，不要把原始 JSON 全量展示给用户。
+
 ## 参考
 
 接口和请求体示例见：

package/skills/douyin-topic-discovery/SKILL.md

@@ -141,6 +141,48 @@ output/
 - `search` 每个关键词默认抓取 `30` 条
 - 后端会基于 `search_general_v3` 自动翻页聚合，不需要额外传分页参数
 
+## 性能准则（必须遵守）
+
+### 数据精简
+
+搜索结果和任务结果都支持 `--fields` 和 `--compact`。**默认必须用 `--fields` 只取需要的字段，禁止全量读取。**
+
+```bash
+# 错误 — 返回全量 JSON，浪费上下文
+9000ai search batch-result --batch-id <id>
+
+# 正确 — 只取选题需要的字段
+9000ai search batch-result --batch-id <id> --fields desc,author_name,likes,duration
+
+# 更紧凑 — 每条一行
+9000ai search batch-result --batch-id <id> --fields desc,author_name,likes --compact
+```
+
+常用字段组合：
+- 选题概览：`--fields desc,author_name,likes,duration,comments`
+- 提取视频链接：`--fields desc,video_url,download_url,play_url`
+- 热榜摘要：`--fields title,hot_value,label`
+
+### 并行执行
+
+独立操作必须并行，不要串行等待。
+
+可以并行：
+- 多个 `batch-result` 查询（不同 batch_id）
+- 写输出文件 + 查询下一批结果
+- 多关键词搜索提交后，同时查询各自的 batch_id
+
+不能并行：
+- 提交搜索 → 等 batch_id 返回 → 查询结果（有依赖）
+
+### 减少中间文件
+
+简单的热榜或搜索请求直接用命令行参数，不要写 JSON 文件。
+
+### 不暴露中间过程
+
+拿到搜索结果后直接输出摘要或执行下一步，不要把原始 JSON 全量展示给用户。
+
 ## 一句话总结
 
 这是一个”热榜 + search_general_v3 搜索流”的抖音选题发现 skill。

package/skills/video-transcription/SKILL.md

@@ -103,6 +103,43 @@ timecodes.sentences[*].text
 9000ai transcribe text --task-id <task_id>
 ```
 
+## 性能准则（必须遵守）
+
+### 数据精简
+
+任务结果支持 `--fields` 和 `--compact`。**默认必须用 `--fields` 只取需要的字段，禁止全量读取。**
+
+```bash
+# 错误 — 返回全量转写 JSON，浪费上下文
+9000ai task results --task-id <id>
+
+# 正确 — 只取需要的字段
+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 全量展示给用户。
+
 ## 参考
 
 接口细节和 JSON 示例见 `references/endpoints.md`。