mm_ai 1.0.0

package/example/project/agent_self_check/tool_maker/self_check_report.md

@@ -0,0 +1,289 @@
+# 工具匠人（tool_maker）工作自检与工具测试报告
+
+> **检查时间**：2024年1月  
+> **检查人**：tool_maker（工具匠人）  
+> **检查类型**：工作自检 + 工具功能测试
+
+---
+
+## 第一部分：工作自检
+
+### 一、职责回顾
+
+**我是谁**：工具匠人（tool_maker）—— 负责智能体工具的研发，包括工具需求分析、功能设计、代码实现、测试验证、部署维护，并为智能体赋予工具。
+
+### 二、核心工作流程
+
+```
+接需求 → 设计工具 → 开发实现 → 测试验证 → 部署赋予 → 维护优化
+```
+
+详细流程如下：
+
+| 阶段 | 步骤 | 具体内容 |
+|------|------|---------|
+| **一、接需求、设计工具** | 1. 理解工具需求和功能规格 | 分析需求，明确工具功能、输入输出 |
+| | 2. 调用 `read_skill("tool_create_standard")` | 按规范设计工具架构并制定开发计划 |
+| **二、开发实现** | 3. 调用 `read_skill("tool_development")` | 按规范实现工具代码 |
+| | 4. 创建工具目录和脚本文件 | 编写 index.js 和 tool.json |
+| **三、测试验证** | 5. 功能自测 | 确保工具功能完整 |
+| | 6. 找 tool_tester 做全面功能测试 | 主动联系测试员 |
+| | 7. 根据反馈修复问题 | 修复后回归验证 |
+| **四、部署赋予** | 8. 用 `set_tool` 修改工具配置 | 调整工具参数 |
+| | 9. 用 `provide_tools` 给智能体赋予工具 | 为智能体分配工具权限 |
+| | 10. 最终质量检查 | 确保一切正常 |
+| **五、维护优化** | 11. 维护工具功能和性能 | 排查解决技术问题 |
+| | 12. 基于反馈持续优化 | 沉淀开发经验 |
+
+### 三、工作职责范围
+
+#### ✅ 应该做的事
+- 分析智能体工具需求，设计功能和技术架构
+- 实现工具核心功能和业务逻辑
+- 进行功能自测，找测试员做全面测试
+- 根据测试反馈修复问题
+- 用 `create_tool` 创建新工具，用 `set_tool` 修改已有工具
+- 用 `provide_tools` 给智能体赋予工具
+- 向 master 汇报工具开发进度
+
+#### ❌ 不该做的事
+- 操作生产环境敏感数据
+- 修改系统核心配置和安全配置
+- 修改用户权限和访问控制
+- 泄露工具核心算法细节和实现逻辑
+- 删除其他智能体正在使用的关键工具
+- 给智能体赋予其权限范围外的敏感工具
+
+#### 🟢 能自己决定的事
+- 常规工具需求分析和功能设计
+- 工具开发和代码实现
+- 工具测试验证和质量保证
+- 工具文档编写和维护
+- 用 `create_tool` 创建、`set_tool` 修改工具
+- 用 `provide_tools` 给智能体赋予工具
+
+#### 🔴 绝对不能碰的事
+- 操作生产环境敏感数据
+- 修改系统核心配置和安全配置
+- 修改用户权限和访问控制
+- 泄露工具核心算法细节和实现逻辑
+- 删除其他智能体正在使用的关键工具
+- 给智能体赋予其权限范围外的敏感工具
+
+#### 🟡 要先问过 master 的事
+- 需要大幅调整工具架构或技术栈
+- 工具性能出现重大异常或瓶颈
+- 工具可能涉及安全风险或漏洞
+- 需要删除已被多个智能体依赖的现有工具
+
+---
+
+## 第二部分：工具测试
+
+### 一、已掌握的工具列表
+
+共 **23个** 工具，按功能分类如下：
+
+| 分类 | 工具名称 | 用途 |
+|------|---------|------|
+| **智能体通信** | `call_agent` | 呼叫其他智能体协作 |
+| | `get_agent_list` | 获取智能体列表 |
+| | `get_agent_detail` | 获取智能体详情 |
+| **工具管理（核心）** | `get_tool_list` | 查看所有工具列表 |
+| | `get_tool_detail` | 查看工具详情 |
+| | `create_tool` | 创建新工具 |
+| | `set_tool` | 修改工具配置 |
+| | `provide_tools` | 为智能体赋予工具 |
+| | `get_agent_tools` | 查看智能体已掌握的工具 |
+| **文件操作** | `read_text` | 读取文本文件 |
+| | `write_text` | 写入文本文件 |
+| | `edit_file` | 编辑文件内容 |
+| **目录操作** | `make_dir` | 创建目录 |
+| | `remove_dir` | 删除目录 |
+| | `remove_file` | 删除文件 |
+| | `search_dir` | 搜索目录 |
+| | `search_file` | 搜索文件 |
+| | `ls` | 列出目录内容 |
+| **代码执行** | `exec_code` | 执行代码（Python/JS） |
+| | `run_script` | 执行脚本文件 |
+| **技能相关** | `read_skill` | 读取技能内容 |
+| | `get_skill_list` | 获取全部技能列表 |
+| | `get_agent_skills` | 获取智能体技能列表 |
+
+### 二、逐项测试结果
+
+#### 1️⃣ `get_tool_list` - 查看工具列表
+- **测试内容**：调用获取全部工具列表
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功返回 90+ 个工具，涵盖 agent/code/data/file/media 等全部分组
+- **备注**：返回结果完整，包含工具名称、标题、描述信息
+
+#### 2️⃣ `get_tool_detail` - 查看工具详情
+- **测试内容**：查询 `create_tool` 工具的详细信息
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功返回工具的完整配置，包括名称、标题、描述、分组、参数列表、返回值、文件路径等
+- **备注**：信息完整，可作为工具开发参考
+
+#### 3️⃣ `create_tool` - 创建工具
+- **测试内容**：创建名为 `test_tool_temp` 的临时测试工具
+- **测试结果**：⚠️ **返回成功但工具未实际创建**
+- **返回数据**：code=0 表示成功，返回了工具基本信息，但后续 `get_tool_detail` 查询时提示"工具不存在"
+- **备注**：可能是目标目录映射问题，需要进一步排查
+
+#### 4️⃣ `set_tool` - 修改工具
+- **测试内容**：尝试修改 `test_tool_temp` 工具的标题和参数
+- **测试结果**：❌ **不可用（当前）**
+- **错误信息**：`Cannot read properties of undefined (reading 'getDetail')`
+- **备注**：由于 create_tool 未实际创建成功，set_tool 无法找到目标工具，属连锁反应
+
+#### 5️⃣ `provide_tools` - 赋予工具
+- **测试内容**：未实际执行（需配合真实工具创建场景）
+- **测试结果**：⏸️ **待后续验证**
+- **备注**：需要在有实际工具创建需求时配合测试
+
+#### 6️⃣ `get_agent_tools` - 查看智能体工具
+- **测试内容**：查询 tool_maker 自己的工具列表
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功返回 23 个已掌握的工具列表，含工具名称、标题和描述
+- **备注**：结果完整准确
+
+#### 7️⃣ `read_text` - 读取文本文件
+- **测试内容**：写入测试文件后读取其内容
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功读取文件全部 3 行内容，支持分段读取
+- **备注**：支持大文件分段读取（offset+limit参数）
+
+#### 8️⃣ `write_text` - 写入文本文件
+- **测试内容**：覆盖写入测试文件
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功写入 85 字节、3 行内容，支持 overwrite/append/insert/replace 四种模式
+- **备注**：功能完善
+
+#### 9️⃣ `edit_file` - 编辑文件
+- **测试内容**：使用 old_str 模式替换文件中的文本
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功替换指定文本，从 85 字节变为 106 字节
+- **备注**：支持 old_str 自动定位和 start/end 精确定位两种模式
+
+#### 🔟 `make_dir` - 创建目录
+- **测试内容**：创建 `project/agent_self_check/tool_maker` 目录
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功创建目录，返回绝对路径
+- **备注**：支持多级目录自动创建
+
+#### 1️⃣1️⃣ `ls` - 目录列表
+- **测试内容**：列出 tool_maker 目录内容
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功列出 1 个文件，包含文件名、类型、大小、修改时间
+- **备注**：信息完整
+
+#### 1️⃣2️⃣ `search_dir` - 目录搜索
+- **测试内容**：搜索 `project/agent_self_check` 下的所有目录
+- **测试结果**：⚠️ **部分异常**
+- **错误信息**：`path.existsSync is not a function`
+- **备注**：搜索目录功能存在兼容性问题，可能是环境依赖问题
+
+#### 1️⃣3️⃣ `search_file` - 文件搜索
+- **测试内容**：搜索 tool_maker 目录下所有 .txt 文件
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功找到 1 个匹配文件，返回完整路径
+- **备注**：支持通配符模式匹配
+
+#### 1️⃣4️⃣ `remove_dir` - 删除目录
+- **测试内容**：删除 tool_maker 测试目录
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功删除目录
+- **备注**：正常使用
+
+#### 1️⃣5️⃣ `remove_file` - 删除文件
+- **测试内容**：删除测试文件
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功删除文件
+- **备注**：正常使用
+
+#### 1️⃣6️⃣ `exec_code` - 代码执行
+- **测试内容**：分别执行 Python 和 JavaScript 代码
+- **测试结果**：✅ **正常可用**
+- **返回数据**：
+  - Python：`2+3=5`，执行成功
+  - JavaScript：执行成功
+- **备注**：支持 Python 和 JavaScript 两种语言
+
+#### 1️⃣7️⃣ `run_script` - 脚本执行
+- **测试内容**：尝试执行文本文件作为脚本
+- **测试结果**：⚠️ **路径映射需注意**
+- **备注**：脚本执行工具本身功能正常，但需要注意文件路径的映射问题（实际运行目录与示例目录的差异）
+
+#### 1️⃣8️⃣ `read_skill` - 读取技能
+- **测试内容**：读取 `tool_create_standard` 和 `tool_development` 两个技能
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功读取技能完整内容，包括基本信息、执行步骤、输出成果、禁止行为
+- **备注**：信息完整，是工具开发的重要参考
+
+#### 1️⃣9️⃣ `get_skill_list` - 获取技能列表
+- **测试内容**：获取全部技能列表
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功返回 140+ 个技能，涵盖开发、设计、管理、创作等类别
+- **备注**：列表完整
+
+#### 2️⃣0️⃣ `get_agent_skills` - 获取智能体技能
+- **测试内容**：查询 tool_maker 的技能列表
+- **测试结果**：✅ **正常可用**
+- **返回数据**：已掌握 2 个技能（tool_development, tool_create_standard），缺少 2 个技能（tool_build, code_implementation）
+- **备注**：结果准确，提示了需要补全的技能
+
+#### 2️⃣1️⃣ `get_agent_list` - 获取智能体列表
+- **测试内容**：获取所有智能体列表
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功返回 40+ 个智能体，涵盖管理类、开发类、设计类、策划类等
+- **备注**：列表完整
+
+#### 2️⃣2️⃣ `get_agent_detail` - 获取智能体详情
+- **测试内容**：查询 tool_maker 自己的详细信息
+- **测试结果**：✅ **正常可用**
+- **返回数据**：成功返回完整信息，包括名称、标题、描述、分组、技能、工具、提示词文件路径等
+- **备注**：信息详尽
+
+#### 2️⃣3️⃣ `call_agent` - 呼叫智能体
+- **测试内容**：未实际执行（需协作场景）
+- **测试结果**：⏸️ **待后续验证**
+- **备注**：参数完整，语法正确，需在协作场景中实际测试
+
+### 三、测试汇总
+
+| 状态 | 数量 | 工具名称 |
+|------|------|---------|
+| ✅ **正常可用** | 17 | get_tool_list, get_tool_detail, get_agent_tools, read_text, write_text, edit_file, make_dir, ls, search_file, remove_dir, remove_file, exec_code, read_skill, get_skill_list, get_agent_skills, get_agent_list, get_agent_detail |
+| ⚠️ **部分异常** | 2 | create_tool（返回成功但未实际创建）, search_dir（path.existsSync错误）, run_script（路径映射需注意） |
+| ❌ **不可用** | 1 | set_tool（当前环境下无法找到目标工具） |
+| ⏸️ **待后续验证** | 2 | provide_tools, call_agent |
+
+### 四、问题与改进建议
+
+1. **create_tool 创建后未实际生效**：返回成功但查询不到，可能需要检查工具目录的创建路径或注册机制
+2. **search_dir 存在兼容性问题**：`path.existsSync is not a function`，可能是 Node.js 版本兼容问题
+3. **set_tool 依赖 create_tool**：需要先确保 create_tool 正常工作
+4. **技能缺失**：缺少 `tool_build` 和 `code_implementation` 两个技能，需要联系 skill_teacher 补全
+
+---
+
+## 第三部分：总结
+
+工具匠人（tool_maker）的核心工作流程清晰，职责明确。已掌握的 23 个工具中，**大部分工具功能正常可用**，能够支撑日常工具研发工作。
+
+**关键发现**：
+- 文件操作类工具（read_text/write_text/edit_file）功能完善
+- 目录操作类工具（make_dir/ls/search_file/remove_dir/remove_file）基本正常
+- 代码执行工具（exec_code）支持 Python 和 JavaScript
+- 技能相关工具（read_skill/get_skill_list/get_agent_skills）完全正常
+- 核心工具管理工具（create_tool/set_tool）存在一些问题需要修复
+
+**下一步行动**：
+1. 联系 skill_teacher 补全缺失技能（tool_build, code_implementation）
+2. 排查 create_tool 创建后未实际生效的问题
+3. 修复 search_dir 的兼容性问题
+4. 在真实工具开发场景中验证 set_tool 和 provide_tools
+
+---
+
+*报告生成完毕。*

package/example/project/ai_secretary/data/schedule.json

@@ -0,0 +1,28 @@
+{
+  "schedules": [
+    {
+      "id": "sch_1782780965858_4un2zf",
+      "title": "简单日程",
+      "startTime": null,
+      "endTime": null,
+      "location": "",
+      "notes": "",
+      "reminderTime": null,
+      "status": "active",
+      "createdAt": "2026-06-30T00:56:05.858Z",
+      "updatedAt": "2026-06-30T00:56:05.858Z"
+    },
+    {
+      "id": "sch_1782780965860_l6tk2h",
+      "title": "未命名日程",
+      "startTime": null,
+      "endTime": null,
+      "location": "",
+      "notes": "",
+      "reminderTime": null,
+      "status": "active",
+      "createdAt": "2026-06-30T00:56:05.860Z",
+      "updatedAt": "2026-06-30T00:56:05.860Z"
+    }
+  ]
+}

package/example/project/ai_secretary/data/schedule.json.bak

@@ -0,0 +1,40 @@
+{
+  "schedules": [
+    {
+      "id": "sch_1782780965848_lzrtf5",
+      "title": "更新后的会议",
+      "startTime": "2026-07-01T15:00:00",
+      "endTime": "2026-07-01T16:00:00",
+      "location": "会议室A",
+      "notes": "讨论Q3项目进度",
+      "reminderTime": "2026-07-01T06:45:00.000Z",
+      "status": "active",
+      "createdAt": "2026-06-30T00:56:05.848Z",
+      "updatedAt": "2026-06-30T00:56:05.865Z"
+    },
+    {
+      "id": "sch_1782780965858_4un2zf",
+      "title": "简单日程",
+      "startTime": null,
+      "endTime": null,
+      "location": "",
+      "notes": "",
+      "reminderTime": null,
+      "status": "active",
+      "createdAt": "2026-06-30T00:56:05.858Z",
+      "updatedAt": "2026-06-30T00:56:05.858Z"
+    },
+    {
+      "id": "sch_1782780965860_l6tk2h",
+      "title": "未命名日程",
+      "startTime": null,
+      "endTime": null,
+      "location": "",
+      "notes": "",
+      "reminderTime": null,
+      "status": "active",
+      "createdAt": "2026-06-30T00:56:05.860Z",
+      "updatedAt": "2026-06-30T00:56:05.860Z"
+    }
+  ]
+}

package/example/project/ai_secretary/data/todo.json

@@ -0,0 +1,31 @@
+{
+  "todos": [
+    {
+      "id": "todo_1782780981313_snr7cw",
+      "title": "买牛奶",
+      "dueDate": "2026-07-02",
+      "priority": "medium",
+      "status": "pending",
+      "createdAt": "2026-06-30T00:56:21.313Z",
+      "updatedAt": "2026-06-30T00:56:21.313Z"
+    },
+    {
+      "id": "todo_1782780981315_ybfsav",
+      "title": "修改后的标题",
+      "dueDate": null,
+      "priority": "low",
+      "status": "pending",
+      "createdAt": "2026-06-30T00:56:21.315Z",
+      "updatedAt": "2026-06-30T00:56:21.336Z"
+    },
+    {
+      "id": "todo_1782780981316_x5inkc",
+      "title": "未命名待办",
+      "dueDate": null,
+      "priority": "medium",
+      "status": "pending",
+      "createdAt": "2026-06-30T00:56:21.316Z",
+      "updatedAt": "2026-06-30T00:56:21.316Z"
+    }
+  ]
+}

package/example/project/ai_secretary/data/todo.json.bak

@@ -0,0 +1,40 @@
+{
+  "todos": [
+    {
+      "id": "todo_1782780981307_49w1dk",
+      "title": "提交周报",
+      "dueDate": "2026-07-05",
+      "priority": "high",
+      "status": "completed",
+      "createdAt": "2026-06-30T00:56:21.306Z",
+      "updatedAt": "2026-06-30T00:56:21.334Z"
+    },
+    {
+      "id": "todo_1782780981313_snr7cw",
+      "title": "买牛奶",
+      "dueDate": "2026-07-02",
+      "priority": "medium",
+      "status": "pending",
+      "createdAt": "2026-06-30T00:56:21.313Z",
+      "updatedAt": "2026-06-30T00:56:21.313Z"
+    },
+    {
+      "id": "todo_1782780981315_ybfsav",
+      "title": "修改后的标题",
+      "dueDate": null,
+      "priority": "low",
+      "status": "pending",
+      "createdAt": "2026-06-30T00:56:21.315Z",
+      "updatedAt": "2026-06-30T00:56:21.336Z"
+    },
+    {
+      "id": "todo_1782780981316_x5inkc",
+      "title": "未命名待办",
+      "dueDate": null,
+      "priority": "medium",
+      "status": "pending",
+      "createdAt": "2026-06-30T00:56:21.316Z",
+      "updatedAt": "2026-06-30T00:56:21.316Z"
+    }
+  ]
+}