mm_ai 1.0.0

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

@@ -0,0 +1,195 @@
+# JS编码规范
+
+## 适用对象和范围
+
+本规范适用于所有使用原生JavaScript编写前端功能代码的场景，包括DOM操作、事件处理、数据请求和API联调。
+
+---
+
+## 1. 变量声明规范
+
+**规则**：必须使用 `const`（优先）或 `let` 声明变量，禁止使用 `var`。
+
+- ✅ 正确：`const API_URL = '/api/users';` / `let currentPage = 1;`
+- ❌ 错误：`var API_URL = '/api/users';`
+
+**违反后果**：`var` 存在函数级作用域提升问题，可能导致变量污染和难以排查的bug。
+
+---
+
+## 2. 命名规范
+
+**规则**：必须按照以下命名法命名标识符。
+
+| 标识符类型 | 命名法 | 示例 |
+|-----------|--------|------|
+| 常量 | UPPER_SNAKE_CASE | `const API_BASE_URL = '/api/v1';` |
+| 变量/函数参数 | camelCase | `let userName = '张三';` |
+| 函数 | camelCase（动词开头） | `function loadUserList() {}` |
+| 类/构造函数 | PascalCase | `class UserService {}` |
+| DOM引用变量 | camelCase + `$`前缀 | `const $submitBtn = ...;` |
+
+- ✅ 正确：`const MAX_COUNT = 100;` / `let userEmail = '';` / `function fetchData() {}`
+- ❌ 错误：`const max_count = 100;` / `let user_email = '';` / `function Fetch_Data() {}`
+
+**违反后果**：命名不一致导致代码可读性差，其他开发者难以理解和维护。
+
+---
+
+## 3. 缩进规范
+
+**规则**：统一使用 **2个空格** 缩进，禁止使用Tab。
+
+- ✅ 正确：
+```javascript
+function loadData() {
+  const url = '/api/data';
+  fetch(url)
+    .then(res => res.json())
+    .then(data => {
+      console.log(data);
+    });
+}
+```
+
+- ❌ 错误：
+```javascript
+function loadData() {
+    const url = '/api/data';
+    fetch(url)
+        .then(res => res.json())
+        .then(data => {
+            console.log(data);
+        });
+}
+```
+
+**违反后果**：缩进不一致导致代码结构混乱，增加代码审查难度。
+
+---
+
+## 4. 语句分隔符规范
+
+**规则**：每条语句末尾必须加分号 `;`。
+
+- ✅ 正确：`const name = '张三';` / `loadData();`
+- ❌ 错误：`const name = '张三'` / `loadData()`
+
+**违反后果**：JavaScript的自动分号插入（ASI）机制在某些情况下会错误推断分号位置，导致运行时错误。
+
+---
+
+## 5. 引号规范
+
+**规则**：字符串统一使用单引号 `'`，模板字符串使用反引号 `` ` ``。
+
+- ✅ 正确：`const name = '张三';` / `` const msg = `你好，${name}`; ``
+- ❌ 错误：`const name = "张三";`
+
+**违反后果**：引号使用不一致影响代码风格统一性，增加合并冲突概率。
+
+---
+
+## 6. 注释规范
+
+**规则**：函数和模块必须使用JSDoc格式注释。
+
+```javascript
+/**
+ * 加载用户列表
+ * @param {number} page - 页码，从1开始
+ * @param {number} [size=20] - 每页条数
+ * @returns {Promise<Array>} 用户列表数据
+ */
+async function loadUserList(page, size = 20) {
+  // ...
+}
+```
+
+- ✅ 正确：函数有JSDoc注释，包含 `@param` 和 `@returns`
+- ❌ 错误：函数无注释，或只写 `// 加载用户列表`
+
+**违反后果**：缺少JSDoc注释导致IDE无法提供类型提示，降低开发效率。
+
+---
+
+## 7. 事件绑定规范
+
+**规则**：必须使用 `addEventListener` 绑定事件，禁止使用 `onclick`/`onchange` 等HTML属性绑定。
+
+- ✅ 正确：`$submitBtn.addEventListener('click', handleSubmit);`
+- ❌ 错误：`<button onclick="handleSubmit()">提交</button>`
+
+**违反后果**：HTML属性绑定混合了结构和行为，不利于维护，且只能绑定一个事件处理函数。
+
+---
+
+## 8. DOM操作规范
+
+**规则**：优先使用 `querySelector`/`querySelectorAll`，避免使用 `getElementById` 等旧API。
+
+- ✅ 正确：`document.querySelector('#user-table')`
+- ❌ 错误：`document.getElementById('user-table')`
+
+**违反后果**：旧API选择能力有限（只能按ID/Class/TagName选择），无法使用CSS选择器的灵活性。
+
+---
+
+## 9. 数据请求规范
+
+**规则**：使用 `fetch` API进行数据请求，必须包含错误处理（`.catch()` 或 `try/catch`）。
+
+- ✅ 正确：
+```javascript
+async function fetchData() {
+  try {
+    const response = await fetch(url);
+    const data = await response.json();
+    return data;
+  } catch (error) {
+    console.error('请求失败:', error);
+    throw error;
+  }
+}
+```
+
+- ❌ 错误：
+```javascript
+function fetchData() {
+  return fetch(url).then(res => res.json());
+}
+```
+
+**违反后果**：缺少错误处理导致网络异常时程序静默失败，用户无法获知错误信息。
+
+---
+
+## 10. 调试规范
+
+**规则**：禁止在最终代码中保留 `console.log` 调试语句，错误日志应使用 `console.error`。
+
+- ✅ 正确：`console.error('请求失败:', error);`
+- ❌ 错误：`console.log('请求结果:', data);`
+
+**违反后果**：生产环境中的 `console.log` 会暴露内部数据，影响性能，且显得代码不专业。
+
+---
+
+## 11. 安全规范
+
+**规则**：禁止使用 `eval()` 或 `new Function()` 执行动态代码。
+
+- ❌ 错误：`eval('alert("hello")');` / `new Function('return ' + userInput)();`
+
+**违反后果**：`eval()` 会执行任意JavaScript代码，存在严重的安全风险（XSS攻击）。
+
+---
+
+## 12. 代码分离规范
+
+**规则**：数据定义（data.js）和功能实现（index.js）必须分离到独立文件。
+
+- ✅ 正确：`data.js` 存放常量和工具函数，`index.js` 存放功能逻辑
+- ❌ 错误：所有代码写在一个文件中
+
+**违反后果**：代码耦合度高，难以维护和测试。

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

@@ -0,0 +1,158 @@
+# JS编码技巧
+
+## 1. 合理使用模板字符串
+
+**适用场景**：需要拼接字符串和变量时。
+
+**具体做法**：使用反引号模板字符串替代 `+` 拼接。
+
+**对比说明**：
+
+| 维度 | 传统拼接 | 模板字符串 |
+|------|---------|-----------|
+| 可读性 | 多变量时难以阅读 | 清晰直观 |
+| 多行支持 | 需加 `\n` 和 `+` | 天然支持多行 |
+| 表达式 | 需先计算再拼接 | 可直接嵌入 `${表达式}` |
+
+**示例**：
+```javascript
+// ❌ 不推荐
+const html = '<div class="card">' +
+  '<h3>' + user.name + '</h3>' +
+  '<p>' + user.email + '</p>' +
+  '</div>';
+
+// ✅ 推荐
+const html = `
+  <div class="card">
+    <h3>${user.name}</h3>
+    <p>${user.email}</p>
+  </div>
+`;
+```
+
+**注意事项**：模板字符串中的 `${}` 内可以放任意JavaScript表达式，包括三元运算符和函数调用。
+
+---
+
+## 2. 使用事件委托处理动态元素
+
+**适用场景**：列表中的按钮点击、表格行操作等需要为动态生成的元素绑定事件的场景。
+
+**具体做法**：在父元素上绑定事件，通过 `event.target.closest()` 判断具体触发元素。
+
+**对比说明**：
+
+| 维度 | 直接绑定 | 事件委托 |
+|------|---------|---------|
+| 动态元素 | 新增元素需重新绑定 | 自动生效 |
+| 性能 | N个元素绑N个监听器 | 只需1个监听器 |
+| 内存 | 多元素时占用大 | 节省内存 |
+
+**示例**：
+```javascript
+// ❌ 不推荐：逐个绑定
+document.querySelectorAll('.btn-delete').forEach(btn => {
+  btn.addEventListener('click', handleDelete);
+});
+
+// ✅ 推荐：事件委托
+$table.addEventListener('click', (event) => {
+  const btn = event.target.closest('.btn-delete');
+  if (!btn) return;
+  handleDelete(parseInt(btn.dataset.id, 10));
+});
+```
+
+**注意事项**：`closest()` 方法会向上查找匹配的祖先元素，包括自身。如果点击的是按钮内部的图标或文字，也能正确找到按钮。
+
+---
+
+## 3. 使用 DocumentFragment 批量渲染
+
+**适用场景**：需要向DOM中插入大量（超过10个）元素时。
+
+**具体做法**：创建 `DocumentFragment`，在内存中构建DOM树，最后一次性追加到真实DOM。
+
+**对比说明**：
+
+| 维度 | 直接 innerHTML | DocumentFragment |
+|------|---------------|-----------------|
+| 性能 | 每次操作触发重排 | 只触发一次重排 |
+| 事件 | 需重新绑定 | 事件委托不受影响 |
+| 安全性 | 可能被XSS攻击 | 安全 |
+
+**示例**：
+```javascript
+// ✅ 推荐：批量渲染
+function renderUsers(users) {
+  const fragment = document.createDocumentFragment();
+  users.forEach(user => {
+    const tr = document.createElement('tr');
+    tr.innerHTML = `<td>${user.name}</td><td>${user.email}</td>`;
+    fragment.appendChild(tr);
+  });
+  $table.innerHTML = '';
+  $table.appendChild(fragment);
+}
+```
+
+**注意事项**：`DocumentFragment` 在内存中操作，不会引起回流（reflow），适合大量数据渲染。
+
+---
+
+## 4. async/await 优于 .then().catch()
+
+**适用场景**：处理异步操作，特别是多个异步操作有依赖关系时。
+
+**具体做法**：使用 `async/await` + `try/catch` 替代链式 `.then().catch()`。
+
+**对比说明**：
+
+| 维度 | .then().catch() | async/await |
+|------|----------------|-------------|
+| 可读性 | 嵌套时难以跟踪 | 像同步代码一样直观 |
+| 错误处理 | 需在每个链上catch | 统一try/catch |
+| 调试 | 断点难以定位 | 可以逐行调试 |
+
+**示例**：
+```javascript
+// ❌ 不推荐：回调地狱
+function loadData() {
+  fetch(url)
+    .then(res => res.json())
+    .then(data => {
+      return fetch(data.nextUrl);
+    })
+    .then(res => res.json())
+    .then(data => render(data))
+    .catch(err => console.error(err));
+}
+
+// ✅ 推荐：async/await
+async function loadData() {
+  try {
+    const res1 = await fetch(url);
+    const data1 = await res1.json();
+    const res2 = await fetch(data1.nextUrl);
+    const data2 = await res2.json();
+    render(data2);
+  } catch (error) {
+    console.error('加载数据失败:', error);
+  }
+}
+```
+
+**注意事项**：`await` 只能在 `async` 函数中使用。如果需要在顶层使用，可以用 IIFE（立即执行函数表达式）包裹。
+
+---
+
+## 5. 常见问题速查
+
+| 问题 | 原因 | 解决方案 |
+|------|------|---------|
+| `this` 指向错误 | 回调函数中丢失上下文 | 使用箭头函数或 `.bind(this)` |
+| 异步数据未加载完成就渲染 | 未等待Promise完成 | 使用 `await` 等待数据返回后再渲染 |
+| 事件重复绑定 | 多次调用初始化函数 | 在绑定前先 `removeEventListener` |
+| 内存泄漏 | 事件绑定后未解绑 | 在组件销毁时调用 `removeEventListener` |
+| 表单提交页面刷新 | 未阻止默认行为 | 在事件回调中调用 `event.preventDefault()` |

package/common/work/develop/js_development/work.json

@@ -0,0 +1 @@
+{"name":"js_development","description":"使用原生JavaScript编写前端功能代码，含DOM操作、事件处理、数据请求、API联调等","type":"dynamic","group":"develop"}

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

@@ -0,0 +1,30 @@
+# MCP协议联调方法
+
+## 前置条件
+
+- [ ] 已有MCP Server实现或协议设计文档
+- [ ] MCP Server已注册了工具、资源或提示
+
+---
+
+## 流程概览
+
+```
+阅读协议文档 → 检查Server实现 → 检查客户端调用 → 编写数据转换协议 → 逐项验证 → 修复问题
+```
+
+---
+
+## 详细步骤
+
+### 步骤1：阅读MCP协议文档
+
+分析协议文档或Server源码，提取工具定义和参数Schema。
+
+### 步骤2：检查MCP Server实现
+
+检查工具注册、资源注册和服务初始化是否正确。
+
+### 步骤3：检查客户端调用
+
+检查客户端MCP调用代码是否与Server定义一致。

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

@@ -0,0 +1,29 @@
+# MCP协议联调规范
+
+## 适用对象和范围
+
+本规范适用于所有MCP协议联调对接的场景。
+
+---
+
+## 1. 以协议文档为准
+
+**规则**：联调必须以MCP协议文档或Server源码中的工具定义为准。
+
+**违反后果**：脱离文档联调导致工具调用参数不匹配。
+
+---
+
+## 2. inputSchema校验规范
+
+**规则**：禁止在未确认inputSchema的情况下调用工具，必须严格遵循参数定义。
+
+**违反后果**：参数不匹配导致工具调用失败。
+
+---
+
+## 3. content结构规范
+
+**规则**：禁止忽略MCP返回的content结构，MCP统一使用content数组包裹返回数据。
+
+**违反后果**：忽略content结构导致数据解析错误。

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

@@ -0,0 +1,21 @@
+# MCP协议联调技巧
+
+## 1. 直接从Server源码提取工具定义
+
+**适用场景**：协议文档不存在时。
+
+**具体做法**：读取MCP Server源码中的工具注册代码，直接提取工具名称、描述和inputSchema。
+
+## 2. 使用统一的错误格式
+
+**适用场景**：MCP返回的错误格式与客户端期望不一致时。
+
+**具体做法**：编写 `normalizeMcpError` 函数统一错误格式。
+
+## 3. 常见问题速查
+
+| 问题 | 原因 | 解决方案 |
+|------|------|---------|
+| 工具调用无响应 | Server未正确处理call_tool | 检查Server的请求处理函数 |
+| 参数校验失败 | inputSchema定义不完整 | 补充required数组和字段类型 |
+| 返回数据为空 | content结构解析错误 | 检查content数组中的type字段 |

package/common/work/develop/mcp_integration/work.json

@@ -0,0 +1 @@
+{"name":"mcp_integration","title":"MCP协议联调","description":"MCP协议联调对接，包括阅读协议文档、验证工具/资源注册、入参出参数据转换","version":"1.0.0","prompt_files":["./prompt/rule.md","./prompt/method.md","./prompt/trick.md"]}

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

@@ -0,0 +1,21 @@
+# 小程序开发方法
+
+## 前置条件
+
+- [ ] 已获取需求文档
+- [ ] 已了解小程序平台规范
+
+## 流程概览
+
+分析需求 → 开发页面 → 实现功能 → 测试交付
+
+## 详细步骤
+
+### 步骤1：分析需求
+分析需求文档，确定小程序功能和页面结构。
+
+### 步骤2：开发页面
+对每个页面创建WXML/WXSS/JS/JSON四个文件。
+
+### 步骤3：实现功能
+编写全局逻辑和配置文件。

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

@@ -0,0 +1,27 @@
+# 小程序开发规范
+
+## 适用对象和范围
+
+本规范适用于所有使用微信小程序框架进行小程序应用开发的场景。
+
+---
+
+## 1. 文件结构规范
+
+**规则**：每个页面必须包含WXML、WXSS、JS、JSON四个文件。
+
+- ✅ 正确：`index.wxml` + `index.wxss` + `index.js` + `index.json`
+- ❌ 错误：缺少WXSS或JSON文件
+
+**违反后果**：缺少文件导致页面渲染异常或配置缺失。
+
+---
+
+## 2. API兼容性规范
+
+**规则**：禁止使用不兼容的API（小程序API与浏览器API不同）。
+
+- ✅ 正确：使用 `wx.request()`、`wx.setStorageSync()`
+- ❌ 错误：使用 `fetch()`、`localStorage`
+
+**违反后果**：使用浏览器API导致小程序运行时报错。

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

@@ -0,0 +1,17 @@
+# 小程序开发技巧
+
+## 1. 使用setData更新数据
+
+**适用场景**：需要更新页面数据时。
+
+**具体做法**：使用 `this.setData()` 更新数据，触发页面重新渲染。
+
+**注意事项**：`setData` 传输数据量有限制（单次不超过1MB），大数据量需分批处理。
+
+## 2. 常见问题速查
+
+| 问题 | 原因 | 解决方案 |
+|------|------|---------|
+| 页面渲染异常 | WXML结构错误 | 检查标签闭合 |
+| 接口调用失败 | 域名未配置 | 在小程序后台配置request合法域名 |
+| 样式不生效 | WXSS选择器错误 | 使用小程序支持的CSS选择器 |

package/common/work/develop/mini_program_development/work.json

@@ -0,0 +1 @@
+{"name":"mini_program_development","title":"小程序开发","description":"使用微信小程序框架进行小程序应用开发","version":"1.0.0","prompt_files":["./prompt/rule.md","./prompt/method.md","./prompt/trick.md"]}

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

@@ -0,0 +1,21 @@
+# 模块开发方法
+
+## 前置条件
+
+- [ ] 已明确需要封装的功能逻辑
+- [ ] 已确定模块接口
+
+## 流程概览
+
+分析需求 → 设计模块结构 → 编写模块代码 → 编写测试用例 → 编写使用文档
+
+## 详细步骤
+
+### 步骤1：分析模块需求
+分析需求文档，确定模块的功能接口和外部依赖。
+
+### 步骤2：设计模块结构
+设计模块的导出接口和内部实现结构。
+
+### 步骤3：编写模块代码
+编写入口文件和内部实现文件。

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

@@ -0,0 +1,35 @@
+# 模块开发规范
+
+## 适用对象和范围
+
+本规范适用于所有开发可复用Node.js代码模块的场景。
+
+---
+
+## 1. 命名规范
+
+**规则**：函数名使用小驼峰（camelCase），变量和参数使用小写蛇形（snake_case），文件名使用小写蛇形。
+
+- ✅ 正确：`function getUserData(user_id) {}`、`validate_input.js`
+- ❌ 错误：`function get_user_data(userId) {}`、`ValidateInput.js`
+
+**违反后果**：命名不一致导致模块接口混乱。
+
+---
+
+## 2. 导出规范
+
+**规则**：模块必须使用 `module.exports` 导出公共API。
+
+- ✅ 正确：`module.exports = { getUserData, validateInput };`
+- ❌ 错误：忘记导出或使用错误的导出方式
+
+**违反后果**：导出错误导致模块无法被正确引用。
+
+---
+
+## 3. 副作用规范
+
+**规则**：禁止模块存在外部副作用（如修改全局变量、写入文件系统）。
+
+**违反后果**：副作用导致模块行为不可预测，增加调试难度。

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

@@ -0,0 +1,21 @@
+# 模块开发技巧
+
+## 1. 单一职责原则
+
+**适用场景**：决定是否将功能拆分为独立模块时。
+
+**具体做法**：每个模块只做一件事，如果模块功能超过一个，考虑拆分。
+
+## 2. 使用JSDoc提供类型提示
+
+**适用场景**：模块需要被其他开发者使用时。
+
+**具体做法**：为所有导出函数添加JSDoc注释，提供参数和返回值类型信息。
+
+## 3. 常见问题速查
+
+| 问题 | 原因 | 解决方案 |
+|------|------|---------|
+| 模块导出后为undefined | 导出方式错误 | 检查 `module.exports` |
+| 循环依赖 | 模块互相引用 | 重构模块结构 |
+| 全局变量污染 | 未使用模块作用域 | 使用 `const/let` 代替 `var` |

package/common/work/develop/module_development/work.json

@@ -0,0 +1 @@
+{"name":"module_development","title":"模块开发","description":"开发可复用的Node.js代码模块，包括模块设计、封装、测试和文档编写","version":"1.0.0","prompt_files":["./prompt/rule.md","./prompt/method.md","./prompt/trick.md"]}

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

@@ -0,0 +1,29 @@
+# MQTT协议联调方法
+
+## 前置条件
+
+- [ ] 已有MQTT协议设计文档
+- [ ] 服务端已实现MQTT Broker连接
+- [ ] 设备端或前端已实现MQTT客户端连接
+
+---
+
+## 流程概览
+
+```
+阅读协议文档 → 检查Topic设计 → 检查消息格式 → 编写数据转换协议 → 逐Topic验证 → 修复问题
+```
+
+---
+
+## 详细步骤
+
+### 步骤1：阅读MQTT协议文档
+
+分析协议文档，提取Broker地址、Topic定义、消息格式和QoS等级。
+
+### 步骤2：检查Topic设计与订阅
+
+检查发布方和订阅方的Topic是否匹配，通配符使用是否正确。
+
+### 步骤3：检查消息格式

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

@@ -0,0 +1,31 @@
+# MQTT协议联调规范
+
+## 适用对象和范围
+
+本规范适用于所有MQTT协议联调对接的场景。
+
+---
+
+## 1. Topic匹配规范
+
+**规则**：发布方和订阅方的Topic必须完全匹配，通配符使用需准确。
+
+- `+` 匹配单层，`#` 匹配多层，不可混用
+
+**违反后果**：Topic不匹配导致消息无法送达。
+
+---
+
+## 2. QoS等级规范
+
+**规则**：禁止忽略QoS等级差异，发布与订阅的QoS等级必须一致。
+
+**违反后果**：QoS不匹配影响消息送达可靠性。
+
+---
+
+## 3. 数据转换规范
+
+**规则**：禁止直接修改设备端固件代码来适配服务端格式，必须通过转换层处理。
+
+**违反后果**：修改固件代码导致设备端维护困难。

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

@@ -0,0 +1,28 @@
+# MQTT协议联调技巧
+
+## 1. 使用统一的Topic命名规范
+
+**适用场景**：设计MQTT Topic结构时。
+
+**具体做法**：使用层级结构 `/domain/device_id/action` 组织Topic。
+
+**示例**：
+```
+/devices/{device_id}/upload
+/devices/{device_id}/command
+/system/notification/{type}
+```
+
+## 2. 编写Payload转换函数
+
+**适用场景**：设备端与服务端数据格式不一致时。
+
+**具体做法**：编写 `transformDeviceToServer` 和 `transformServerToDevice` 转换函数。
+
+## 3. 常见问题速查
+
+| 问题 | 原因 | 解决方案 |
+|------|------|---------|
+| 消息收不到 | Topic不匹配 | 检查发布和订阅的Topic字符串 |
+| 消息格式错误 | Payload结构不一致 | 编写转换函数统一格式 |
+| 连接失败 | Broker地址错误 | 检查Broker地址和端口 |