session-mechanism：两个看板整包搬进 boards/（页面与脚本同处一包）

用户令：「把这两个看板都纳入会话技能中，分两个看板文件夹，开个 boards 文件夹放两个看板」
「1 boards 2 A」（文件夹名 boards；本区部署与计划任务本轮一起改）

## 分层（新增第三层）
  scripts/  ＝ 可执行程序（被计划任务／hook 调）
  assets/   ＝ 静态素材（样式、模板）
  boards/   ＝ 自带页面的看板程序（一个看板一个文件夹，页面＋脚本同处一包）

## 动了什么
* boards/会话看板/（6 文件）：board.py / board_ext.py / board-launch.py /
  board-launch.py.tpl / board.html / board-render-probe.js（从 scripts/ 与 assets/ 搬入）
* boards/项目管理界面/（3 文件）：project-board.py / project-board.html /
  project-board-launch.py（从工作区 交付物/项目管理界面/ 复制入）

## 搬迁带出的真缺陷（已修，非补丁）
* board.py：「与 collabd.py 同目录」这个前提搬走后不成立 ⇒ 原来会**静默**落到
  本地抄的那份判据（自测「两侧共用同一实现」判 FAIL，但看板照跑、肉眼看不出来）。
  改成候选表（同目录 → 包内 scripts/ → DSH_SKILL_ROOT/scripts/），并在兜底分支**写 stderr 留痕**。
* board.py：CFG_P 同样按 HERE 找配置 ⇒ 与 collabd.py::load_cfg() 对齐查找顺序。
* selftest.py：一个 H 指两处的假设（board.py 与 collabd.py 同目录）拆成 H/B 两参数；
  board.html / board.py 全部改走 BOARD_DIR / board_py()。

## 顺带修一条既有 FAIL（与搬迁无关）
* 判据锚点没跟文档改：supervise-persistence.md 措辞在 053a6a6 已改成
  「排期按点拉起主会话这条路不存在」，判据仍锚旧句 ⇒ 恒红。判据改成锚档内现存那句。

## 验收
* selftest：--filter 看板 PASS 110 / FAIL 0（报告型 1 条不计入）；
  全量 PASS 91 / FAIL 1（同一条报告型，实质 FAIL 0）。
* 会话看板 board.py --out ⇒ 50515 字节快照，无「回落本地判据」告警（证明真从 collabd.py 取）。
* 项目管理界面 --once ⇒ 4 个项目全列出；HTTP / 200 · 54102 字节（＝技能包真身那份）·
  /api/projects 出数据 · /healthz ok。

session-mechanism/references/architecture.md

@@ -54,7 +54,7 @@
 | **投递** | ⛔🔴 **2026-10-03 07:2x 已退役，不是"降级"而是真删**：`supervise()` 203→71 行、两个 `_deliver_str()` 调用点删除、`--tick` 的 `check_delivery_consumed()` 调用删除、`collabd.config.json` 的 `wake_enable` **true→false**。⚠️ 保留的 4 个函数（`_deliver_str`／`follow_for_topic`／`wake_round`／`check_delivery_consumed`）是**零调用点**实现，`selftest` 有 4 处**真调用**前两个 ⇒ ⛔ 删函数体＝`NameError`；⚠️ 判"函数体内没调用 X"**必须走 AST**（`selftest.py::_calls_in()`），字面 grep 会被退役 docstring **永久假红**（P0-36）。⛔ 「唯一投递方＝常驻投递进程」整条**作废**。 |
 | **接收／处理（现行两条腿）** | **接收**＝`--report` 写 `tasks.json`（**四态台账，唯一权威**，唯一真源）；`--once` ＝**纯投影**，⛔ 不写。<br>**处理**＝`maybe_spawn_check_agent()` 建 `[检查]-…` 排期（五道闸），由常驻 `--supervise` 每 2 轮判一次 —— ⛔ 这是这条腿的**唯一载体**（**检查会话只能靠排期开**）。<br>⛔ **没有第三环**：队列变化**不再自动通知任何人**。 |
 | **⛔ 已废弃** | **「用自动任务当闹钟」**（2026-10-01 用户明确废弃，原话：「**定时任务的方案已经废弃了**」）⇒ §4.0／§4.1 只作历史。｜🔴 **2026-10-03 新增**：**队列投递段 ＋ 唤醒回路**（载体就是投递）—— 见本节上方状态块。 |
-| **本机起法** | 🔴🔴 **2026-10-02 23:0x 实测订正**：**不是"本机不存在长跑进程"，是"载体不同"。**<br>① 同一时刻用 `start /b` 与 `Popen+DETACHED` 各起一条每秒打点的探针 ⇒ 两条**活到约 11 分钟后停在同一 tick**（67/64 行）⇒ **差别不在起法关键字，在父链**（从**工具调用进程树**里起的活不过当轮）。<br>② 反证：MCN 工作台 `mcn-work-shop/start.bat` 由**用户从桌面双击**、属用户登录会话 ⇒ **一直活着**。<br>③ ✅ **正解＝走 WorkBuddy 自己的后台任务**（`run_in_background`；⛔ 别用 `subprocess` 自己造）。⚠️ 子进程用 `pythonw.exe`（GUI 子系统 ⇒ ⛔ 不闪窗）｜⚠️ `pythonw` 无 stdout ⇒ **必须显式重定向到文件**。<br>④ **S8 自愈仍保留**（`--supervise` 心跳 ＋ `--tick` 顺手续命 ＋ 判据 `pid 活 ∧ 心跳新鲜(<90 s)`），⛔ 但理由已换：**常驻总会被打断** ⇒ 要能自动补回来。⛔ **别拿 `_tick.stamp`／投递日志当证据**（那些轮次是钩子写的 —— P0-21）。<br>⑤ 🔴 **启完必查三样**：`netstat` 有 **LISTENING**（⛔ `TIME_WAIT`／`FIN_WAIT_2` 不算）＋ `curl` 得 **200** ＋ `tasklist` 进程在。<br>⑥ 🔴 **改看板要不要重启有四类答案（P0-38，⛔ 别一律重启）**：改 `assets/board.html` **不用**（`board.py:1293` 每请求 `read_bytes()`）／改 `board_ext.py` **不用**（`EXT_CACHE` 按 `(mtime,size)` 热重载）／改 `board.py` 自身**必须**／改 `collabd.config.json` **必须**（`C = _cfg()` 在 `board.py:81` 模块级执行一次）⇒ **判据＝先答"这个文件是谁在读、什么时候读"**。 |
+| **本机起法** | 🔴🔴 **2026-10-02 23:0x 实测订正**：**不是"本机不存在长跑进程"，是"载体不同"。**<br>① 同一时刻用 `start /b` 与 `Popen+DETACHED` 各起一条每秒打点的探针 ⇒ 两条**活到约 11 分钟后停在同一 tick**（67/64 行）⇒ **差别不在起法关键字，在父链**（从**工具调用进程树**里起的活不过当轮）。<br>② 反证：MCN 工作台 `mcn-work-shop/start.bat` 由**用户从桌面双击**、属用户登录会话 ⇒ **一直活着**。<br>③ ✅ **正解＝走 WorkBuddy 自己的后台任务**（`run_in_background`；⛔ 别用 `subprocess` 自己造）。⚠️ 子进程用 `pythonw.exe`（GUI 子系统 ⇒ ⛔ 不闪窗）｜⚠️ `pythonw` 无 stdout ⇒ **必须显式重定向到文件**。<br>④ **S8 自愈仍保留**（`--supervise` 心跳 ＋ `--tick` 顺手续命 ＋ 判据 `pid 活 ∧ 心跳新鲜(<90 s)`），⛔ 但理由已换：**常驻总会被打断** ⇒ 要能自动补回来。⛔ **别拿 `_tick.stamp`／投递日志当证据**（那些轮次是钩子写的 —— P0-21）。<br>⑤ 🔴 **启完必查三样**：`netstat` 有 **LISTENING**（⛔ `TIME_WAIT`／`FIN_WAIT_2` 不算）＋ `curl` 得 **200** ＋ `tasklist` 进程在。<br>⑥ 🔴 **改看板要不要重启有四类答案（P0-38，⛔ 别一律重启）**：改 `boards/会话看板/board.html` **不用**（`board.py:1293` 每请求 `read_bytes()`）／改 `board_ext.py` **不用**（`EXT_CACHE` 按 `(mtime,size)` 热重载）／改 `board.py` 自身**必须**／改 `collabd.config.json` **必须**（`C = _cfg()` 在 `board.py:81` 模块级执行一次）⇒ **判据＝先答"这个文件是谁在读、什么时候读"**。 |
 | **看板服务（单实例）** | 🔴 **2026-09-30 加护栏**：Windows 的 `SO_REUSEADDR` 允许**同端口重复绑定且不报错** ⇒ 多个 `board.py --serve` **静默并存**、同一 URL 被**随机**应答 ⇒ 快照/代码版本**打架**。现：检测到已有看板 ⇒ **拒绝启动**；换新代码 ⇒ `--takeover`。停机 ⇒ `stop-collab.py`。🔴 **2026-10-03**：`/board.json` 的 `meta.deliver_retired == "2026-10-03"` ＝ 前端把「队列通知」卡画成退役说明的判据。 |
 | **唤醒** | ⛔🔴 **2026-10-03 07:2x：这条整条失效** —— 唤醒的载体就是投递，投递已真删 ⇒ 所谓「三条件合取」（主会话未在处理 ∧ 无待反馈 ∧ 需求未完成）**不再有执行者**。⚠️ 下方 §2.0.1 那条「未读验收判据 ⇒ 误判完成」的缺口**随本条一起冻结**（判据本身还在，⛔ 但没人跑了）。⚠️ **「常驻＝唤醒时钟」这个类比 ⛔ 别再沿用。** |
 | **同工作区 ＋ 会话类别** | 🔴 **默认形态 ＝ 一个工作区**（2026-10-01 用户定）。🔴🔴 **2026-10-03 起会话只两类：① 主会话 ② 任务会话**（唤醒会话／跟进会话／队列上报**已整套退役**）—— ⛔ 原文写的"四类"**作废**。两类**同工作区**，⛔ 不靠 cwd。⚠️ **「接续会话」＝形态，⛔ 不是第三类**（撞阈值时由它自己建出来、**角色继承被接续那条**）。 |

session-mechanism/references/collab-detail.md

@@ -162,7 +162,7 @@
 落点：`board.py::_goal_topics_source()` → `project.topics_source.kind ∈ {declared, fallback, none}`
 （`declared` 时一并显示说明时间/说明人）。回归用例：`selftest.py::看板：任务类别来源必须说得出口`。
 
-## 0.5 🔴 看板（`scripts/board.py` ＋ `assets/board.html`）
+## 0.5 🔴 看板（`boards/会话看板/board.py` ＋ `boards/会话看板/board.html`）
 
 ### 0.5.0 🔴🔴 「看板」默认指**那个实时动态看板** —— 它是**要起着的**（2026-10-01 用户点破）
 
@@ -174,7 +174,7 @@
 |---|---|
 | 地址 | **`http://127.0.0.1:8788/`**（⛔ 只绑回环） |
 | 起法 | **会话后台任务 ＋ stdout 落文件**（本机唯一可行的起法） |
-| 命令 | `COLLABD_CONFIG=<ws>/.workbuddy/collab/collabd.config.json DSH_COLLAB_WS=<ws> "<python>" "<技能>/scripts/board.py" --serve 8788 --takeover > <ws>/tmp/board-serve.out.log 2>&1` |
+| 命令 | `COLLABD_CONFIG=<ws>/.workbuddy/collab/collabd.config.json DSH_COLLAB_WS=<ws> "<python>" "<技能>/boards/会话看板/board.py" --serve 8788 --takeover > <ws>/tmp/board-serve.out.log 2>&1` |
 | 换代码重起 | 加 **`--takeover`**（先停旧的再接管）。⛔ **别裸起第二个** —— Windows `SO_REUSEADDR` 会让两实例**静默并存**、同一 URL 随机应答（"改了、也重启了、却还是旧的"就是这么来的）。单实例护栏：已有看板 ⇒ **拒绝启动** |
 | 改完必须重启 | ⚠️ 服务进程**已 import** 技能里的 `board.py` ⇒ 改快照内容后**不重启就跑旧代码** |
 | 停机出口 | `.workbuddy/collab/stop-collab.py`（dry-run 只报告）｜`goalctl stop --yes` 会顺带停它 |
@@ -373,7 +373,7 @@ headless chrome ／附着用户 Chrome** ⇒ **不许擅自开浏览器**。但"
    ⇒ `file://` 双击即看，⛔ 不依赖本地服务、⛔ 不依赖网络。**桩验"内容与几何"，人眼验"观感"**，两件都要做。
 
 🔴🔴 **改之前必须知道的两件位置事实**（2026-10-01 实测，⛔ 不知道就会白改）：
-- **`board.html` 从「包内」读**（`board.py` 用 `HERE.parent/assets/board.html`）⇒ 改包内**即生效**。
+- **`board.html` 从「包内」读**（`board.py` 用 `HERE/board.html`）⇒ 改包内**即生效**。
 - **`board_ext.py` 从「使用方工作区」读**（配置项 `board_ext`，默认 `<工作区>/.workbuddy/collab/board_ext.py`）
   ⇒ **只改包内那份等于没改** —— 必须 `cp` 同步过去，并**核 md5 一致**。
   ⚠️ 同理还有 `goalctl.py` / `stop-collab.py` / `deliver-gateway-token.py` 等**工作区副本**。
@@ -420,7 +420,7 @@ headless chrome ／附着用户 Chrome** ⇒ **不许擅自开浏览器**。但"
 - ⛔ **技能里不写死这一格叫什么** —— 名字由使用方经 `front.triggers[].name` 给。
   🔴 **用户 2026-10-01 定的名（现行）＝「唤醒会话」**；同日更早叫过「唤醒主会话」（**已作废**，用户原话「**唤醒主会话 改为 唤醒会话**」），再早叫「唤醒脉冲会话」「唤醒定时任务」（均**已作废**）。
   属**项目侧**，`board.html` 里⛔ 不写死这个名字 —— 由使用方经 `front.triggers[].name` 给。
-  **判据：`assets/board.html` 的渲染逻辑里不该出现具体项目名。**
+  **判据：`boards/会话看板/board.html` 的渲染逻辑里不该出现具体项目名。**
 - 🔴 **2026-10-01 23:1x 图上改「简称」（用户第六条口径）**：`唤醒会话 →` **唤醒**、`队列上报的跟进会话 →` **跟进**
   （⛔ 用户明令**两者字号一致**，`n-title-sm` 13px）、`目标检查 →` **协作**（`n-title` 16px）。
   ⚠️ **简称 ≠ 改角色** —— 正文／代码里的**全称不变**；图里 `?`／`aria-label` **必须带简称对照**
@@ -930,7 +930,7 @@ headless chrome ／附着用户 Chrome** ⇒ **不许擅自开浏览器**。但"
 | **常驻程序** | `collabd.py`（自述"协作守护程序"） | 队列闸门（`NEXT.md`）＋ **唤醒投递** ＋ 证据分级／真空／断链告警／体检／看板覆写。**⛔ 不做派活** | 「判定层」「常驻程序」「机械层」 |
 | **会话** | `sessions` 表 | 执行体：「读—判—写」；**一次性**、可替换 | —— |
 | **棒** | 一次派活 ＝ 一个会话 | 同一件事的执行单位（「一棒一线」） | —— |
-| **看板** | `scripts/board.py --serve` → `assets/board.html` | **用户唯一入口**（只读旁路 · 异步快照） | ⛔ 别把 `digest.md`（机械摘要）当用户入口；⛔ 也别再提已退役的 `交付物/手机接入-实时状态.md` |
+| **看板** | `boards/会话看板/board.py --serve` → `boards/会话看板/board.html` | **用户唯一入口**（只读旁路 · 异步快照） | ⛔ 别把 `digest.md`（机械摘要）当用户入口；⛔ 也别再提已退役的 `交付物/手机接入-实时状态.md` |
 | **设备接入 · 本地反代** | `dsh-client` · 真身 `@dsh-client/device-shim`（`127.0.0.1:20090`） | 只绑回环的 HTTP+WS 反代，**在进程内注入本机 DSH 的会话凭据**，供覆盖网络中继从设备入口访问桌面 DSH。⚠️ 该包已标「已退役」，计划并入 `@dsh-local/ai1net` 的第 6 块模块**M6「设备接入」**，但**尚未落地**（仓库里还没有 `ai1net` 包） | ⛔ 别再叫它「**垫片**」「shim」「薄垫片」 |
 | **覆盖网络节点 · 中继客户端** | `dsh-client` · `<Repo>/lib/net/relay/main.js --client`，由 `overlay-node-daemon.ps1` 监护 | 本机作为**节点**接入覆盖网络：向中继注册（`registered host=… accepted=[20090]`）、维护长连、转发流 | ⛔ 别再叫它「**设备侧 worker**」「worker」「节点进程」 |
 

session-mechanism/references/deploy.md

@@ -112,7 +112,7 @@
 | **L0 技能包级**（每台机器一份） | `<技能包>/env/roots.env`（真文件不入库；样例 `*.example` 入库） | 这台机器的根：`DSH_WS_ROOT`、`DSH_AIROOT`、`WB_RESULT_HOOK_WS`、`COLLABD_PROD_CONFIG`、`CODEBUDDY_CONFIG_DIR`、`DSH_DOCS_ROOT` | **包内脚本**：钩子（`scripts/hooks/*`）、`board.py`、`goalctl.py`、`collabctl.py` |
 | **L1 工作区级**（每工作区一份） | `<工作区>/.workbuddy/collab/collabd.config.json` | 这个工作区自己的东西：`workspace`／`inbox`／`live`／`taskgraph`／`host_db`（可写本机绝对路径）／`peer_workspaces` | **部署副本**：`<ws>/.workbuddy/collab/` 下的 `collabd.py`、`goalctl.py` |
 
-**桥接（谁把两层接起来）**：`scripts/supervise-launch.py`（常驻）与 `scripts/board-launch.py`（看板）。
+**桥接（谁把两层接起来）**：`scripts/supervise-launch.py`（常驻）与 `boards/会话看板/board-launch.py`（看板）。
 计划任务的动作里**没有 env 字段**，所以这两个启动器在**进程内**设
 `COLLABD_CONFIG=<本区>/collabd.config.json` ＋ `CODEBUDDY_CONFIG_DIR`，再 `runpy` 起本体。
 

session-mechanism/references/pitfalls.md

@@ -254,7 +254,7 @@
 
 
 - **形状**：看板是**一个常驻 HTTP 服务**（`board.py --serve <port>`），代码**载入内存后一直跑**。
-  于是**改完 `board.py` ／ `assets/board.html` ／ `board_ext.py`，页面上一点变化都没有** ——
+  于是**改完 `board.py` ／ `boards/会话看板/board.html` ／ `board_ext.py`，页面上一点变化都没有** ——
   服务还是**改之前**那份代码，它**不会自己重载**。
 - **实测**：用户报「看板中协作会话区域**还是**看不到协作会话」。反复核对页面与代码都对得上，
   最后发现**病根是进程**：服务是 **20:24:38** 起的，而改代码发生在 **21:xx**
@@ -302,7 +302,7 @@
 
 - **形状**：用编辑工具换掉一段 `/* … */` 注释时，替换的两端**都没带上结尾 `*/`** ⇒
   新注释与它下面那一行代码**粘连成一条注释**，从那行往下的代码**全被吃掉**。
-- **实测**：`assets/board.html` 改完，`node --check` 只报一句 `SyntaxError: Unexpected token '}'`，
+- **实测**：`boards/会话看板/board.html` 改完，`node --check` 只报一句 `SyntaxError: Unexpected token '}'`，
   并说「多余的 `}` 在 772 行」—— 而**真正的病灶在 ~1000 行**（那里少了一个 `*/`）。
   当场表现为**渲染断言 35 条全红**，看着像"改坏了半个文件"。
 - 🔴 **为什么这个坑难查**：第一反应是数 `{` 和 `}` 的个数。**没用** ——
@@ -992,9 +992,9 @@ GUI 子系统 ⇒ 无 stdout ⇒ **静默无痕**，连"起没起"都查不到
 
 | 改什么 | 要重启吗 | 依据（代码行） |
 |---|---|---|
-| `assets/board.html` | ⛔ **不用**（只需刷新页面） | `board.py:1293` `serve()` 里 `html_p.read_bytes()` —— **每次请求实时读盘**；且 `/board.json` 带 `html_sig`（`mtime.size`）⇒ 页面自动重载 |
-| `scripts/board_ext.py` | ⛔ **不用** | `EXT_CACHE` 按 `(mtime, size)` 签名**热重载**（`board.py:855-870`） |
-| `scripts/board.py` 自身 | ✅ **必须** | 进程里跑的是**启动那一刻载入**的旧代码（P0-17 本体） |
+| `boards/会话看板/board.html` | ⛔ **不用**（只需刷新页面） | `board.py:1293` `serve()` 里 `html_p.read_bytes()` —— **每次请求实时读盘**；且 `/board.json` 带 `html_sig`（`mtime.size`）⇒ 页面自动重载 |
+| `boards/会话看板/board_ext.py` | ⛔ **不用** | `EXT_CACHE` 按 `(mtime, size)` 签名**热重载**（`board.py:855-870`） |
+| `boards/会话看板/board.py` 自身 | ✅ **必须** | 进程里跑的是**启动那一刻载入**的旧代码（P0-17 本体） |
 | `collabd.config.json` | ✅ **必须** | `C = _cfg()` 在 `board.py:81` **模块级执行一次**，⛔ 无 re-read 路径（P0-33 第 1 条） |
 
 **现跑实证**（`tmp/_probe_hotreload.py`，改 `<title>` 插标记再还原，⛔ 未重启任何进程）：
@@ -2351,7 +2351,7 @@ INBOX = '…\ai1net-dsh-server\tmp\supervise-inbox'
   而**计划任务的"动作"里根本没有 env 字段** ⇒ 这个变量只能由**启动器在进程内设**。
 - 🔴 **注意变量名别混**：包内 `roots.env` 提供的是 **`COLLABD_PROD_CONFIG`**，
   而 `board.py` 读的是 **`COLLABD_CONFIG`** —— 名字对不上 ⇒ `roots.env` 兜不住它。
-- ✅ **修法**：新增 **`scripts/board-launch.py`**（启动器）＝先在进程内设
+- ✅ **修法**：新增 **`boards/会话看板/board-launch.py`**（启动器）＝先在进程内设
   `COLLABD_CONFIG=<主区>/.workbuddy/collab/collabd.config.json` ＋ `PYTHONIOENCODING` ＋
   兜住 `sys.stdout/stderr`（pythonw 下可能是 `None`），再 `runpy.run_path(board.py, run_name="__main__")`；
   看板任务的动作改指 **`pythonw.exe board-launch.py`**。