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

+39
View File
@@ -7881,5 +7881,44 @@ def t_skill_entry_triggers_same_source():
return rows
@case("🔴 术语表只能有一处正本(⛔ 两处必打架 —— 2026-10-15 实测「五样/四样」)")
def t_term_table_single_source():
"""🔴 2026-10-15 立(本轮整改"宿主"一词时实测踩到)。
判据来源:`references/06-技能优化规程.md` 的 **B⑥ 单一真源**。
实测:`architecture.md §7` 与 `collab-detail.md §11` 各存一张术语表,
且对「宿主」给出不同内容 —— 一处写提供**四样**、一处写**五样**(多"执行体·会话")。
已收敛:`architecture.md §7` 是唯一正本,`collab-detail.md §11` 改为指针。
⇒ 判据落在**全包只有一处**带 `| 正式名 |` 表头的表,且那处必须是 `architecture.md`。
"""
rows = []
hits = []
for p in sorted((HERE.parent / "references").glob("*.md")):
try:
t = p.read_text(encoding="utf-8", errors="replace")
except Exception:
continue
n = t.count("| 正式名 |")
if n:
hits.append((p.name, n))
try:
sk = (HERE.parent / "SKILL.md").read_text(encoding="utf-8", errors="replace")
if sk.count("| 正式名 |"):
hits.append(("SKILL.md", sk.count("| 正式名 |")))
except Exception:
pass
rows.append(("带术语表表头的文件数(应=1,实测 %d:%s)"
% (len(hits), ", ".join(a for a, _ in hits) or "无"), len(hits) == 1))
rows.append(("唯一那处是 architecture.md(术语正本)",
bool(hits) and hits[0][0] == "architecture.md"))
rows.append(("术语表里已没有「宿主」当正式名(应改成 WorkBuddy 本体)",
bool(hits) and "| **宿主** |" not in
(HERE.parent / "references" / "architecture.md")
.read_text(encoding="utf-8", errors="replace")))
return rows
if __name__ == "__main__":
sys.exit(main())