session-mechanism:术语表收敛到一处 + 「宿主」改正式名 WorkBuddy 本体

用户令:「宿主 这个词要优化,看看产品规划技能中是如何优化这些难懂的词」。
口径借 product-planning 的语体规范(references/stage-proto-doc/references/doc-language-spec.md
§2.1–§2.4):技术实现名不当正式名;正式名取界面实显名/术语表/行业通用词;一个东西一个名;首次出现给全称。

- architecture.md §7 立为「术语唯一天条真源」:正式名「宿主」→「WorkBuddy 本体」,表加「旧称/别再叫」列,
  并入 collab-detail §11 的独有条目(设备接入·本地反代/覆盖网络节点·中继客户端/棒/会话);新增 §7.1 写词的规矩。
- collab-detail.md §11 的两张表删除、改为指针。实测打架:§11 写「宿主提供五样(含执行体·会话)」,
  而 architecture.md 与 collab-detail §1 都写「四样」⇒ 同一条两处两说。§11.1 命名铁律原文保留。
- SKILL.md:description 的悬空指向「见文首术语表」(本包从没有术语表)改为「见 architecture.md §7 术语」;
  「现状地图」首屏加一行「宿主 = WorkBuddy 本体」。
- 01-文档索引.md 加一行(看不懂的词 → architecture §7);06 的 B⑧ 加术语正本指针。

新增自测 t_term_table_single_source(3 项):全包只许一处 `| 正式名 |` 表头且必须是 architecture.md、
正本里不许再出现「| **宿主** |」。已做变异对照(塞第二张表 ⇒ 报红;复原 ⇒ 绿)。
This commit is contained in:
admin committed 2026-10-15 23:46:16 +08:00
1 parent ed9ed847bd
commit a46b914a80
6 files changed
+77 -23

No files matched your search

+4 -13
View File
@@ -919,20 +919,11 @@ headless chrome /附着用户 Chrome** ⇒ **不许擅自开浏览器**。但"
---
## 11 🔴 术语表(**说话/写文档一律用「正式名」这一列**)
## 11 🔴 术语表
> 2026-09-29 用户指出"宿主是什么/机械程序又是什么,之前只提过**投递**和**常驻程序**" —— 属实:**同一个程序在文件里有 4 个名字**,图当然读不懂。**以本表为准。**
| 正式名 | 实体(在哪) | 干什么 | ⛔ 别再叫它 |
|---|---|---|---|
| **宿主** | WorkBuddy 本体 | 提供五样:状态(只读 3 表)/**调度**(自动化排期)/**事件**(钩子)/执行体(会话)/互斥(域锁) | 「平台」「服务端」 |
| **投递** | `advance-watch.py`(`.workbuddy/tools/`) | 零 token 机械判定:直读 `automation_runs`、判靶点/锁,写 `advance.md` + `needs-ai.json`。⛔ 不派活/不开会话/不联网/不读口令 | 「机械层程序」「机械程序」「看门狗」 |
| **常驻程序** | `collabd.py`(自述"协作守护程序") | 队列闸门(`NEXT.md`)+ **唤醒投递** + 证据分级/真空/断链告警/体检/看板覆写。**⛔ 不做派活** | 「判定层」「常驻程序」「机械层」 |
| **会话** | `sessions` 表 | 执行体:「读—判—写」;**一次性**、可替换 | —— |
| **棒** | 一次派活 = 一个会话 | 同一件事的执行单位(「一棒一线」) | —— |
| **看板** | `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」「节点进程」 |
> 🔴 **正本已收敛到一处**(2026-10-15):术语表**只有一份** ⇒ `references/architecture.md §7 术语`(说话/写文档一律用那一列)。
> 本节不再维护表格 —— 曾因两处各存一张而打架:本节写「宿主提供**五样**(含执行体·会话)」,而 `architecture.md §7` 与本节 §1 都写**四样**。
> 本节只保留**不在正本里**的那部分 ⇒ 下面是 §11.1 命名铁律原文(用户 2026-09-30 明令)。
### 11.1 🔴 命名铁律(用户 2026-09-30 明令)