From 3105052c510ed21ab2c0c3add4abbdf2b84e3343 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Thu, 15 Oct 2026 21:54:40 +0800 Subject: [PATCH] =?UTF-8?q?docs(tools):=20=E7=94=A8=E8=AF=AD=E8=A7=84?= =?UTF-8?q?=E8=8C=83=E6=89=B9=20M8=E2=80=94=E2=80=94doc=5Fterm=5Faudit=20?= =?UTF-8?q?=E5=90=B8=E6=94=B6=E7=94=A8=E8=AF=AD=E8=A7=84=E8=8C=83=20A=20?= =?UTF-8?q?=E8=A1=A8=2010=20=E8=AF=8D=EF=BC=88=E5=AF=B9=E6=A0=87/=E8=8B=A5?= =?UTF-8?q?=E5=B9=B2/=E4=B8=8D=E5=BE=97/=E6=8A=A5=E9=94=99/buff/=E6=94=B6?= =?UTF-8?q?=E5=8F=A3/=E5=9C=A8=E9=A3=9E/=E5=AF=B9=E6=8B=8D/=E9=94=80?= =?UTF-8?q?=E8=B4=A6=E9=94=80=E5=8F=B7/=E8=90=BD=E6=96=87=EF=BC=89+?= =?UTF-8?q?=E7=94=A8=E8=AF=AD=E8=A7=84=E8=8C=83=E8=8A=82=E5=85=A5=E8=8A=82?= =?UTF-8?q?=E7=BA=A7=E8=B1=81=E5=85=8D+buff=20=E8=A1=8C=E5=86=85=E4=BB=A3?= =?UTF-8?q?=E7=A0=81=E8=AF=AD=E5=A2=83=E8=B1=81=E5=85=8D=EF=BC=9B=E6=9C=AF?= =?UTF-8?q?=E8=AF=AD=E8=A1=A8=E5=AF=B9=E5=A4=96=E5=91=BD=E5=90=8D=E7=BA=AA?= =?UTF-8?q?=E5=BE=8B=20=E4=B8=8D=E5=BE=97=E2=86=92=E7=A6=81=E6=AD=A2?= =?UTF-8?q?=EF=BC=88A=20=E8=A1=A8=E8=87=AA=E6=B4=81=EF=BC=89=E3=80=82?= =?UTF-8?q?=E9=9A=8F=E6=89=B9/=E5=8F=B0=E8=B4=A6=E7=B3=BB=E7=99=BD?= =?UTF-8?q?=E5=90=8D=E5=8D=95=E4=BF=A1=E5=8F=B7=E8=87=AA=E8=B1=81=E5=85=8D?= =?UTF-8?q?=E4=B8=8D=E5=88=97=E6=89=AB=EF=BC=8C=E6=B3=A8=E9=87=8A=E5=9C=A8?= =?UTF-8?q?=E6=A1=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/gdd/术语表.md | 2 +- tools/doc_term_audit.py | 19 +++++++++++++++++-- 2 files changed, 18 insertions(+), 3 deletions(-) diff --git a/design/gdd/术语表.md b/design/gdd/术语表.md index ce3f69ee..12828cc0 100644 --- a/design/gdd/术语表.md +++ b/design/gdd/术语表.md @@ -133,7 +133,7 @@ | 规则 | 内容 | |---|---| -| 禁用字面 | 「雷」「插旗」及相关字面（雷格/踩雷/插旗/旗）**不得进入对外命名**——「扫雷插旗」仅系内部开发用语，对外世界观=探索地下城/挖掘地下城 | +| 禁用字面 | 「雷」「插旗」及相关字面（雷格/踩雷/插旗/旗）**禁止进入对外命名**——「扫雷插旗」仅系内部开发用语，对外世界观=探索地下城/挖掘地下城 | | 插旗的对外表达 | **封印**（件名示例：封印桩/封印回响/封印匠/封印爆裂） | | 危险格的对外风味 | **地下城陷阱 / 怪物巢穴**（巢穴仅限世界观风味层使用——产品名清巢者出处、美术纹样名；机制表述仍用危险格） | | 连锁展开的对外表达 | **坍塌显形**：挖穿薄壳、整片松动地面塌陷露出（00 篇巢穴隐喻轴定名；机制文档内部仍用连锁展开） | diff --git a/tools/doc_term_audit.py b/tools/doc_term_audit.py index 44d43632..4ba17894 100644 --- a/tools/doc_term_audit.py +++ b/tools/doc_term_audit.py @@ -43,6 +43,19 @@ RETIRED_TERMS = [ ("道具窗口|可选类道具|已消耗未生效|使用被拒|窗口打开锚行|窗口跳过锚行", "2026-09-15", "（随可选类道具整体删除）", "格面资源批"), ("雾格", "2026-09-14", "（雾格移除）", "不做清单"), ("兄弟精", "2026-09-26", "L2 熊地精（bugbear 复用）", "变体名未经批准退役批——用户质问查证后全仓清除"), + # —— 用语规范（2026-10-15 用户令）：权威=design/gdd/术语表.md「用语规范」A 表，机器闸吸收 —— + # 注意：「随批」「台账」两词本身是上方行级白名单信号（行内出现即归留档类），对其扫描会自豁免， + # 故不列入；「收口」「在飞」等照常扫描。术语表「用语规范」节已加入节级豁免（词表自身不命中）。 + ("对标", "2026-10-15", "参照", "用语规范 A 表（STC 1.7）"), + ("若干", "2026-10-15", "写具体数值或写明数值出处", "用语规范 A 表（STC 5.4）"), + ("不得", "2026-10-15", "禁止", "用语规范 A 表（STC 词表）"), + ("报错", "2026-10-15", "名词用错误；动词用返回错误/显示错误", "用语规范 A 表（STC 词表）"), + (r"\bbuff\b", "2026-10-15", "增益", "用语规范 A 表（STC 1.1）"), + ("收口", "2026-10-15", "完成/合并进 master", "用语规范 A 表（doc-conventions 第 4 节）"), + ("在飞", "2026-10-15", "正在执行中", "用语规范 A 表（doc-conventions 第 4 节）"), + ("对拍", "2026-10-15", "与基线数据逐项比对", "用语规范 A 表（doc-conventions 第 4 节）"), + ("销账|销号", "2026-10-15", "注销", "用语规范 A 表（doc-conventions 第 4 节）"), + ("落文", "2026-10-15", "写入文档/已写入", "用语规范 A 表（doc-conventions 第 4 节同族）"), ] DEFAULT_DIRS = ["design/gdd", "design/registry"] @@ -53,6 +66,8 @@ DEFAULT_DIRS = ["design/gdd", "design/registry"] # 使用次数账，迭代 11 起在役）系现行机制共用该词——秘宝/同调/主动件等语境不算命中。 TERM_CONTEXT_EXEMPT = { "充能": re.compile(r"秘宝|同调|主动件|每冒险|冒险开始|充能账|充能维护|attunement"), + # buff：反引号行内代码（字段/键名）原样保留（STC 6.2），只查散文用词 + r"\bbuff\b": re.compile(r"`[^`]*buff[^`]*`"), } # 行级白名单信号：命中任一即归"留档类" @@ -62,8 +77,8 @@ WHITELIST_RE = re.compile( r"|\bv0\.\d+" r"|修订记录|版本历史|履行回执|台账" ) -# 节级白名单：版本历史/修订记录节内整段豁免 -SECTION_RE = re.compile(r"^#{1,6}\s*(版本历史|修订记录)") +# 节级白名单：版本历史/修订记录/用语规范节内整段豁免（用语规范节的不用列是内容本身） +SECTION_RE = re.compile(r"^#{1,6}\s*(版本历史|修订记录|用语规范)") COMMENT_RE = re.compile(r"^\s*[;#]")