@9000ai/cli 0.4.0 → 0.5.1

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+## What's new in v0.5.1
+
+- `9000ai init --path <dir>` — one command to setup workspace
+- `9000ai search keyword --wait` — auto-poll, returns results directly
+- `9000ai transcribe submit --wait` — same for transcription
+- `9000ai monitor fetch --sec-user <id>` — fetch user homepage videos instantly
+- Streamlined skills (removed legacy Python scripts)
+- Hub SKILL.md: cleaner structure with call principles

package/dist/client.d.ts

@@ -7,6 +7,12 @@ export interface RequestOptions {
     timeout?: number;
 }
 export declare function request(opts: RequestOptions): Promise<unknown>;
+/** Poll a task/batch until terminal status. Returns final response data. */
+export declare function pollUntilDone(path: string, opts?: {
+    interval?: number;
+    timeout?: number;
+    quiet?: boolean;
+}): Promise<unknown>;
 export declare function printJson(data: unknown, opts?: {
     fields?: string;
     compact?: boolean;

package/dist/client.js

@@ -40,6 +40,28 @@ export async function request(opts) {
         clearTimeout(timer);
     }
 }
+/** Poll a task/batch until terminal status. Returns final response data. */
+export async function pollUntilDone(path, opts) {
+    const interval = opts?.interval ?? 3_000;
+    const timeout = opts?.timeout ?? 600_000;
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+        const data = await request({ method: "GET", path });
+        const resp = data;
+        const inner = (resp.data ?? resp);
+        const status = (inner.status ?? "").toUpperCase();
+        if (["SUCCESS", "COMPLETED", "FAILED", "ERROR"].includes(status)) {
+            return data;
+        }
+        if (!opts?.quiet) {
+            const elapsed = Math.round((Date.now() - start) / 1000);
+            console.error(`[${elapsed}s] status: ${status || "PENDING"} — polling...`);
+        }
+        await new Promise((r) => setTimeout(r, interval));
+    }
+    console.error("Error: poll timed out");
+    process.exit(1);
+}
 export function printJson(data, opts) {
     let output = data;
     // --fields: extract specified fields from items/data

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerInitCommand(program: Command): void;

package/dist/commands/init.js

@@ -0,0 +1,83 @@
+import { existsSync, mkdirSync, copyFileSync, readdirSync, statSync } from "fs";
+import { homedir } from "os";
+import { join, relative } from "path";
+const TEMPLATES_DIR = join(homedir(), ".9000ai", "skills", "9000AI-hub", "init", "templates");
+/** Files under profile/ are never overwritten — user may have edited them. */
+const NEVER_OVERWRITE_DIRS = ["profile"];
+function copyTemplates(src, dest, relBase) {
+    const created = [];
+    const skipped = [];
+    if (!existsSync(src))
+        return { created, skipped };
+    const entries = readdirSync(src);
+    for (const entry of entries) {
+        const srcPath = join(src, entry);
+        const destPath = join(dest, entry);
+        const rel = relative(relBase, destPath);
+        const stat = statSync(srcPath);
+        if (stat.isDirectory()) {
+            if (!existsSync(destPath)) {
+                mkdirSync(destPath, { recursive: true });
+            }
+            const sub = copyTemplates(srcPath, destPath, relBase);
+            created.push(...sub.created);
+            skipped.push(...sub.skipped);
+        }
+        else {
+            if (existsSync(destPath)) {
+                // Never overwrite profile files
+                const topDir = rel.split(/[/\\]/)[0];
+                if (NEVER_OVERWRITE_DIRS.includes(topDir)) {
+                    skipped.push(rel);
+                    continue;
+                }
+                // Other existing files: also skip (idempotent)
+                skipped.push(rel);
+            }
+            else {
+                mkdirSync(join(destPath, ".."), { recursive: true });
+                copyFileSync(srcPath, destPath);
+                created.push(rel);
+            }
+        }
+    }
+    return { created, skipped };
+}
+export function registerInitCommand(program) {
+    program
+        .command("init")
+        .description("Initialize content workspace — copy templates to project directory")
+        .requiredOption("--path <dir>", "Project directory to initialize")
+        .action((opts) => {
+        const dest = opts.path;
+        // Check templates exist
+        if (!existsSync(TEMPLATES_DIR)) {
+            console.error(`Error: Templates not found at ${TEMPLATES_DIR}\n` +
+                `Run: npm install -g @9000ai/cli`);
+            process.exit(1);
+        }
+        // Create dest if needed
+        if (!existsSync(dest)) {
+            mkdirSync(dest, { recursive: true });
+        }
+        const { created, skipped } = copyTemplates(TEMPLATES_DIR, dest, dest);
+        // Output summary
+        if (created.length > 0) {
+            console.log(`Created ${created.length} files:`);
+            created.forEach((f) => console.log(`  + ${f}`));
+        }
+        if (skipped.length > 0) {
+            console.log(`Skipped ${skipped.length} existing files:`);
+            skipped.forEach((f) => console.log(`  - ${f}`));
+        }
+        if (created.length === 0 && skipped.length === 0) {
+            console.log("No template files found.");
+            return;
+        }
+        console.log(`\nWorkspace ready: ${dest}`);
+        console.log(`\nNext steps:`);
+        console.log(`  1. Fill in profile/ (identity.md, voice.md, topics.md, product.md)`);
+        console.log(`  2. cd ${dest}`);
+        console.log(`  3. Open Claude Code and start working`);
+    });
+}

package/dist/commands/monitor.js

@@ -104,4 +104,21 @@ export function registerMonitorCommands(parent) {
         const data = await request({ method: "GET", path: `/api/v1/douyin/monitor/runs/${opts.runId}` });
         printJson(data, { fields: opts.fields, compact: opts.compact });
     });
+    cmd
+        .command("fetch")
+        .description("Fetch user homepage videos directly (sync, no queue)")
+        .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("--fields <list>", "Comma-separated fields to extract")
+        .option("--compact", "One JSON object per line")
+        .action(async (opts) => {
+        const params = new URLSearchParams({
+            sec_user_id: opts.secUser,
+            count: opts.count,
+            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 });
+    });
 }

package/dist/commands/search.js

@@ -1,4 +1,4 @@
-import { request, printJson } from "../client.js";
+import { request, printJson, pollUntilDone } from "../client.js";
 import { writeJson, writeTsv, listOutputFiles, readOutputJson, timestampSlug } from "../output.js";
 export function registerSearchCommands(parent) {
     const cmd = parent.command("search").description("Douyin topic discovery — trending boards and keyword search");
@@ -36,6 +36,9 @@ export function registerSearchCommands(parent) {
         .option("--filter-duration <v>", "Duration filter", "")
         .option("--min-likes <n>", "Minimum likes", "0")
         .option("--min-comments <n>", "Minimum comments", "0")
+        .option("--wait", "Poll until batch 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 (keywords, opts) => {
         const payload = {
             keywords,
@@ -55,9 +58,32 @@ export function registerSearchCommands(parent) {
         });
         const resp = data;
         const inner = resp.data;
-        console.log(`Batch submitted → batch_id: ${inner?.batch_id}`);
-        console.log(`Use: 9000ai search batch-result --batch-id ${inner?.batch_id}`);
-        printJson(inner);
+        const batchId = inner?.batch_id;
+        if (!opts.wait || !batchId) {
+            console.log(`Batch submitted → batch_id: ${batchId}`);
+            console.log(`Use: 9000ai search batch-result --batch-id ${batchId}`);
+            printJson(inner);
+            return;
+        }
+        // --wait: poll then fetch results
+        console.error(`Batch submitted → ${batchId}, waiting...`);
+        await pollUntilDone(`/api/v1/tasks/batch/${batchId}`);
+        const resultData = await request({
+            method: "GET",
+            path: `/api/v1/douyin/discovery/search-videos/batch/${batchId}/results`,
+        });
+        const resultResp = resultData;
+        const resultInner = resultResp.data;
+        const items = (resultInner?.items ?? []);
+        if (items.length > 0) {
+            const slug = timestampSlug();
+            writeJson("latest_search.json", resultInner);
+            writeJson(`latest_search_${slug}.json`, resultInner);
+            writeTsv("latest_search.tsv", items);
+            writeTsv(`latest_search_${slug}.tsv`, items);
+            console.error(`${items.length} items → output/latest_search.json`);
+        }
+        printJson(resultInner, { fields: opts.fields, compact: opts.compact });
     });
     cmd
         .command("batch-result")

package/dist/commands/transcribe.js

@@ -1,4 +1,4 @@
-import { request, printJson } from "../client.js";
+import { request, printJson, pollUntilDone } from "../client.js";
 import { loadJsonFile } from "../utils/format.js";
 export function registerTranscribeCommands(parent) {
     const cmd = parent.command("transcribe").description("Video / audio transcription");
@@ -6,6 +6,9 @@ export function registerTranscribeCommands(parent) {
         .command("submit")
         .description("Submit batch video-to-text task")
         .requiredOption("--json-file <path>", "JSON file with video task details")
+        .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) => {
         const payload = loadJsonFile(opts.jsonFile);
         const data = await request({
@@ -13,7 +16,21 @@ export function registerTranscribeCommands(parent) {
             path: "/api/v1/media/batch-video-to-text",
             payload,
         });
-        printJson(data);
+        const resp = data;
+        const inner = resp.data;
+        const batchId = inner?.batch_id;
+        if (!opts.wait || !batchId) {
+            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({
+            method: "GET",
+            path: `/api/v1/tasks/batch/${batchId}`,
+        });
+        printJson(resultData, { fields: opts.fields, compact: opts.compact });
     });
     cmd
         .command("text")

package/dist/index.js

@@ -8,11 +8,12 @@ import { registerTranscribeCommands } from "./commands/transcribe.js";
 import { registerTaskCommands } from "./commands/task.js";
 import { registerFeedbackCommands } from "./commands/feedback.js";
 import { registerSkillCommands } from "./commands/skill.js";
+import { registerInitCommand } from "./commands/init.js";
 const program = new Command();
 program
     .name("9000ai")
     .description("9000AI Toolbox CLI — unified interface for 9000AI platform")
-    .version("0.4.0");
+    .version("0.5.0");
 registerConfigCommands(program);
 registerAuthCommands(program);
 registerSearchCommands(program);
@@ -21,6 +22,7 @@ registerTranscribeCommands(program);
 registerTaskCommands(program);
 registerFeedbackCommands(program);
 registerSkillCommands(program);
+registerInitCommand(program);
 program.parseAsync(process.argv).catch((err) => {
     console.error(err);
     process.exit(1);

package/dist/postinstall.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
 /**
- * postinstall: copy bundled skills to ~/.9000ai/skills/
+ * postinstall: copy bundled skills to ~/.9000ai/skills/ and show changelog
  */
 export {};

package/dist/postinstall.js

@@ -1,17 +1,40 @@
 #!/usr/bin/env node
 /**
- * postinstall: copy bundled skills to ~/.9000ai/skills/
+ * postinstall: copy bundled skills to ~/.9000ai/skills/ and show changelog
  */
-import { existsSync, mkdirSync, cpSync } from "fs";
+import { existsSync, mkdirSync, cpSync, readFileSync } from "fs";
 import { dirname, join } from "path";
 import { homedir } from "os";
 import { fileURLToPath } from "url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const src = join(__dirname, "..", "skills");
 const dest = join(homedir(), ".9000ai", "skills");
+// Read version
+let version = "unknown";
+try {
+    const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+    version = pkg.version;
+}
+catch { }
 if (!existsSync(src)) {
     process.exit(0);
 }
 mkdirSync(dest, { recursive: true });
 cpSync(src, dest, { recursive: true, force: true });
-console.log(`9000AI skills installed → ${dest}`);
+// Read changelog
+let changelog = "";
+try {
+    changelog = readFileSync(join(__dirname, "..", "CHANGELOG.md"), "utf-8");
+}
+catch { }
+console.log(`\n@9000ai/cli v${version} installed\n`);
+console.log(`Skills updated: ${dest}\n`);
+if (changelog) {
+    console.log(changelog);
+    console.log("");
+}
+console.log(`Get started:`);
+console.log(`  1. 9000ai config set --base-url <server-url> --api-key <key>`);
+console.log(`  2. 9000ai init --path <your-project-dir>`);
+console.log(`  3. cd <your-project-dir> → start working`);
+console.log(`\nUpdate: npm update -g @9000ai/cli\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@9000ai/cli",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "9000AI Toolbox CLI — unified command-line interface for 9000AI platform",
   "type": "module",
   "bin": {
@@ -14,7 +14,8 @@
   },
   "files": [
     "dist",
-    "skills"
+    "skills",
+    "CHANGELOG.md"
   ],
   "dependencies": {
     "commander": "^12.1.0"

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

@@ -1,10 +1,13 @@
 ---
-name: 9000AI-hub-9000AI
-description: 9000AI 中台总入口。用于识别用户属于哪个业务模块，并路由到对应 skill。中台只负责目录、主调用命令、路由规则和统一使用规范，不直接执行业务。
+name: 9000AI-hub
+description: 9000AI 中台总入口。识别用户意图，路由到对应模块。首次使用时引导初始化。
 triggers:
   - /9000AI
   - /9000AI中台
-  - 9000AI中台
+  - /content-init
+  - /初始化工作空间
+  - 初始化
+  - 第一次用
 role: router
 scope: routing
 output-format: routing-only
@@ -12,227 +15,109 @@ output-format: routing-only
 
 # 9000AI 中台
 
-## 作用
+9000AI 是一个内容创作者中台。它把抖音热榜、关键词搜索、主页监控、视频转写这些能力整合在一起，通过 `9000ai` CLI 统一调用，后端异步执行。
 
-你是 9000AI 的总入口。
-你的职责不是直接执行业务，而是：
-1. 识别用户当前属于哪个模块
-2. 告诉系统应该进入哪个 skill
-3. 在必要时提示下一步怎么继续
+你作为 AI 助手，通过这个中台帮用户完成选题发现、竞品分析、素材采集等内容创作工作流。中台只是工具层——你负责理解用户意图、编排调用、输出结果。
 
-中台不重复解释子 skill 的全部细节。具体参数、脚本命令、输出文件格式，以对应子 skill 的 `SKILL.md` 为准。
+## 调用原则
 
-## 总原则
+1. **无依赖的操作必须并行。** 热榜+搜索、多个关键词——没有数据依赖就同时发出
+2. **异步任务用 `--wait`。** 搜索和转写加 `--wait`，一条命令拿到最终结果
+3. **有依赖的操作串行。** 上一步输出是下一步输入时，必须等
+4. **用 `--fields` 只取需要的字段。** 永远不要全量读取
 
-1. 优先选择最贴近用户意图的单个模块
-2. 不要同时展开多个模块，除非用户明确要求串联
-3. 中台只提供主调用命令，不展开全部子命令
-4. 统一环境变量、统一 runner 规范，以中台为准
-5. 如果用户只是泛泛提问，先帮他判断该进入哪个模块
-
-## 初始化（首次使用必读）
-
-### 这一步在干什么？
-
-9000AI 的 skill（热榜、监控、转写……）本身不直接干活，它们只是"遥控器"。
-真正干活的是 **9000AI 中台服务**——一个跑在某台电脑上的后端程序。
+```bash
+# 单任务
+9000ai search keyword "美食探店" --wait --fields desc,likes,author_name
+
+# 多数据源并行
+并行 {
+  9000ai search hot
+  9000ai search keyword "关键词A" --wait --fields desc,likes,author_name
+  9000ai search keyword "关键词B" --wait --fields desc,likes,author_name
+}
+
+# 有依赖，串行
+9000ai search keyword "xxx" --wait --fields desc,video_url,likes
+→ 拿 video_url → 9000ai transcribe submit --json-file ... --wait
+```
 
-初始化就是告诉这些遥控器：**中台服务跑在哪、用什么钥匙才能连上去。**
+## 模块目录
 
-你需要两样东西：
+### 抖音选题发现
+- 命令: `9000ai search`
+- 场景: 热榜、关键词搜索、候选视频发现
 
-| 要填的 | 是什么 | 从哪来 |
-|--------|--------|--------|
-| `--base-url` | 中台服务的网络地址 | 跑服务的那台电脑的 IP + 端口，比如 `http://192.168.1.100:8025` |
-| `--api-key` | 你的身份钥匙 | 在中台后端的 `.env` 文件里配置，找管理员要 |
+### 抖音主页监控
+- 命令: `9000ai monitor`
+- 场景: 直接获取主页视频（`monitor fetch`）、加入监控队列（`monitor submit`）
 
-> **怎么找 base-url？**
-> 在跑中台服务的那台电脑上，打开终端输入 `ipconfig`（Windows）或 `ifconfig`（Mac/Linux），
-> 找到局域网 IP（通常是 `192.168.x.x`），加上端口 `8025`，就是你的地址。
-> 如果你就在跑服务的这台电脑上用，填 `http://127.0.0.1:8025` 就行。
+### 视频转写
+- 命令: `9000ai transcribe`
+- 场景: 批量视频转文字、查看转写结果
 
-### 怎么初始化？
+### 反馈提交
+- 命令: `9000ai feedback`
+- 场景: 提交反馈、查看记录。接口报错或用户不满时主动提议反馈
 
-**只需要跑一次**，之后所有命令都自动共享这个配置：
+## 路由规则
 
-```bash
-9000ai config set --base-url http://192.168.x.x:8025 --api-key sk-xxx
-```
+| 用户意图 | 路由 |
+|---------|------|
+| 初始化 / 第一次用 / 搭建工作空间 | 执行下方"首次使用流程" |
+| 查热榜 / 搜抖音 / 找选题 | `9000ai search` |
+| 看某人主页 / 监控抖音号 | `9000ai monitor` |
+| 视频转文字 / 转写 | `9000ai transcribe` |
+| 反馈 / 建议 / 报 bug | `9000ai feedback` |
 
-成功后会看到确认信息。如果以后中台换了地址或换了 key，再跑一次就行。
+## 首次使用流程
 
-### 怎么检查当前配置？
+### 1. 确认中台连接
 
 ```bash
 9000ai config show
 ```
 
-### 没初始化会怎样？
+未配置 → 问用户要地址和 key：
 
-任何 skill 在调用中台时都会报错：`缺少 API key`，并提示你先运行上面的初始化命令。
-
-### 配置存在哪？
-
-保存在 `9000AI-hub-9000AI/local/config.json`（这个文件不入 git，不用担心泄露）。
-各 skill 不需要单独配置，都从这里读。
-
-## PowerShell 编码准则
-
-在 Windows PowerShell 里直接跑脚本时，默认编码容易把中文参数和输出搞乱码。
-进入任何 9000AI skill 之前，先按 UTF-8 设好控制台：
-
-```powershell
-$env:PYTHONIOENCODING = 'utf-8'
-[Console]::InputEncoding = [System.Text.Encoding]::UTF8
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+```bash
+9000ai config set --base-url <地址> --api-key <key>
 ```
 
-如果不先设 UTF-8，常见问题是：
-- 中文关键词被打坏
-- 返回 JSON 中文发花
-- 复制到后续命令里的参数失真
-
-## 模块目录
-
-### 0. 内容工作空间初始化
-
-- skill: `content-init`（位于 `9000AI-hub-9000AI/init/SKILL.md`）
-- 主调用命令: `/content-init`
-- 适用场景:
-  - 首次使用 9000AI 内容中台
-  - 初始化项目工作空间目录结构
-  - 创建 agent 人格、主张库模板、用户画像模板
-  - 查看使用指南
-
-### 1. 抖音主页监控
-
-- skill: `douyin-monitor-9000AI`
-- 主调用命令: `/douyin-monitor-9000AI`
-- 适用场景:
-  - 添加监控账号
-  - 发起主页监控
-  - 查看监控运行状态
-  - 回看监控结果
-
-### 2. 抖音选题发现
-
-- skill: `douyin-topic-discovery-9000AI`
-- 主调用命令: `/douyin-topic-discovery-9000AI`
-- 适用场景:
-  - 抖音热榜
-  - 抖音搜索流
-  - 候选视频发现
-  - 搜索结果落本地 output 文件
-
-### 3. 视频转写
-
-- skill: `video-transcription`
-- 主调用命令: `/video-transcription`
-- 适用场景:
-  - 批量视频转文字
-  - 查看转写任务状态
-  - 回看转写结果
-
-### 4. 反馈提交
-
-- skill: `feedback-9000AI`
-- 主调用命令: `/feedback-9000AI`
-- 适用场景:
-  - 提交使用反馈（工作流串联建议、Bug、功能请求等）
-  - 查看自己的反馈记录
-
-## 路由规则
-
-- 用户要”初始化 / 开始使用 / 搭建工作空间 / 第一次用 / 初始化内容工作空间”
-  - 路由到 `content-init`（`9000AI-hub-9000AI/init/SKILL.md`）
-
-- 用户要”监控抖音号 / 看主页更新 / 查主页监控结果”
-  - 路由到 `douyin-monitor-9000AI`
-
-- 用户要“查热榜 / 搜抖音内容 / 找选题 / 找候选视频”
-  - 路由到 `douyin-topic-discovery-9000AI`
-
-- 用户要”把视频转成文字 / 提交转写 / 看转写结果”
-  - 路由到 `video-transcription`
-
-- 用户要”提交反馈 / 有建议 / 报 bug / 反馈意见”
-  - 路由到 `feedback-9000AI`
-
-## 串联规则
-
-只有在用户明确要求多步串联时，才跨模块：
-
-- 先搜索，再转写
-- 先监控，再分析结果
-
-如果需要串联：
-1. 先进入第一个模块完成提交
-2. 拿到任务结果或结果引用
-3. 再进入下一个模块继续执行
-
-## 统一使用规范
-
-1. 不把大结果直接塞进上下文
-2. 优先使用子 skill 的 `output` 文件、`task_id`、`batch_id`、`row_no` 继续操作
-3. 不在中台里展开子 skill 的全部脚本命令
-4. 如果用户问”该用哪个模块”，中台负责判断
-5. 如果用户已经明确说了模块名，直接进入对应 skill
-6. 共享执行底座以 `9000AI-hub-9000AI/shared/runner.py` 为准
-7. 统一 runner 规范以 `9000AI-hub-9000AI/references/runner-spec-v1.md` 为准
-8. 以下情况主动提议进入 `feedback-9000AI` 提交反馈，不要等用户说：
-   - 任何 skill 出现接口报错、任务失败、结果异常
-   - 发现某个工作流可以改进或串联自动化
-   - 用户表达了不满、困惑或明确的改进意见
-
-## 性能准则（必须遵守）
-
-### 数据精简
-
-所有查询命令都支持 `--fields` 和 `--compact` 参数。**默认必须用 `--fields` 只取需要的字段，禁止全量读取。**
+### 2. 初始化工作空间
 
 ```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
+9000ai init --path <项目目录>
 ```
 
-常用字段组合：
-- 搜索结果概览：`--fields desc,author_name,likes,duration`
-- 提取转写链接：`--fields video_url,download_url,play_url,desc`
-- 监控结果摘要：`--fields desc,author_name,likes,comments,create_time`
+### 3. 载入角色
 
-### 并行执行
+初始化完成后，读取项目目录下的 `agents/content-agent.md` 作为你的角色设定。这个文件定义了你的工作方式、可用能力、inbox 处理规则等。
 
-独立的操作必须并行，不要串行等待。用 subagent 或并行工具调用。
+**如果用户还没初始化**，你只有中台调度能力。**初始化后**，你才是完整的内容创作执行助手。
 
-可以并行的场景：
-- 写 inbox 文件 + 提交转写任务
-- 多个关键词的搜索结果查询
-- 查多个 task_id 的状态
+### 4. 了解用户
 
-不能并行的场景：
-- 搜索 → 等结果 → 筛选（有依赖关系）
-- 创建监控对象 → 提交监控任务（需要 creator_id）
+主动发起对话：
 
-### 减少中间文件
+> 工作空间搭好了。我想先了解一下你，这样后面做选题会更精准。
+> 我们可以聊几个问题，也可以你把资料丢进 inbox/（支持 .txt），我来提取。
 
-CLI 支持 `--json-file` 也支持直接传参。简单请求直接传参，不要写中间 JSON 文件。
+**对话模式** — 依次引导：
+1. **identity.md** — 你是谁？做什么业务？目标受众？
+2. **voice.md** — 内容风格？参考博主？什么话不说？
+3. **topics.md** — 主攻方向？不碰的领域？
+4. **product.md** — 产品/服务？定价？核心卖点？
 
-### 不暴露中间过程
+**inbox 模式** — 读取 inbox/ 的 .txt，提取信息填充 profile/。
 
-用户要的是结果，不是过程。拿到数据后直接输出摘要或执行下一步，不要把原始 JSON 展示给用户。
+完成后：
 
-## 一句话总结
+> 画像建好了。现在可以开始——比如"帮我做选题调研"、"看看最近热榜"。
 
-中台只负责：
+## 参考文档
 
-- 看用户要做什么
-- 告诉系统该去哪个 skill
-- 给出主调用命令
+需要更详细的使用规范时查阅：
 
-中台不直接执行业务。
+- `references/usage-guidelines.md` — 性能准则、字段组合、串联规则、PowerShell 编码
+- `references/env.example` — 环境变量示例