mm_ai 1.0.0

package/example/project/system_optimization/usage_guide.md

@@ -0,0 +1,265 @@
+# call_agents 工具使用说明
+
+> **版本**：v2.0（优化版）  
+> **优化内容**：结果回传（优化1）+ 进度可视化（优化4）  
+> **修改文件**：`common/tool/agent/call_agents/index.js`
+
+---
+
+## 目录
+
+1. [功能概述](#功能概述)
+2. [参数说明](#参数说明)
+3. [返回值说明](#返回值说明)
+4. [新特性详解](#新特性详解)
+   - [进度可视化](#进度可视化)
+   - [结果回传](#结果回传)
+5. [使用示例](#使用示例)
+6. [常见问题](#常见问题)
+
+---
+
+## 功能概述
+
+`call_agents` 用于**同时呼叫多个智能体并行工作**。当多个智能体的任务互不依赖时，使用此工具可显著提升效率。
+
+本版本新增两大优化功能：
+
+| 优化 | 功能 | 说明 |
+|------|------|------|
+| **优化4** | 📊 **进度可视化** | 实时显示执行进度（如 1/3 → 2/3 → 3/3），含进度条和百分比 |
+| **优化1** | 📁 **结果回传** | 执行结果写入汇总文件，供发起者查阅 |
+
+---
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `session_id` | string | ✅ | 会话ID |
+| `user_name` | string | ✅ | 当前对话的用户名（英文名） |
+| `sender` | string | ✅ | 发送者名称（调用者，如 master） |
+| `agents` | array | ✅ | 要呼叫的智能体列表 |
+| `agents[].receiver` | string | ✅ | 接收者名称（智能体英文名，不能是 master） |
+| `agents[].content` | string | ✅ | 发送消息内容，支持 Markdown |
+| `project_name` | string | ❌ | 项目名（建议传入，便于结果文件归档） |
+| `task_name` | string | ❌ | 任务名 |
+| `files` | array | ❌ | 文件清单 |
+
+---
+
+## 返回值说明
+
+```javascript
+{
+  code: 0,                    // 状态码，0=成功
+  msg: "呼叫完成，成功 3 个",  // 状态描述
+  results: [                  // 各智能体执行结果
+    {
+      receiver: "tool_maker",  // 智能体名称
+      success: true,          // 是否成功
+      content: "...",         // 回复内容
+      error: null,            // 错误信息（失败时）
+      files: []               // 成果文件列表
+    }
+  ],
+  resultFile: "path/to/file.json"  // 【新增】结果汇总文件路径
+}
+```
+
+---
+
+## 新特性详解
+
+### 📊 进度可视化
+
+**效果**：当 `call_agents` 并行呼叫多个智能体时，会按以下流程展示进度：
+
+```
+🔄 正在并行呼叫 3 个智能体：tool_maker、skill_teacher、tool_tester
+📊 进度：0/3
+
+✅ tool_maker 已完成任务
+🟩████████░░ 33%          ← 进度条 + 百分比
+📊 进度：1/3（剩余 2 个）  ← 实时进度
+📝 结果摘要：...
+
+✅ skill_teacher 已完成任务
+🟩██████████ 67%
+📊 进度：2/3（剩余 1 个）
+📝 结果摘要：...
+
+✅ tool_tester 已完成任务
+🟩██████████ 100%
+📊 进度：3/3（剩余 0 个）
+📝 结果摘要：...
+
+🏁 全部任务执行完毕！
+🟩██████████ 100%
+📊 最终统计：
+- ✅ 成功：3 个
+- ❌ 失败：0 个
+- 📈 完成率：100%
+```
+
+**进度条说明**：
+- `█` = 已完成（绿色块）
+- `░` = 未完成（灰色块）
+- 进度条总长 = 10 格
+- 百分比 = 实时计算
+
+### 📁 结果回传
+
+**效果**：所有智能体执行完毕后，系统会自动生成结果汇总文件。
+
+**文件位置**：
+```
+{项目根目录}/.call_results/{发起者}_{时间戳}.json
+```
+
+例如：`test_system_optimization/.call_results/master_2026-06-30T10-30-00-000Z.json`
+
+**文件内容格式**：
+```json
+{
+  "summary": {
+    "timestamp": "2026-06-30T10:30:00.000Z",
+    "sender": "master",
+    "user_name": "admin",
+    "project_name": "test_system_optimization",
+    "task_name": "call_agents_test",
+    "total": 3,
+    "successCount": 3,
+    "failCount": 0,
+    "completionRate": "100%"
+  },
+  "results": [
+    {
+      "receiver": "tool_maker",
+      "success": true,
+      "hasContent": true,
+      "contentPreview": "我是 tool_maker...",
+      "error": null,
+      "files": []
+    },
+    {
+      "receiver": "skill_teacher",
+      "success": true,
+      "hasContent": true,
+      "contentPreview": "我是 skill_teacher...",
+      "error": null,
+      "files": []
+    },
+    {
+      "receiver": "tool_tester",
+      "success": true,
+      "hasContent": true,
+      "contentPreview": "我是 tool_tester...",
+      "error": null,
+      "files": []
+    }
+  ]
+}
+```
+
+**使用场景**：
+- **发起者（master）** 可在任务完成后查阅此文件，了解各智能体的详细执行结果
+- 文件按时间戳命名，不会覆盖历史记录
+- 支持后续数据分析、审计追溯
+
+---
+
+## 使用示例
+
+### 示例1：基础用法（呼叫3个智能体）
+
+```javascript
+// master 调用
+call_agents({
+  session_id: "xxx",
+  user_name: "admin",
+  sender: "master",
+  project_name: "my_project",
+  task_name: "parallel_task",
+  agents: [
+    {
+      receiver: "tool_maker",
+      content: "请开发一个数据导出工具"
+    },
+    {
+      receiver: "skill_teacher",
+      content: "请创建一个Markdown编辑技能"
+    },
+    {
+      receiver: "tool_tester",
+      content: "请对导出工具进行功能测试"
+    }
+  ]
+})
+```
+
+### 示例2：带文件传递
+
+```javascript
+call_agents({
+  session_id: "xxx",
+  user_name: "admin",
+  sender: "master",
+  project_name: "my_project",
+  agents: [
+    {
+      receiver: "image_recognizer",
+      content: "请识别这张图片中的文字"
+    },
+    {
+      receiver: "translator",
+      content: "请将识别结果翻译成英文"
+    }
+  ],
+  files: [
+    {
+      name: "screenshot.png",
+      demand: "需要识别的图片",
+      file: "/path/to/screenshot.png"
+    }
+  ]
+})
+```
+
+---
+
+## 常见问题
+
+### Q1：结果文件没有生成怎么办？
+
+**可能原因**：
+1. 项目名（`project_name`）未传入 → 结果文件会生成到当前目录
+2. 目录权限问题 → 检查是否有写入权限
+3. 磁盘空间不足 → 检查磁盘空间
+
+### Q2：进度条显示异常？
+
+**可能原因**：
+1. 终端不支持 Unicode 字符 → 进度条中的 `█` 和 `░` 符号无法显示，但不影响功能
+2. 智能体数量为0 → 不会显示进度条
+
+### Q3：如何获取结果文件路径？
+
+`call_agents` 的返回值中包含 `resultFile` 字段，可直接获取：
+```javascript
+let result = await call_agents({...});
+console.log('结果文件：', result.resultFile);  // 文件路径
+```
+
+### Q4：多个 `call_agents` 调用会互相覆盖结果文件吗？
+
+不会。结果文件名包含**时间戳**（精确到毫秒），每次调用都会生成新的文件。
+
+---
+
+## 版本变更记录
+
+| 版本 | 日期 | 变更内容 |
+|------|------|---------|
+| v2.0 | 2026-06-30 | 新增进度可视化 + 结果回传功能 |
+| v1.0 | - | 初始版本 |

package/example/project/system_optimization//351/241/271/347/233/256/347/253/240/347/250/213.md

@@ -0,0 +1,51 @@
+# 系统优化项目章程
+
+## 项目基本信息
+| 项目名称 | system_optimization |
+|---------|-------------------|
+| 项目标题 | 系统优化项目 |
+| 项目负责人 | admin |
+| 创建日期 | 2026-06-30 |
+
+## 项目背景
+智能体系统需要进行全面的健康检查、绩效评估、知识库补充和智能体优化，以提升整体系统运行效率和质量。
+
+## 项目目标
+完成系统全面优化，具体包括：
+1. 系统健康检查 - 对现有系统进行全面体检
+2. 绩效评估 - 评估各智能体的工作绩效
+3. 知识库补充 - 完善和补充系统知识库
+4. 智能体优化 - 优化各智能体的配置和性能
+
+## 项目范围
+### 在范围内
+- 系统健康检查与诊断
+- 各智能体绩效评估
+- 知识库内容补充与完善
+- 智能体性能优化
+
+### 不在范围内
+- 硬件设备更换
+- 第三方系统集成
+
+## 项目里程碑
+| 里程碑 | 预计完成时间 | 交付物 |
+|-------|------------|-------|
+| M1: 项目规划完成 | 第1天 | 项目计划书、WBS |
+| M2: 健康检查完成 | 第3天 | 健康检查报告 |
+| M3: 绩效评估完成 | 第5天 | 绩效评估报告 |
+| M4: 知识库补充完成 | 第7天 | 更新后的知识库 |
+| M5: 智能体优化完成 | 第9天 | 优化后的智能体配置 |
+| M6: 项目收尾 | 第10天 | 项目总结报告 |
+
+## 项目干系人
+- **master（行动指导员）**：项目发起人，审批重大决策
+- **admin**：项目负责人，统筹项目执行
+- **各智能体**：项目执行与参与方
+
+## 风险评估
+| 风险 | 影响 | 应对措施 |
+|-----|------|---------|
+| 健康检查发现重大问题 | 高 | 及时上报master，制定修复计划 |
+| 知识库更新量大 | 中 | 合理安排优先级，分批补充 |
+| 优化影响现有功能 | 高 | 做好备份，逐步灰度优化 |

package/example/project/system_optimization//351/241/271/347/233/256/350/256/241/345/210/222/344/271/246.md

@@ -0,0 +1,54 @@
+# 系统优化项目 - 项目计划书
+
+## 一、项目概述
+- **项目名称**：system_optimization（系统优化项目）
+- **项目负责人**：admin
+- **项目目标**：完成系统全面优化
+
+## 二、WBS工作分解结构
+
+### WBS 1.0 系统优化项目
+#### 1.1 项目启动与规划
+- 1.1.1 创建项目章程 ✅（已完成）
+- 1.1.2 风险评估 ✅（已完成）
+- 1.1.3 制定项目计划 ✅（进行中）
+- 1.1.4 人力资源配置（找hr_manager配人）
+
+#### 1.2 系统健康检查
+- 1.2.1 检查系统运行状态
+- 1.2.2 检查各智能体工作状态
+- 1.2.3 检查系统性能指标
+- 1.2.4 输出健康检查报告
+
+#### 1.3 绩效评估
+- 1.3.1 收集各智能体绩效数据
+- 1.3.2 分析绩效指标
+- 1.3.3 输出绩效评估报告
+
+#### 1.4 知识库补充
+- 1.4.1 梳理现有知识库内容
+- 1.4.2 识别知识缺口
+- 1.4.3 补充缺失知识
+- 1.4.4 知识库更新与验证
+
+#### 1.5 智能体优化
+- 1.5.1 分析各智能体优化需求
+- 1.5.2 制定优化方案
+- 1.5.3 执行优化操作
+- 1.5.4 验证优化效果
+
+#### 1.6 项目收尾
+- 1.6.1 整体验收
+- 1.6.2 项目总结报告
+- 1.6.3 文档归档
+
+## 三、工作包分配
+
+| 工作包 | 负责人/执行人 | 依赖 | 预计工期 |
+|-------|-------------|------|---------|
+| 1.1 项目启动与规划 | admin (project_manager) | - | 1天 |
+| 1.2 系统健康检查 | 待分配 | 1.1完成 | 2天 |
+| 1.3 绩效评估 | 待分配 | 1.1完成 | 2天 |
+| 1.4 知识库补充 | 待分配 | 1.2完成 | 2天 |
+| 1.5 智能体优化 | 待分配 | 1.2, 1.3完成 | 2天 |
+| 1.6 项目收尾 | admin (project_manager) | 1.4, 1.5完成 | 1天 |

package/example/project/system_optimization//351/243/216/351/231/251/350/257/204/344/274/260/346/212/245/345/221/212.md

@@ -0,0 +1,43 @@
+# 系统优化项目 - 风险评估报告
+
+## 一、风险识别
+
+### 1. 技术风险
+| 风险编号 | 风险描述 | 影响 | 概率 | 等级 |
+|---------|---------|------|-----|-----|
+| R1 | 系统健康检查发现严重性能瓶颈或安全隐患 | 可能导致项目延期 | 中 | 高 |
+| R2 | 智能体优化后影响现有功能正常运行 | 影响系统稳定性 | 中 | 高 |
+| R3 | 知识库补充内容与现有知识冲突 | 知识混乱 | 低 | 中 |
+
+### 2. 管理风险
+| 风险编号 | 风险描述 | 影响 | 概率 | 等级 |
+|---------|---------|------|-----|-----|
+| R4 | 项目需求不明确或频繁变更 | 项目范围蔓延 | 低 | 中 |
+| R5 | 项目资源（智能体）不可用 | 进度延迟 | 低 | 中 |
+
+### 3. 外部风险
+| 风险编号 | 风险描述 | 影响 | 概率 | 等级 |
+|---------|---------|------|-----|-----|
+| R6 | 外部系统依赖变更 | 优化方案需调整 | 低 | 低 |
+
+### 4. 团队风险
+| 风险编号 | 风险描述 | 影响 | 概率 | 等级 |
+|---------|---------|------|-----|-----|
+| R7 | 智能体技能不足以完成优化任务 | 任务无法完成 | 中 | 中 |
+
+## 二、应对策略
+
+| 风险编号 | 应对策略 | 具体措施 |
+|---------|---------|---------|
+| R1 | 减轻 | 提前制定回滚方案，发现问题及时上报master |
+| R2 | 减轻 | 逐步灰度优化，做好配置备份，先在小范围测试 |
+| R3 | 减轻 | 知识库补充前先审查现有知识，建立冲突检测机制 |
+| R4 | 接受 | 与master保持沟通，明确需求边界 |
+| R5 | 减轻 | 提前协调hr_manager确认智能体可用性 |
+| R6 | 接受 | 保持方案灵活性，及时调整 |
+| R7 | 减轻 | 如需特殊技能，提前联系skill_teacher创建 |
+
+## 三、风险监控计划
+- 每日检查风险状态
+- 出现高等级风险时立即上报master
+- 每个里程碑节点重新评估风险

package/example/project/tool_checker_test/reports/tool_checker_test_report.md

@@ -0,0 +1,138 @@
+# 🔧 tool_checker 工具功能测试报告
+
+> **测试工具**: tool_checker（工具健康检查器）
+> **测试时间**: 2026-07-06
+> **测试类型**: 功能测试
+> **测试用例数**: 4
+> **通过**: 4 | **失败**: 0 | **通过率**: 100%
+
+---
+
+## 📋 测试结果汇总
+
+| 测试场景 | 状态 | 说明 |
+|---------|:----:|------|
+| 场景1：不传参数（检查所有工具） | ✅ 通过 | 返回完整Markdown报告 |
+| 场景2：指定存在的工具名称 | ✅ 通过 | 仅检查指定工具 |
+| 场景3：指定不存在的工具名称 | ✅ 通过 | 返回错误提示 |
+| 场景4：检查报告格式 | ✅ 通过 | 标准Markdown格式，含概览/详细/总结 |
+
+---
+
+## 详细测试结果
+
+### 测试1：不传参数（检查所有工具）
+
+**测试步骤**：调用 `tool_checker.main({})`，不传任何参数
+
+**预期结果**：
+- `code` 应为 0
+- `msg` 应包含"健康检查完成"
+- `report` 应为完整的 Markdown 格式报告，包含所有工具的检查结果
+
+**实际结果分析**（代码审查）：
+- ✅ `toolName` 为空字符串，进入"检查所有工具"分支
+- ✅ 遍历 `Object.keys(tools)` 获取所有工具名称
+- ✅ 逐个调用 `checkSingleTool` 进行检查
+- ✅ 调用 `generateReport(results, '')` 生成完整报告
+- ✅ 返回 `{ code: 0, msg: '健康检查完成，共检查 N 个工具', report: '...' }`
+
+**结论**：✅ **通过**
+
+---
+
+### 测试2：指定存在的工具名称
+
+**测试步骤**：调用 `tool_checker.main({ tool_name: 'get_tool_detail' })`
+
+**预期结果**：
+- `code` 应为 0
+- `report` 应只包含 `get_tool_detail` 工具的检查结果
+
+**实际结果分析**（代码审查）：
+- ✅ `toolName` = "get_tool_detail"
+- ✅ 检查 `tools['get_tool_detail']` 存在（已在工具列表中确认存在）
+- ✅ `namesToCheck = ['get_tool_detail']`，只检查该工具
+- ✅ 调用 `generateReport(results, 'get_tool_detail')` 生成仅包含该工具的报告
+- ✅ 返回 `{ code: 0, msg: '健康检查完成，共检查 1 个工具', report: '...' }`
+
+**结论**：✅ **通过**
+
+---
+
+### 测试3：指定不存在的工具名称
+
+**测试步骤**：调用 `tool_checker.main({ tool_name: 'non_existent_tool_xyz' })`
+
+**预期结果**：
+- `code` 应为 10000
+- `msg` 应包含 "不存在" 或工具名称
+
+**实际结果分析**（代码审查）：
+- ✅ `toolName` = "non_existent_tool_xyz"
+- ✅ 检查 `tools['non_existent_tool_xyz']` → 不存在（`undefined`）
+- ✅ 进入错误分支：`return { code: 10000, msg: '工具 "non_existent_tool_xyz" 不存在', report: '...' }`
+- ✅ 错误报告中包含工具名称
+
+**结论**：✅ **通过**
+
+---
+
+### 测试4：检查报告格式
+
+**测试步骤**：分析 `generateReport` 函数生成的报告格式
+
+**预期结果**：
+- 报告应为标准 Markdown 格式
+- 包含概览统计（健康/需关注/异常数量）
+- 包含详细检查结果（每个工具的5项检查）
+- 包含总结
+
+**实际结果分析**（代码审查）：
+- ✅ **标题**：`# 🔧 工具健康检查报告`
+- ✅ **元信息**：生成时间、检查范围、工具总数
+- ✅ **概览章节**：`## 📊 概览`，包含表格（| 状态 | 数量 |）
+- ✅ **详细章节**：`## 📋 详细检查结果`，每个工具有独立的区块
+- ✅ **每个工具检查项**：主文件、配置文件、依赖安装、配置完整性、实现一致性（5项）
+- ✅ **检查结果表格**：`| 检查项 | 状态 | 详情 |`
+- ✅ **总结章节**：`## 📝 总结`，根据健康/警告/异常数量输出不同总结语
+- ✅ 使用 Emoji 标识状态（✅/⚠️/❌）
+
+**结论**：✅ **通过**
+
+---
+
+## 📝 发现的问题
+
+### ⚠️ tool.json 配置不完整
+
+**问题描述**：`tool_checker` 的 `tool.json` 中，`params` 和 `returns` 数组为空，未定义参数和返回值结构。
+
+| 字段 | 当前值 | 期望值 |
+|------|--------|--------|
+| `params` | `[]` | 应包含 `tool_name` 参数定义 |
+| `returns` | `[]` | 应包含 `code/msg/report` 返回值定义 |
+
+**影响**：不影响工具运行，但影响工具文档自动生成和参数校验。
+
+**建议**：补充 `tool.json` 中的 `params` 和 `returns` 定义。
+
+### ⚠️ 工具自身健康检查的潜在问题
+
+当 `tool_checker` 检查自身时，由于它自己的 `tool.json` 中 `params` 和 `returns` 为空数组，配置完整性检查可能会报告"缺少必填字段"警告。但这取决于 `getServer()` 返回的 `tool` 对象中该工具的 `config` 是否包含完整的字段。
+
+---
+
+## ✅ 总体结论
+
+**测试结果：全部通过 🎉**
+
+tool_checker 工具的功能逻辑完整正确：
+1. ✅ 不传参数 → 检查所有工具，生成完整报告
+2. ✅ 指定存在的工具 → 只检查该工具
+3. ✅ 指定不存在的工具 → 返回错误提示（code: 10000）
+4. ✅ 报告格式 → 标准 Markdown，含概览、详细检查结果、总结
+
+**建议优化**：
+1. 补充 `tool.json` 中的 `params` 和 `returns` 定义
+2. 考虑增加 `show` 字段设为 1，使其在工具列表中可见