下载中心

🔧 规则配置参考

代码设计师 —— 规则文件配置 · Mounts 挂载配置

📜 规则文件配置

项目规则文件位于 /.codeDesigner/codeDesigner.md,是 AI 开发团队的行为约束库,动态维护、严格限量。

目录约定

用途路径说明
临时文件/tmp/临时脚本、测试输出、诊断日志
文档/docs/项目文档、指南、配置参考源文件
测试/test/单元测试、集成测试代码

编码规范

规范要求示例
变量命名使用 camelCaseuserProfile, isLoading
组件文件名使用 PascalCaseUserProfile.tsx, NavBar.tsx
类型定义禁止使用 any,必须定义 Interface 或 Typeinterface User { name: string }

条目上限与淘汰机制

📏

总量上限

规则总条目 ≤ 30 条,超过时自动触发清理流程

🗑️

淘汰优先级

安全红线 > 架构约束 > 编码规范 > 临时教训,低优先级先淘汰

🔄

清理策略

同类合并、淘汰低热度项、删除已修复的临时熔断规则

🔒

只读保护

架构级规范(如 MVVM 命令规范)由人工标注为只读,防止自动删除

📄 规则文件结构

规则文件按章节组织,如「禁止事项」「目录约定」「编码规范」「框架约束」「运维安全」,每个同类规则最多保留 1 条,保持精炼。

🔌 Mounts 挂载配置

Mounts 挂载系统用于将外部存储(本地目录或远程 FTP)映射为虚拟路径,在项目启动时初始化。

本地挂载(Local)

将本地磁盘目录映射为项目的虚拟路径:

{ "virtualPath": "/mounts/backup", "targetConfig": { "type": "local", "path": "E:\\BackupStorage" } }

远程 FTP 挂载

将远程 FTP 服务器目录映射为虚拟路径,支持只读模式:

{ "virtualPath": "/mounts/remote", "targetConfig": { "type": "ftp", "host": "192.168.1.100", "port": 21, "username": "ftpuser", "password": "******", "ssl": false, "mode": "pasv", "path": "/home/ftpuser/data", "readonly": true } }

配置加载优先级

项目启动时按以下优先级依次加载配置:

优先级配置项说明
1(最高)project.json解析项目元数据、Mounts 挂载(启动即加载)
2codeDesigner.md加载规则约束(目录约定、编码规范)
3roles/*.md按注册的角色逐文件加载详细定义
4skills/*.md按注册的技能逐文件加载详细定义
5(最低)guide/*.md按需加载指南文档
⚡ Mounts 特殊说明

因挂载文件系统需在项目启动时初始化,Mounts 在 project.json 解析阶段(优先级 1)立即处理,在加载规则/角色/技能之前完成挂载。

完整配置示例

{ "ProjectName": "CodeDesigner", "ProjectPath": "D:\\Project\\CodeDesigner.Site", "ProjectId": 59458000, "Mounts": [ { "virtualPath": "/mounts/backup", "targetConfig": { "type": "local", "path": "E:\\BackupStorage" } }, { "virtualPath": "/mounts/remote", "targetConfig": { "type": "ftp", "host": "192.168.1.100", "port": 21, "username": "ftpuser", "password": "******", "ssl": false, "mode": "pasv", "path": "/home/ftpuser/data", "readonly": true } } ] }