mm_ai 1.0.0

package/common/work/develop/mqtt_integration/work.json

@@ -0,0 +1 @@
+{"name":"mqtt_integration","title":"MQTT协议联调","description":"MQTT协议联调对接，包括阅读协议文档、Topic设计与订阅、入参出参数据转换","version":"1.0.0","prompt_files":["./prompt/rule.md","./prompt/method.md","./prompt/trick.md"]}

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

@@ -0,0 +1,19 @@
+# Node.js服务端开发方法
+
+## 前置条件
+
+- [ ] 已获取需求文档和架构设计文档
+- [ ] 已确定服务端技术栈（Express/Koa）
+- [ ] 已了解数据库类型和连接信息
+
+## 流程概览
+
+分析需求 → 初始化项目结构 → 编写应用入口 → 编写中间件 → 编写配置 → 编写工具函数 → 验证服务启动
+
+## 详细步骤
+
+### 步骤1：分析需求
+分析需求文档和架构设计文档，了解服务端技术栈要求。
+
+### 步骤2：初始化项目结构
+创建服务端项目目录结构。

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

@@ -0,0 +1,123 @@
+# Node.js服务端开发规范
+
+## 适用对象和范围
+
+本规范适用于所有搭建Node.js服务端应用的场景，包括Express/Koa框架搭建、中间件配置、启动管理和部署配置。
+
+---
+
+## 1. 变量声明规范
+
+**规则**：能用 `const` 就用 `const`，只有确实需要重新赋值的变量才用 `let`。
+
+- ✅ 正确：`const app = express();`、`let port = process.env.PORT || 3000;`
+- ❌ 错误：`let app = express();`（不需要重新赋值却用let）
+
+**违反后果**：滥用 `let` 降低代码可读性，无法明确标识哪些变量是只读的。
+
+---
+
+## 2. 命名规范
+
+**规则**：函数使用小驼峰（camelCase），变量和参数使用小写蛇形（snake_case），常量使用全大写蛇形（SCREAMING_SNAKE_CASE）。
+
+| 标识符类型 | 命名法 | 示例 |
+|-----------|--------|------|
+| 函数 | camelCase | `function getUserData(user_id) {}` |
+| 变量/参数 | snake_case | `let user_name = 'xxx';` |
+| 常量 | SCREAMING_SNAKE_CASE | `const MAX_RETRY_COUNT = 3;` |
+
+- ✅ 正确：`function getUserData(user_id) { ... }`
+- ❌ 错误：`function get_user_data(userId) { ... }`
+
+**违反后果**：命名不一致导致代码可读性差。
+
+---
+
+## 3. 缩进规范
+
+**规则**：统一使用2个空格缩进。
+
+- ✅ 正确：使用2空格
+- ❌ 错误：使用Tab或4空格
+
+**违反后果**：缩进不一致导致代码结构混乱。
+
+---
+
+## 4. 注释规范
+
+**规则**：函数必须使用JSDoc格式注释。
+
+```javascript
+/**
+ * 获取用户数据
+ * @param {number} user_id - 用户ID
+ * @returns {Promise<Object>} 用户数据对象
+ */
+async function getUserData(user_id) {
+  // ...
+}
+```
+
+**违反后果**：缺少JSDoc注释导致IDE无法提供类型提示。
+
+---
+
+## 5. 敏感信息安全规范
+
+**规则**：禁止将密码、密钥、token等敏感信息硬编码在代码中，必须使用环境变量。
+
+- ✅ 正确：`const DB_PASSWORD = process.env.DB_PASSWORD;`
+- ❌ 错误：`const DB_PASSWORD = '123456';`
+
+**违反后果**：硬编码敏感信息导致代码泄露时密码一同泄露，存在严重安全风险。
+
+---
+
+## 6. 中间件注册顺序规范
+
+**规则**：错误处理中间件必须注册在所有中间件和路由之后。
+
+- ✅ 正确：
+```javascript
+app.use(cors());
+app.use(logger());
+app.use('/api', routes);
+app.use(errorHandler);  // 错误处理放最后
+```
+
+- ❌ 错误：
+```javascript
+app.use(errorHandler);  // 错误处理放前面
+app.use(cors());
+app.use('/api', routes);
+```
+
+**违反后果**：错误处理中间件放前面会导致它无法捕获后续中间件的错误。
+
+---
+
+## 7. 目录结构规范
+
+**规则**：服务端代码必须遵循以下目录结构。
+
+```
+./project/{项目名}/server/
+├── app.js
+├── config/
+│   ├── index.js
+│   └── db.js
+├── middleware/
+│   ├── auth.js
+│   ├── error_handler.js
+│   └── logger.js
+├── routes/
+├── controllers/
+├── models/
+├── utils/
+│   └── response.js
+└── package.json
+```
+
+**违反后果**：目录混乱导致代码难以维护和扩展。

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

@@ -0,0 +1,115 @@
+# Node.js服务端开发技巧
+
+## 1. 使用环境变量管理配置
+
+**适用场景**：需要区分开发、测试、生产环境时。
+
+**具体做法**：使用 `dotenv` 包加载 `.env` 文件，通过 `process.env` 读取配置。
+
+**对比说明**：
+
+| 维度 | 硬编码配置 | 环境变量 |
+|------|-----------|---------|
+| 安全性 | 代码泄露时配置泄露 | 配置在环境变量中 |
+| 环境切换 | 需修改代码 | 切换.env文件即可 |
+| 团队协作 | 每个人用不同配置需改代码 | 每人有自己的.env |
+
+**示例**：
+```javascript
+// .env 文件
+PORT=3000
+DB_HOST=localhost
+DB_PORT=27017
+
+// config/index.js
+require('dotenv').config();
+module.exports = {
+  port: process.env.PORT || 3000,
+  db: {
+    host: process.env.DB_HOST || 'localhost',
+    port: process.env.DB_PORT || 27017
+  }
+};
+```
+
+**注意事项**：`.env` 文件不应提交到版本控制，应在 `.gitignore` 中添加。
+
+---
+
+## 2. 统一错误处理中间件
+
+**适用场景**：需要统一处理所有接口的错误返回格式。
+
+**具体做法**：编写一个错误处理中间件，放在所有中间件和路由之后。
+
+**对比说明**：
+
+| 维度 | 每个接口单独处理错误 | 统一错误处理 |
+|------|-------------------|-------------|
+| 代码量 | 每个接口都要写try/catch | 只需一个中间件 |
+| 一致性 | 错误格式可能不一致 | 统一格式 |
+| 维护性 | 修改格式需改所有接口 | 只需改中间件 |
+
+**示例**：
+```javascript
+// error_handler.js
+function errorHandler(err, req, res, next) {
+  console.error(`[Error] ${req.method} ${req.path}:`, err.message);
+  
+  const status = err.status || 500;
+  res.status(status).json({
+    code: status,
+    message: err.message || '服务器内部错误',
+    timestamp: new Date().toISOString()
+  });
+}
+
+module.exports = errorHandler;
+```
+
+**注意事项**：Express的错误处理中间件必须有4个参数 `(err, req, res, next)`。
+
+---
+
+## 3. 使用async中间件包装器
+
+**适用场景**：使用 `async/await` 的路由处理器需要捕获异步错误。
+
+**具体做法**：编写一个 `asyncHandler` 包装函数。
+
+**对比说明**：
+
+| 维度 | 每个路由手动try/catch | 使用asyncHandler |
+|------|---------------------|-----------------|
+| 代码冗余 | 每个路由都要写try/catch | 只需在定义时包裹 |
+| 遗漏风险 | 容易忘记catch | 自动捕获 |
+
+**示例**：
+```javascript
+// utils/async_handler.js
+const asyncHandler = (fn) => (req, res, next) => {
+  Promise.resolve(fn(req, res, next)).catch(next);
+};
+
+module.exports = asyncHandler;
+
+// routes/user_routes.js
+router.get('/users', asyncHandler(async (req, res) => {
+  const users = await userService.list();
+  res.json({ code: 0, data: users });
+}));
+```
+
+**注意事项**：Koa框架天然支持async/await错误捕获，不需要此包装器。
+
+---
+
+## 4. 常见问题速查
+
+| 问题 | 原因 | 解决方案 |
+|------|------|---------|
+| 端口被占用 | 上次进程未关闭 | 使用 `lsof -i :端口号` 查找并kill进程 |
+| CORS跨域错误 | 前端域名与后端不一致 | 配置 `cors` 中间件，设置 `origin` |
+| 请求体为空 | 未配置body解析中间件 | 添加 `express.json()` 和 `express.urlencoded()` |
+| 静态文件404 | 静态文件路径配置错误 | 检查 `express.static()` 的路径参数 |
+| 数据库连接超时 | 连接字符串错误 | 检查 `DB_HOST`、`DB_PORT`、认证信息 |

package/common/work/develop/nodejs_server/work.json

@@ -0,0 +1 @@
+{"name":"nodejs_server","title":"Node.js服务端开发","description":"搭建Node.js服务端应用，包括Express/Koa框架、中间件、启动配置等","version":"1.0.0","prompt_files":["./prompt/rule.md","./prompt/method.md","./prompt/trick.md"]}

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

@@ -0,0 +1,18 @@
+# 性能优化 - 方法
+
+## 流程概览
+```
+分析性能瓶颈 → 制定优化方案 → 执行优化 → 验证效果
+```
+
+## 步骤1：分析性能瓶颈
+使用性能分析工具识别系统瓶颈（CPU、内存、I/O、网络）。
+
+## 步骤2：制定优化方案
+针对瓶颈制定优化策略，包括代码优化、资源优化和架构优化。
+
+## 步骤3：执行优化
+实施优化方案，调整代码、配置或架构。
+
+## 步骤4：验证效果
+测试优化后的系统性能，确认提升效果。

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

@@ -0,0 +1,11 @@
+# 性能优化 - 规范
+
+## 1. 优化原则
+- 禁止在生产环境直接执行未经测试的优化方案
+- 优化前必须分析性能瓶颈，不能盲目优化
+- 每次优化后必须验证效果
+
+## 2. 优化维度
+- 代码优化：算法效率、循环优化、减少不必要的计算
+- 资源优化：图片压缩、代码压缩、懒加载
+- 架构优化：缓存策略、数据库优化、负载均衡

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

@@ -0,0 +1,10 @@
+# 性能优化 - 技巧
+
+## 1. 二八原则
+80%的性能问题来自20%的代码，先定位热点再优化。
+
+## 2. 可回滚
+每次优化前做好备份或版本控制，优化失败能快速回滚。
+
+## 3. 量化指标
+优化前后用具体数据说话，避免"感觉变快了"的主观判断。

package/common/work/develop/optimize_performance/work.json

@@ -0,0 +1 @@
+{"name":"optimize_performance","description":"系统性能优化","type":"dynamic","group":"develop"}

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

@@ -0,0 +1,55 @@
+# 性能优化方法
+
+## 前置条件
+
+- [ ] 已确认系统存在性能问题（响应慢、资源占用高等）
+- [ ] 已获取系统架构和代码信息
+
+---
+
+## 流程概览
+
+```
+分析性能瓶颈 → 制定优化方案 → 执行优化 → 验证效果
+```
+
+---
+
+## 详细步骤
+
+### 步骤1：分析性能瓶颈
+
+使用性能分析工具识别系统瓶颈：
+- CPU瓶颈：使用 `top`、`perf` 等工具
+- 内存瓶颈：使用 `free`、`valgrind` 等工具
+- I/O瓶颈：使用 `iostat`、`iotop` 等工具
+- 网络瓶颈：使用 `netstat`、`tcpdump` 等工具
+
+### 步骤2：制定优化方案
+
+针对识别的瓶颈制定优化策略：
+- 代码优化：算法优化、减少循环、缓存结果
+- 资源优化：压缩资源、懒加载、CDN加速
+- 架构优化：引入缓存层、读写分离、水平扩展
+
+### 步骤3：执行优化
+
+实施优化方案，调整代码、配置或架构。
+
+### 步骤4：验证效果
+
+测试优化后的系统性能，对比优化前后的指标。
+
+---
+
+## 决策分支
+
+- **优化效果不达预期** → 回滚优化，重新分析瓶颈
+- **优化引入新问题** → 立即回滚，排查问题原因
+
+---
+
+## 产出物说明
+
+1. 性能优化报告（含优化前后对比数据）
+2. 优化后的系统配置或代码

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

@@ -0,0 +1,35 @@
+# 性能优化规范
+
+## 适用对象和范围
+
+本规范适用于所有系统性能优化场景，包括代码优化、资源优化和架构优化。
+
+---
+
+## 1. 先分析后优化
+
+**规则**：必须先通过性能分析工具识别瓶颈，再制定优化方案。
+
+- ✅ 正确：先用工具分析CPU/内存/I/O瓶颈，再有针对性地优化
+- ❌ 错误：凭感觉猜测瓶颈位置
+
+**违反后果**：盲目优化可能浪费时间在非瓶颈环节，实际效果甚微。
+
+---
+
+## 2. 测试验证规范
+
+**规则**：优化方案必须经过测试验证才能上线。
+
+- ✅ 正确：在测试环境验证优化效果，对比优化前后的性能指标
+- ❌ 错误：未经测试直接在生产环境执行优化
+
+**违反后果**：未经测试的优化可能引入新问题，导致系统不稳定。
+
+---
+
+## 3. 回滚准备规范
+
+**规则**：优化方案必须准备回滚方案，优化效果不达预期时立即回滚。
+
+**违反后果**：无回滚方案导致优化失败后无法快速恢复。

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

@@ -0,0 +1,45 @@
+# 性能优化技巧
+
+## 1. 使用缓存减少重复计算
+
+**适用场景**：相同数据被频繁访问时。
+
+**具体做法**：引入内存缓存（Redis/Memcached）或本地缓存。
+
+**示例**：
+```javascript
+// 本地缓存示例
+const cache = new Map();
+
+async function getUserData(userId) {
+  if (cache.has(userId)) {
+    return cache.get(userId);
+  }
+  const data = await db.query('SELECT * FROM users WHERE id = ?', [userId]);
+  cache.set(userId, data);
+  return data;
+}
+```
+
+**注意事项**：缓存需要设置过期时间，避免数据不一致。
+
+---
+
+## 2. 使用数据库索引优化查询
+
+**适用场景**：数据库查询响应慢时。
+
+**具体做法**：为查询条件字段添加索引，使用EXPLAIN分析查询计划。
+
+**注意事项**：索引不是越多越好，写操作频繁的表要控制索引数量。
+
+---
+
+## 3. 常见问题速查
+
+| 问题 | 原因 | 解决方案 |
+|------|------|---------|
+| CPU使用率100% | 死循环或低效算法 | 检查代码逻辑，优化算法 |
+| 内存持续增长 | 内存泄漏 | 检查未释放的对象和事件监听 |
+| 数据库查询慢 | 缺少索引 | 添加索引，优化SQL |
+| 页面加载慢 | 资源过大 | 压缩资源，使用懒加载 |

package/common/work/develop/performance_optimization/work.json

@@ -0,0 +1 @@
+{"name":"performance_optimization","description":"优化系统性能，包括代码优化、资源优化和架构优化，提升系统响应速度和吞吐量","type":"dynamic","group":"develop"}

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

@@ -0,0 +1,21 @@
+# 插件开发方法
+
+## 前置条件
+
+- [ ] 已明确插件需要实现的扩展点
+- [ ] 已了解宿主系统的插件接口规范
+
+## 流程概览
+
+分析需求 → 设计插件接口 → 编写插件代码 → 编写配置文件 → 测试验证
+
+## 详细步骤
+
+### 步骤1：分析插件需求
+分析需求文档，确定插件需要实现的扩展点和接口规范。
+
+### 步骤2：设计插件接口
+定义插件的标准接口：`init(config)`、`execute(context)`、`destroy()`。
+
+### 步骤3：编写插件代码
+编写插件核心逻辑代码。

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

@@ -0,0 +1,32 @@
+# 插件开发规范
+
+## 适用对象和范围
+
+本规范适用于所有开发可扩展Node.js插件的场景。
+
+---
+
+## 1. 接口规范
+
+**规则**：插件必须实现标准接口：`init(config)`、`execute(context)`、`destroy()`。
+
+- ✅ 正确：`module.exports = { init, execute, destroy };`
+- ❌ 错误：缺少任意一个标准接口
+
+**违反后果**：缺少标准接口导致宿主系统无法正确加载插件。
+
+---
+
+## 2. 隔离性规范
+
+**规则**：禁止插件修改宿主核心逻辑，插件只能通过标准接口与宿主交互。
+
+**违反后果**：修改宿主逻辑导致系统不稳定。
+
+---
+
+## 3. 兼容性规范
+
+**规则**：禁止在未测试兼容性的情况下发布插件。
+
+**违反后果**：未测试兼容性导致宿主系统崩溃。

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

@@ -0,0 +1,21 @@
+# 插件开发技巧
+
+## 1. 使用配置驱动插件行为
+
+**适用场景**：插件需要支持不同配置时。
+
+**具体做法**：在 `plugin.json` 中定义配置项，在 `init(config)` 中读取配置。
+
+## 2. 错误隔离
+
+**适用场景**：插件执行出错时不影响宿主系统。
+
+**具体做法**：在 `execute` 中使用try/catch捕获所有异常，返回统一错误格式。
+
+## 3. 常见问题速查
+
+| 问题 | 原因 | 解决方案 |
+|------|------|---------|
+| 插件加载失败 | 未导出标准接口 | 检查 `module.exports` |
+| 插件功能异常 | 依赖或配置错误 | 检查plugin.json配置 |
+| 接口不兼容 | 宿主接口变更 | 调整导出函数签名 |

package/common/work/develop/plugin_development/work.json

@@ -0,0 +1 @@
+{"name":"plugin_development","description":"开发可扩展的Node.js插件，包括插件设计、接口定义、封装和测试","type":"dynamic","group":"develop"}

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

@@ -0,0 +1,19 @@
+# Python后端开发方法
+
+## 前置条件
+
+- [ ] 已获取需求文档和API设计文档
+- [ ] 已确定技术栈（FastAPI/Django/Flask）
+- [ ] 已了解数据模型定义
+
+## 流程概览
+
+分析需求 → 初始化项目 → 编写数据模型 → 编写API接口 → 编写配置和启动文件
+
+## 详细步骤
+
+### 步骤1：分析需求
+分析需求文档和API设计文档，确定技术栈（FastAPI/Django/Flask）和数据模型。
+
+### 步骤2：初始化项目
+创建项目目录结构。

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

@@ -0,0 +1,119 @@
+# Python后端开发规范
+
+## 适用对象和范围
+
+本规范适用于所有使用Python进行Web后端开发的场景，包括FastAPI/Django/Flask框架搭建、API实现和业务逻辑编写。
+
+---
+
+## 1. 缩进规范
+
+**规则**：统一使用4个空格缩进，遵循PEP8规范。
+
+- ✅ 正确：每级缩进4个空格
+- ❌ 错误：使用Tab或2空格
+
+**违反后果**：Python依赖缩进定义代码块，缩进不一致会导致语法错误。
+
+---
+
+## 2. 行宽规范
+
+**规则**：每行代码不超过79个字符（PEP8标准）。
+
+- ✅ 正确：长表达式使用括号换行或反斜杠
+- ❌ 错误：一行超过79字符
+
+**违反后果**：超过行宽导致代码在终端和代码审查工具中显示不完整。
+
+---
+
+## 3. 命名规范
+
+**规则**：类名使用PascalCase，函数和变量名使用snake_case，常量名使用SCREAMING_SNAKE_CASE。
+
+| 标识符类型 | 命名法 | 示例 |
+|-----------|--------|------|
+| 类名 | PascalCase | `class UserService:` |
+| 函数名 | snake_case | `def get_user_data():` |
+| 变量名 | snake_case | `user_name = '张三'` |
+| 常量名 | SCREAMING_SNAKE_CASE | `MAX_RETRY_COUNT = 3` |
+
+- ✅ 正确：`class UserService:`、`def get_user_data():`
+- ❌ 错误：`class user_service:`、`def GetUserData():`
+
+**违反后果**：命名不符合PEP8规范导致代码审查不通过，社区风格不一致。
+
+---
+
+## 4. 注释规范
+
+**规则**：函数和类必须使用docstring格式注释。
+
+```python
+def get_user_data(user_id: int) -> dict:
+    """获取用户数据
+    
+    Args:
+        user_id: 用户ID
+        
+    Returns:
+        用户数据字典
+        
+    Raises:
+        ValueError: 用户不存在时
+    """
+    pass
+```
+
+- ✅ 正确：函数有docstring注释
+- ❌ 错误：函数无注释或只写 `# 获取用户数据`
+
+**违反后果**：缺少docstring导致IDE无法提供类型提示和文档生成。
+
+---
+
+## 5. 类型注解规范
+
+**规则**：函数参数和返回值必须使用类型注解。
+
+- ✅ 正确：`def get_user(user_id: int) -> dict:`
+- ❌ 错误：`def get_user(user_id):`
+
+**违反后果**：缺少类型注解导致代码可读性差，无法利用静态类型检查工具。
+
+---
+
+## 6. 异常处理规范
+
+**规则**：必须使用try/except捕获异常，禁止使用裸except。
+
+- ✅ 正确：
+```python
+try:
+    result = await db.execute(query)
+except ValueError as e:
+    logger.error(f"参数错误: {e}")
+    raise
+```
+
+- ❌ 错误：
+```python
+try:
+    result = await db.execute(query)
+except:  # 裸except
+    pass
+```
+
+**违反后果**：裸except会捕获所有异常（包括KeyboardInterrupt），可能导致程序无法正常退出。
+
+---
+
+## 7. 敏感信息安全规范
+
+**规则**：禁止将密码、密钥硬编码在代码中，必须使用环境变量或配置文件。
+
+- ✅ 正确：`DB_PASSWORD = os.getenv('DB_PASSWORD')`
+- ❌ 错误：`DB_PASSWORD = '123456'`
+
+**违反后果**：硬编码敏感信息存在严重安全风险。