agency-orchestrator 0.5.1 → 0.5.2

package/README.en.md

@@ -11,7 +11,7 @@
 
 **One sentence → full plan · 211 expert AI roles · Zero-code YAML · 10 LLM providers · 7 need no API key**
 
-> **Note:** `ao compose --run` auto-detects your language. For English input, it uses [agency-agents](https://github.com/msitarzewski/agency-agents) (170+ English roles). Use `ao init --lang en` to download the English role library. **6 English workflow templates** are ready in `workflows/en/` — more coming in v0.6.
+> **Note:** `ao compose --run` auto-detects your language. Both 211 Chinese roles and 170+ English roles ([agency-agents](https://github.com/msitarzewski/agency-agents), MIT) are **bundled in the npm package — no extra download needed**. **6 English workflow templates** are ready in `workflows/en/` — more coming in v0.6.
 
 > 📖 [Full Tutorial](https://dev.to/jnmetacode/agency-orchestrator-one-sentence-five-ai-agents-a-complete-plan-in-3-minutes-1ij6) — from install to real-world use in 10 minutes
 
@@ -217,8 +217,8 @@ All API providers support custom `base_url` and `api_key`, compatible with any O
 
 ```bash
 ao demo                              # Zero-config multi-agent demo
-ao init                              # Download 211 Chinese AI roles
-ao init --lang en                    # Download 170+ English AI roles
+ao init                              # (Optional) Copy 211 Chinese roles locally for editing
+ao init --lang en                    # (Optional) Copy 170+ English roles locally for editing
 ao init --workflow                    # Interactive workflow creator
 ao compose "description"             # AI-powered workflow generation
 ao compose "description" --run       # Generate AND execute in one command

package/README.md

@@ -216,8 +216,8 @@ analyze ──→ tech_review  ──→ summary
 
 ```bash
 ao demo                              # 零配置体验多智能体协作
-ao init                              # 下载 211 个中文 AI 角色
-ao init --lang en                    # 下载 170+ 个英文 AI 角色
+ao init                              # （可选）复制 211 个中文角色到本地以便编辑
+ao init --lang en                    # （可选）复制 170+ 个英文角色到本地以便编辑
 ao init --workflow                    # 交互式创建工作流
 ao compose "一句话描述"                # AI 智能编排工作流
 ao compose "一句话描述" --run          # 编排并立即执行

package/dist/cli/compose.js

@@ -334,20 +334,52 @@ export async function composeWorkflow(options) {
     writeFileSync(savedPath, yaml + '\n', 'utf-8');
     const relativePath = relative(process.cwd(), savedPath);
     console.log(`  Token 用量: 输入 ${result.usage.input_tokens}, 输出 ${result.usage.output_tokens}`);
-    // 6. 校验生成的 YAML
+    // 6. 校验生成的 YAML（含角色路径真实性校验，防 LLM 幻觉）
     const warnings = [];
-    try {
+    const validRolePaths = new Set(roles.map(r => r.path));
+    async function validateGenerated(path) {
         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);
+        const errors = [];
+        const invalidRoles = [];
+        try {
+            const workflow = parseWorkflow(path);
+            errors.push(...validateWorkflow(workflow));
+            for (const step of workflow.steps) {
+                if (step.role && !validRolePaths.has(step.role)) {
+                    invalidRoles.push(step.role);
+                    errors.push(`step "${step.id}" 的 role "${step.role}" 不存在于角色库中`);
+                }
             }
         }
+        catch (err) {
+            errors.push(`YAML 解析失败: ${err instanceof Error ? err.message : err}`);
+        }
+        return { errors, invalidRoles };
     }
-    catch (err) {
-        warnings.push(`YAML 解析失败: ${err instanceof Error ? err.message : err}`);
+    const first = await validateGenerated(savedPath);
+    // 发现幻觉角色 → 让 LLM 修一次
+    if (first.invalidRoles.length > 0) {
+        console.log(`  检测到 ${first.invalidRoles.length} 个不存在的角色，自动重新生成...`);
+        const retryPrompt = lang === 'en'
+            ? `The following role paths in your previous YAML do NOT exist in the catalog: ${first.invalidRoles.join(', ')}.\n\nRegenerate the FULL YAML. Use ONLY role paths from the catalog above. Do not invent new paths.`
+            : `你上次生成的 YAML 里有不存在的 role 路径：${first.invalidRoles.join('、')}。\n\n请重新生成完整 YAML，role 必须严格使用上方角色目录中列出的路径，不要编造。`;
+        try {
+            const retryResult = await connector.chat(systemPrompt, `${userPrompt}\n\n${retryPrompt}`, {
+                ...llmConfig,
+                max_tokens: llmConfig.max_tokens || 4096,
+            });
+            const retryYaml = extractYamlFromResponse(retryResult.content);
+            if (retryYaml && retryYaml.includes('steps:')) {
+                writeFileSync(savedPath, retryYaml + '\n', 'utf-8');
+                const second = await validateGenerated(savedPath);
+                warnings.push(...second.errors);
+                return { yaml: retryYaml, savedPath, relativePath, warnings };
+            }
+        }
+        catch (err) {
+            warnings.push(`自动修正失败（保留原始输出）: ${err instanceof Error ? err.message : err}`);
+        }
     }
+    warnings.push(...first.errors);
     return { yaml, savedPath, relativePath, warnings };
 }

package/dist/connectors/cli-base.js

@@ -29,7 +29,7 @@ export class CLIBaseConnector {
         const args = useStdin
             ? (this.cfg.buildStdinArgs?.(config) ?? this.cfg.buildArgs('-', config))
             : this.cfg.buildArgs(fullPrompt, config);
-        const timeout = config.timeout || 300_000; // 默认 5 分钟，effort=low 正常 1-3 分钟内响应
+        const timeout = config.timeout || 600_000; // 默认 10 分钟（gateway/MiniMax 等 CLI provider 可能单步 5+ 分钟）
         return new Promise((resolve, reject) => {
             const child = spawn(this.cfg.command, args, {
                 env: { ...process.env },

package/dist/core/executor.js

@@ -10,7 +10,7 @@ export async function executeDAG(dag, options) {
     const startTime = Date.now();
     const stepResults = [];
     const isCLI = llmConfig.provider.endsWith('-cli') || llmConfig.provider === 'claude-code';
-    const timeout = llmConfig.timeout || (isCLI ? 300_000 : 120_000); // CLI 5分钟，API 2分钟
+    const timeout = llmConfig.timeout || (isCLI ? 600_000 : 120_000); // CLI 10分钟（gateway/MiniMax 等可能单步 5+ 分钟），API 2分钟
     const maxRetry = llmConfig.retry ?? 5;
     // CLI provider 强制串行：共享同一账户额度，并发会触发限速反而更慢
     const effectiveConcurrency = isCLI ? 1 : concurrency;

package/integrations/aider/README.md

@@ -2,6 +2,8 @@
 
 在 Aider（开源 AI 编程终端工具）中直接运行多角色工作流，无需额外 API key。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/antigravity/README.md

@@ -2,6 +2,8 @@
 
 在 Antigravity 中直接运行多角色工作流，无需额外 API key。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/claude-code/README.md

@@ -2,6 +2,8 @@
 
 在 Claude Code 中直接运行多角色工作流，**无需 API key**。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/codex/README.md

@@ -2,6 +2,8 @@
 
 在 OpenAI Codex CLI 中直接运行多角色工作流，无需额外 API key。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/copilot/README.md

@@ -2,6 +2,8 @@
 
 在 GitHub Copilot（VS Code / JetBrains）中直接运行多角色工作流，无需额外 API key。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/cursor/README.md

@@ -2,6 +2,8 @@
 
 在 Cursor 中使用多角色工作流，无需 API key。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/deerflow/README.md

@@ -2,6 +2,8 @@
 
 在 DeerFlow（字节跳动开源 SuperAgent）中直接运行多角色工作流。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/gemini-cli/README.md

@@ -2,6 +2,8 @@
 
 在 Gemini CLI 中直接运行多角色工作流，无需额外 API key。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/kiro/README.md

@@ -2,6 +2,8 @@
 
 在 Kiro 中直接运行多角色工作流，无需 API key。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/openclaw/README.md

@@ -2,6 +2,8 @@
 
 在 OpenClaw 中直接运行多角色工作流，无需 API key。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/opencode/README.md

@@ -2,6 +2,8 @@
 
 在 OpenCode（开源终端 AI 编程工具）中直接运行多角色工作流，无需额外 API key。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/qwen/README.md

@@ -2,6 +2,8 @@
 
 在 Qwen Code（通义灵码 AI IDE 插件）中直接运行多角色工作流，无需额外 API key。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/trae/README.md

@@ -2,6 +2,8 @@
 
 在 Trae（字节跳动 AI IDE，国内最大的 AI 编程工具）中直接运行多角色工作流，无需 API key。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/integrations/windsurf/README.md

@@ -2,6 +2,8 @@
 
 在 Windsurf（Codeium AI IDE）中直接运行多角色工作流，无需额外 API key。
 
+> 🌐 **English users:** `npm install -g agency-orchestrator` — both 211 Chinese and 170+ English roles are bundled. Use `ao compose "your idea" --run` from CLI, or follow this guide for IDE-specific setup (translations coming in v0.6).
+
 ## 安装
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agency-orchestrator",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Multi-agent YAML workflow engine — 211 AI roles, auto DAG parallelism, zero code. One sentence → multiple AI roles collaborate → complete plan in minutes. 10 LLM providers, 7 need no API key.",
   "keywords": [
     "multi-agent",

package/workflows/xiaohongshu-viral-post.yaml

@@ -0,0 +1,103 @@
+name: "小红书爆款笔记创作"
+description: "一句话主题 → 策略分析 + 文案撰写 + SEO 标题 + 整合成稿"
+
+agents_dir: "agency-agents-zh"
+
+llm:
+  provider: "deepseek"
+  model: "deepseek-chat"
+  max_tokens: 4096
+  retry: 2
+
+concurrency: 3
+
+inputs:
+  - name: topic
+    description: "笔记主题（如：秋季穿搭技巧 / 职场新人避坑指南）"
+    required: true
+  - name: target_audience
+    description: "目标人群（如：25-35 岁女性白领，可选）"
+    required: false
+    default: "小红书主流用户（女性为主，关注生活方式）"
+
+steps:
+  - id: strategy
+    role: "marketing/marketing-xiaohongshu-specialist"
+    name: "小红书策略师"
+    emoji: "📱"
+    task: |
+      围绕主题「{{topic}}」做爆款策略分析，目标人群：{{target_audience}}。
+
+      输出结构（300-400 字）:
+      1. **选题角度**：3 个具体的切入角度，每个说明爆款潜力
+      2. **情绪钩子**：应该激发用户什么情绪（共鸣 / 焦虑 / 好奇 / 获得感）
+      3. **内容骨架**：建议的内容结构（开头钩子→主体价值→结尾互动）
+      4. **互动设计**：让用户评论/收藏的 1 个具体触发点
+    output: strategy
+
+  - id: copy
+    role: "marketing/marketing-content-creator"
+    name: "文案创作"
+    emoji: "✍️"
+    task: |
+      根据策略写一篇小红书正文（500-700 字）。
+
+      策略要点：
+      {{strategy}}
+
+      正文要求：
+      - 开头 1 句话抓人（不要寒暄、不要自我介绍）
+      - 用"我"视角讲亲身经历或观察，真实感
+      - 分 3-5 个小节，每节有明确价值点
+      - 夹杂 emoji 让视觉轻盈（不要堆砌）
+      - 结尾 1 句引导评论/收藏
+    output: post_body
+    depends_on: [strategy]
+
+  - id: title
+    role: "marketing/marketing-baidu-seo-specialist"
+    name: "标题+标签专家"
+    emoji: "🎯"
+    task: |
+      围绕主题「{{topic}}」和策略要点，产出:
+
+      1. **5 个候选标题**（每个 ≤20 字）：
+         - 至少 2 个带数字
+         - 至少 1 个带对比反差
+         - 至少 1 个带结果承诺
+      2. **推荐标题**：从 5 个里选 1 个最可能爆的，说明理由
+      3. **10 个话题标签**：按搜索量和相关性排序（#xxx 格式）
+
+      参考策略：
+      {{strategy}}
+    output: title_and_tags
+    depends_on: [strategy]
+
+  - id: final
+    role: "marketing/marketing-content-creator"
+    name: "整合发稿"
+    emoji: "📝"
+    task: |
+      把下面内容整合成一篇可以直接发布的小红书笔记。
+
+      标题和标签：
+      {{title_and_tags}}
+
+      正文：
+      {{post_body}}
+
+      输出格式（严格按此结构）:
+      ```
+      【标题】：<选用推荐标题>
+
+      【正文】：
+      <完整正文，可微调以适配标题>
+
+      【话题标签】：
+      <10 个标签，每个前面加 #，用空格分隔>
+
+      【发布建议】：
+      <2-3 行，包含建议发布时间、是否配图、评论区引导语>
+      ```
+    output: final_post
+    depends_on: [copy, title]