前言

本规范为硬红线规则，所有 AI 编码、重构、修复、新增代码必须 100% 遵守。 核心唯一准则：原版内核不动、官方应用不改、自研代码隔离、完全适配 MuuCMF-T6 原生规范，绝不自创语法与架构。 适配版本：MuuCMF-T6 全系列稳定版，严格遵循官方开发命名、目录、业务逻辑规范。

一、绝对禁止操作（红线 0 容忍，AI 严禁触碰）

1. 禁止修改 MuuCMF 原版内核文件

以下目录只读、零修改、零覆盖、零重构

app/common
app/admin
app/index
app/api
app/ucenter
public/static/common
config（系统核心配置）
route（系统默认路由）

• 禁止 AI 优化、重构、注释、删减、修复内核源码
• 禁止 AI 替换系统原生函数、重写底层 Hook、重写鉴权逻辑
• 禁止 AI 修改系统默认返回格式、异常抛出机制、日志机制

2. 禁止修改官方付费 / 默认应用源码

云课堂、云小店、会员系统、积分、支付、分销、DIY 装修、权限体系

• 禁止 AI 改官方模块控制器、模型、数据库字段、逻辑流程
• 禁止 AI 绕过原生支付校验、会员鉴权、订单状态机制

3. 禁止 AI 自创架构

• 禁止脱离 TP6+MuuCMF 分层，自创 Controller 直连 DB、跳过模型层
• 禁止自创全局函数、自创静态配置、自创鉴权方式
• 禁止废弃系统自带缓存、事务、事件机制

4. 禁止数据库危险操作

• 禁止 AI 修改、删除、更名系统原生数据表、原生字段
• 禁止 AI 新增带系统前缀、冲突字段的表
• 禁止 AI 随意加唯一索引、主键、外键（必须人工审核）

二、唯一合法自研开发方式（强制 AI 遵守）

1. 所有自研业务必须独立隔离

• 全部新建自定义应用（例如：app/myproject、app/custom）
• 自研控制器、模型、视图、路由、静态资源全部放在自研独立目录
• 绝不和系统目录、官方应用目录混写代码

2. 数据表规范

• 自研数据表全新新建，前缀自定义，不占用系统表
• 禁止复用系统表新增业务字段（除备注、扩展预留字段外）
• 表名、字段名严格遵循官方规范：小写 + 下划线，统一命名格式

3. 代码分层强制标准（AI 必须严格执行）

严格遵循 MuuCMF-T6 官方分层逻辑：

1. Controller：只做参数校验、路由接收、响应返回
2. Service：所有业务逻辑、流程判断、状态流转
3. Model：只做字段映射、关联、scope、规则验证
4. Validate：独立验证器，统一参数校验

禁止：Controller 写业务、Model 写流程、代码分层混乱

三、MuuCMF 官方命名规范（AI 强制执行）

严格匹配框架官方标准，杜绝 AI 自由命名：

1. 目录、配置、静态资源：小写 + 下划线
2. 类文件、控制器、模型：大驼峰（首字母大写）
3. 方法、函数、变量：小写 + 下划线
4. 数据库表、字段：小写 + 下划线
5. 路由地址：全小写，下划线分隔，禁止驼峰路由

四、业务功能强制约束（核心避坑点）

1. 会员 / 权限体系

• 必须使用系统原生登录、UID、权限、角色、黑名单机制
• 禁止 AI 自建用户表、自建登录、自建权限
• 所有自研接口必须走系统原生鉴权中间件，禁止绕过登录验证

2. 支付 / 订单 / 资金类（最高优先级严控）

• 余额、积分、订单、退款、支付回调 严禁 AI 自由发挥
• 资金逻辑必须加：事务回滚、重复拦截、状态锁、超时判断、日志全记录
• AI 写完资金代码，必须输出：异常场景清单、边界测试用例

3. 文件上传、安全校验

• 必须使用系统原生上传方法，禁止 AI 手写上传逻辑
• 强制后缀校验、大小校验、恶意文件拦截、存储路径规范
• 禁止暴露绝对路径、禁止前端直传任意目录

4. 接口返回格式（统一固定）

必须完全沿用 MuuCMF 原生格式，禁止 AI 自定义返回结构 成功：code:1 失败：code:0 统一携带：msg、data、time，禁止增减字段、修改字段命名

五、前端 Vue/SPA 开发约束

适配 T6 新版 Vue3 SPA 后台规范：

1. 自研页面独立路由、独立组件，不修改系统原生页面组件
2. 统一 Element-Plus 规范，禁止 AI 混用多种 UI 写法、自定义全局样式污染
3. 表单必须绑定验证规则，禁止裸提交、无校验提交
4. 列表分页、搜索、筛选必须复用系统通用分页方法，禁止手写分页逻辑
5. 禁止全局 CSS 覆盖系统样式，自定义样式隔离在自研组件内

六、AI 编码输出强制要求（每次写代码必带）

AI 每完成一段代码，必须附带输出三项内容：

1. 代码适配说明：适配 MuuCMF-T6 版本、遵循的框架规范
2. 风险点说明：并发风险、边界风险、权限风险
3. 测试用例：正向、反向、异常场景测试步骤

七、版本升级兼容约束

1. 所有自研代码完全隔离，确保一键升级官方原版无冲突
2. 禁止 AI 补丁式修改内核，杜绝隐性版本冲突
3. 系统每次小版本更新后，AI 协助比对文件差异，仅保留纯自研代码

八、最终 AI 开发总口诀（可固定置顶 Prompt）

1. 内核不动、官方不改、自研隔离
2. 分层清晰、规范对齐、绝不自创
3. 资金慎写、权限必鉴、异常全覆盖
4. 格式统一、兼容优先、无隐性债务

九、可直接复制的 AI 全局启动 Prompt

你现在为我开发 MuuCMF 自研xx项目，严格遵守以上全部约束清单。所有代码必须适配 MuuCMF 官方规范，禁止修改系统内核、官方应用源码。所有自研功能独立新建应用隔离开发，严格执行分层架构、命名规范、统一返回格式。资金、权限、接口逻辑严格风控，禁止自创架构和语法。每次输出代码必须附带适配说明、风险点、测试用例，杜绝缝合代码、隐性 BUG、版本冲突。