admin
c1b5e4d966
- 变更规模：新增 514 / 修改 62 / 重命名 155 / 删除 4（归档重组与文档轮次） - .gitignore 修：`归档/**/db-cwd归一-备份-*/` —— 原规则写绝对层级（归档/db-cwd归一-…）， 目录搬进 归档/配置与备份/ 后**静默失效**，43 MB 的 DB 备份又变成未跟踪 - .gitignore 补：嵌套 git 内部数据（归档/内嵌git-20261008/、归档/skills-git-旧线-20261007/dotgit-原样移出/） - .gitignore 补：运行态与部署副本（.workbuddy/collab/、.workbuddy/tools/、.workbuddy/.load-pending、.workbuddy/tmp-*） - .gitignore 补：备份件（*.bak-*） - 未跟踪文件从 2190 降到 890（其余为 归档/ 归档件与 .workbuddy/memory/ 知识文件，按口径入库）
67 lines
3.1 KiB
Markdown
67 lines
3.1 KiB
Markdown
# 工作区目录说明 — 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。
|