product-planning：新增「文档的两态：当前版与过期版」——方案文件夹放当前权威版、归档-过期版收过期文档，含收口四步与实测依据

session-mechanism/env/roots.env.example

@@ -0,0 +1,25 @@
+# session-mechanism · 根目录（样例 · ⛔ 请勿当成真文件用）
+#
+# 🔴 为什么有这份样例：真正的 `roots.env` 是**本机 `install.py --apply` 生成的**
+#   （里面写的是**这台机器**的路径）⇒ ⛔ 不入库（入库会把别的电脑的路径覆盖掉）。
+#   本文件只示范**有哪些键、各填什么**，值一律是占位符。
+#
+# 用法：本机跑一次 `python install.py --apply` ⇒ 它会在包根生成真正的 `roots.env`。
+#
+# 读取机制：各脚本头部 `_sm_load_roots()` 以 setdefault 注入
+#   ⇒ **宿主 env 优先，本文件兜底**。
+
+# ① 工作区根（`state.py`、台账、心跳都在它下面）
+DSH_WS_ROOT=<工作区根>，例：E:/AIProject/<工作区别名>
+
+# ② 结果钩子认的工作区（一般与 ① 同值）
+WB_RESULT_HOOK_WS=<同上>
+
+# ③ 本工作区的协作机制部署配置（`COLLABD_CONFIG` 指向它；每个工作区一份）
+COLLABD_PROD_CONFIG=<工作区根>/.workbuddy/collab/collabd.config.json
+
+# ④ WorkBuddy 的配置目录（宿主库 workbuddy.db 在它下面）
+CODEBUDDY_CONFIG_DIR=<WorkBuddy 配置目录>，例：E:/ProgramData/.workbuddy
+
+# ⑤ 文档库根（锁目录 `05-交接单/.locks` 在它下面）
+DSH_DOCS_ROOT=<文档库根>