mm_ai 1.0.0

package/common/knowledge/design/responsive_breakpoints/knowledge.md

@@ -0,0 +1,69 @@
+# 响应式断点规范
+
+## 标准断点（参考 Bootstrap / Ant Design）
+
+| 断点名称 | 缩写 | 范围 | 目标设备 |
+|:---------|:----|:-----|:---------|
+| **XS** | `<576px` | 0–575px | 小屏手机 |
+| **SM** | `≥576px` | 576–767px | 大屏手机 |
+| **MD** | `≥768px` | 768–991px | 平板竖屏 |
+| **LG** | `≥992px` | 992–1199px | 平板横屏/小桌面 |
+| **XL** | `≥1200px` | 1200–1599px | 标准桌面 |
+| **XXL** | `≥1600px` | 1600+px | 大屏桌面 |
+
+## CSS Media Query 模板
+
+```scss
+// XS: <576px（默认样式，不需要 media query）
+// SM: ≥576px
+@media (min-width: 576px) { }
+// MD: ≥768px
+@media (min-width: 768px) { }
+// LG: ≥992px
+@media (min-width: 992px) { }
+// XL: ≥1200px
+@media (min-width: 1200px) { }
+// XXL: ≥1600px
+@media (min-width: 1600px) { }
+```
+
+## 断点设计策略
+
+### 移动优先（Mobile First）
+1. 先设计 XS 尺寸（最小屏幕），确保核心功能完整
+2. 逐级增加布局复杂度，充分利用大屏空间
+3. 每个断点只改布局，不改内容
+
+### 内容优先（Content First）
+- **XS–SM**：单列布局，内容堆叠，核心操作可见
+- **MD–LG**：双列布局，侧边栏出现，导航展开
+- **XL–XXL**：多列布局，提供更多信息密度
+
+### 导航适配规则
+
+| 断点 | 导航模式 | 说明 |
+|:----|:---------|:-----|
+| XS | 底部 Tab + 汉堡菜单 | 单手操作区域 |
+| SM | 顶部栏 + 汉堡菜单 | 充分利用顶栏 |
+| MD | 侧边栏（收起）+ 顶栏 | 侧栏可展开 |
+| LG+ | 侧边栏（展开）+ 顶栏 | 完整导航 |
+
+## 图片/资源适配
+
+```html
+<!-- 响应式图片 -->
+<img src="small.jpg"
+     srcset="medium.jpg 768w, large.jpg 1200w"
+     sizes="(max-width: 768px) 100vw, 50vw"
+     alt="描述">
+```
+
+## 设计稿与前端对齐
+
+| 设计稿宽度 | 对应断点 | 交付规范 |
+|:----------|:--------|:---------|
+| 375px | XS–SM | 移动端设计稿 |
+| 768px | MD | 平板设计稿 |
+| 1440px | XL | 桌面端设计稿 |
+
+> 设计稿至少覆盖 XS（375px）、MD（768px）、XL（1440px）三个断点。

package/common/knowledge/design/spacing_grid/knowledge.json

@@ -0,0 +1,9 @@
+{
+  "name": "spacing_grid",
+  "title": "间距与网格规范",
+  "description": "UI设计的间距体系、栅格系统和布局规范。触发关键词：间距、网格、栅格、布局、边距、间距体系",
+  "version": "1.0.0",
+  "prompt_file": "./knowledge.md",
+  "group": "design",
+  "tags": ["ui_design", "frontend_layout", "product_design"]
+}

package/common/knowledge/design/spacing_grid/knowledge.md

@@ -0,0 +1,69 @@
+# 间距与网格规范
+
+## 8px 基准间距体系
+
+间距值均为 8px 的倍数（或半倍数）：
+
+| Token | px | rem | 适用场景 |
+|:------|:---|:----|:---------|
+| spacing-0 | 0 | 0 | 无间距 |
+| spacing-1 | 2px | 0.125rem | 微间距（图标与文字） |
+| spacing-2 | 4px | 0.25rem | 紧凑间距（标签间距） |
+| spacing-3 | 8px | 0.5rem | **基础间距**（内边距基础） |
+| spacing-4 | 12px | 0.75rem | 内容与容器边缘 |
+| spacing-5 | 16px | 1rem | 卡片内边距/列表间距 |
+| spacing-6 | 20px | 1.25rem | 段落间距/表单间距 |
+| spacing-7 | 24px | 1.5rem | 组件间距/区块间距 |
+| spacing-8 | 32px | 2rem | 板块间距/大间距 |
+| spacing-9 | 40px | 2.5rem | 章节间距 |
+| spacing-10 | 48px | 3rem | 页面级间距 |
+| spacing-11 | 56px | 3.5rem | 超大间距 |
+| spacing-12 | 64px | 4rem | 极限间距 |
+
+> 原则：优先使用 8px 倍数间距，偶尔使用 4px 做微调。避免使用奇数间距。
+
+## 栅格系统
+
+### 网页端栅格（12列）
+| 断点 | 容器宽度 | 列宽 | 间距 | 边距 |
+|:----|:---------|:----|:----|:-----|
+| < 768px | 100% | 自适应 | 16px | 16px |
+| ≥ 768px | 720px | 48px | 24px | 24px |
+| ≥ 992px | 960px | 56px | 24px | 24px |
+| ≥ 1200px | 1140px | 72px | 24px | 24px |
+| ≥ 1600px | 1440px | 96px | 24px | 24px |
+
+### 移动端栅格（4列）
+| 屏幕宽度 | 间距 | 边距 |
+|:---------|:----|:-----|
+| 320–374px | 8px | 16px |
+| 375–414px | 8px | 16px |
+| ≥ 415px | 12px | 24px |
+
+## 内边距规则
+
+| 元素 | 内边距 |
+|:----|:-------|
+| 页面容器 | 24px（桌面）/ 16px（移动） |
+| 卡片 Container | 16px / 24px |
+| 模态框内容 | 24px |
+| 表格单元格 | 8px 16px |
+| 输入框 | 8px 12px |
+| 按钮 | 水平 16px / 垂直 4px–8px |
+| 列表项 | 8px 16px |
+| 标签/Badge | 4px 8px |
+
+## 布局层级（Z-Index）
+
+| 层级 | 值 | 元素 |
+|:----|:---|:-----|
+| Base | 0 | 页面内容 |
+| Sticky | 100 | 粘性定位元素 |
+| Dropdown | 200 | 下拉菜单 |
+| NavBar | 300 | 导航栏 |
+| Modal Backdrop | 400 | 模态遮罩 |
+| Modal | 500 | 模态框 |
+| Notification | 600 | 通知/提示 |
+| Tooltip | 700 | 提示工具 |
+| Loading | 800 | 加载遮罩 |
+| Max | 9999 | 最高优先级 |

package/common/knowledge/design/svg_standards/knowledge.json

@@ -0,0 +1,9 @@
+{
+  "name": "svg_standards",
+  "title": "SVG规范常识",
+  "description": "SVG矢量图形标准规范，含viewBox/xmlns/标签闭合/颜色/尺寸体系等基础知识",
+  "version": "1.0.0",
+  "prompt_file": "./knowledge.md",
+  "group": "design",
+  "tags": ["icon_design", "svg_drawing", "ui_design", "frontend_layout"]
+}

package/common/knowledge/design/svg_standards/knowledge.md

@@ -0,0 +1,51 @@
+# SVG规范常识
+
+## 基础规范
+
+| 要求 | 说明 | 正确示例 | 错误示例 |
+|:-----|:-----|:---------|:---------|
+| 命名空间 | 每个SVG必须包含 `xmlns` | `xmlns="http://www.w3.org/2000/svg"` | 缺少xmlns |
+| viewBox | 必须包含viewBox定义 | `viewBox="0 0 24 24"` | 没有viewBox |
+| 标签闭合 | 所有标签必须闭合 | `<circle cx="12" cy="12" r="10"/>` | 不闭合 |
+| 颜色值 | 使用HEX或命名色值 | `stroke="#1890FF"` | 随意色值 |
+
+## 尺寸体系
+
+| 图标级别 | 尺寸(px) | viewBox | 适用场景 |
+|:---------|:---------|:--------|:---------|
+| 迷你图标 | 12×12 | `0 0 12 12` | 标签、内联文本 |
+| 小图标 | 16×16 | `0 0 16 16` | 列表项、菜单 |
+| 常规图标 | 24×24 | `0 0 24 24` | 操作按钮、导航 |
+| 大图标 | 32×32 | `0 0 32 32` | 功能入口 |
+| 较大图标 | 48×48 | `0 0 48 48` | 特色功能展示 |
+| 特大图标 | 64×64 | `0 0 64 64` | 空状态、大模块 |
+
+## 样式规范
+
+| 属性 | 常用值 | 说明 |
+|:-----|:-------|:-----|
+| `stroke-width` | `2`（图标）、`1`（细节） | 线条粗细 |
+| `stroke` | `currentColor` / `#xxx` | 线条颜色 |
+| `fill` | `none` / `#xxx` | 填充颜色 |
+| `stroke-linecap` | `round` / `butt` | 线端点样式 |
+| `stroke-linejoin` | `round` / `miter` | 线连接点样式 |
+| `stroke-opacity` | `0.5`–`1` | 线条不透明度 |
+
+## 常用元素
+
+| 元素 | 用途 | 关键属性 |
+|:-----|:-----|:---------|
+| `<path>` | 自定形状 | `d="M... L... Z"` |
+| `<circle>` | 圆形 | `cx cy r` |
+| `<rect>` | 矩形 | `x y width height rx ry` |
+| `<line>` | 线条 | `x1 y1 x2 y2` |
+| `<polyline>` | 折线 | `points="x,y x,y"` |
+| `<g>` | 分组 | `transform` |
+| `<text>` | 文字 | `x y font-size font-family` |
+
+## 兼容性注意事项
+
+- 避免使用SVG 2.0新特性（如`<mesh>`），浏览器支持不全面
+- 避免使用复杂滤镜（`<filter>`），旧浏览器不支持
+- 图标用 `fill="none"` + `stroke="currentColor"` 支持主题切换
+- viewBox保持正方形比例（宽高比1:1），避免缩放变形

package/common/knowledge/design/typography/knowledge.json

@@ -0,0 +1,9 @@
+{
+  "name": "typography",
+  "title": "字体排版规范",
+  "description": "UI设计的字体层级、字号行高和排版规则。触发关键词：字体、字号、排版、行高、字重、字体层级",
+  "version": "1.0.0",
+  "prompt_file": "./knowledge.md",
+  "group": "design",
+  "tags": ["ui_design", "frontend_layout", "product_design"]
+}

package/common/knowledge/design/typography/knowledge.md

@@ -0,0 +1,57 @@
+# 字体排版规范
+
+## 字号层级（基准: 14px / 16px）
+
+| 层级 | 字号 | 行高 | 字重 | 适用场景 |
+|:----|:----|:----|:----|:---------|
+| **H1** | 36px / 2.25rem | 1.3 | Bold 700 | 页面标题 |
+| **H2** | 28px / 1.75rem | 1.3 | Bold 700 | 区块标题 |
+| **H3** | 24px / 1.5rem | 1.35 | SemiBold 600 | 卡片标题 |
+| **H4** | 20px / 1.25rem | 1.4 | SemiBold 600 | 模块标题 |
+| **H5** | 16px / 1rem | 1.5 | Medium 500 | 子标题/分组标题 |
+| **H6** | 14px / 0.875rem | 1.5 | Medium 500 | 小标题/标签标题 |
+| **Body** | 14px / 0.875rem | 1.6 | Regular 400 | 正文 |
+| **Body Small** | 12px / 0.75rem | 1.5 | Regular 400 | 辅助文字/说明 |
+| **Caption** | 12px / 0.75rem | 1.4 | Regular 400 | 注释/图注 |
+| **Overline** | 10px / 0.625rem | 1.4 | Medium 500 | 上标标签/小标签 |
+| **Code** | 13px / 0.8125rem | 1.6 | Regular 400 | 代码/技术内容 |
+
+## 字重映射
+
+| 字重名称 | 数值 | CSS Token |
+|:---------|:----|:----------|
+| Thin | 100 | `--font-weight-thin` |
+| Light | 300 | `--font-weight-light` |
+| Regular | **400** | `--font-weight-regular` |
+| Medium | 500 | `--font-weight-medium` |
+| SemiBold | 600 | `--font-weight-semibold` |
+| Bold | **700** | `--font-weight-bold` |
+| ExtraBold | 800 | `--font-weight-extrabold` |
+
+## 字体系列
+
+```css
+/* 中文字体栈 */
+font-family: -apple-system, "PingFang SC", "Microsoft YaHei", "Noto Sans SC", sans-serif;
+
+/* 英文/数字字体栈 */
+font-family: -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+
+/* 等宽字体（代码） */
+font-family: "SF Mono", "Fira Code", "JetBrains Mono", "Consolas", monospace;
+```
+
+## 段落间距
+
+| 关系 | 间距 | 比例 |
+|:----|:----|:-----|
+| 标题与正文 | 12px / 0.75rem | 1x |
+| 段落与段落 | 16px / 1rem | 1.25x |
+| 大标题与下一级标题 | 24px / 1.5rem | 2x |
+| 正文与列表 | 12px / 0.75rem | 1x |
+| 列表项之间 | 4px / 0.25rem | 0.33x |
+
+## 行长限制
+- 中文：每行 30–40 字符
+- 英文：每行 60–75 字符
+- 移动端：每行 25–35 字符

package/common/knowledge/design/ui_icon_size/knowledge.json

@@ -0,0 +1,9 @@
+{
+  "name": "ui_icon_size",
+  "title": "UI图标尺寸规范",
+  "description": "UI设计、图标设计、前端排版共享的图标尺寸常识规范。触发关键词：图标尺寸、图标大小、icon尺寸、icon大小",
+  "version": "1.0.0",
+  "prompt_file": "./knowledge.md",
+  "group": "ui",
+  "tags": ["ui_design", "icon_design", "frontend_layout", "product_design"]
+}

package/common/knowledge/design/ui_icon_size/knowledge.md

@@ -0,0 +1,73 @@
+# UI图标尺寸规范
+
+## 通用图标尺寸体系
+
+| 级别 | 尺寸(px) | 适用场景 |
+|:----|:---------|:---------|
+| 迷你图标 | 12×12 | 标签、徽标、状态指示、内联文本装饰 |
+| 小图标 | 16×16 | 列表项图标、树节点图标、工具条小按钮 |
+| 常规图标 | 24×24 | 主操作按钮、导航栏图标、 Tab 图标 |
+| 大图标 | 32×32 | 功能入口、二级导航、空状态插图 |
+| 较大图标 | 48×48 | 首页功能入口、特色功能展示 |
+| 特大图标 | 64×64 | 页面级空状态、启动页、大模块标识 |
+
+## 设计原则
+
+1. **视觉对齐**：所有图标需在对应尺寸网格内居中对齐，上下左右留白均匀
+2. **可识别性**：迷你/小图标应简化细节，确保在小尺寸下仍可辨认
+3. **风格统一**：同一产品内所有图标保持相同的线宽（常规2px / 填充式）、圆角风格和透视角度
+4. **像素完美**：关键边缘对齐像素网格，避免抗锯齿模糊
+5. **语义一致**：同一语义（如"设置"）在不同尺寸下使用相同的图形语言
+
+## 触控区域
+
+| 设备 | 最小触控区域 | 图标间距 |
+|:----|:------------|:---------|
+| 桌面端 | 24×24 | ≥8px |
+| 移动端 | 44×44（建议48×48） | ≥12px |
+| 车载/工控 | 56×56 | ≥16px |
+
+## 不同场景的图标尺寸建议
+
+### 导航场景
+- 顶部导航栏：24×24
+- 侧边栏导航：16×16（折叠） / 24×24（展开）
+- 底部标签栏：24×24（active状态可用32×32）
+
+### 内容场景
+- 列表图标：16×16
+- 卡片图标：24×24 / 32×32
+- 文章内联图标：12×12 / 16×16
+
+### 功能场景
+- 主要操作按钮：24×24
+- 次要操作/文字按钮：16×16
+- 工具条：16×16 / 24×24
+
+### 反馈场景
+- 提示/通知图标：16×16
+- 成功/警告/错误状态图：24×24（密集） / 48×48（空状态页）
+- 加载/进度指示：24×24
+
+## 文件命名规范
+
+```
+{category}_{name}_{size}.svg
+示例：nav_home_24.svg、action_add_16.svg
+```
+
+## 图标资源格式要求
+- 优先使用 SVG 格式（可缩放、支持多主题）
+- 提供 @2x / @3x 的 PNG 备选（用于不支持 SVG 的场景）
+- SVG 需删除冗余元数据，压缩至最小
+
+## 设计稿与前端验收对照表
+
+| 设计稿标注 | 前端实现 | 验收标准 |
+|:----------|:---------|:---------|
+| 迷你 12px | `width:12px; height:12px` | 视觉清晰无模糊 |
+| 小 16px | `width:16px; height:16px` | 边缘对齐像素网格 |
+| 常规 24px | `width:24px; height:24px` | 居中对齐无偏移 |
+| 大 32px | `width:32px; height:32px` | 细节完整可辨认 |
+| 较大 48px | `width:48px; height:48px` | 视觉重量平衡 |
+| 特大 64px | `width:64px; height:64px` | 可作为页面视觉焦点 |

package/common/knowledge/develop/database_design/knowledge.json

@@ -0,0 +1,9 @@
+{
+  "name": "database_design",
+  "title": "数据库设计规范",
+  "description": "数据库表结构、字段命名、索引设计和SQL编写规范。触发关键词：数据库、表结构、SQL、字段、索引、数据模型",
+  "version": "1.0.0",
+  "prompt_file": "./knowledge.md",
+  "group": "develop",
+  "tags": ["backend_dev", "nodejs_dev", "fullstack_dev"]
+}

package/common/knowledge/develop/database_design/knowledge.md

@@ -0,0 +1,80 @@
+# 数据库设计规范
+
+## 命名规范
+
+| 元素 | 规则 | 示例 |
+|:----|:-----|:-----|
+| 数据库 | 项目名_环境 | `mm_ai_dev`, `mm_ai_prod` |
+| 表名 | 小写蛇形复数 | `users`, `order_items`, `user_roles` |
+| 字段名 | 小写蛇形 | `user_id`, `created_at`, `is_active` |
+| 主键 | `id` | `BIGINT UNSIGNED AUTO_INCREMENT` |
+| 外键 | `{关联表单数}_id` | `user_id`, `order_id` |
+| 唯一索引 | `uk_{表}_{字段}` | `uk_users_email` |
+| 普通索引 | `idx_{表}_{字段}` | `idx_users_status` |
+| 联合索引 | `idx_{表}_{f1}_{f2}` | `idx_users_status_created` |
+
+## 每张表必须包含的字段
+
+```sql
+`id`         BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键ID',
+`created_at` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+`updated_at` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+`deleted_at` datetime DEFAULT NULL COMMENT '删除时间（软删除）',
+```
+
+## 字段类型选择
+
+| 数据类型 | 长度 | 适用场景 |
+|:---------|:-----|:---------|
+| `TINYINT` | 1 | 状态/枚举（小于 256 个值） |
+| `SMALLINT` | 2 | 小范围数值 |
+| `INT` | 4 | 常规数值（推荐 `INT UNSIGNED`） |
+| `BIGINT` | 8 | 大数值/ID（推荐 `BIGINT UNSIGNED`） |
+| `VARCHAR(32)` | 可变 | 短文本（状态码、手机号） |
+| `VARCHAR(255)` | 可变 | 常规文本（名称、邮箱、标题） |
+| `TEXT` | 可变 | 长文本（描述、备注） |
+| `LONGTEXT` | 可变 | 超长文本（文章内容） |
+| `DECIMAL(10,2)` | 精确 | 金额（禁止使用 FLOAT/DOUBLE） |
+| `JSON` | 可变 | 结构化数据（MySQL 5.7+） |
+| `DATETIME` | 8 | 时间（推荐，时区无关用） |
+| `TIMESTAMP` | 4 | 时间戳（时区相关） |
+
+## SQL 编写规范
+
+### 基本规则
+- 关键字大写：`SELECT`, `FROM`, `WHERE`, `INSERT INTO`
+- 字段名小写反引号包裹：`` `user_id` ``
+- 每行一个字段，缩进对齐
+- JOIN 表使用别名
+
+### 查询示例
+```sql
+SELECT
+  u.`id`,
+  u.`name`,
+  u.`email`,
+  o.`order_no`,
+  o.`amount`
+FROM `users` u
+INNER JOIN `orders` o ON o.`user_id` = u.`id`
+WHERE u.`status` = 1
+  AND o.`created_at` >= '2024-01-01'
+ORDER BY o.`created_at` DESC
+LIMIT 20;
+```
+
+### 索引设计原则
+1. WHERE 条件字段建索引
+2. ORDER BY 字段建索引（与 WHERE 组合建联合索引）
+3. JOIN 关联字段必须建索引
+4. 区分度低的字段（性别、状态）不适合单独建索引
+5. 联合索引遵循"最左前缀"原则
+6. 不要给每个字段都建索引（影响写入性能）
+
+### 禁止行为
+- ❌ 禁止使用 `SELECT *`（必须明确指定字段）
+- ❌ 禁止在大表上使用 `LIKE '%keyword%'`
+- ❌ 禁止在循环中执行 SQL（用批量操作替代）
+- ❌ 禁止存储明文密码（必须哈希处理）
+- ❌ 禁止使用外键约束（用代码逻辑保证数据一致性）
+- ❌ 禁止在事务中执行耗时操作

package/common/knowledge/develop/database_naming_conventions/knowledge.json

@@ -0,0 +1,9 @@
+{
+  "name": "database_naming_conventions",
+  "title": "数据库命名与注释规范",
+  "description": "数据库表命名、字段命名和注释规范，包含表名格式、字段命名规则和注释编写标准。触发关键词：表命名、字段命名、注释规范、建表、SQL",
+  "version": "1.0.0",
+  "prompt_file": "./knowledge.md",
+  "group": "develop",
+  "tags": ["backend_dev", "database"]
+}

package/common/knowledge/develop/database_naming_conventions/knowledge.md

@@ -0,0 +1,156 @@
+# 数据库命名与注释规范
+
+## 一、表命名规范
+
+### 基本格式
+`<app_name>_<function_name>` 或 `<app_name>_<function_name>_<type_name>`
+
+### 规则说明
+- **app_name**：应用名称缩写，小写
+- **function_name**：功能名称，小写
+- **type_name**：类型名称（可选），小写
+
+### 示例
+| 应用 | 功能 | 类型 | 表名 |
+|:----|:-----|:-----|:-----|
+| cms | article | - | `cms_article` |
+| cms | article | type | `cms_article_type` |
+| sys | user | - | `sys_user` |
+| sys | user | role | `sys_user_role` |
+| order | goods | - | `order_goods` |
+| order | goods | detail | `order_goods_detail` |
+
+## 二、字段命名规范
+
+### 主键字段
+自增ID字段命名为最后一个name + '_id'
+
+| 表名 | 主键字段 |
+|:-----|:---------|
+| cms_article | `article_id` |
+| cms_article_type | `type_id` |
+| sys_user | `user_id` |
+| sys_user_role | `user_role_id` |
+
+### 外键字段
+命名为关联表最后一个name + '_id'
+
+| 当前表 | 关联表 | 外键字段 |
+|:-------|:-------|:---------|
+| cms_article | cms_article_type | `type_id` |
+| order_goods | sys_user | `user_id` |
+
+### 普通字段
+采用小写蛇形命名
+
+| 字段名 | 含义 |
+|:-------|:-----|
+| `user_name` | 用户名 |
+| `created_at` | 创建时间 |
+| `is_deleted` | 是否删除 |
+
+## 三、注释规范
+
+### 字段注释格式
+`中文名：[最小值，最大值]描述(关联信息)`
+
+### [最小值，最大值]规则
+- **数值类型**：最小数值到最大数值
+- **字符串类型**：最小字符串长度到最大字符串长度
+
+### 关联信息格式
+- **关联表**：`关联表名.主键字段名.关联字段名称`
+- **枚举类型**：`(枚举值1|枚举值2|枚举值3)`
+
+### 完整示例
+
+#### 数值类型字段
+```sql
+`type_id` INT NOT NULL DEFAULT 0 COMMENT '分类ID：[0, 1000]文章的分类(cms_article_type.type_id.name)',
+`status` TINYINT NOT NULL DEFAULT 0 COMMENT '状态：[0, 2]文章状态(0草稿|1发布|2归档)',
+`sort_order` INT NOT NULL DEFAULT 0 COMMENT '排序：[0, 9999]显示顺序',
+`view_count` INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '浏览量：[0, 4294967295]文章浏览次数',
+```
+
+#### 字符串类型字段
+```sql
+`article_title` VARCHAR(255) NOT NULL COMMENT '文章标题：[1, 255]文章的标题',
+`article_summary` VARCHAR(500) DEFAULT NULL COMMENT '文章摘要：[0, 500]文章的简要描述',
+`author_name` VARCHAR(64) NOT NULL COMMENT '作者名称：[1, 64]文章作者',
+`email` VARCHAR(128) NOT NULL COMMENT '邮箱：[6, 128]用户邮箱地址',
+`mobile` VARCHAR(11) DEFAULT NULL COMMENT '手机号：[0, 11]用户手机号码',
+```
+
+#### 枚举类型字段
+```sql
+`is_active` TINYINT NOT NULL DEFAULT 1 COMMENT '是否激活：[0, 1]用户状态(0否|1是)',
+`gender` TINYINT DEFAULT NULL COMMENT '性别：[0, 2]用户性别(0未知|1男|2女)',
+`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否删除：[0, 1]软删除标记(0否|1是)',
+```
+
+#### 日期时间字段
+```sql
+`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间：[0, 0]记录创建时间',
+`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间：[0, 0]记录更新时间',
+`deleted_at` DATETIME DEFAULT NULL COMMENT '删除时间：[0, 0]软删除时间',
+`publish_time` DATETIME DEFAULT NULL COMMENT '发布时间：[0, 0]文章发布时间',
+```
+
+#### 关联表字段
+```sql
+`user_id` BIGINT NOT NULL COMMENT '用户ID：[0, 9223372036854775807]所属用户(sys_user.user_id.user_name)',
+`article_id` BIGINT NOT NULL COMMENT '文章ID：[0, 9223372036854775807]关联文章(cms_article.article_id.article_title)',
+`type_id` INT NOT NULL COMMENT '类型ID：[0, 1000]文章分类(cms_article_type.type_id.name)',
+```
+
+### 表注释格式
+`表中文名`
+
+```sql
+CREATE TABLE `cms_article` (
+  ...
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文章表';
+```
+
+## 四、索引命名规范
+
+### 唯一索引
+`uk_<表名缩写>_<字段名>`
+
+### 普通索引
+`idx_<表名缩写>_<字段名>`
+
+### 联合索引
+`idx_<表名缩写>_<字段1>_<字段2>`
+
+### 示例
+| 索引类型 | 索引名称 | 说明 |
+|:---------|:---------|:-----|
+| 唯一索引 | `uk_cms_art_title` | 文章标题唯一索引 |
+| 普通索引 | `idx_cms_art_type` | 文章类型索引 |
+| 联合索引 | `idx_cms_art_type_status` | 类型+状态联合索引 |
+
+## 五、完整建表示例
+
+```sql
+CREATE TABLE `cms_article` (
+  `article_id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '文章ID：[0, 9223372036854775807]自增主键',
+  `type_id` INT NOT NULL DEFAULT 0 COMMENT '分类ID：[0, 1000]文章的分类(cms_article_type.type_id.name)',
+  `article_title` VARCHAR(255) NOT NULL COMMENT '文章标题：[1, 255]文章的标题',
+  `article_summary` VARCHAR(500) DEFAULT NULL COMMENT '文章摘要：[0, 500]文章的简要描述',
+  `article_content` LONGTEXT COMMENT '文章内容：[0, 4294967295]文章的正文内容',
+  `author_name` VARCHAR(64) NOT NULL COMMENT '作者名称：[1, 64]文章作者',
+  `status` TINYINT NOT NULL DEFAULT 0 COMMENT '状态：[0, 2]文章状态(0草稿|1发布|2归档)',
+  `sort_order` INT NOT NULL DEFAULT 0 COMMENT '排序：[0, 9999]显示顺序',
+  `view_count` INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '浏览量：[0, 4294967295]文章浏览次数',
+  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否删除：[0, 1]软删除标记(0否|1是)',
+  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间：[0, 0]记录创建时间',
+  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间：[0, 0]记录更新时间',
+  `deleted_at` DATETIME DEFAULT NULL COMMENT '删除时间：[0, 0]软删除时间',
+  PRIMARY KEY (`article_id`),
+  UNIQUE KEY `uk_cms_art_title` (`article_title`),
+  KEY `idx_cms_art_type` (`type_id`),
+  KEY `idx_cms_art_status` (`status`),
+  KEY `idx_cms_art_created` (`created_at`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文章表';
+```

package/common/knowledge/develop/file_upload_standards/knowledge.json

@@ -0,0 +1,9 @@
+{
+  "name": "file_upload_standards",
+  "title": "文件上传安全规范",
+  "description": "文件上传的类型白名单、大小限制、存储安全和校验规则常识",
+  "version": "1.0.0",
+  "prompt_file": "./knowledge.md",
+  "group": "develop",
+  "tags": ["backend_dev", "mm_development", "security_basics"]
+}