mm_ai 1.0.0

package/common/work/develop/develop_plugin/prompt/rule.md

@@ -0,0 +1,18 @@
+# 开发插件 - 规范
+
+## 1. 代码规范
+- 函数命名使用小驼峰（camelCase）
+- 变量和参数命名使用小写蛇形（snake_case）
+- 常量命名使用全大写蛇形（SCREAMING_SNAKE_CASE）
+- 缩进统一使用2个空格
+- 注释使用JSDoc格式
+
+## 2. 标准接口规范
+插件必须实现以下三个标准接口函数：
+- `init(config)`：初始化插件
+- `execute(context)`：执行插件核心逻辑
+- `destroy()`：清理插件资源
+
+## 3. 插件原则
+- 禁止插件修改宿主核心逻辑（只能通过标准接口交互）
+- 禁止在未测试兼容性的情况下发布插件

package/common/work/develop/develop_plugin/prompt/trick.md

@@ -0,0 +1,10 @@
+# 开发插件 - 技巧
+
+## 1. 接口稳定
+插件的标准接口一旦确定，尽量保持稳定，避免影响已有集成。
+
+## 2. 配置可扩展
+插件配置使用对象格式，便于后续扩展新配置项。
+
+## 3. 错误隔离
+插件内部的错误不应影响宿主系统的正常运行。

package/common/work/develop/develop_plugin/work.json

@@ -0,0 +1 @@
+{"name":"develop_plugin","description":"开发可扩展Node.js插件","type":"dynamic","group":"develop"}

package/common/work/develop/develop_python_backend/prompt/method.md

@@ -0,0 +1,21 @@
+# Python后端开发 - 方法
+
+## 流程概览
+```
+分析需求 → 初始化项目 → 编写数据模型 → 编写API接口 → 编写配置和启动文件
+```
+
+## 步骤1：分析需求
+读取需求文档和API设计文档，确定技术栈和数据模型。
+
+## 步骤2：初始化项目
+创建项目目录，生成requirements.txt。
+
+## 步骤3：编写数据模型
+编写ORM模型定义。
+
+## 步骤4：编写API接口
+按照API设计文档编写路由和视图函数。
+
+## 步骤5：编写配置和启动文件
+编写应用配置和启动入口。

package/common/work/develop/develop_python_backend/prompt/rule.md

@@ -0,0 +1,14 @@
+# Python后端开发 - 规范
+
+## 1. 代码规范
+- 遵循PEP8规范（缩进4空格，行宽≤79字符）
+- 类名使用PascalCase
+- 函数名使用snake_case
+- 变量名使用snake_case
+- 常量名使用SCREAMING_SNAKE_CASE
+- 注释使用docstring格式
+
+## 2. 框架选择
+- FastAPI：适合高性能API服务
+- Django：适合大型全栈应用
+- Flask：适合小型应用和微服务

package/common/work/develop/develop_python_backend/prompt/trick.md

@@ -0,0 +1,10 @@
+# Python后端开发 - 技巧
+
+## 1. 虚拟环境
+使用venv或poetry管理项目依赖，避免全局包冲突。
+
+## 2. 异步优先
+使用async/await处理I/O密集型操作，提升并发能力。
+
+## 3. 类型提示
+使用Python类型提示（Type Hints），提高代码可读性和IDE支持。

package/common/work/develop/develop_python_backend/work.json

@@ -0,0 +1 @@
+{"name":"develop_python_backend","description":"Python后端开发","type":"dynamic","group":"develop"}

package/common/work/develop/develop_tool/prompt/method.md

@@ -0,0 +1,34 @@
+# 工具开发 - 方法文档
+
+## 操作流程
+
+### 步骤1：分析工具需求
+- 明确工具的功能需求
+- 定义输入参数和输出结果
+- 确认使用场景
+
+### 步骤2：创建工具目录
+- 创建 `./tool/{工具名称}/` 目录
+
+### 步骤3：编写工具代码
+- 编写index.js，实现async main(params)
+- 参数校验、核心逻辑、异常处理
+
+### 步骤4：编写工具配置
+- 编写tool.json配置文件
+- 定义完整的参数和返回值
+
+### 步骤5：注册工具
+- 调用工具创建功能注册到系统
+
+### 步骤6：测试验证
+- 进行功能测试
+- 确认工具正常运行
+
+### 步骤7：赋予工具
+- 为目标智能体赋予工具
+- 确认智能体可正常使用
+
+### 步骤8：维护优化
+- 收集使用反馈
+- 持续优化工具功能

package/common/work/develop/develop_tool/prompt/rule.md

@@ -0,0 +1,37 @@
+# 工具开发 - 规则文档
+
+## 任务目标
+进行智能体工具研发，涵盖工具需求分析、功能设计、代码实现、测试验证、部署赋予与维护优化全流程。
+
+## 输入条件
+- 工具需求描述
+- 目标智能体信息
+- 技术栈要求
+
+## 必须遵守的规则
+
+### 规则1：需求分析先行
+- 明确工具的功能、输入参数和输出结果
+- 确认工具的使用场景和目标用户
+- 评估工具实现的可行性和工作量
+
+### 规则2：标准化目录结构
+- 工具目录：`./tool/{工具名称}/`
+- 主文件：index.js
+- 配置文件：tool.json
+
+### 规则3：代码规范
+- 入口函数：`async function main(params)`
+- 统一返回格式：`{ code, msg, data }`
+- 完整的参数校验和异常处理
+- 禁止硬编码敏感信息
+
+### 规则4：全流程覆盖
+- 包含需求分析、设计、编码、测试、部署、维护
+- 测试验证通过后才能赋予智能体
+- 维护阶段收集使用反馈持续优化
+
+## 输出要求
+- 工具脚本文件（index.js）
+- 工具配置文件（tool.json）
+- 已注册和赋予的工具

package/common/work/develop/develop_tool/prompt/trick.md

@@ -0,0 +1,23 @@
+# 工具开发 - 技巧文档
+
+## 最佳实践
+
+### 需求分析技巧
+- 明确工具的输入输出边界
+- 考虑异常场景和边界情况
+- 与目标智能体的角色定位匹配
+
+### 设计经验
+- 工具功能保持单一职责
+- 参数设计考虑扩展性
+- 返回值包含足够信息
+
+### 测试要点
+- 使用真实的输入数据测试
+- 覆盖正常、异常、边界场景
+- 测试工具在智能体中的实际表现
+
+### 常见问题
+- **需求不明确**：先澄清再开发
+- **赋予失败**：检查工具配置是否正确
+- **使用异常**：检查参数传递是否正确

package/common/work/develop/develop_tool/work.json

@@ -0,0 +1 @@
+{"name":"develop_tool","description":"进行智能体工具研发，含需求分析、设计、实现、测试和部署全流程","type":"dynamic","group":"develop"}

package/common/work/develop/develop_uniapp/prompt/method.md

@@ -0,0 +1,24 @@
+# UniApp开发 - 方法
+
+## 流程概览
+```
+分析需求 → 创建项目配置 → 开发页面和组件 → 多端适配 → 兼容性测试 → 打包交付
+```
+
+## 步骤1：分析需求
+确定目标平台（iOS、Android、Web、小程序）。
+
+## 步骤2：创建项目配置
+编写pages.json、manifest.json和uni.scss。
+
+## 步骤3：开发页面和组件
+编写Vue单文件组件。
+
+## 步骤4：多端适配与兼容性处理
+使用条件编译处理平台差异，封装统一的适配层接口。
+
+## 步骤5：兼容性测试
+检查各平台代码文件完整性，抽查条件编译代码的正确性。
+
+## 步骤6：打包交付
+编写README.md，包含各平台构建说明。

package/common/work/develop/develop_uniapp/prompt/rule.md

@@ -0,0 +1,18 @@
+# UniApp开发 - 规范
+
+## 1. 代码规范
+- 函数命名使用小驼峰（camelCase）
+- 变量和参数命名使用小写蛇形（snake_case）
+- 常量命名使用全大写蛇形（SCREAMING_SNAKE_CASE）
+- 缩进统一使用2个空格
+- 注释使用JSDoc格式
+
+## 2. CSS命名规范
+- 组件命名用下划线 `_` 拼接
+- 状态变体用连字符 `-` 拼接
+- 全部小写，禁止驼峰
+
+## 3. 跨平台规范
+- 禁止使用不支持的平台API
+- 禁止在未测试多端的情况下交付
+- 禁止使用不兼容的平台特性（必须使用条件编译隔离平台差异）

package/common/work/develop/develop_uniapp/prompt/trick.md

@@ -0,0 +1,10 @@
+# UniApp开发 - 技巧
+
+## 1. 条件编译
+使用 `#ifdef` / `#ifndef` 处理平台差异，保持代码整洁。
+
+## 2. 适配层封装
+对平台差异较大的功能，封装统一的适配层接口，上层调用无需关心平台。
+
+## 3. 真机调试
+在模拟器上开发完成后，务必在真机上测试，模拟器与真机表现可能不同。

package/common/work/develop/develop_uniapp/work.json

@@ -0,0 +1 @@
+{"name":"develop_uniapp","description":"UniApp跨平台开发","type":"dynamic","group":"develop"}

package/common/work/develop/develop_vue/prompt/method.md

@@ -0,0 +1,30 @@
+# Vue开发 - 方法
+
+## 流程概览
+```
+分析需求 → 初始化项目结构 → 配置构建工具 → 编写Vue组件 → 配置路由 → 配置状态管理 → 封装API接口 → 验证完整性
+```
+
+## 步骤1：分析需求
+读取需求文档和API设计文档，确定页面结构、组件划分和数据接口。
+
+## 步骤2：初始化Vue项目结构
+创建Vue项目目录结构。
+
+## 步骤3：配置构建工具
+生成package.json和vite.config.js配置文件。
+
+## 步骤4：编写Vue组件
+按功能模块划分组件，编写.vue单文件组件。
+
+## 步骤5：配置路由
+配置页面路由和导航守卫。
+
+## 步骤6：配置状态管理
+管理全局状态（用户信息、应用配置）。
+
+## 步骤7：封装API接口
+封装后端API调用。
+
+## 步骤8：验证完整性
+检查组件引用、路由配置、API接口路径。

package/common/work/develop/develop_vue/prompt/rule.md

@@ -0,0 +1,50 @@
+# Vue开发规范
+
+## 1. 组件命名
+
+组件文件名、注册名、模板引用必须统一使用小写蛇形（snake_case）。
+
+✅ `user_card.vue` → `name: 'user_card'` → `<user_card></user_card>`
+❌ `UserCard.vue` → `name: 'UserCard'` → `<UserCard></UserCard>`
+
+## 2. JS代码命名规范
+
+组件 `<script>` 中的 JS 代码必须遵循以下命名规范：
+
+| 类型 | 规范 | 示例 |
+|:----:|:----:|:----:|
+| 类 | 大驼峰（PascalCase） | `class UserManager` |
+| 函数/方法 | 小驼峰（camelCase） | `getUserData()`、`computed`、`watch` |
+| 常量 | 全大写蛇形（SCREAMING_SNAKE_CASE） | `const API_BASE_URL = '/api'` |
+| 变量和参数 | 小写蛇形（snake_case） | `let user_name = 'xxx'`、`this.user_list` |
+
+✅ `let user_name = '张三'`、`this.user_list = []`
+❌ `let userName = '张三'`、`this.users = []`
+
+## 3. 数据驱动
+
+禁止直接操作DOM，必须使用Vue的数据驱动方式。
+
+✅ `<input v-model="user_name">`、`:class="{ active: is_active }"`
+❌ `document.querySelector('#input').value = 'xxx'`
+
+## 4. 组件拆分
+
+禁止将全部业务逻辑写在一个组件中，必须按功能拆分。
+
+✅ `user_list.vue` + `user_card.vue` + `user_form.vue`
+❌ 一个 `user_manage.vue` 包含所有功能
+
+## 5. API调用
+
+所有数据操作必须通过API接口，禁止在前端直接操作数据库。
+
+✅ `axios.get('/api/users').then(res => this.user_list = res.data)`
+❌ 前端代码中直接拼接SQL
+
+## 6. 缩进
+
+统一使用2个空格缩进。
+
+✅ 模板、脚本、样式均使用2空格
+❌ 使用Tab或4空格

package/common/work/develop/develop_vue/prompt/trick.md

@@ -0,0 +1,20 @@
+# Vue开发技巧
+
+## 1. 计算属性替代方法
+
+计算属性有缓存，依赖不变时不重新计算，性能更好。
+
+| 维度 | methods方法 | computed计算属性 |
+|------|------------|----------------|
+| 缓存 | 每次调用都执行 | 依赖不变时不重新计算 |
+| 响应式 | 需要手动触发 | 自动追踪依赖 |
+| 模板调用 | `{{ formatName() }}` | `{{ formattedName }}` |
+
+## 2. 常见问题
+
+| 问题 | 原因 | 解决 |
+|------|------|------|
+| 组件未显示 | 未注册或未导入 | 检查components注册和导入路径 |
+| 数据修改但视图未更新 | 直接修改了数组/对象 | 使用展开运算符创建新对象 |
+| this指向错误 | 回调中丢失上下文 | 使用箭头函数 |
+| API跨域 | 前后端域名不一致 | 配置proxy或CORS |

package/common/work/develop/develop_vue/work.json

@@ -0,0 +1 @@
+{"name":"develop_vue","description":"Vue框架前端开发","type":"dynamic","group":"develop"}

package/common/work/develop/e2e_testing_fe/prompt/method.md

@@ -0,0 +1,21 @@
+# 前端E2E测试方法
+
+## 前置条件
+
+- [ ] 前端服务已启动
+- [ ] 已安装Playwright依赖
+
+## 流程概览
+
+分析页面结构 → 设计测试场景 → 编写测试用例 → 执行测试 → 组件渲染测试 → 浏览器兼容性测试 → 生成报告
+
+## 详细步骤
+
+### 步骤1：分析前端页面结构
+搜索前端页面文件，提取页面路由和交互元素清单。
+
+### 步骤2：设计E2E测试场景
+基于页面路由设计用户核心操作流程的测试场景。
+
+### 步骤3：编写E2E测试用例
+编写Playwright测试脚本。

package/common/work/develop/e2e_testing_fe/prompt/rule.md

@@ -0,0 +1,46 @@
+# 前端E2E测试规范
+
+## 适用对象和范围
+
+本规范适用于所有对Web前端进行E2E端到端测试、UI组件渲染测试和浏览器兼容性测试的场景。
+
+---
+
+## 1. 测试框架规范
+
+**规则**：前端E2E测试必须使用Playwright框架。
+
+- ✅ 正确：`npm install --save-dev @playwright/test`
+- ❌ 错误：使用非标准E2E测试框架
+
+**违反后果**：非标准框架可能导致浏览器驱动不兼容。
+
+---
+
+## 2. 多浏览器覆盖规范
+
+**规则**：必须覆盖至少两种浏览器引擎（Chromium、Firefox、WebKit）。
+
+- ✅ 正确：使用 `projects` 配置多浏览器
+- ❌ 错误：仅测试单一浏览器
+
+**违反后果**：单一浏览器测试无法发现跨浏览器兼容性问题。
+
+---
+
+## 3. 智能等待规范
+
+**规则**：禁止在E2E测试中硬编码等待时间，必须使用智能等待。
+
+- ✅ 正确：`page.waitForSelector('.result')`、`page.waitForURL('**/dashboard')`
+- ❌ 错误：`page.waitForTimeout(3000)`
+
+**违反后果**：硬编码等待导致测试不稳定（网络波动时容易失败）或执行时间过长。
+
+---
+
+## 4. 测试场景覆盖规范
+
+**规则**：必须覆盖用户核心操作流程，包括登录、核心业务操作、页面导航和表单提交。
+
+**违反后果**：未覆盖核心流程导致上线后关键功能出问题。

package/common/work/develop/e2e_testing_fe/prompt/trick.md

@@ -0,0 +1,37 @@
+# 前端E2E测试技巧
+
+## 1. 使用page对象模型
+
+**适用场景**：需要维护多个页面的测试用例时。
+
+**具体做法**：为每个页面创建Page Object类，封装页面元素和操作方法。
+
+**示例**：
+```javascript
+class LoginPage {
+  constructor(page) {
+    this.page = page;
+    this.usernameInput = page.locator('input[name="username"]');
+    this.passwordInput = page.locator('input[name="password"]');
+    this.submitBtn = page.locator('button[type="submit"]');
+  }
+  
+  async login(username, password) {
+    await this.usernameInput.fill(username);
+    await this.passwordInput.fill(password);
+    await this.submitBtn.click();
+  }
+}
+```
+
+**注意事项**：Page Object模式提高测试代码复用性和可维护性。
+
+---
+
+## 2. 常见问题速查
+
+| 问题 | 原因 | 解决方案 |
+|------|------|---------|
+| 元素定位失败 | 选择器错误或元素未加载 | 使用 `waitForSelector` 等待元素出现 |
+| 测试不稳定 | 网络波动或异步渲染 | 使用智能等待替代固定超时 |
+| 跨域问题 | 前端服务与测试环境不同源 | 配置Playwright的 `baseURL` |

package/common/work/develop/e2e_testing_fe/work.json

@@ -0,0 +1 @@
+{"name":"e2e_testing_fe","description":"对Web前端进行E2E端到端测试、UI组件渲染测试和浏览器兼容性测试","type":"dynamic","group":"develop"}

package/common/work/develop/encapsulate_code/prompt/method.md

@@ -0,0 +1,18 @@
+# 封装代码 - 方法
+
+## 封装形式
+
+### 1. 函数封装
+将相关功能函数放在一个模块中导出，适合无状态工具函数。
+
+### 2. 类封装
+适合有状态的服务、管理器等复杂对象，使用 `class` 定义。
+
+### 3. 模块封装（module.exports）
+将相关工具函数组织为模块对象导出。
+
+### 4. NPM包封装
+适合需要跨项目、跨团队复用的功能，包含 package.json、入口文件、源码目录、测试目录。
+
+### 5. 闭包封装
+适合需要私有变量和方法的场景。

package/common/work/develop/encapsulate_code/prompt/rule.md

@@ -0,0 +1,21 @@
+# 封装代码 - 规范
+
+## 1. 命名规范
+| 类型 | 规范 | 示例 |
+|------|------|------|
+| 函数名 | 小驼峰 | `formatAmount` |
+| 变量/参数 | 小写蛇形 | `user_list` |
+| 类名 | 大驼峰 | `CacheManager` |
+| 常量 | 全大写蛇形 | `MAX_RETRY_COUNT` |
+| 文件名 | 小写蛇形 | `string_utils.js` |
+
+## 2. 导出规范
+使用 `module.exports = { ... }` 或 `exports.xxx` 方式导出。
+
+## 3. 注释规范
+所有函数必须有JSDoc注释，说明功能、参数和返回值。
+
+## 4. 封装原则
+- 禁止在通用模块中引入框架特定的API
+- 禁止在模块中使用全局变量污染命名空间
+- 禁止模块存在外部副作用（如修改全局变量、写入文件系统）

package/common/work/develop/encapsulate_code/prompt/trick.md

@@ -0,0 +1,13 @@
+# 封装代码 - 技巧
+
+## 1. 单一职责
+每个模块只做一件事，做好一件事。功能复杂的模块应拆分为多个小模块。
+
+## 2. 接口稳定
+模块的导出接口一旦确定，尽量保持稳定，避免频繁修改。
+
+## 3. 错误处理
+模块内部应妥善处理异常，不将未处理的错误抛到外部。
+
+## 4. 文档先行
+先写 README.md 说明API用法，再写实现代码。

package/common/work/develop/encapsulate_code/work.json

@@ -0,0 +1 @@
+{"name":"encapsulate_code","description":"通用代码封装","type":"dynamic","group":"develop"}

package/common/work/develop/error_handling/prompt/method.md

@@ -0,0 +1,95 @@
+# 错误处理 - 方法
+
+## 前置条件
+- [ ] 已确定项目使用的日志框架
+- [ ] 已定义错误码表
+
+## 流程概览
+```
+定义错误类 → 抛出错误 → 全局捕获 → 格式化响应 → 记录日志
+```
+
+## 后端错误处理
+
+### 1. 自定义错误类
+```javascript
+class AppError extends Error {
+  constructor(code, message, detail = '') {
+    super(message);
+    this.code = code;
+    this.detail = detail;
+    this.name = 'AppError';
+  }
+}
+
+// 使用
+throw new AppError(10001, '用户不存在', `userId: ${id}`);
+```
+
+### 2. 全局错误处理中间件
+```javascript
+app.use(async (err, req, res, next) => {
+  if (err instanceof AppError) {
+    return res.json({ code: err.code, msg: err.message, data: null });
+  }
+  // 未知错误：记录日志，返回 500
+  logger.error('未捕获错误', err);
+  return res.status(500).json({ code: 50000, msg: '服务器内部错误', data: null });
+});
+```
+
+### 3. 异步错误包装
+```javascript
+const asyncHandler = (fn) => (req, res, next) =>
+  Promise.resolve(fn(req, res, next)).catch(next);
+
+app.get('/api/users', asyncHandler(async (req, res) => {
+  const users = await userService.list();
+  res.json({ code: 0, msg: '成功', data: users });
+}));
+```
+
+## 前端错误处理
+
+### 1. HTTP 错误拦截
+```javascript
+http.interceptors.response.use(
+  (response) => {
+    const { code, msg } = response.data;
+    if (code !== 0) {
+      message.error(msg);
+      return Promise.reject(new Error(msg));
+    }
+    return response.data;
+  },
+  (error) => {
+    if (error.response) {
+      switch (error.response.status) {
+        case 401: // 跳转登录
+        case 403: // 无权限提示
+        case 500: // 服务器错误提示
+      }
+    }
+    return Promise.reject(error);
+  }
+);
+```
+
+### 2. React 错误边界
+```jsx
+class ErrorBoundary extends React.Component {
+  state = { hasError: false, error: null };
+  static getDerivedStateFromError(error) {
+    return { hasError: true, error };
+  }
+  componentDidCatch(error, info) {
+    logger.error('组件渲染错误', error, info);
+  }
+  render() {
+    if (this.state.hasError) {
+      return <ErrorFallback error={this.state.error} />;
+    }
+    return this.props.children;
+  }
+}
+```

package/common/work/develop/error_handling/prompt/rule.md

@@ -0,0 +1,46 @@
+# 错误处理 - 规范
+
+## 后端错误对象结构
+```javascript
+{
+  code: 10001,        // 错误码
+  message: '错误描述',  // 用户可读的错误描述
+  detail: '详细信息'    // 调试用（不返回给前端）
+}
+```
+
+## 错误码范围
+
+| 范围 | 说明 |
+|:-----|:-----|
+| 0 | 成功 |
+| 10000–19999 | 通用错误（参数错误、认证失败） |
+| 20000–29999 | 业务逻辑错误 |
+| 30000–39999 | 第三方服务错误 |
+| 50000–59999 | 系统级错误 |
+
+## 日志级别
+
+| 级别 | 触发场景 |
+|:-----|:---------|
+| `debug` | 开发环境调试信息 |
+| `info` | 请求入口/出口、状态变更 |
+| `warn` | 参数异常、降级处理 |
+| `error` | 业务异常、第三方调用失败 |
+| `fatal` | 数据库连接失败、内存溢出 |
+
+## 日志内容要求
+```javascript
+// ✅ 好的日志
+logger.info('用户登录成功', { userId: 123, ip: '192.168.1.1' });
+logger.error('数据库查询失败', { sql: 'SELECT ...', error: err.message });
+
+// ❌ 差的日志
+logger.info('成功');
+```
+
+## 禁止行为
+- ❌ 禁止吞掉异常（空的 catch 块）
+- ❌ 禁止将敏感信息（密码、token）写入日志
+- ❌ 禁止在前端暴露后端错误栈
+- ❌ 禁止用 `console.log` 替代日志框架