@9000ai/cli 0.5.4 → 0.5.5

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## What's new in v0.5.5
+
+- `--format csv` — search keyword, batch-result, monitor fetch 均支持 CSV 输出，省 token
+- `--skills-path` — `config set --skills-path <dir>` 自定义 skills 安装路径
+- `9000ai update --path <dir>` — 指定 skills 同步目标路径
+- 统一字段名：monitor fetch 返回 `desc`/`create_time`（与 search 一致）
+
 ## What's new in v0.5.3
 
 - `9000ai update` — sync skills after npm update, shows what changed

package/dist/client.d.ts

@@ -16,4 +16,5 @@ export declare function pollUntilDone(path: string, opts?: {
 export declare function printJson(data: unknown, opts?: {
     fields?: string;
     compact?: boolean;
+    format?: string;
 }): void;

package/dist/client.js

@@ -64,6 +64,25 @@ export async function pollUntilDone(path, opts) {
 }
 export function printJson(data, opts) {
     let output = data;
+    // --format csv: extract items array, pick fields, output as CSV
+    if (opts?.format === "csv") {
+        const arr = extractArray(output);
+        if (arr && arr.length > 0) {
+            const fieldList = opts.fields
+                ? opts.fields.split(",").map((f) => f.trim())
+                : Object.keys(arr[0]);
+            const picked = arr.map((item) => pick(item, fieldList));
+            const header = fieldList.join(",");
+            const lines = picked.map((row) => fieldList.map((k) => {
+                const v = String(row[k] ?? "");
+                return v.includes(",") || v.includes('"') || v.includes("\n")
+                    ? `"${v.replace(/"/g, '""')}"`
+                    : v;
+            }).join(","));
+            console.log([header, ...lines].join("\n"));
+            return;
+        }
+    }
     // --fields: extract specified fields from items/data
     if (opts?.fields) {
         const fieldList = opts.fields.split(",").map((f) => f.trim());

package/dist/commands/monitor.js

@@ -110,6 +110,7 @@ export function registerMonitorCommands(parent) {
         .requiredOption("--sec-user <id>", "User sec_user_id or homepage URL")
         .option("--count <n>", "Number of videos to fetch", "20")
         .option("--sort <n>", "Sort: 0=newest 1=hottest", "0")
+        .option("--format <fmt>", "Output format: csv|json", "json")
         .option("--fields <list>", "Comma-separated fields to extract")
         .option("--compact", "One JSON object per line")
         .action(async (opts) => {
@@ -119,6 +120,6 @@ export function registerMonitorCommands(parent) {
             sort_type: opts.sort,
         });
         const data = await request({ method: "GET", path: `/api/v1/douyin/monitor/user-posts?${params}` });
-        printJson(data, { fields: opts.fields, compact: opts.compact });
+        printJson(data, { fields: opts.fields, compact: opts.compact, format: opts.format });
     });
 }

package/dist/commands/search.js

@@ -68,6 +68,7 @@ export function registerSearchCommands(parent) {
         .option("--min-likes <n>", "Minimum likes", "0")
         .option("--min-comments <n>", "Minimum comments", "0")
         .option("--wait", "Poll until batch completes then print results")
+        .option("--format <fmt>", "Output format: csv|json", "json")
         .option("--fields <list>", "Comma-separated fields to extract (used with --wait)")
         .option("--compact", "One JSON object per line (used with --wait)")
         .action(async (keywords, opts) => {
@@ -114,12 +115,13 @@ export function registerSearchCommands(parent) {
             writeTsv(`latest_search_${slug}.tsv`, items);
             console.error(`${items.length} items → output/latest_search.json`);
         }
-        printJson(resultInner, { fields: opts.fields, compact: opts.compact });
+        printJson(resultInner, { fields: opts.fields, compact: opts.compact, format: opts.format });
     });
     cmd
         .command("batch-result")
         .description("Query async search batch results")
         .requiredOption("--batch-id <id>", "Batch ID")
+        .option("--format <fmt>", "Output format: csv|json", "json")
         .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) => {
@@ -138,7 +140,7 @@ export function registerSearchCommands(parent) {
             writeTsv(`latest_search_${slug}.tsv`, items);
             console.log(`${items.length} items → output/latest_search.json`);
         }
-        printJson(inner, { fields: opts.fields, compact: opts.compact });
+        printJson(inner, { fields: opts.fields, compact: opts.compact, format: opts.format });
     });
     cmd
         .command("zhihu-hot")

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.4");
+    .version("0.5.5");
 registerConfigCommands(program);
 registerAuthCommands(program);
 registerSearchCommands(program);

package/package.json

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

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

@@ -25,10 +25,11 @@ output-format: routing-only
 2. **异步任务用 `--wait`。** 搜索和转写加 `--wait`，一条命令拿到最终结果
 3. **有依赖的操作串行。** 上一步输出是下一步输入时，必须等
 4. **用 `--fields` 只取需要的字段。** 永远不要全量读取
+5. **列表数据用 `--format csv`。** 比 JSON 省 token，适合视频列表、搜索结果等
 
 ```bash
 # 单任务
-9000ai search keyword "美食探店" --wait --fields desc,likes,author_name
+9000ai search keyword "美食探店" --wait --format csv --fields desc,likes,author_name
 
 # 多数据源并行
 并行 {

package/skills/douyin-monitor/SKILL.md

@@ -99,7 +99,7 @@ output-format: task-oriented
 9000ai config set --base-url http://127.0.0.1:8025 --api-key <key>
 9000ai auth whoami
 9000ai auth capabilities
-9000ai monitor fetch --sec-user <sec_user_id> --fields description,likes,comments,plays
+9000ai monitor fetch --sec-user <sec_user_id> --fields desc,likes,comments,plays
 9000ai monitor list-creators
 9000ai monitor create-creator --json-file creator.json
 9000ai monitor update-creator --creator-id <creator_id> --json-file creator_update.json
@@ -118,7 +118,7 @@ output-format: task-oriented
 
 ### 数据精简
 
-任务结果和监控详情都支持 `--fields` 和 `--compact`。**默认必须用 `--fields` 只取需要的字段，禁止全量读取。**
+任务结果和监控详情都支持 `--fields`、`--compact` 和 `--format csv`。**默认必须用 `--fields` 只取需要的字段，禁止全量读取。**
 
 ```bash
 # 错误 — 返回全量 JSON，浪费上下文
@@ -127,7 +127,10 @@ output-format: task-oriented
 # 正确 — 只取监控摘要字段
 9000ai task results --task-id <id> --fields desc,author_name,likes,comments,create_time
 
-# 更紧凑 — 每条一行
+# CSV 格式 — 省 token，适合列表数据
+9000ai monitor fetch --sec-user <id> --format csv --fields desc,likes,shares,create_time
+
+# 更紧凑 — 每条一行 JSON
 9000ai task results --task-id <id> --fields desc,author_name,likes --compact
 ```
 

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

@@ -145,7 +145,7 @@ output/
 
 ### 数据精简
 
-搜索结果和任务结果都支持 `--fields` 和 `--compact`。**默认必须用 `--fields` 只取需要的字段，禁止全量读取。**
+搜索结果和任务结果都支持 `--fields`、`--compact` 和 `--format csv`。**默认必须用 `--fields` 只取需要的字段，禁止全量读取。**
 
 ```bash
 # 错误 — 返回全量 JSON，浪费上下文
@@ -154,7 +154,10 @@ output/
 # 正确 — 只取选题需要的字段
 9000ai search batch-result --batch-id <id> --fields desc,author_name,likes,duration
 
-# 更紧凑 — 每条一行
+# CSV 格式 — 省 token，适合列表数据
+9000ai search keyword "美食探店" --wait --format csv --fields desc,author_name,author_sec_uid,likes
+
+# 更紧凑 — 每条一行 JSON
 9000ai search batch-result --batch-id <id> --fields desc,author_name,likes --compact
 ```