让Qoder养成良好的目录组织习惯

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

  • :red_circle: High - Blocking issue
  • :yellow_circle: Medium - Important improvement
  • :green_circle: Low - Nice to have

Additional Info

(Optional: screenshots, examples, links)