mm_ai 1.0.0

package/common/skill/mm/mm_event_config/skill.json

@@ -0,0 +1,14 @@
+{
+  // 技能名称
+  "name": "mm_event_config",
+  // 技能标题(显示用的中文名称)
+  "title": "mm API Event事件配置规范",
+  // 技能描述，50个字符以内，包含用于什么场景和触发关键词
+  "description": "MMos框架API Event的event.json配置规范速查，含字段说明/target路径/JSON模板。触发词：event.json、事件配置、配置规范",
+  // 技能版本
+  "version": "1.0.0",
+  // 技能提示词
+  "prompt_file": "./skill.md",
+  // 工具配置项
+  "tools": []
+}

package/common/skill/mm/mm_event_config/skill.md

@@ -0,0 +1,132 @@
+# mm_event_config
+
+> 💡 **提示**：配置mm Event前，先用 `read_work` 工具读取 `config_mm_event` 提示词，能配置得更好。
+
+## 基本信息
+- **名称**: mm_event_config
+- **标题**: mm API Event事件配置规范
+- **描述**: MMos框架API Event的event.json配置规范速查，含字段说明、target路径规范、各类型JSON模板
+- **依赖工具**: read_text, write_text
+
+---
+
+## 一、event.json 字段说明
+
+文件路径：`./app/{app_name}/event_api/{event_name}/event.json`
+
+| 字段 | 类型 | 必填 | 说明 | web | client | manage |
+|:----|:----|:----|:-----|:---|:-------|:-------|
+| `target` | string | ✅ | 目标路径匹配，使用 `*` 通配符 | `"/{app_name}*"` | `"/api/{app_name}/*"` | `"/apis/{app_name}/*"` |
+| `name` | string | ✅ | 事件名 `{app_name}_{event_name}` | `"user_web"` | `"user_client"` | `"user_manage"` |
+| `title` | string | ✅ | 事件标题 | `"网站-用户管理"` | `"用户客户端调用的接口事件"` | `"用户管理端调用的接口事件"` |
+| `description` | string | ✅ | 事件功能描述 | ✅ | ✅ | ✅ |
+| `stage` | string | ✅ | 阶段：`before`/`check`/`main`/`render`/`after` | `"main"` | `"main"` | `"main"` |
+| `method` | string | **仅web** | `ALL`/`GET`/`POST` | `"ALL"` ✅ | 不填 ❌ | 不填 ❌ |
+| `main` | string | ✅ | 脚本文件路径 | `"./main.js"` | `"./main.js"` | `"./main.js"` |
+| `end` | bool | ✅ | 有结果则结束后面的执行 | `true` | `true` | `true` |
+| `sort` | number | ✅ | 执行顺序，越小越优先 | `100` | `99` | `99` |
+| `state` | number | 可选 | 启用状态控制，`1`=启用 | 不填 | 可选 `1` | 可选 `1` |
+
+**关键差异速记：**
+- **web**：有 `method`、字段带注释
+- **client/manage**：无 `method`、字段不带注释
+- **所有**：必须有 `"end": true`
+
+---
+
+## 二、target 路径规范
+
+| 事件类型 | 格式 | 示例（app=user） |
+|:---------|:-----|:-----------------|
+| **web** | `"/{app_name}*"`（`*`直接跟在路径后，无斜杠） | `"/user*"` |
+| **client** | `"/api/{app_name}/*"` | `"/api/user/*"` |
+| **manage** | `"/apis/{app_name}/*"` | `"/apis/user/*"` |
+
+**路径格式规则：**
+- 以 `/` 开头
+- 使用 `*` 作为通配符匹配任意路径
+- web事件：`"/{app_name}*"`（无斜杠的`*`直接跟在路径后）
+- client/manage事件：`"/api/{app_name}/*"` 或 `"/apis/{app_name}/*"`（带斜杠的`/*`）
+- 示例：`"/cms*"` 匹配 /cms 下的所有路径
+- 示例：`"/api/cms/*"` 匹配 /api/cms/ 下的所有路径
+
+---
+
+## 三、event.json 各类型模板
+
+### web事件模板（带注释）
+```json
+{
+    // 目标对象
+    "target": "/{app_name}*",
+    // 事件名称, 用于动态增删改
+    "name": "{app_name}_web",
+    // 标题, 用于开发者查看事件
+    "title": "网站-{标题}",
+    // 描述, 用于介绍该事件是做什么用的
+    "description": "用于{功能描述}",
+    // 阶段, 分执行前before、验证check、主要main、渲染render、执行后after阶段
+    "stage": "main",
+    // 响应方法 GET请求、POST请求、ALL所有请求，如果非API事件可自定义
+    "method": "ALL",
+    // 函数文件, 当事件触发时执行指定的脚本
+    "main": "./main.js",
+    // 如果有结果则结束后面的执行
+    "end": true,
+    // 执行顺序, 数值越小越优先执行
+    "sort": 100
+}
+```
+
+### client事件模板（无method、无注释）
+```json
+{
+    "target": "/api/{app_name}/*",
+    "name": "{app_name}_client",
+    "title": "{App名}客户端调用的接口事件",
+    "description": "用于{功能描述}",
+    "stage": "main",
+    "main": "./main.js",
+    "sort": 99,
+    "end": true
+}
+```
+
+### manage事件模板（无method、无注释）
+```json
+{
+    "target": "/apis/{app_name}/*",
+    "name": "{app_name}_manage",
+    "title": "{App名}管理端调用的接口事件",
+    "description": "用于{功能描述}",
+    "stage": "main",
+    "main": "./main.js",
+    "sort": 99,
+    "end": true
+}
+```
+
+### 带state字段的模板（如需启用状态控制）
+```json
+{
+    "target": "/api/{app_name}/*",
+    "name": "{app_name}_client",
+    "title": "{App名}客户端调用的接口事件",
+    "description": "用于{功能描述}",
+    "stage": "main",
+    "main": "./main.js",
+    "state": 1,
+    "sort": 99,
+    "end": true
+}
+```
+
+---
+
+## 禁止行为（与event.json配置相关）
+
+- 禁止在 client/manage 事件中添加 `method` 字段（参考文件中这些事件没有method）
+- 禁止遗漏 `end` 字段（所有事件类型都必须有 `"end": true`）
+- 禁止在 web 事件中使用 `"/{app_name}/*"` 格式的 target（参考文件实际格式为 `"/{app_name}*"`，不带斜杠）
+- 禁止在JSON配置文件中使用除注释外的非法字符
+- 禁止使用无意义的事件名，必须使用 `{app_name}_{event_name}` 格式

package/common/skill/mm/mm_event_script/skill.json

@@ -0,0 +1,14 @@
+{
+  // 技能名称
+  "name": "mm_event_script",
+  // 技能标题(显示用的中文名称)
+  "title": "mm API Event事件脚本编码规范",
+  // 技能描述，50个字符以内，包含用于什么场景和触发关键词
+  "description": "MMos框架API Event的main.js编码规范速查，含完整模板/模式对比/框架API。触发词：main.js、事件脚本、编码规范",
+  // 技能版本
+  "version": "1.0.0",
+  // 技能提示词
+  "prompt_file": "./skill.md",
+  // 工具配置项
+  "tools": []
+}

package/common/skill/mm/mm_event_script/skill.md

@@ -0,0 +1,247 @@
+# mm_event_script
+
+> 💡 **提示**：编写mm Event脚本前，先用 `read_work` 工具读取 `script_mm_event` 提示词，能编写得更好。
+
+## 基本信息
+- **名称**: mm_event_script
+- **标题**: mm API Event事件脚本编码规范
+- **描述**: MMos框架API Event的main.js编码规范速查，含编码规范、三种事件完整代码模板、模式对比、框架API说明
+- **依赖工具**: read_text, write_text
+
+## 一、编码规范（硬性要求）
+
+| 类型 | 规范 | 示例 |
+|:----|:-----|:-----|
+| 函数名 | 小驼峰 | `main`、`getData`、`formatResult` |
+| 变量名 | 小写蛇形 | `path`、`html`、`id_str`、`view_bag`、`api` |
+| 参数名 | 小写蛇形 | `ctx`、`db`、`option` |
+| 类名 | 大驼峰 | `TplEngine`、`ApiManager` |
+| 常量 | 全大写蛇形 | `DEFAULT_SORT`、`MAX_PAGE_SIZE` |
+| 文件名 | 小写蛇形 | `event.json`、`main.js` |
+| 目录名 | 小写蛇形 | `event_api`、`web`、`client`、`manage` |
+| 缩进 | 2个空格 | |
+| 注释 | JSDoc风格 | `/** @param {Object} ctx 说明 */` |
+
+---
+
+## 二、main.js 编码结构规范
+
+### 2.0 统一导出规范
+
+**所有函数必须写在 `module.exports = { }` 的 `{}` 内部**，函数之间通过 `this.xxx()` 调用（无需 `exports.main = main` 或单独定义函数）。
+
+```javascript
+module.exports = {
+    /**
+     * @description 接口主函数
+     * @param {Object} ctx HTTP上下文
+     * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+     * @return {Object} 执行结果
+     */
+    async main(ctx, db) {
+        // 调用辅助方法用 this.xxx()
+        return await this.doProcess(ctx, db);
+    },
+
+    /**
+     * 辅助方法
+     */
+    async doProcess(ctx, db) {
+        // 业务逻辑
+    }
+};
+```
+
+### 2.1 web事件 main.js 模板
+
+```javascript
+// 使用api管理器
+var api = $.admin.api('{app_name}_web', '网站-{标题}');
+// 首次启动更新api接口;
+api.call('update');
+
+module.exports = {
+    /**
+     * @description 接口主函数
+     * @param {Object} ctx HTTP上下文
+     * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+     * @return {Object} 执行结果
+     */
+    async main(ctx, db) {
+        if (ctx.path === '/{app_name}') {
+            ctx.response.redirect('/{app_name}/');
+            return
+        }
+        if (ctx.path.indexOf("/{app_name}/img") === 0) {
+            return null;
+        }
+
+        var sql = $.sqlAdmin('sys');
+
+        // 使用模板引擎
+        db.tpl = new $.Tpl();
+        var bag = db.tpl.viewBag;
+        bag.path = ctx.path;
+        bag.query = ctx.query;
+        bag.app = "{app_name}";
+        await db.tpl.runFunc('common', ctx.request);
+        await db.tpl.runFunc('{app_name}', ctx.request);
+
+        // 在这定义要访问的数据库 (分布式开发时设置不同的数据库名)
+        $.push(db, sql.db(), true);
+        db.tpl.current_theme = bag.current_theme;
+        var html = await api.run(ctx, db);
+        if (html) {
+            html = await $.func.html_filter(ctx, db, html);
+            return await $.func.vue_filter(html);
+        }
+    }
+};
+```
+
+**关键要点：**
+- 模块级：`var api = $.admin.api(...)` 和 `api.call('update')`（**无**第二个参数）
+- main函数写在 `module.exports = {}` 内部，**不再使用** `exports.main = main` 写法
+- 函数内先处理两个特殊路径：
+  - `ctx.path === '/{app_name}'` → 重定向到 `/{app_name}/`
+  - `ctx.path.indexOf("/{app_name}/img") === 0` → 返回 null（跳过图片请求）
+- `var sql = $.sqlAdmin('sys')` 定义在**函数内部**
+- 使用 `db.tpl = new $.Tpl()` 初始化模板引擎
+- 调用 `db.tpl.runFunc('common', ...)` 和 `db.tpl.runFunc('{app_name}', ...)`
+- 返回 HTML 时经过 `$.func.html_filter` 和 `$.func.vue_filter` 过滤
+
+### 2.2 client事件 main.js 模板
+
+```javascript
+var api = $.admin.api('{app_name}_client', '{标题}');
+// 首次启动更新api接口;
+api.call('update', 'app/{app_name}/');
+
+var sql = $.sqlAdmin('sys');
+
+module.exports = {
+    /**
+     * @description 接口主函数
+     * @param {Object} ctx HTTP上下文
+     * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+     * @return {Object} 执行结果
+     */
+    async main(ctx, db) {
+        // 在这定义要访问的数据库 (分布式开发时设置不同的数据库名)
+        $.push(db, sql.db(), true);
+        return api.run(ctx, db);
+    }
+};
+```
+
+**关键要点：**
+- 模块级：`var api = $.admin.api(...)`、`api.call('update', 'app/{app_name}/')`（**有**第二个参数）、`var sql = $.sqlAdmin('sys')`
+- main函数写在 `module.exports = {}` 内部，**不再使用** `exports.main = main` 写法
+- `sql` 变量定义在**模块级**（函数外部）
+- 函数内仅两行：设置数据库 + 调用API
+- 无模板引擎、无路径判断、无HTML过滤
+
+### 2.3 manage事件 main.js 模板
+
+```javascript
+var api = $.admin.api('{app_name}_manage', '{标题}');
+// 首次启动更新api接口;
+api.call('update', 'app/{app_name}/');
+
+var sql = $.sqlAdmin('sys');
+
+module.exports = {
+    /**
+     * @description 接口主函数
+     * @param {Object} ctx HTTP上下文
+     * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+     * @return {Object} 执行结果
+     */
+    async main(ctx, db) {
+        // 在这定义要访问的数据库 (分布式开发时设置不同的数据库名)
+        $.push(db, sql.db(), true);
+        return api.run(ctx, db);
+    }
+};
+```
+
+**关键要点：**
+- 与client事件结构完全一致
+- 模块级定义 `api`、`api.call('update', 'app/{app_name}/')`、`var sql = $.sqlAdmin('sys')`
+- main函数写在 `module.exports = {}` 内部，**不再使用** `exports.main = main` 写法
+- 函数内仅两行
+
+---
+
+## 三、main.js 模式对比
+
+| 差异点 | web事件 | client事件 | manage事件 |
+|:-------|:--------|:-----------|:-----------|
+| `api.call('update')` 参数 | **无参数** | **有参数** `'app/{app_name}/'` | **有参数** `'app/{app_name}/'` |
+| `var sql = $.sqlAdmin('sys')` 位置 | **函数内部** | **模块级**（函数外部） | **模块级**（函数外部） |
+| 路径判断 | 有（重定向+img过滤） | 无 | 无 |
+| 模板引擎 `db.tpl` | 有 | 无 | 无 |
+| HTML过滤 | 有（html_filter+vue_filter） | 无 | 无 |
+| 函数体行数 | ~20行 | ~2行 | ~2行 |
+
+### 代码骨架速查
+
+**web事件骨架：**
+```
+模块级：var api = $.admin.api('{app_name}_web', '网站-{标题}');
+        api.call('update');     ← 无参数
+
+函数内：ctx.path === '/{app_name}' → redirect
+        ctx.path.indexOf("/{app_name}/img") === 0 → return null
+        var sql = $.sqlAdmin('sys');         ← 函数内
+        db.tpl = new $.Tpl();                ← 模板引擎
+        db.tpl.runFunc('common', ...)
+        db.tpl.runFunc('{app_name}', ...)
+        $.push(db, sql.db(), true)
+        api.run → html_filter → vue_filter
+```
+
+**client/manage事件骨架：**
+```
+模块级：var api = $.admin.api('{app_name}_{type}', '{标题}');
+        api.call('update', 'app/{app_name}/');  ← 有参数
+        var sql = $.sqlAdmin('sys');            ← 模块级
+
+函数内：$.push(db, sql.db(), true)
+        return api.run(ctx, db)
+```
+
+---
+
+## 四、框架API说明
+
+| API | 说明 |
+|:----|:-----|
+| `$.admin.api(name, title)` | 创建/获取API管理器 |
+| `$.admin.sql(name)` | 获取SQL管理器 |
+| `$.push(db, database, true)` | 设置要访问的数据库（分布式开发时设置不同的数据库名） |
+| `$.pool.api[name]` | 获取已注册的API管理器 |
+| `$.config.get(key)` | 获取配置项 |
+| `$.eventer.run(name, ctx, model)` | 触发事件 |
+| `$.func.html_filter(ctx, db, html)` | HTML过滤器 |
+| `$.func.vue_filter(html)` | Vue过滤器 |
+| `$.is_ready` | 系统是否就绪 |
+| `db.tpl` | 模板引擎实例 |
+| `db.tpl.view(path, model)` | 渲染视图模板 |
+| `db.tpl.viewBag` | 视图数据包 |
+| `db.tpl.runFunc(name, request)` | 运行函数 |
+| `ctx.path` | 当前请求路径 |
+| `ctx.query` | 请求查询参数 |
+| `ctx.request` | 请求对象 |
+| `ctx.response.redirect(url)` | 重定向 |
+
+---
+
+## 禁止行为（与main.js编写相关）
+
+- 禁止在 main.js 中使用 `async function main(ctx, db){}` + `exports.main = main` 的写法，必须使用 `module.exports = { async main(ctx, db){} }` 格式
+- 禁止遗漏 `module.exports = { ... }` 导出
+- 禁止遗漏 `api.call('update')` — web用无参 `api.call('update')`，client/manage用带参 `api.call('update', 'app/{app_name}/')`
+- 禁止在web事件中遗漏 `db.tpl` 初始化和 `db.tpl.runFunc` 调用
+- 禁止在 client/manage 事件中将 `var sql = $.sqlAdmin('sys')` 定义在函数内部（应定义在模块级）
+- 禁止在web事件中遗漏根路径重定向和img路径过滤逻辑

package/common/skill/mm/mm_file_upload/skill.json

@@ -0,0 +1,14 @@
+{
+  // 技能名称
+  "name": "mm_file_upload",
+  // 技能标题(显示用的中文名称)
+  "title": "mm文件上传处理指南",
+  // 技能描述，50个字符以内，包含用于什么场景和触发关键词
+  "description": "MMos框架文件上传处理指南，含文件接收/存储/类型校验/大小限制/图片处理/访问路径。触发词：文件上传、上传、图片上传、file upload",
+  // 技能版本
+  "version": "1.0.0",
+  // 技能提示词
+  "prompt_file": "./skill.md",
+  // 工具配置项
+  "tools": []
+}

package/common/skill/mm/mm_file_upload/skill.md

@@ -0,0 +1,142 @@
+# mm_file_upload
+
+> 💡 **提示**：处理mm文件上传前，先用 `read_work` 工具读取 `guide_mm_upload` 提示词，能处理得更好。
+
+## 基本信息
+- **名称**: mm_file_upload
+- **标题**: mm文件上传处理指南
+- **描述**: MMos框架文件上传处理指南，包含文件上传配置、接收上传文件、文件存储规范
+- **依赖工具**: read_text, write_text, make_dir
+
+## 编码规范（硬性要求）
+| 类型 | 规范 | 示例 |
+|:----|:-----|:-----|
+| 函数名 | 小驼峰 | `uploadFile`、`checkFileType`、`generateFileName` |
+| 变量名 | 小写蛇形 | `file_path`、`file_name`、`file_size`、`upload_dir` |
+| 参数名 | 小写蛇形 | `ctx`、`db`、`file`、`body` |
+| 常量 | 全大写蛇形 | `MAX_FILE_SIZE`、`ALLOWED_TYPES` |
+
+---
+
+## 一、接收上传文件
+
+```javascript
+async function main(ctx, db) {
+    var files = ctx.request.files;  // 获取上传的文件对象
+    var body = ctx.request.body;    // 获取其他表单字段
+
+    if (!files || !files.file) {
+        return { error: { code: 20000, message: "请选择要上传的文件" } };
+    }
+
+    var file = files.file;
+    // file.path — 临时文件路径
+    // file.name — 原始文件名
+    // file.size — 文件大小(字节)
+    // file.type — MIME类型
+}
+```
+
+---
+
+## 二、文件存储规范
+
+### 2.1 存储路径
+```javascript
+var now = new Date();
+var date_path = now.toStr('yyyy-MM-dd');
+var upload_dir = './static/file/' + date_path + '/';
+```
+
+### 2.2 文件名生成
+```javascript
+var ext = file.name.split('.').pop();  // 获取扩展名
+var timestamp = Date.now();
+var random_str = Math.random().toString(36).substring(2, 8);
+var new_file_name = timestamp + '_' + random_str + '.' + ext;
+```
+
+### 2.3 目录自动创建
+```javascript
+var fs = require('fs');
+var path = require('path');
+
+var upload_dir = './static/file/' + date_path + '/';
+if (!fs.existsSync(upload_dir)) {
+    fs.mkdirSync(upload_dir, { recursive: true });
+}
+```
+
+---
+
+## 三、文件安全规范
+
+> 文件类型白名单、大小限制等安全规范请用 `read_knowledge('file_upload_standards')` 查阅。
+
+---
+
+## 四、完整代码模板
+
+```javascript
+const fs = require('fs');
+const path = require('path');
+
+var MAX_FILE_SIZE = 10 * 1024 * 1024;  // 10MB
+var ALLOWED_TYPES = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'pdf'];
+
+async function main(ctx, db) {
+    try {
+        var files = ctx.request.files;
+        var body = ctx.request.body;
+
+        if (!files || !files.file) {
+            return { error: { code: 20000, message: "请选择要上传的文件" } };
+        }
+
+        var file = files.file;
+        var ext = file.name.split('.').pop().toLowerCase();
+
+        // 类型校验
+        if (ALLOWED_TYPES.indexOf(ext) === -1) {
+            return { error: { code: 20000, message: "不支持的文件类型" } };
+        }
+
+        // 大小校验
+        if (file.size > MAX_FILE_SIZE) {
+            return { error: { code: 20000, message: "文件大小不能超过10MB" } };
+        }
+
+        // 生成存储路径
+        var now = new Date();
+        var date_path = now.toStr('yyyy-MM-dd');
+        var upload_dir = './static/file/' + date_path + '/';
+        var new_file_name = Date.now() + '_' + Math.random().toString(36).substring(2, 8) + '.' + ext;
+
+        if (!fs.existsSync(upload_dir)) {
+            fs.mkdirSync(upload_dir, { recursive: true });
+        }
+
+        // 移动文件
+        var target_path = path.join(upload_dir, new_file_name);
+        fs.renameSync(file.path, target_path);
+
+        var file_url = '/file/' + date_path + '/' + new_file_name;
+
+        return { result: { url: file_url, name: new_file_name, size: file.size } };
+    } catch (err) {
+        $.log.error("文件上传失败", err);
+        return { error: { code: 10000, message: "文件上传失败" } };
+    }
+}
+
+exports.main = main;
+```
+
+## 输出成果
+- 文件上传API接口代码
+- 上传的文件存储在 `./static/file/{date}/` 目录
+
+## 禁止行为
+- 禁止接受可执行文件（`.exe`/`.sh`/`.bat`/`.jar`）的上传
+- 禁止使用用户提供的原始文件名直接存储（防止路径穿越攻击）
+- 禁止超过限制大小的文件上传

package/common/skill/mm/mm_mqtt_guide/skill.json

@@ -0,0 +1,14 @@
+{
+  // 技能名称
+  "name": "mm_mqtt_guide",
+  // 技能标题(显示用的中文名称)
+  "title": "mm MQTT物联网协议开发指南",
+  // 技能描述，50个字符以内，包含用于什么场景和触发关键词
+  "description": "MMos框架MQTT物联网协议开发指南，含MQTT配置/设备通信/事件认证/mqtt.json配置。触发词：MQTT、物联网、设备通信、mqtt开发",
+  // 技能版本
+  "version": "1.0.0",
+  // 技能提示词
+  "prompt_file": "./skill.md",
+  // 工具配置项
+  "tools": []
+}