# 工作区目录说明 — 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/` | 退役概念留痕 |

## 五、维护约定

1. **新接续包** ⇒ 直接进 `归档/接续历史/<主题>/`，⛔ **不再堆根目录**。
2. **过程产物** ⇒ 落 `tmp/` 对应子目录，⛔ 不落根目录。
3. **定稿文档** ⇒ `docs/<主题>/`；**交付件** ⇒ `交付物/`。
4. **退役件** ⇒ 加日期后缀进 `归档/`。
5. 🔴 **`tmp/` 是过程区，可随时清**（除三个活文件）—— 见 `pitfalls.md` P0-84。