工作区目录说明 — ai1net-dsh-server
整理日期：2026-10-05
判据：按「类别 + 作用」分层 —— 活跃件在根、过程件进 tmp、定稿件进 docs/交付物、历史件进归档。
一、根目录（只放「活跃核心件」）
| 项 |
作用 |
CODEBUDDY.md |
🔴 会话作业规则（单一事实源，自动注入） |
README.md |
项目说明入口 |
AGENTS.md |
代理协作说明 |
state.py |
平台状态脚本 |
.gitignore |
入库规则 |
start-board.bat.备用 / start-collab.bat.备用 |
看板/协作启动（备用） |
会话机制-一键开关.bat |
会话机制启停入口 |
.codebuddy/ |
宿主规则与配置 |
.workbuddy/ |
🔴 记忆 / 协作机制 / 技能副本（⛔ 知识资产，勿删） |
.git/ |
版本控制 |
二、按作用分层的目录
| 目录 |
作用 |
判据 |
docs/ |
定稿文档（按主题分 11 类） |
结论已定、跨会话可查 |
交付物/ |
正式交付件 |
要交给人/给外部看的 |
执行会话/ |
目标会话目录（目标-<线>-<id>/） |
机制运行时生成 |
归档/ |
历史件（退役件、旧快照、接续历史） |
已失效但需留痕 |
tmp/ |
过程产物（探针 / 输出 / 备份） |
一次性、可再生 |
待清理/ |
待用户处置件 |
拿不准去留的暂存 |
三、tmp/ 子分类（过程产物，568 → 8）
| 子目录 |
装什么 |
判据 |
tmp/probes/ |
一次性探针脚本（.py / .ps1 / .js） |
跑完即弃 |
tmp/out/ |
命令输出（.txt / .out / .log / .json / .html） |
取证快照 |
tmp/bak/ |
各类改前备份（*.bak-*） |
改动留痕 |
tmp/ws/ |
测试用临时工作区 |
自检夹具 |
tmp/shots/ |
截图 |
视觉取证 |
tmp/supervise-inbox/ |
🔴 常驻协作程序收件箱 |
⛔ 活文件，勿动 |
tmp/supervise-bg.log |
🔴 常驻后台日志 |
⛔ 活文件 |
tmp/board-serve.err.log |
🔴 看板服务错误日志 |
⛔ 占用中 |
四、归档/ 结构与作用
| 子目录 |
作用 |
归档/接续历史/ |
会话接续包按主题归档（会话机制 / 运行治理 / 文档库 / 机制排查） |
归档/代码与机制清退/ |
退役代码 |
归档/技能-退役-20261001/ |
退役技能 |
| `归档/技能包-旧件-20261001 |
02/` |
归档/技能包快照/ |
技能包版本快照 |
归档/文档整理/ |
文档库历次整理 |
归档/迁移/ |
迁移留痕 |
归档/配置与备份/ |
配置改动备份 |
归档/试验与样例/ |
试验性产物 |
归档/手机接入线-概念退役-20260930/ |
退役概念留痕 |
五、维护约定
- 新接续包 ⇒ 直接进
归档/接续历史/<主题>/，⛔ 不再堆根目录。
- 过程产物 ⇒ 落
tmp/ 对应子目录，⛔ 不落根目录。
- 定稿文档 ⇒
docs/<主题>/；交付件 ⇒ 交付物/。
- 退役件 ⇒ 加日期后缀进
归档/。
- 🔴
tmp/ 是过程区，可随时清（除三个活文件）—— 见 pitfalls.md P0-84。
admin
c1b5e4d966