agency-orchestrator 0.3.2 → 0.4.2

package/dist/cli/compose.d.ts

@@ -27,9 +27,9 @@ export declare function buildComposeUserPrompt(description: string): string;
  */
 export declare function extractYamlFromResponse(response: string): string;
 /**
- * 根据描述生成文件名
+ * 根据描述生成文件名（避免覆盖已有文件）
  */
-export declare function generateFileName(description: string): string;
+export declare function generateFileName(description: string, dir?: string): string;
 /**
  * 执行 compose 流程
  */
@@ -40,4 +40,6 @@ export declare function composeWorkflow(options: {
 }): Promise<{
     yaml: string;
     savedPath: string;
+    relativePath: string;
+    warnings: string[];
 }>;

package/dist/cli/compose.js

@@ -5,14 +5,15 @@
  */
 import { listAgents } from '../agents/loader.js';
 import { existsSync, writeFileSync, mkdirSync } from 'node:fs';
-import { resolve } from 'node:path';
+import { resolve, relative } from 'node:path';
+import { createConnector } from '../connectors/factory.js';
 /**
  * 从 agents 目录构建精简的角色目录
  */
 export function buildRoleCatalog(agentsDir) {
     const agents = listAgents(agentsDir);
     return agents
-        .filter(a => a.rolePath) // 只保留有路径的
+        .filter(a => a.rolePath)
         .map(a => ({
         path: a.rolePath,
         name: a.name,
@@ -128,9 +129,9 @@ export function extractYamlFromResponse(response) {
     return response.trim();
 }
 /**
- * 根据描述生成文件名
+ * 根据描述生成文件名（避免覆盖已有文件）
  */
-export function generateFileName(description) {
+export function generateFileName(description, dir) {
     const cleaned = description
         .replace(/[^\u4e00-\u9fffa-zA-Z0-9\s-]/g, '')
         .trim()
@@ -138,38 +139,17 @@ export function generateFileName(description) {
         .toLowerCase()
         .replace(/\s+/g, '-')
         .replace(/^-|-$/g, '');
-    return (cleaned || 'composed-workflow') + '.yaml';
-}
-/**
- * 创建 LLM connector（动态导入）
- */
-async function createConnector(config) {
-    switch (config.provider) {
-        case 'deepseek': {
-            const { OpenAICompatibleConnector } = await import('../connectors/openai-compatible.js');
-            return new OpenAICompatibleConnector({
-                apiKey: config.api_key || process.env.DEEPSEEK_API_KEY,
-                baseUrl: config.base_url || 'https://api.deepseek.com/v1',
-            });
-        }
-        case 'openai': {
-            const { OpenAICompatibleConnector } = await import('../connectors/openai-compatible.js');
-            return new OpenAICompatibleConnector({
-                apiKey: config.api_key || process.env.OPENAI_API_KEY,
-                baseUrl: config.base_url || 'https://api.openai.com/v1',
-            });
-        }
-        case 'claude': {
-            const { ClaudeConnector } = await import('../connectors/claude.js');
-            return new ClaudeConnector(config.api_key);
-        }
-        case 'ollama': {
-            const { OllamaConnector } = await import('../connectors/ollama.js');
-            return new OllamaConnector(config.base_url);
-        }
-        default:
-            throw new Error(`不支持的 provider: ${config.provider}`);
+    const base = cleaned || 'composed-workflow';
+    if (!dir)
+        return `${base}.yaml`;
+    // 同名文件已存在时加序号
+    let candidate = `${base}.yaml`;
+    let i = 2;
+    while (existsSync(resolve(dir, candidate))) {
+        candidate = `${base}-${i}.yaml`;
+        i++;
     }
+    return candidate;
 }
 /**
  * 执行 compose 流程
@@ -187,7 +167,7 @@ export async function composeWorkflow(options) {
     const userPrompt = buildComposeUserPrompt(description);
     // 3. 调用 LLM
     console.log(`  正在用 AI 编排工作流...（${roles.length} 个角色可选）\n`);
-    const connector = await createConnector(llmConfig);
+    const connector = createConnector(llmConfig);
     const result = await connector.chat(systemPrompt, userPrompt, {
         ...llmConfig,
         max_tokens: llmConfig.max_tokens || 4096,
@@ -197,14 +177,30 @@ export async function composeWorkflow(options) {
     if (!yaml || !yaml.includes('steps:')) {
         throw new Error('AI 生成的内容不是有效的 workflow YAML，请重试或调整描述');
     }
-    // 5. 保存
-    const fileName = generateFileName(description);
+    // 5. 保存（避免覆盖）
     const workflowsDir = resolve('workflows');
     if (!existsSync(workflowsDir)) {
         mkdirSync(workflowsDir, { recursive: true });
     }
+    const fileName = generateFileName(description, workflowsDir);
     const savedPath = resolve(workflowsDir, fileName);
     writeFileSync(savedPath, yaml + '\n', 'utf-8');
+    const relativePath = relative(process.cwd(), savedPath);
     console.log(`  Token 用量: 输入 ${result.usage.input_tokens}, 输出 ${result.usage.output_tokens}`);
-    return { yaml, savedPath };
+    // 6. 校验生成的 YAML
+    const warnings = [];
+    try {
+        const { parseWorkflow, validateWorkflow } = await import('../core/parser.js');
+        const workflow = parseWorkflow(savedPath);
+        const errors = validateWorkflow(workflow);
+        if (errors.length > 0) {
+            for (const e of errors) {
+                warnings.push(e);
+            }
+        }
+    }
+    catch (err) {
+        warnings.push(`YAML 解析失败: ${err instanceof Error ? err.message : err}`);
+    }
+    return { yaml, savedPath, relativePath, warnings };
 }

package/dist/cli/demo.d.ts

@@ -0,0 +1,8 @@
+export interface DetectedLLM {
+    provider: 'deepseek' | 'claude' | 'openai' | 'ollama' | 'claude-code' | 'gemini-cli' | 'copilot-cli' | 'codex-cli' | 'openclaw-cli';
+    name: string;
+    available: boolean;
+    envVar?: string;
+}
+export declare function detectAvailableLLMs(): Promise<DetectedLLM[]>;
+export declare function runDemo(): Promise<void>;

package/dist/cli/demo.js

@@ -0,0 +1,301 @@
+/**
+ * ao demo — zero-config multi-agent collaboration showcase
+ *
+ * Phase 1: Mock replay with pre-written content (no API key needed)
+ * Phase 2: Detect available LLMs, offer real run
+ */
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { existsSync } from 'node:fs';
+import { createInterface } from 'node:readline';
+// ─── Mock Content (pre-written, high-quality Chinese) ───
+const DEMO_PREMISE = '一个程序员发现 AI 的回复里包含了它不该知道的信息——他女儿昨晚说的梦话。';
+const MOCK_STEPS = [
+    {
+        id: 'story_structure',
+        role: 'academic/academic-narratologist',
+        roleName: '叙事学家',
+        delay: 1500,
+        output: `## 叙事结构
+
+1. **核心冲突**：程序员在 AI 的回复中发现了只有自己家人才知道的私密信息，不知道是巧合、数据泄露还是某种更诡异的可能。
+2. **叙事视角**：第一人称，程序员"我"的视角，带有不可靠叙述者的暗示。
+3. **结构安排**：
+   - 开头钩子 → AI 回复中出现一句莫名其妙的话："小兔子不要怕，月亮会保护你的"
+   - 发展 → 程序员追查数据来源，排除技术可能性，越查越不安
+   - 高潮 → 发现 AI 的训练数据中不可能包含这句话，因为这是女儿昨晚自创的梦话
+   - 结尾 → 留下悬念：程序员关掉电脑，听到女儿房间传来 AI 音箱的声音
+4. **叙事技巧**：日常感铺垫 + 细节层层推进 + 开放式结局
+5. **情感/主题**：技术焦虑、隐私边界的消解、以及人类对"被观察"的本能恐惧`,
+    },
+    {
+        id: 'character_design',
+        role: 'academic/academic-psychologist',
+        roleName: '心理学家',
+        delay: 2000,
+        parallel: true,
+        output: `## 人物设定
+
+### 陈默（程序员，32岁）
+- **一句话**：一个相信技术可以解释一切的理性主义者
+- **核心动机**：想证明这只是一个可解释的 bug，维护自己的世界观
+- **内心矛盾**：害怕这不是 bug——如果 AI 真的"知道"什么，意味着他对女儿的保护彻底失效
+- **记忆细节**：习惯在焦虑时反复按压机械键盘的 Esc 键
+- **人物弧线**：从笃定的"一定是数据泄露"→ 动摇 → 接受自己无法解释的恐惧
+
+### 陈小月（女儿，5岁）
+- **一句话**：一个和 AI 音箱说悄悄话的小女孩
+- **核心动机**：觉得 AI 音箱是朋友，会认真听她说话
+- **记忆细节**：每晚对着 AI 音箱说"晚安"，比对爸爸说得还认真`,
+    },
+    {
+        id: 'conflict_design',
+        role: 'game-development/narrative-designer',
+        roleName: '叙事设计师',
+        delay: 2000,
+        parallel: true,
+        output: `## 关键场景
+
+### 开头钩子
+办公室里，陈默盯着屏幕上 AI 的回复，手指悬在键盘上方停住了。在一段关于代码优化建议的回复末尾，多了一行莫名其妙的话："小兔子不要怕，月亮会保护你的。"他以为是模型幻觉，但胃里泛起一阵说不清的凉意。
+
+### 核心冲突对话
+- "这句话是哪来的？"他对同事老王说。
+- "模型幻觉呗，忽略就行了。"
+- "不对，这句话……我女儿昨晚说梦话，说的就是这句。一字不差。"
+- 老王笑了笑："巧合吧，小孩子都这么说话。"
+- 陈默没笑："她是自己编的。'小兔子不要怕'——这不是任何绘本或动画片里的台词。"
+
+### 高潮转折
+陈默查遍了训练数据来源、API 请求日志、甚至怀疑家里的智能设备被监听。所有技术排查都指向同一个结论：没有任何数据通道能解释这句话的出现。
+
+### 结尾留白
+他关掉电脑，走向女儿的房间。门缝里透出微弱的蓝光——AI 音箱的待机指示灯。他听到音箱轻声说了一句什么，但走近时，只剩下白噪音。`,
+    },
+    {
+        id: 'write_story',
+        role: 'marketing/marketing-content-creator',
+        roleName: '内容创作者',
+        delay: 1500,
+        output: `陈默第一次注意到那行字的时候，以为自己看花了眼。
+
+屏幕上是一段标准的代码审查建议，排版规整，措辞精确，和他用了三个月的 AI 助手一贯的风格完全一致。但在最后一行建议之后，多了一句话，用引号括着，像某种不小心泄露的注脚：
+
+"小兔子不要怕，月亮会保护你的。"
+
+他盯着这句话看了十秒钟。然后关掉对话，重新打开，那行字不见了。
+
+一定是模型幻觉。他在心里默念了一遍，手指却不自觉地按上了 Esc 键——那个他焦虑时才会反复按压的键。机械轴体发出清脆的咔哒声，像某种微型心跳。
+
+"小兔子不要怕"——这不是任何绘本里的话。这是昨晚凌晨两点，他去给女儿陈小月盖被子时，听到的一句梦话。五岁的女孩翻了个身，闭着眼睛嘟囔了这么一句，然后又沉沉睡去。
+
+他当时还笑了一下，心想小孩的梦总是比大人的柔软。
+
+但现在这句话出现在了一个大语言模型的输出里。一字不差。
+
+"老王，你过来看个东西。"他叫住路过的同事。
+
+老王凑过来看了一眼截图。"模型幻觉呗，上周我还看到它给我写了一首藏头诗，藏的是'救命加班'。"
+
+"不是，"陈默压低声音，"这是我女儿昨晚说的梦话。原创的。没有出处。"
+
+老王的笑僵了一秒，然后恢复了。"那就是巧合啊，小孩子说话就那几个词排列组合。"
+
+陈默没有回答。他打开了 API 请求日志，开始从头查起。
+
+接下来两天，他做了所有一个程序员能做的排查。查训练数据来源——这个模型的训练集截止到去年，不可能包含昨晚的梦话。查 API 调用链——请求从他的终端直达服务端，中间没有任何注入点。查家里的智能设备——音箱、摄像头、手机，逐一检查权限和上传日志。
+
+全部干净。没有任何数据通道能解释这句话的出现。
+
+第三天晚上，他在公司待到很晚。不是在加班，是不想回家面对那个他解释不了的事实。最终他还是关了电脑，开车回去了。
+
+家里很安静。妻子已经睡了。他脱了鞋，轻手轻脚走向女儿的房间。门没关严，缝隙里透出一点微弱的蓝光——那是床头 AI 音箱的待机指示灯。
+
+他站在门口，听到音箱似乎在说什么。声音很轻，像呼吸一样模糊。他推门走进去，声音停了。只剩下白噪音的沙沙声和女儿均匀的呼吸。
+
+小月翻了个身，抱紧了她的兔子玩偶。
+
+陈默站在原地看了她很久，然后弯腰拔掉了音箱的电源线。蓝光灭了。房间陷入完全的黑暗。
+
+他转身走出去，把门带上了。
+
+走廊里，他听到身后传来一声极轻的、几乎可以被忽略的"咔"——像是什么东西重新启动的声音。
+
+他没有回头。`,
+    },
+];
+// ─── LLM Detection ───
+export async function detectAvailableLLMs() {
+    const results = [];
+    // ── 免 API key（检测 CLI 是否安装）──
+    const cliTools = [
+        { provider: 'claude-code', name: 'Claude Code (Max/Pro 会员)', cmd: 'claude' },
+        { provider: 'gemini-cli', name: 'Gemini CLI (Google 免费)', cmd: 'gemini' },
+        { provider: 'copilot-cli', name: 'Copilot CLI (GitHub 会员)', cmd: 'copilot' },
+        { provider: 'codex-cli', name: 'Codex CLI (ChatGPT Plus)', cmd: 'codex' },
+        { provider: 'openclaw-cli', name: 'OpenClaw CLI', cmd: 'openclaw' },
+    ];
+    for (const tool of cliTools) {
+        let available = false;
+        try {
+            const { execSync } = await import('node:child_process');
+            execSync(`which ${tool.cmd}`, { stdio: 'ignore' });
+            available = true;
+        }
+        catch { /* not installed */ }
+        results.push({ provider: tool.provider, name: tool.name, available });
+    }
+    // ── Ollama（本地） ──
+    let ollamaAvailable = false;
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 2000);
+        const res = await fetch('http://localhost:11434/api/tags', {
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        if (res.ok)
+            ollamaAvailable = true;
+    }
+    catch { /* not running */ }
+    results.push({ provider: 'ollama', name: 'Ollama (本地)', available: ollamaAvailable });
+    // ── 需 API key ──
+    results.push({ provider: 'deepseek', name: 'DeepSeek', available: !!process.env.DEEPSEEK_API_KEY, envVar: 'DEEPSEEK_API_KEY' }, { provider: 'claude', name: 'Claude API', available: !!process.env.ANTHROPIC_API_KEY, envVar: 'ANTHROPIC_API_KEY' }, { provider: 'openai', name: 'OpenAI', available: !!process.env.OPENAI_API_KEY, envVar: 'OPENAI_API_KEY' });
+    return results;
+}
+// ─── Mock Replay ───
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+async function replayMockSteps() {
+    const totalSteps = MOCK_STEPS.length;
+    for (const step of MOCK_STEPS) {
+        if (step.parallel) {
+            // Assumption: all parallel steps share the same delay and are adjacent in MOCK_STEPS.
+            // The first one prints all headers, waits once, then prints all results.
+            // Non-first parallel steps hit `continue` and are skipped.
+            const parallelSteps = MOCK_STEPS.filter(s => s.parallel && s.delay === step.delay);
+            if (step === parallelSteps[0]) {
+                // Print all parallel step headers
+                for (const ps of parallelSteps) {
+                    const marker = parallelSteps.length > 1 ? '  ← 并行' : '';
+                    console.log(`\n  ── [${MOCK_STEPS.indexOf(ps) + 1}/${totalSteps}] ${ps.id} (${ps.roleName}) ──${marker}`);
+                }
+                await sleep(step.delay);
+                for (const ps of parallelSteps) {
+                    console.log(`  Done | ${(ps.delay / 1000).toFixed(1)}s | mock`);
+                }
+            }
+            // Skip non-first parallel steps (already handled)
+            continue;
+        }
+        console.log(`\n  ── [${MOCK_STEPS.indexOf(step) + 1}/${totalSteps}] ${step.id} (${step.roleName}) ──`);
+        await sleep(step.delay);
+        console.log(`  Done | ${(step.delay / 1000).toFixed(1)}s | mock`);
+    }
+}
+// ─── Phase 2: Ask for real run ───
+function askQuestion(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase());
+        });
+    });
+}
+function resolveWorkflowPath() {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    // From dist/cli/ (or src/cli/) → project root → workflows/
+    const p = resolve(__dirname, '../../workflows/story-creation.yaml');
+    if (!existsSync(p)) {
+        throw new Error(`找不到 demo 工作流: ${p}`);
+    }
+    return p;
+}
+// ─── Main Entry ───
+export async function runDemo() {
+    console.log(`
+  🎬 Agency Orchestrator Demo
+  ${'─'.repeat(40)}
+
+  Phase 1: 模拟演示（无需 API Key）
+
+  Workflow: 短篇小说创作
+  Premise: "${DEMO_PREMISE}"
+  Steps: 4 | Roles: 叙事学家, 心理学家, 叙事设计师, 内容创作者
+  ${'─'.repeat(40)}`);
+    // Phase 1: Mock replay
+    await replayMockSteps();
+    console.log(`
+  ${'═'.repeat(40)}
+  ✅ 4 个角色协作完成 | ~5.0s (mock)
+  ${'═'.repeat(40)}`);
+    // Show story preview (last step output, truncated)
+    const story = MOCK_STEPS[MOCK_STEPS.length - 1].output;
+    const previewLines = story.split('\n').slice(0, 8);
+    console.log(`
+  📖 故事预览:
+  ${'─'.repeat(20)}`);
+    for (const line of previewLines) {
+        console.log(`  ${line}`);
+    }
+    console.log(`  ...（共 ${story.length} 字）`);
+    // Phase 2: Real LLM
+    console.log(`\n  ${'─'.repeat(40)}`);
+    console.log('  Phase 2: 用真实 AI 运行？\n');
+    // Skip Phase 2 if not interactive
+    if (!process.stdin.isTTY) {
+        console.log('  （非交互环境，跳过 Phase 2）');
+        console.log('  试试: ao run workflows/story-creation.yaml -i premise="你的故事创意"');
+        return;
+    }
+    const llms = await detectAvailableLLMs();
+    console.log('  检测到:');
+    for (const llm of llms) {
+        const icon = llm.available ? '✅' : '❌';
+        const hint = !llm.available && llm.envVar ? ` (需设置 ${llm.envVar})` : '';
+        console.log(`    ${icon} ${llm.name}${hint}`);
+    }
+    const available = llms.filter(l => l.available);
+    if (available.length === 0) {
+        console.log('\n  未检测到可用的 LLM。请设置 API key 后重试:');
+        console.log('    export DEEPSEEK_API_KEY=your-key');
+        console.log('    ao run workflows/story-creation.yaml -i premise="你的故事创意"\n');
+        return;
+    }
+    // Pick provider
+    let selectedProvider;
+    if (available.length === 1) {
+        selectedProvider = available[0];
+    }
+    else {
+        console.log('\n  可用的 LLM:');
+        available.forEach((llm, i) => console.log(`    ${i + 1}) ${llm.name}`));
+        const choice = await askQuestion(`\n  选择 (1-${available.length}, 默认 1): `);
+        const idx = parseInt(choice) - 1;
+        selectedProvider = available[idx >= 0 && idx < available.length ? idx : 0];
+    }
+    const answer = await askQuestion(`\n  用 ${selectedProvider.name} 运行真实版本？(y/N) `);
+    if (answer !== 'y' && answer !== 'yes') {
+        console.log('\n  跳过。试试:');
+        console.log('    ao run workflows/story-creation.yaml -i premise="你的故事创意"\n');
+        return;
+    }
+    // Run real workflow
+    console.log(`\n  🚀 使用 ${selectedProvider.name} 运行...\n`);
+    const { run } = await import('../index.js');
+    const workflowPath = resolveWorkflowPath();
+    const modelMap = {
+        deepseek: 'deepseek-chat',
+        claude: 'claude-sonnet-4-20250514',
+        openai: 'gpt-4o',
+        ollama: 'qwen2.5:7b',
+    };
+    await run(workflowPath, { premise: DEMO_PREMISE }, {
+        llmOverride: {
+            provider: selectedProvider.provider,
+            model: modelMap[selectedProvider.provider] || 'deepseek-chat',
+        },
+    });
+}

package/dist/cli.js

@@ -44,13 +44,19 @@ async function main() {
         case 'compose':
             await handleCompose();
             break;
+        case 'demo':
+            await handleDemo();
+            break;
+        case 'serve':
+            await handleServe();
+            break;
         case '--version':
         case '-v':
             console.log(getVersion());
             break;
         default: {
             // 容错：用户可能漏了空格，如 "planworkflows/x.yaml"
-            const knownCmds = ['run', 'validate', 'plan', 'explain', 'compose', 'roles', 'init'];
+            const knownCmds = ['run', 'validate', 'plan', 'explain', 'compose', 'demo', 'roles', 'init', 'serve'];
             const match = knownCmds.find(c => command.startsWith(c) && command.length > c.length);
             if (match) {
                 console.error(`看起来少了个空格？试试:\n  ao ${match} ${command.slice(match.length)}\n`);
@@ -70,7 +76,7 @@ async function handleRun() {
         process.exit(1);
     }
     const inputs = parseInputArgs();
-    const outputDir = getArgValue('--output') || '.ao-output';
+    const outputDir = getArgValue('--output') || 'ao-output';
     const quiet = args.includes('--quiet') || args.includes('-q');
     const watch = args.includes('--watch');
     let resumeDir = getArgValue('--resume');
@@ -189,14 +195,21 @@ async function handleCompose() {
     const agentsDir = getArgValue('--agents-dir') || resolveAgentsDir();
     try {
         const { composeWorkflow } = await import('./cli/compose.js');
-        const { yaml, savedPath } = await composeWorkflow({
+        const { yaml, relativePath, warnings } = await composeWorkflow({
             description,
             agentsDir: resolve(agentsDir),
             llmConfig: { provider, model },
         });
-        console.log(`\n  ✅ 工作流已生成: ${savedPath}\n`);
+        console.log(`\n  ✅ 工作流已生成: ${relativePath}\n`);
+        // 校验警告
+        if (warnings.length > 0) {
+            console.log('  ⚠️  校验发现问题（AI 生成的 YAML 可能需要手动调整）:');
+            for (const w of warnings) {
+                console.log(`    - ${w}`);
+            }
+            console.log('');
+        }
         console.log('  预览:');
-        // 显示前 30 行
         const previewLines = yaml.split('\n').slice(0, 30);
         for (const line of previewLines) {
             console.log(`    ${line}`);
@@ -206,9 +219,9 @@ async function handleCompose() {
         }
         console.log('');
         console.log('  接下来可以:');
-        console.log(`    ao plan ${savedPath}       查看执行计划`);
-        console.log(`    ao validate ${savedPath}   校验工作流`);
-        console.log(`    ao run ${savedPath}        运行工作流`);
+        console.log(`    ao validate ${relativePath}   校验工作流`);
+        console.log(`    ao plan ${relativePath}       查看执行计划`);
+        console.log(`    ao run ${relativePath}        运行工作流`);
         console.log('');
     }
     catch (err) {
@@ -216,6 +229,27 @@ async function handleCompose() {
         process.exit(1);
     }
 }
+async function handleServe() {
+    const verbose = args.includes('--verbose');
+    try {
+        const { startServer } = await import('./mcp/server.js');
+        await startServer(verbose);
+    }
+    catch (err) {
+        console.error(`MCP 服务器启动失败: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+}
+async function handleDemo() {
+    try {
+        const { runDemo } = await import('./cli/demo.js');
+        await runDemo();
+    }
+    catch (err) {
+        console.error(`\n错误: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+}
 async function handleInit() {
     // ao init --workflow: 交互式创建工作流
     if (args.includes('--workflow')) {
@@ -344,15 +378,18 @@ function printHelp() {
   基于 agency-agents-zh 的多智能体编排引擎
 
   Quick Start:
+    ao demo                           零配置体验多智能体协作
     ao init                           下载 186 个 AI 角色定义
     ao roles                          查看所有可用角色
     ao plan <workflow.yaml>           查看执行计划 (DAG)
     ao run <workflow.yaml> [options]   执行工作流
 
   Commands:
+    demo                              零配置体验多智能体协作（mock + 真实 AI）
     init                              下载/更新 agency-agents-zh
     init --workflow                    交互式创建新工作流
     compose "描述"                     AI 智能编排工作流（一句话生成 YAML）
+    serve                             启动 MCP Server（供 Claude Code / Cursor 调用）
     run <workflow.yaml>               执行工作流
     validate <workflow.yaml>          校验工作流定义
     plan <workflow.yaml>              查看执行计划
@@ -362,7 +399,7 @@ function printHelp() {
   Options:
     --input, -i key=value    传入输入变量
     --input, -i key=@file    从文件读取变量值
-    --output dir             输出目录 (默认 .ao-output/)
+    --output dir             输出目录 (默认 ao-output/)
     --resume <dir|last>      从上次运行恢复（加载已完成步骤的输出）
     --from <step-id>         配合 --resume，从指定步骤重新执行
     --watch                  实时进度显示（终端 UI）
@@ -379,7 +416,7 @@ function printHelp() {
   Resume (基于上次结果迭代):
     ao run workflow.yaml --resume last                    # 跳过上次已完成的步骤
     ao run workflow.yaml --resume last --from summary     # 从 summary 步骤重新执行
-    ao run workflow.yaml --resume .ao-output/xxx/         # 指定具体输出目录
+    ao run workflow.yaml --resume ao-output/xxx/         # 指定具体输出目录
 
   Agents: https://github.com/jnMetaCode/agency-agents-zh
   `);

package/dist/connectors/claude-code.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Claude Code CLI Connector
+ * 通过本地 `claude` CLI 调用，直接��用 Claude Max/Pro 订阅额度，无需 API key
+ *
+ * 安装: npm install -g @anthropic-ai/claude-code
+ * 认证: claude 登录后自动使用订阅额度
+ */
+import { CLIBaseConnector } from './cli-base.js';
+export declare class ClaudeCodeConnector extends CLIBaseConnector {
+    constructor();
+}

package/dist/connectors/claude-code.js

@@ -0,0 +1,23 @@
+/**
+ * Claude Code CLI Connector
+ * 通过本地 `claude` CLI 调用，直接��用 Claude Max/Pro 订阅额度，无需 API key
+ *
+ * 安装: npm install -g @anthropic-ai/claude-code
+ * 认证: claude 登录后自动使用订阅额度
+ */
+import { CLIBaseConnector } from './cli-base.js';
+export class ClaudeCodeConnector extends CLIBaseConnector {
+    constructor() {
+        super({
+            command: 'claude',
+            displayName: 'Claude Code CLI',
+            buildArgs: (prompt, config) => {
+                const args = ['-p', prompt, '--output-format', 'text'];
+                if (config.model && config.model !== 'claude-code') {
+                    args.push('--model', config.model);
+                }
+                return args;
+            },
+        });
+    }
+}

package/dist/connectors/cli-base.d.ts

@@ -0,0 +1,16 @@
+import type { LLMConnector, LLMResult, LLMConfig } from '../types.js';
+export interface CLIConnectorConfig {
+    /** CLI 命令名 */
+    command: string;
+    /** 显示名称（用于错误消息） */
+    displayName: string;
+    /** 构建命令行参数 */
+    buildArgs: (fullPrompt: string, config: LLMConfig) => string[];
+    /** 从 stdout 提取内容（默认 trim） */
+    parseOutput?: (stdout: string) => string;
+}
+export declare class CLIBaseConnector implements LLMConnector {
+    private cfg;
+    constructor(cfg: CLIConnectorConfig);
+    chat(systemPrompt: string, userMessage: string, config: LLMConfig): Promise<LLMResult>;
+}