代码设计师 —— 规则文件配置 · Mounts 挂载配置
项目规则文件位于 /.codeDesigner/codeDesigner.md,是 AI 开发团队的行为约束库,动态维护、严格限量。
| 用途 | 路径 | 说明 |
|---|---|---|
| 临时文件 | /tmp/ | 临时脚本、测试输出、诊断日志 |
| 文档 | /docs/ | 项目文档、指南、配置参考源文件 |
| 测试 | /test/ | 单元测试、集成测试代码 |
| 规范 | 要求 | 示例 |
|---|---|---|
| 变量命名 | 使用 camelCase | userProfile, isLoading |
| 组件文件名 | 使用 PascalCase | UserProfile.tsx, NavBar.tsx |
| 类型定义 | 禁止使用 any,必须定义 Interface 或 Type | interface User { name: string } |
规则总条目 ≤ 30 条,超过时自动触发清理流程
安全红线 > 架构约束 > 编码规范 > 临时教训,低优先级先淘汰
同类合并、淘汰低热度项、删除已修复的临时熔断规则
架构级规范(如 MVVM 命令规范)由人工标注为只读,防止自动删除
规则文件按章节组织,如「禁止事项」「目录约定」「编码规范」「框架约束」「运维安全」,每个同类规则最多保留 1 条,保持精炼。
Mounts 挂载系统用于将外部存储(本地目录或远程 FTP)映射为虚拟路径,在项目启动时初始化。
将本地磁盘目录映射为项目的虚拟路径:
{
"virtualPath": "/mounts/backup",
"targetConfig": {
"type": "local",
"path": "E:\\BackupStorage"
}
}将远程 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 挂载(启动即加载) |
| 2 | codeDesigner.md | 加载规则约束(目录约定、编码规范) |
| 3 | roles/*.md | 按注册的角色逐文件加载详细定义 |
| 4 | skills/*.md | 按注册的技能逐文件加载详细定义 |
| 5(最低) | guide/*.md | 按需加载指南文档 |
因挂载文件系统需在项目启动时初始化,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
}
}
]
}