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

+27 -9
View File
@@ -952,15 +952,33 @@
## 7 术语(说话/写文档一律用这一列)
| 正式名 | 实体 |
|---|---|
| **宿主** | WorkBuddy 本体(地基) |
| **主会话** | 工作区入口会话(判断 + 派活) |
| **任务会话** | 被派出去的一次性会话("一棒一线") |
| **常驻程序** | 持有队列、收上报、判定/告警/看板/单例(⛔ 不派活) |
| **投递** | 逐条读队列、发通知与唤醒、机械判定 |
| **看板** | 用户唯一入口 |
| **需求台账** | 常驻程序持有的**唯一**需求状态存放处(**四态**:待执行/执行中/已完成/有阻碍)—— ⛔ 不另开第二处 |
🔴 **本节是术语的唯一天条真源**(2026-10-15 收敛):别处只准引用,⛔ 不许另抄一张表。
实测教训:`collab-detail.md §11` 曾另存一张,把「宿主」写成提供**五样**(含"执行体·会话"),
而本节正文写的是**四样** —— 同一件事两处两说,读的人无从判断谁对。
| 正式名 | 实体 | 旧称/别再叫 |
|---|---|---|
| **WorkBuddy 本体** | 装在本机、跑着会话与技能的那个程序(=地基,⛔ 不是第 6 个主体)。它只提供**四样**:状态(三张只读表)/调度(自动化排期=**唯一能开新会话的通道**)/事件(钩子)/互斥(域锁) | 「宿主」「平台」「服务端」 |
| **主会话** | 工作区入口会话(判断 + 派活) | —— |
| **任务会话** | 被派出去的一次性会话("一棒一线") | 「执行会话」 |
| **常驻程序** | 持有队列、收上报、判定/告警/看板/单例(⛔ 不派活) | 「协作程序」「协作守护程序」「机械层」「判定层」 |
| **投递** | 逐条读队列、发通知与唤醒、机械判定 | 「机械层程序」「看门狗」 |
| **会话** | 执行体:「读—判—写」;一次性、可替换 | —— |
| **棒** | 一次派活 = 一个会话(「一棒一线」) | —— |
| **看板** | 用户唯一入口(只读旁路 · 异步快照) | ⛔ 别把 `digest.md`(机械摘要)当用户入口 |
| **需求台账** | 常驻程序持有的**唯一**需求状态存放处(**四态**:待执行/执行中/已完成/有阻碍)—— ⛔ 不另开第二处 | —— |
| **设备接入 · 本地反代** | `dsh-client` · 真身 `@dsh-client/device-shim`(`127.0.0.1:20090`):只绑回环的 HTTP+WS 反代,进程内注入本机 DSH 的会话凭据 | 「垫片」「shim」「薄垫片」 |
| **覆盖网络节点 · 中继客户端** | `dsh-client` · `<Repo>/lib/net/relay/main.js --client`,由 `overlay-node-daemon.ps1` 监护 | 「设备侧 worker」「worker」「节点进程」 |
### 7.1 写词的规矩(2026-10-15 立 · 口径借 `product-planning` 的语体规范)
- 🔴 **正式名取「读者看得懂」的那个**:界面实显名 > 已确认术语表 > 行业通用词。
技术实现名(进程、锁、数据库)不上正式名 —— 「宿主」指的就是 WorkBuddy 那个进程,属此类 ⇒ 正式名改 **`WorkBuddy 本体`**。
- 🔴 **一个东西一个名**:首次出现写**全称**,之后用上表的正式名;⛔ 不另造简称。
(用户 2026-09-30 明令:「垫片」「worker」这类抽象词禁用,一律写「`系统` · `功能名`」。)
- 🔴 **旧称只作映射**:读到「宿主」「协作程序」「垫片」等旧词 ⇒ 照上表换成正式名。
存量旧文**不动字**(改一处带一片,风险大于收益);**新写的、以及动到那一行时顺手改的**,一律用正式名。
- 📌 判据来源:`product-planning` 的 `references/stage-proto-doc/references/doc-language-spec.md` §2.1–§2.4。
---