Problem
What problem does this solve?
目录污染
Solution
How should it work?
完善的目录标准规范
1. 特殊目录识别规则(递归生效)
.qoder/ - 工作区根目录标记,所在目录为工作区顶层
.project/ - 项目文档目录,包含需求、设计、API文档等
.bak/ - 备份目录,只读权限,禁止版本控制include
.temp/ - 临时文件目录,沙盘环境,可读写但禁止提交
.scripts/ - 脚本目录,包含构建、部署、测试脚本
.lib/ - 静态库输出目录,编译生成的库文件
.bin/ - 可执行文件输出目录,编译生成的可执行文件
.log/|.logs/ - 日志文件目录,运行时日志输出
.cache/ - 构建缓存目录,加速编译过程
.dist/ - 分发目录,打包发布文件
.config/ - 配置目录,环境相关配置文件
2. 目录权限与访问控制
权限矩阵:
.qoder/: 只读 | 禁止修改 | 工作区配置
.project/: 读写 | 文档操作 | 禁止编译输出
.bak/: 只读 | 禁止修改 | 版本控制忽略
.temp/: 读写 | 沙盘环境 | 版本控制忽略
.scripts/: 执行 | 脚本管理 | 版本控制包含
.lib/: 读写 | 编译输出 | 版本控制可选
.bin/: 读写 | 编译输出 | 版本控制忽略
.log/: 读写 | 日志输出 | 版本控制忽略
.cache/: 读写 | 构建缓存 | 版本控制忽略
3. 严格的目录使用规范
3.1 工作区约束
# 工作区顶层保护
- 工作区顶层写保护
- 所有修改必须在专用子目录中进行
3.2 源码和项目目录保护
# 源码目录(src/)约束
- 严禁在源码目录进行编译输出
- 禁止向源码目录写入临时文件
- 源码目录禁止包含二进制文件
- 保持源码目录的纯净性和可移植性
3.3 测试与脚本管理
# 脚本和测试文件管理
- 所有测试脚本必须存放在.scripts/或test/scripts/目录
- 批处理文件、shell脚本必须模块化组织
- 临时测试代码必须使用.temp/沙盘目录
- 生产环境脚本与开发环境脚本分离
3.4 编译输出控制
# 编译输出管理
- 所有编译产物必须输出到.bin/或.lib/目录
- 中间文件(obj文件)必须写入.temp/obj/
- 禁止编译产物污染源码目录
- 构建系统必须支持输出目录自定义
Use Case
When would you use this?
创建、修改、重构、分析
Priority
-
High - Blocking issue -
Medium - Important improvement -
Low - Nice to have
Additional Info
(Optional: screenshots, examples, links)