mm_ai 1.0.0

package/common/skill/mm/mm_plugin_script/skill.md

@@ -0,0 +1,163 @@
+# mm_plugin_script
+
+> 💡 **提示**：编写mm Plugin脚本前，先用 `read_work` 工具读取 `script_mm_plugin` 提示词，能编写得更好。
+
+## 基本信息
+- **名称**: mm_plugin_script
+- **标题**: mm Plugin插件脚本编码规范
+- **描述**: MMos框架Plugin独立插件的index.js编码规范，含插件生命周期方法、完整代码模板
+- **依赖工具**: read_text, write_text
+
+## 一、编码规范（硬性要求）
+
+| 类型 | 规范 | 示例 |
+|:----|:-----|:-----|
+| 函数名 | 小驼峰 | `main`、`install`、`init`、`start`、`stop` |
+| 变量名 | 小写蛇形 | `option`、`msg`、`config`、`db` |
+| 文件名 | 小写蛇形 | `plugin.json`、`index.js` |
+| 缩进 | 2个空格 | |
+| 注释 | JSDoc风格 | `/** @param {Object} option 说明 */` |
+
+---
+
+## 二、独立插件编码结构规范
+
+### 2.0 统一导出规范
+
+**所有函数必须写在 `module.exports = { }` 的 `{}` 内部**，函数之间通过 `this.xxx()` 调用（无需单独定义函数或使用 `exports.xxx`）。
+
+```javascript
+module.exports = {
+    init(option) {
+        // 调用其他方法用 this.xxx()
+        return this.doInit(option);
+    },
+
+    doInit(option) {
+        return null;
+    }
+};
+```
+
+独立插件的 index.js 使用 `module.exports = { ... }` 导出对象，与 app 的 index.js 生命周期类似。
+
+**参考文件：** `./app/wechat/plugin/wechat_public/index.js`、`./app/tool/plugin/email_send/index.js`
+
+### 2.1 生命周期方法
+
+| 方法 | 说明 | 返回值 |
+|:----|:-----|:-------|
+| `init(option)` | 初始化 | 成功返回null，失败返回错误提示字符串 |
+| `install(option)` | 安装时调用 | 成功返回null |
+| `start(option)` | 启动时调用 | 成功返回null |
+| `stop(option)` | 停止时调用 | 成功返回null |
+| `uninstall(option)` | 卸载时调用 | 成功返回null |
+| `update(option)` | 更新时调用 | 成功返回null |
+| `restart(option)` | 重启时调用 | 成功返回null |
+| `end(option)` | 结束时调用 | 成功返回null |
+| `update_options_after(option)` | 配置更新后调用 | 成功返回null |
+
+---
+
+## 三、完整代码模板
+
+```javascript
+module.exports = {
+    /**
+     * 初始化
+     * @param {Object} option 配置参数
+     * @return {String} 成功返回null, 否则返回错误提示
+     */
+    init(option) {
+        var msg = null;
+        return msg;
+    },
+
+    /**
+     * 安装
+     * @param {Object} option 配置参数
+     * @return {String} 成功返回null,否则返回错误提示
+     */
+    install(option) {
+        var msg = null;
+        return msg;
+    },
+
+    /**
+     * 启动
+     * @param {Object} option 配置参数
+     * @return {String} 成功返回null,否则返回错误提示
+     */
+    start(option) {
+        var msg = null;
+        return msg;
+    },
+
+    /**
+     * 停止
+     * @param {Object} option 配置参数
+     * @return {String} 成功返回null,否则返回错误提示
+     */
+    stop(option) {
+        var msg = null;
+        return msg;
+    },
+
+    /**
+     * 卸载
+     * @param {Object} option 配置参数
+     * @return {String} 成功返回null,否则返回错误提示
+     */
+    uninstall(option) {
+        var msg = null;
+        return msg;
+    },
+
+    /**
+     * 更新
+     * @param {Object} option 配置参数
+     * @return {String} 成功返回null,否则返回错误提示
+     */
+    update(option) {
+        var msg = null;
+        return msg;
+    },
+
+    /**
+     * 重启
+     * @param {Object} option 配置参数
+     * @return {String} 成功返回null,否则返回错误提示
+     */
+    restart(option) {
+        var msg = null;
+        return msg;
+    },
+
+    /**
+     * 结束
+     * @param {Object} option 配置参数
+     * @return {String} 成功返回null,否则返回错误提示
+     */
+    end(option) {
+        var msg = null;
+        return msg;
+    },
+
+    /**
+     * 配置更新后
+     * @param {Object} option 配置参数
+     * @return {String} 成功返回null,否则返回错误提示
+     */
+    update_options_after(option) {
+        var msg = null;
+        return msg;
+    }
+};
+```
+
+---
+
+## 禁止行为（与index.js编写相关）
+
+- 禁止使用箭头函数定义生命周期方法，必须使用简写方法语法 `method() {}`
+- 禁止遗漏 `module.exports = { ... }` 导出

package/common/skill/mm/mm_plugin_structure_guide/skill.json

@@ -0,0 +1,14 @@
+{
+  // 技能名称
+  "name": "mm_plugin_structure_guide",
+  // 技能标题(显示用的中文名称)
+  "title": "mm Plugin插件目录结构指南",
+  // 技能描述，50个字符以内，包含用于什么场景和触发关键词
+  "description": "MMos框架Plugin插件的目录结构规范速查，含各类插件目录模板/文件命名规范。触发词：插件目录、目录结构、plugin结构",
+  // 技能版本
+  "version": "1.0.0",
+  // 技能提示词
+  "prompt_file": "./skill.md",
+  // 工具配置项
+  "tools": []
+}

package/common/skill/mm/mm_plugin_structure_guide/skill.md

@@ -0,0 +1,130 @@
+# mm_plugin_structure_guide
+
+> 创建mm Plugin插件目录前，先参考本指南规划目录结构。
+
+## 基本信息
+- **名称**: mm_plugin_structure_guide
+- **标题**: mm Plugin插件目录结构指南
+- **描述**: MMos框架Plugin插件的目录结构规范速查，含各类插件目录模板、文件命名规范
+- **依赖工具**: make_dir, read_text, search_dir
+
+## 一、插件类型与目录结构
+
+### 1.1 API插件（event_api）
+
+适用于提供HTTP API接口的插件。
+
+```
+./app/{app_name}/event_api/{api_group}/
+├── index.js          # API接口主脚本
+├── api.json          # API路由配置
+├── param.json        # 参数校验配置（可选）
+└── sql.json          # SQL查询配置（可选）
+```
+
+**示例：** `./app/cms/event_api/article/`、`./app/sys/event_api/user/`
+
+### 1.2 独立插件（plugin）
+
+适用于功能独立的插件模块。
+
+```
+./app/{app_name}/plugin/{plugin_name}/
+├── index.js          # 插件入口脚本
+├── plugin.json       # 插件配置
+├── event.json        # 事件配置（可选）
+├── param.json        # 参数校验配置（可选）
+└── sql.json          # SQL查询配置（可选）
+```
+
+**示例：** `./app/wechat/plugin/wechat_public/`、`./app/tool/plugin/email_send/`
+
+### 1.3 挂件插件（pendant）
+
+适用于UI挂件/小组件。
+
+```
+./app/{app_name}/pendant/{pendant_name}/
+├── pendant.html      # 挂件HTML模板
+├── index.js          # 挂件脚本（可选）
+├── pendant.json      # 挂件配置
+├── event.json        # 事件配置（可选）
+└── static/
+    ├── css/
+    │   └── style.css # 自定义样式
+    └── js/
+        └── app.js    # 前端脚本
+```
+
+**示例：** `./app/home/pendant/nav_menu/`
+
+### 1.4 独立应用插件（app）
+
+适用于完整功能的应用模块。
+
+```
+./app/{app_name}/
+├── index.js          # 应用入口脚本
+├── app.json          # 应用配置
+├── event.json        # 事件配置（可选）
+├── param.json        # 参数校验配置（可选）
+├── sql.json          # SQL查询配置（可选）
+├── plugin/           # 子插件目录
+│   └── {plugin_name}/
+├── event_api/        # API接口目录
+│   └── {api_group}/
+├── pendant/          # 挂件目录
+│   └── {pendant_name}/
+└── static/           # 静态资源
+    ├── css/
+    ├── js/
+    └── img/
+```
+
+**示例：** `./app/cms/`、`./app/home/`、`./app/sys/`
+
+---
+
+## 二、目录命名规范
+
+| 元素 | 规范 | 示例 |
+|:----|:-----|:-----|
+| app目录 | 小写英文 | `home`、`cms`、`sys`、`wechat` |
+| api_group目录 | 小写蛇形 | `article`、`user_info`、`file_upload` |
+| plugin目录 | 小写蛇形 | `wechat_public`、`email_send` |
+| pendant目录 | 小写蛇形 | `nav_menu`、`user_card` |
+| 静态资源目录 | 固定名称 | `static`、`css`、`js`、`img` |
+
+---
+
+## 三、配置文件清单
+
+| 文件名 | 用途 | 必需 |
+|:-------|:-----|:-----|
+| `api.json` | API路由配置 | API插件必需 |
+| `plugin.json` | 独立插件配置 | 独立插件必需 |
+| `pendant.json` | 挂件配置 | 挂件必需 |
+| `app.json` | 应用配置 | 应用必需 |
+| `event.json` | 事件配置 | 需要事件时必需 |
+| `param.json` | 参数校验 | 可选 |
+| `sql.json` | SQL查询配置 | 可选 |
+| `index.js` | 入口脚本 | 必需 |
+| `pendant.html` | 挂件模板 | 挂件必需 |
+
+---
+
+## 四、创建步骤
+
+1. **确定插件类型**：API插件 / 独立插件 / 挂件 / 应用
+2. **使用 `make_dir`** 创建目录结构
+3. **使用 `read_text`** 读取参考模板
+4. **按需创建** 配置文件和脚本
+
+---
+
+## 禁止行为
+
+- ❌ 禁止在 `plugin/` 目录下创建独立应用
+- ❌ 禁止在 `event_api/` 目录下创建挂件
+- ❌ 禁止使用中文命名目录或文件
+- ❌ 禁止在目录名中使用空格或特殊字符

package/common/skill/mm/mm_publish_guide/skill.json

@@ -0,0 +1,14 @@
+{
+  // 技能名称
+  "name": "mm_publish_guide",
+  // 技能标题(显示用的中文名称)
+  "title": "mm版本管理与发布指南",
+  // 技能描述，50个字符以内，包含用于什么场景和触发关键词
+  "description": "MMos框架版本管理与发布指南，含语义化版本/plugin.json版本管理/app.json版本管理/依赖管理/发布流程。触发词：版本管理、发布、version、semver、依赖管理",
+  // 技能版本
+  "version": "1.0.0",
+  // 技能提示词
+  "prompt_file": "./skill.md",
+  // 工具配置项
+  "tools": []
+}

package/common/skill/mm/mm_publish_guide/skill.md

@@ -0,0 +1,121 @@
+# mm_publish_guide
+
+> 💡 **提示**：发布mm版本前，先用 `read_work` 工具读取 `guide_mm_publish` 提示词，能发布得更好。
+
+## 基本信息
+- **名称**: mm_publish_guide
+- **标题**: mm版本管理与发布指南
+- **描述**: MMos框架版本管理与发布指南，包含语义化版本规范、插件/应用版本管理、发布流程
+- **依赖工具**: read_text, write_text
+
+## 编码规范（硬性要求）
+| 类型 | 规范 | 示例 |
+|:----|:-----|:-----|
+| 版本号 | 语义化版本 | `"1.0.0"`、`"2.3.1"` |
+| 依赖名 | 小写蛇形 | `"cms"`、`"user"`、`"sys"` |
+| 配置键 | 小写蛇形 | `version`、`dependencies`、`author` |
+
+---
+
+## 一、版本号规范
+
+采用语义化版本（SemVer）：`主版本.次版本.修订号`
+
+> 详细的语义化版本规范请用 `read_knowledge('version_semantics')` 查阅。
+
+---
+
+## 二、插件版本管理（plugin.json）
+
+```json
+{
+    "name": "plugin_name",
+    "title": "插件标题",
+    "version": "1.0.0",
+    "author": "作者名",
+    "dependencies": ["cms", "user"],
+    "description": "插件功能描述"
+}
+```
+
+### version 字段
+- 初始版本：`"1.0.0"`
+- Bug修复：增加修订号 `"1.0.1"`
+- 新增功能：增加次版本 `"1.1.0"`
+- 重大变更：增加主版本 `"2.0.0"`
+
+---
+
+## 三、应用版本管理（app.json）
+
+```json
+{
+    "name": "app_name",
+    "version": "1.0",
+    "title": "应用标题",
+    "dependencies": []
+}
+```
+
+### version 字段
+- 应用版本号格式为 `"主版本.次版本"`（如 `"1.0"`）
+- 重大更新时增加主版本号
+
+---
+
+## 四、依赖管理
+
+```json
+{
+    "dependencies": ["cms", "user", "sys"]
+}
+```
+
+- `dependencies` 数组列出当前插件/应用依赖的其他应用
+- 框架在加载时会按依赖顺序初始化
+- 依赖应用必须先安装和启用
+
+---
+
+## 五、发布流程
+
+1. **版本检查**：确认当前版本号是否正确
+2. **更新版本号**：在 `plugin.json` 或 `app.json` 中更新 `version`
+3. **更新依赖**：检查并更新 `dependencies` 列表
+4. **验证功能**：测试升级后的功能完整性
+5. **更新日志**：记录版本变更说明
+
+---
+
+## 六、版本升级（update生命周期）
+
+```javascript
+module.exports = {
+    /**
+     * 版本升级逻辑
+     * @param {Object} option 配置参数
+     */
+    update(option) {
+        var old_version = option.old_version || "0.0.0";
+        var new_version = option.new_version || "1.0.0";
+
+        if (old_version === "0.0.0") {
+            // 首次安装
+        }
+        if (old_version < "1.0.0" && new_version >= "1.0.0") {
+            // 升级到1.0.0时执行的数据迁移
+        }
+        if (old_version < "2.0.0" && new_version >= "2.0.0") {
+            // 升级到2.0.0时的数据迁移
+        }
+    }
+};
+```
+
+## 输出成果
+- 带版本管理的 `plugin.json` 或 `app.json`
+
+## 禁止行为
+- 禁止在生产环境中使用 `"0.x.x"` 开发版本号
+- 禁止在 `dependencies` 中声明循环依赖
+- 禁止在版本升级时跳过主版本号的变更（如有破坏性变更）

package/common/skill/mm/mm_security_guide/skill.json

@@ -0,0 +1,14 @@
+{
+  // 技能名称
+  "name": "mm_security_guide",
+  // 技能标题(显示用的中文名称)
+  "title": "mm安全与授权开发指南",
+  // 技能描述，50个字符以内，包含用于什么场景和触发关键词
+  "description": "MMos框架安全与授权开发指南，含OAuth授权/事件阶段/用户状态/API权限/缓存安全。触发词：安全、授权、oauth、权限、before事件、check事件",
+  // 技能版本
+  "version": "1.0.0",
+  // 技能提示词
+  "prompt_file": "./skill.md",
+  // 工具配置项
+  "tools": []
+}

package/common/skill/mm/mm_security_guide/skill.md

@@ -0,0 +1,191 @@
+# mm_security_guide
+
+> 💡 **提示**：配置mm安全前，先用 `read_work` 工具读取 `guide_mm_security` 提示词，能配置得更好。
+
+## 基本信息
+- **名称**: mm_security_guide
+- **标题**: mm安全与授权开发指南
+- **描述**: MMos框架安全与授权开发指南，包含OAuth授权体系、事件阶段(before/check/main/render/after)、用户状态获取、API scope权限、缓存安全策略、完整配置模板
+- **依赖工具**: read_text, write_text
+
+## 编码规范（硬性要求）
+| 类型 | 规范 | 示例 |
+|:----|:-----|:-----|
+| 函数名 | 小驼峰 | `getState`、`checkAuth`、`verifyToken` |
+| 变量名 | 小写蛇形 | `user_id`、`user_group`、`sign_in`、`access_token` |
+| 参数名 | 小写蛇形 | `ctx`、`db`、`client`、`username`、`password` |
+| 配置键 | 小写蛇形 | `signIn`、`user_group`、`user_admin` |
+
+---
+
+## 一、OAuth授权体系
+
+在 `api.json` 中通过 `oauth` 配置授权规则：
+
+```json
+{
+    "oauth": {
+        "signIn": false,       // 是否需要登录才能访问
+        "vip": 0,             // 会员权限级别，0不限制
+        "gm": 0,              // 管理员权限级别，0不限制
+        "mc": 0,              // 商户/第三方权限级别，0不限制
+        "user_group": [],     // 允许访问的用户组ID数组
+        "user_admin": []      // 允许访问的管理组ID数组
+    }
+}
+```
+
+### 各字段说明
+| 字段 | 类型 | 说明 | 示例 |
+|:----|:----|:-----|:-----|
+| `signIn` | boolean | 是否需要登录 | `true`=需登录，`false`=公开 |
+| `vip` | number | 会员等级门槛，0不限 | `1`=VIP1以上可访问 |
+| `gm` | number | 管理员等级门槛，0不限 | `1`=管理员以上可访问 |
+| `mc` | number | 商户等级门槛，0不限 | `1`=商户以上可访问 |
+| `user_group` | array | 允许的用户组ID | `[1, 5]`=仅ID为1和5的用户组 |
+| `user_admin` | array | 允许的管理组ID | `[1]`=仅超级管理员组 |
+
+---
+
+## 二、事件阶段（event.json）
+
+通过 `event.json` 的 `stage` 字段设置事件阶段：
+
+| 阶段 | 值 | 说明 | 典型用途 |
+|:----|:---|:-----|:---------|
+| 执行前 | `"before"` | 在main之前执行 | 权限检查、参数预处理 |
+| 验证 | `"check"` | 验证阶段 | token验证、权限校验 |
+| 主要 | `"main"` | 主要业务逻辑 | 核心业务处理 |
+| 渲染 | `"render"` | 渲染阶段 | 模板渲染 |
+| 执行后 | `"after"` | 在main之后执行 | 日志记录、后续处理 |
+
+### before/check事件配置
+在 `./app/{app_name}/event_api/api/` 下定义：
+```
+event_api/api/
+├── before_event.json   # before事件配置
+├── before.js           # before事件处理
+├── check_event.json    # check事件配置
+└── check.js            # check事件处理
+```
+
+---
+
+## 三、用户状态获取
+
+```javascript
+/**
+ * 获取当前用户状态
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器
+ * @return {Object} 用户信息
+ */
+var user = await this.getState(ctx, db) || {
+    user_id: 0,      // 用户ID，0=未登录
+    gm: 0,           // 管理员等级，0=普通用户
+    vip: 0,          // VIP等级，0=非VIP
+    avatar: "",      // 头像URL
+    nickname: "",    // 昵称
+    username: "",    // 用户名
+    phone: ""        // 手机号
+};
+```
+
+---
+
+## 四、API scope权限
+
+```json
+{
+    "scope": true
+    // true = 开放访问，所有请求均可访问，API文档公开
+    // false = 受限访问，仅特定协议头可访问，API文档隐藏
+    // 字符串值 = 指定允许访问的域名或标识
+}
+```
+
+- `scope: true` — 接口在API文档中可见，所有请求均可访问
+- `scope: false` — 接口在API文档中隐藏，仅特定协议头可访问
+- `scope: "特定值"` — 指定允许访问的域名或标识
+
+---
+
+## 五、缓存安全策略
+
+```json
+{
+    "cache": 0,            // 缓存时长(分钟)，0=不缓存
+    "client_cache": false  // 客户端缓存
+}
+```
+
+- `cache: 0` — 不缓存，每次请求都执行业务逻辑
+- `cache: 5` — 缓存5分钟，二次访问直接从缓存读取
+- `client_cache: true` — 浏览器缓存，不再访问服务器
+- `client_cache: false` — 服务端缓存，仍会访问服务器
+
+---
+
+## 六、完整配置模板
+
+### 公开API（无需登录）
+```json
+{
+    "path": "/home/",
+    "name": "home_index",
+    "oauth": {
+        "signIn": false,
+        "vip": 0,
+        "gm": 0,
+        "mc": 0,
+        "user_group": [],
+        "user_admin": []
+    },
+    "scope": true,
+    "cache": 0
+}
+```
+
+### 需登录API
+```json
+{
+    "path": "/user/profile",
+    "name": "user_profile",
+    "oauth": {
+        "signIn": true,
+        "vip": 1,
+        "gm": 0,
+        "mc": 0,
+        "user_group": [],
+        "user_admin": []
+    },
+    "scope": false,
+    "cache": 0
+}
+```
+
+### 管理员API
+```json
+{
+    "path": "/admin/setting",
+    "name": "admin_setting",
+    "oauth": {
+        "signIn": true,
+        "vip": 0,
+        "gm": 1,
+        "mc": 0,
+        "user_group": [],
+        "user_admin": [1]
+    },
+    "scope": false,
+    "cache": 0
+}
+```
+
+## 输出成果
+- `api.json` 中完整的oauth配置
+
+## 禁止行为
+- 禁止在公开API中遗漏 `oauth` 配置
+- 禁止在敏感接口中设置 `cache > 0`（缓存可能导致数据泄露）
+- 禁止在需要登录的接口中设置 `scope: true`

package/common/skill/mm/mm_sql_config/skill.json

@@ -0,0 +1,14 @@
+{
+  // 技能名称
+  "name": "mm_sql_config",
+  // 技能标题(显示用的中文名称)
+  "title": "mm SQL配置文件指南",
+  // 技能描述，50个字符以内，包含用于什么场景和触发关键词
+  "description": "MMos框架SQL配置文件(sql.json)完整指南，支持增删改查全部操作，声明式定义查询规则/条件映射/更新操作/字段格式化。触发词：sql.json、sql配置、SQL查询",
+  // 技能版本
+  "version": "1.0.0",
+  // 技能提示词
+  "prompt_file": "./skill.md",
+  // 工具配置项
+  "tools": []
+}