openmatrix 0.1.56 → 0.1.57

package/README.md

@@ -386,6 +386,27 @@ Accept 阶段由 Reviewer Agent 执行:
 }
 ```
 
+## 状态存储
+
+任务状态持久化在 `.openmatrix/` 目录:
+
+```
+.openmatrix/
+├── state.json              # 全局状态 (runId, status, config, statistics)
+├── plan.md                 # AI 生成的执行计划
+├── tasks-input.json        # 任务输入 (goals, constraints, deliverables)
+├── tasks/
+│   └── TASK-001/
+│       ├── task.json       # 任务定义 + 状态 + 阶段信息
+│       ├── context.md      # Agent 上下文 (供后续 Agent 读取)
+│       ├── develop.json    # 开发阶段结果
+│       ├── verify.json     # 验证阶段结果 (质量门禁)
+│       ├── accept.json     # 验收阶段结果
+│       └── artifacts/      # 产出文件 (result.md, quality-report.json 等)
+├── approvals/              # 审批记录
+└── meetings/               # Meeting 记录
+```
+
 ---
 
 ## 多语言支持
@@ -465,6 +486,9 @@ cd openmatrix && npm install && npm run build && npm test
 - [x] `/om:brainstorm` 头脑风暴模式
 - [x] 多语言支持 (Python/Go/Java/TypeScript 等)
 - [x] E2E 测试支持 (Web/Mobile/GUI)
+- [x] Agent 上下文共享 (Agent Memory)
+- [x] Task 子目录结构 + Phase 结果持久化
+- [x] 执行循环持久化 (`openmatrix step`/`complete` 防上下文压缩丢失)
 - [ ] VSCode 扩展
 - [ ] CI/CD 集成
 

package/dist/agents/impl/researcher-agent.d.ts

@@ -7,11 +7,20 @@ import type { Task, AgentType, AgentResult } from '../../types/index.js';
  * - 分析技术方案
  * - 总结最佳实践
  * - 提供决策建议
+ *
+ * 支持动态领域感知，根据任务描述自动适配研究方向
  */
 export declare class ResearcherAgent {
     readonly type: AgentType;
     readonly capabilities: string[];
     execute(task: Task): Promise<AgentResult>;
-    private buildResearchPrompt;
+    /**
+     * 构建动态领域感知的研究 Prompt
+     */
+    private buildDynamicResearchPrompt;
+    /**
+     * 从任务描述中提取研究上下文
+     */
+    private extractResearchContext;
     private generateRunId;
 }

package/dist/agents/impl/researcher-agent.js

@@ -9,6 +9,8 @@ exports.ResearcherAgent = void 0;
  * - 分析技术方案
  * - 总结最佳实践
  * - 提供决策建议
+ *
+ * 支持动态领域感知，根据任务描述自动适配研究方向
  */
 class ResearcherAgent {
     type = 'researcher';
@@ -16,7 +18,7 @@ class ResearcherAgent {
     async execute(task) {
         const startTime = Date.now();
         try {
-            const prompt = this.buildResearchPrompt(task);
+            const prompt = this.buildDynamicResearchPrompt(task);
             return {
                 runId: this.generateRunId(),
                 taskId: task.id,
@@ -44,88 +46,208 @@ class ResearcherAgent {
             };
         }
     }
-    buildResearchPrompt(task) {
+    /**
+     * 构建动态领域感知的研究 Prompt
+     */
+    buildDynamicResearchPrompt(task) {
+        // 从任务描述中提取领域和角色信息
+        const { domain, role, focus } = this.extractResearchContext(task.description);
         return `
 # 调研任务
 
-## 调研问题
+## 研究领域
+${domain}
+
+## 角色定位
+${role}
+
+## 研究方向
+${focus}
 
+## 原始任务描述
 ${task.description}
 
 ## 调研步骤
 
 1. **搜索资料**
-   - 官方文档
-   - 技术博客
-   - GitHub 仓库
-   - Stack Overflow
+   - 使用 WebSearch 搜索领域核心概念
+   - 搜索行业标准、最佳实践
+   - 搜索主流技术方案和开源项目
+   - 搜索常见挑战和解决方案
 
-2. **分析方案**
+2. **分析整理**
    - 功能对比
-   - 性能对比
-   - 社区支持
+   - 性能特点
+   - 社区生态
    - 学习曲线
+   - 适用场景
 
 3. **总结发现**
-   - 关键信息
-   - 优缺点
-   - 适用场景
+   - 关键信息提炼
+   - 优缺点分析
+   - 决策建议
 
 ## 输出格式
 
 \`\`\`markdown
-# 调研报告
+# ${domain} 调研报告
 
-## 问题
-[调研的核心问题]
+## 核心发现
 
-## 调研方法
-- 搜索关键词: ...
-- 参考来源: ...
+[3-5 个关键发现，每个用一句话概括]
 
-## 发现
+1. ...
+2. ...
+3. ...
 
-### 方案 A: [名称]
-- 描述: ...
-- 优点:
-  - ...
-- 缺点:
-  - ...
-- 适用场景: ...
+## 详细分析
 
-### 方案 B: [名称]
-- 描述: ...
-- 优点:
+### 发现 1: [标题]
+- **描述**: ...
+- **关键点**:
   - ...
-- 缺点:
-  - ...
-- 适用场景: ...
+- **注意事项**: ...
+
+### 发现 2: [标题]
+...
 
-## 方案对比
+## 行业最佳实践
 
-| 维度 | 方案 A | 方案 B |
-|-----|--------|--------|
-| 性能 | ⭐⭐⭐ | ⭐⭐ |
-| 易用性 | ⭐⭐ | ⭐⭐⭐ |
-| 社区 | ⭐⭐⭐ | ⭐ |
+1. ...
+2. ...
+3. ...
+
+## 关键决策点
+
+[用户需要做出的关键决策]
+
+1. **决策 1**: [决策描述]
+   - 选项 A: ... (适用场景)
+   - 选项 B: ... (适用场景)
+   - 建议: ...
+
+2. **决策 2**: ...
 
-## 建议
+## 推荐方案
 
-**推荐方案**: [方案 X]
+**首选方案**: ...
 
 **理由**:
 1. ...
 2. ...
 
+**备选方案**: ...
+
 ## 参考资料
+
 1. [标题](链接)
+2. [标题](链接)
 \`\`\`
 
 ## 开始调研
 
 请使用 WebSearch 和 WebFetch 工具搜索相关信息。
+至少搜索 5 个相关关键词，覆盖官方文档、社区讨论、技术博客等维度。
 `;
     }
+    /**
+     * 从任务描述中提取研究上下文
+     */
+    extractResearchContext(description) {
+        const lower = description.toLowerCase();
+        // 领域关键词映射
+        const domainMap = [
+            {
+                keywords: ['游戏', 'game', 'gamedev', 'unity', 'unreal'],
+                domain: '游戏开发',
+                aspects: ['游戏类型', '目标平台', '技术架构', '美术风格', '盈利模式']
+            },
+            {
+                keywords: ['网站', 'website', 'web app', '门户'],
+                domain: 'Web 网站开发',
+                aspects: ['功能需求', '用户体验', '技术栈', 'SEO', '性能优化']
+            },
+            {
+                keywords: ['app', '移动应用', 'ios', 'android', 'flutter'],
+                domain: '移动应用开发',
+                aspects: ['平台选择', '用户界面', '性能优化', '发布流程', '用户增长']
+            },
+            {
+                keywords: ['支付', 'payment', 'stripe', '支付宝'],
+                domain: '支付系统',
+                aspects: ['支付方式', '安全合规', '风控策略', '对账结算', '国际化']
+            },
+            {
+                keywords: ['电商', 'ecommerce', 'shop', '商城'],
+                domain: '电商系统',
+                aspects: ['商品管理', '购物流程', '库存物流', '营销工具', '数据分析']
+            },
+            {
+                keywords: ['社交', 'social', 'community', '论坛'],
+                domain: '社交平台',
+                aspects: ['用户关系', '内容互动', '实时通讯', '内容审核', '推荐算法']
+            },
+            {
+                keywords: ['安全', 'security', 'auth', '认证', '加密'],
+                domain: '安全领域',
+                aspects: ['威胁模型', '认证授权', '数据保护', '审计监控', '合规要求']
+            },
+            {
+                keywords: ['后台', 'admin', 'dashboard', 'cms', '管理'],
+                domain: '后台管理系统',
+                aspects: ['权限模型', '数据看板', '工作流程', 'API 设计', '多租户']
+            },
+            {
+                keywords: ['ai', '人工智能', 'ml', '机器学习', '大模型', 'llm'],
+                domain: 'AI/机器学习',
+                aspects: ['模型选择', '数据处理', '训练部署', '性能优化', '伦理合规']
+            },
+            {
+                keywords: ['区块链', 'blockchain', 'web3', 'defi', 'nft'],
+                domain: '区块链',
+                aspects: ['链选择', '智能合约', '安全审计', '性能扩展', '合规监管']
+            },
+            {
+                keywords: ['音视频', 'streaming', '直播', 'rtc', 'webrtc'],
+                domain: '音视频',
+                aspects: ['编解码', '传输协议', '延迟优化', '存储分发', '实时互动']
+            }
+        ];
+        // 查找匹配的领域
+        for (const { keywords, domain, aspects } of domainMap) {
+            if (keywords.some(kw => lower.includes(kw))) {
+                return {
+                    domain,
+                    role: `${domain}专家`,
+                    focus: `请重点调研以下方面: ${aspects.join('、')}`
+                };
+            }
+        }
+        // 通用领域：尝试从"做X"模式提取
+        const actionPatterns = [
+            /做(一个|个)(.+?)(的|app|网站|系统|平台|工具|应用|$)/,
+            /开发(一个|个)?(.+?)(系统|应用|平台|工具|$)/,
+            /构建(一个|个)?(.+?)(系统|应用|平台|工具|$)/,
+            /build (a |an )?(.+?)(app|website|system|tool|platform|$)/i,
+        ];
+        for (const pattern of actionPatterns) {
+            const match = description.match(pattern);
+            if (match && match[2]) {
+                const extracted = match[2].trim();
+                return {
+                    domain: extracted,
+                    role: `${extracted}领域专家`,
+                    focus: `请调研 ${extracted} 的核心概念、技术方案、最佳实践、常见挑战`
+                };
+            }
+        }
+        // 默认：使用原始描述
+        return {
+            domain: '项目开发',
+            role: '技术顾问',
+            focus: '请调研相关技术方案、最佳实践、实现路径'
+        };
+    }
     generateRunId() {
         return `researcher-${Date.now().toString(36)}`;
     }

package/dist/cli/commands/brainstorm.js

@@ -177,6 +177,8 @@ exports.brainstormCommand = new commander_1.Command('brainstorm')
     }
     // 生成头脑风暴问题
     const questions = generateBrainstormQuestions(taskContent, taskTitle);
+    // 检测是否涉及垂直领域
+    const domainDetection = detectVerticalDomain(taskContent);
     // 创建会话
     const session = {
         status: 'brainstorming',
@@ -185,12 +187,13 @@ exports.brainstormCommand = new commander_1.Command('brainstorm')
         questions,
         answers: {},
         insights: [],
-        designNotes: []
+        designNotes: [],
+        suggestResearch: domainDetection.isVertical ? domainDetection.domain : undefined
     };
     await fs.writeFile(brainstormPath, JSON.stringify(session, null, 2));
     if (options.json) {
         // JSON 输出供 Skill 解析
-        console.log(JSON.stringify({
+        const output = {
             status: 'brainstorming',
             message: '开始头脑风暴',
             taskTitle,
@@ -202,11 +205,21 @@ exports.brainstormCommand = new commander_1.Command('brainstorm')
                 multiSelect: q.multiSelect
             })),
             hint: '请逐一回答问题，完成后再调用 --complete'
-        }));
+        };
+        // 如果检测到垂直领域，添加建议
+        if (domainDetection.isVertical) {
+            output.suggestResearch = domainDetection.domain;
+            output.researchHint = `检测到垂直领域「${domainDetection.domain}」，建议先进行领域调研`;
+        }
+        console.log(JSON.stringify(output));
     }
     else {
         console.log('\n🧠 开始头脑风暴...\n');
         console.log(`📋 任务: ${taskTitle}\n`);
+        if (domainDetection.isVertical) {
+            console.log(`🔍 检测到垂直领域: ${domainDetection.domain}`);
+            console.log('   建议使用 /om:research 进行领域调研\n');
+        }
         console.log('需要探索以下问题:');
         questions.forEach((q, i) => {
             console.log(`  ${i + 1}. ${q.question}`);
@@ -214,6 +227,37 @@ exports.brainstormCommand = new commander_1.Command('brainstorm')
         console.log('\n💡 使用 /om:brainstorm 技能进行交互式问答');
     }
 });
+/**
+ * 检测是否可能需要领域调研
+ * 不硬编码领域，只判断是否像垂直领域任务
+ */
+function detectVerticalDomain(taskContent) {
+    const lower = taskContent.toLowerCase();
+    // 检测"做X"模式 - 这是垂直领域任务的典型特征
+    const actionPatterns = [
+        /做(一个|个)(.+?)(的|app|网站|系统|平台|工具|应用|游戏|$)/,
+        /开发(一个|个)?(.+?)(系统|应用|平台|工具|游戏|$)/,
+        /构建(一个|个)?(.+?)(系统|应用|平台|工具|$)/,
+        /build (a |an )?(.+?)(app|website|system|tool|platform|game|$)/i,
+        /create (a |an )?(.+?)(app|website|system|tool|platform|game|$)/i,
+    ];
+    for (const pattern of actionPatterns) {
+        const match = taskContent.match(pattern);
+        if (match && match[2]) {
+            const extracted = match[2].trim();
+            // 如果提取的内容有意义，认为是垂直领域任务
+            if (extracted.length > 1) {
+                return { isVertical: true, domain: extracted };
+            }
+        }
+    }
+    // 检测是否包含"系统"、"平台"、"应用"等大词
+    const systemKeywords = ['系统', '平台', '应用', 'system', 'platform', 'app'];
+    if (systemKeywords.some(kw => lower.includes(kw))) {
+        return { isVertical: true, domain: '待分析' };
+    }
+    return { isVertical: false, domain: '' };
+}
 /**
  * 根据任务内容生成头脑风暴问题
  */

package/dist/cli/commands/research.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const researchCommand: Command;

package/dist/cli/commands/research.js

@@ -0,0 +1,270 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.researchCommand = void 0;
+// src/cli/commands/research.ts
+const commander_1 = require("commander");
+const gitignore_js_1 = require("../../utils/gitignore.js");
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * 生成并行研究 Agent 配置
+ */
+function generateAgents(topic, domain, aspects) {
+    return [
+        {
+            role: 'domain_researcher',
+            focus: `搜索 ${domain} 领域的核心概念、行业标准、最佳实践。关键词: ${aspects.slice(0, 4).join(', ')}`,
+            status: 'pending'
+        },
+        {
+            role: 'tech_explorer',
+            focus: `搜索 ${domain} 的主流技术方案、开源项目、技术栈选择、架构模式`,
+            status: 'pending'
+        },
+        {
+            role: 'scenario_analyst',
+            focus: `结合用户具体需求 "${topic}"，分析实际应用场景、常见挑战、经验教训`,
+            status: 'pending'
+        }
+    ];
+}
+exports.researchCommand = new commander_1.Command('research')
+    .description('领域调研和问题探索 - 为后续任务提供知识基础')
+    .argument('[topic]', '研究主题')
+    .option('--json', '输出 JSON 格式 (供 Skill 解析)')
+    .option('--confirm', '确认进入深度研究 (从 Skill 传入)')
+    .option('--complete', '标记研究完成，生成报告和任务上下文')
+    .option('--results <json>', '研究结果 JSON (从 Skill 传入)')
+    .action(async (topic, options) => {
+    const basePath = process.cwd();
+    const omPath = path.join(basePath, '.openmatrix');
+    const researchPath = path.join(omPath, 'research');
+    const knowledgePath = path.join(researchPath, 'knowledge');
+    // 确保目录存在
+    await fs.mkdir(omPath, { recursive: true });
+    await fs.mkdir(researchPath, { recursive: true });
+    await fs.mkdir(knowledgePath, { recursive: true });
+    // 确保 .openmatrix 被 git 忽略
+    await (0, gitignore_js_1.ensureOpenmatrixGitignore)(basePath);
+    const sessionPath = path.join(researchPath, 'session.json');
+    // ========== --complete 模式: 研究完成，汇总结果 ==========
+    if (options.complete) {
+        try {
+            const sessionData = await fs.readFile(sessionPath, 'utf-8');
+            const session = JSON.parse(sessionData);
+            // 如果传入了结果，合并
+            if (options.results) {
+                try {
+                    const results = JSON.parse(options.results);
+                    if (results.agents)
+                        session.agents = results.agents;
+                    if (results.report)
+                        session.report = results.report;
+                    if (results.knowledge)
+                        session.knowledge = [...session.knowledge, ...results.knowledge];
+                    if (results.context)
+                        session.context = results.context;
+                    if (results.domainQuestions)
+                        session.domainQuestions = results.domainQuestions;
+                    if (results.answers)
+                        session.answers = { ...session.answers, ...results.answers };
+                }
+                catch {
+                    // 忽略解析错误
+                }
+            }
+            session.status = 'completed';
+            session.completedAt = new Date().toISOString();
+            await fs.writeFile(sessionPath, JSON.stringify(session, null, 2));
+            // 写入研究报告
+            if (session.report) {
+                await fs.writeFile(path.join(researchPath, 'RESEARCH.md'), session.report, 'utf-8');
+            }
+            // 写入知识条目
+            for (let i = 0; i < session.knowledge.length; i++) {
+                await fs.writeFile(path.join(knowledgePath, `finding-${i + 1}.md`), session.knowledge[i], 'utf-8');
+            }
+            // 写入任务上下文 (供 start 使用)
+            const taskContext = session.context || { goals: [], constraints: [], deliverables: [] };
+            await fs.writeFile(path.join(researchPath, 'context.json'), JSON.stringify({
+                topic: session.topic,
+                domain: session.domain,
+                ...taskContext,
+                reportPath: '.openmatrix/research/RESEARCH.md',
+                knowledgePath: '.openmatrix/research/knowledge/'
+            }, null, 2), 'utf-8');
+            if (options.json) {
+                console.log(JSON.stringify({
+                    status: 'completed',
+                    message: '研究完成',
+                    topic: session.topic,
+                    domain: session.domain,
+                    report: session.report,
+                    knowledge: session.knowledge,
+                    context: taskContext,
+                    reportPath: '.openmatrix/research/RESEARCH.md',
+                    hint: '研究结果已保存，可以使用 /om:start 开始执行任务'
+                }));
+            }
+            else {
+                console.log('研究完成!');
+                console.log(`   主题: ${session.topic}`);
+                console.log(`   领域: ${session.domain}`);
+                console.log(`   知识条目: ${session.knowledge.length} 个`);
+                console.log('\n使用 /om:start 基于研究结果开始任务');
+            }
+            return;
+        }
+        catch {
+            if (options.json) {
+                console.log(JSON.stringify({ status: 'error', message: '没有进行中的研究会话' }));
+            }
+            else {
+                console.log('没有进行中的研究会话');
+                console.log('   使用 openmatrix research <topic> 开始新的研究');
+            }
+            return;
+        }
+    }
+    // ========== --confirm 模式: 用户确认后进入深度研究 ==========
+    if (options.confirm) {
+        try {
+            const sessionData = await fs.readFile(sessionPath, 'utf-8');
+            const session = JSON.parse(sessionData);
+            if (session.status !== 'preview') {
+                if (options.json) {
+                    console.log(JSON.stringify({ status: 'error', message: `当前状态为 ${session.status}，无法确认` }));
+                }
+                else {
+                    console.log(`当前状态为 ${session.status}，无法确认`);
+                }
+                return;
+            }
+            // 生成研究 Agent
+            const agents = generateAgents(session.topic, session.domain, session.aspects);
+            session.status = 'researching';
+            session.agents = agents;
+            await fs.writeFile(sessionPath, JSON.stringify(session, null, 2));
+            if (options.json) {
+                console.log(JSON.stringify({
+                    status: 'researching',
+                    message: '开始深度研究',
+                    topic: session.topic,
+                    domain: session.domain,
+                    aspects: session.aspects,
+                    agents: agents.map(a => ({ role: a.role, focus: a.focus, status: a.status })),
+                    hint: '使用 Agent 工具并行执行研究'
+                }));
+            }
+            else {
+                console.log('\n开始深度研究...\n');
+                console.log(`  主题: ${session.topic}`);
+                console.log(`  领域: ${session.domain}`);
+                console.log('\n研究 Agent:');
+                agents.forEach((a, i) => {
+                    console.log(`  ${i + 1}. [${a.role}] ${a.focus}`);
+                });
+            }
+            return;
+        }
+        catch {
+            if (options.json) {
+                console.log(JSON.stringify({ status: 'error', message: '没有待确认的研究会话' }));
+            }
+            else {
+                console.log('没有待确认的研究会话');
+            }
+            return;
+        }
+    }
+    // ========== 初始模式: 创建会话，等待 AI 分析 ==========
+    let researchTopic = topic;
+    if (!researchTopic) {
+        const defaultPath = path.join(basePath, 'RESEARCH.md');
+        try {
+            const content = await fs.readFile(defaultPath, 'utf-8');
+            const lines = content.split('\n');
+            for (const line of lines) {
+                const match = line.match(/^#\s+(.+)$/);
+                if (match) {
+                    researchTopic = match[1].trim();
+                    break;
+                }
+            }
+            if (!researchTopic)
+                researchTopic = content.slice(0, 100).trim();
+            if (!options.json)
+                console.log(`读取研究文件: ${defaultPath}`);
+        }
+        catch {
+            if (options.json) {
+                console.log(JSON.stringify({ status: 'error', message: '请提供研究主题' }));
+            }
+            else {
+                console.log('请提供研究主题');
+                console.log('   用法: openmatrix research <topic>');
+                console.log('   或创建 RESEARCH.md 文件');
+            }
+            return;
+        }
+    }
+    // 创建初始会话 - 领域信息由 Agent 分析后更新
+    const session = {
+        status: 'initialized',
+        topic: researchTopic,
+        domain: '',
+        aspects: [],
+        estimatedQuestions: 0,
+        agents: [],
+        domainQuestions: [],
+        answers: {},
+        knowledge: [],
+        createdAt: new Date().toISOString()
+    };
+    await fs.writeFile(sessionPath, JSON.stringify(session, null, 2));
+    if (options.json) {
+        console.log(JSON.stringify({
+            status: 'initialized',
+            message: '研究会话已创建，需要 AI 分析领域',
+            topic: researchTopic,
+            hint: '请使用 Agent 分析主题，识别领域和调研方向，然后更新会话并展示给用户确认'
+        }));
+    }
+    else {
+        console.log(`\n研究主题: ${researchTopic}`);
+        console.log('使用 /om:research 技能启动 AI 分析');
+    }
+});