From 5a292859ba67d693da0ee9fd7dd0084118c07aa4 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 11 Oct 2026 16:57:42 +0800 Subject: [PATCH] =?UTF-8?q?docs(fix):=20=E5=AE=9A=E6=97=B6=E6=A3=80?= =?UTF-8?q?=E6=9F=A5=E5=91=88=E6=8A=A5=E9=A1=B9=E2=91=A3=E2=91=A5=E4=BF=AE?= =?UTF-8?q?=E5=A4=8D=EF=BC=88roadmap=E5=BD=93=E5=89=8D=E4=BD=8D=E7=BD=AE?= =?UTF-8?q?=E8=8A=82=E6=8D=A2=E4=BB=A3+doc=5Fterm=5Faudit=E5=85=85?= =?UTF-8?q?=E8=83=BD=E8=AF=8D=E4=B9=89=E8=B1=81=E5=85=8D=EF=BC=9B=E7=BA=AF?= =?UTF-8?q?=E6=96=87=E6=A1=A3=E9=9B=B6=E6=B5=8B=E8=AF=95=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ④roadmap.md「当前位置」节 2026-09-29→2026-10-11 刷新：旧节停在 M-2/M-3 时代（已达成/挂起清单全是已闭项）且把 stage.txt 当现行阶段引用——重写为当下事实（里程碑语义换代注指针 M3=Alpha完整实现现行/M4=Beta不排期；迭代19五卡已入库+迭代20头卡待发令+21/22冻结；近期主战场=文档治理连续批+下一前沿=专长/秘宝实装批写卡与迭代20卡A；实时状态归 active.md 快照节，stage.txt 定性旧开关仅存档） ⑥doc_term_audit.py 词级语境豁免机制：充能词条退役的只是挖掘期/战斗段充能（2026-09-19），秘宝主动件「每冒险充能」（同调件使用次数账，迭代11起在役）系现行机制共用该词——新增 TERM_CONTEXT_EXEMPT（充能行含秘宝/同调/主动件/每冒险等语境信号即不算命中）；疑似现行 20→3（=iter19 基线三元组，定时检查不再每轮误报 17 处） 闸：lint 2 不通过（=06/07 基线存量）/死链 1（=数据配置221 存量）+06:505 worktree 环境假象/term 疑似 3（基线）/熵增 PASS --- roadmap.md | 10 +++++----- tools/doc_term_audit.py | 12 ++++++++++++ 2 files changed, 17 insertions(+), 5 deletions(-) diff --git a/roadmap.md b/roadmap.md index 3397c282..706871b4 100644 --- a/roadmap.md +++ b/roadmap.md @@ -21,12 +21,12 @@ | 2026-09-28 | **M-2 关卡画面独立化完成（迭代 3+4 已入库，出口闸目检通过）**：独立屏 LevelMapScreen+独立性断言（状态记录 224）/关卡画面样张 v1 机检 11/11 冻结+节点图标组接线+终稿落码+换层挂点（art-bible v2.14，状态记录 225）；出口检查单 `design/qa/m2-exit-gate-checklist-2026-09-28.md` 用户八项目检通过（状态记录 227） | | 2026-09-29 | **迭代重排（用户裁决「内容逻辑闭环先于验收」）**：M-3 更名「数值标定与 Alpha 创建」——战斗演出完善前移迭代 6、魔法道具+元进度标定编入迭代 7、Alpha 验收后移迭代 8；M-4 转 Alpha 后深化与内容扩展（本批，状态记录 242） | -## 当前位置（2026-09-29） +## 当前位置（2026-10-11 刷新） -- **阶段**：Vertical Slice Implementation（`stage.txt`） -- **已达成**：一局完整三关冒险+存档+元进度+营地闭合（数值 provisional，归 M-3 调参批标定）；**M-1 切片表现收口关闭**（初步验收 2026-09-28，出口检查单 `design/qa/m1-exit-gate-checklist-2026-09-28.md`）；**M-2 关卡画面独立化关闭**（出口闸 2026-09-28 通过，出口检查单 `design/qa/m2-exit-gate-checklist-2026-09-28.md`）；UX 文档面四 spec 齐（battle / level-map / level-clear / interaction-patterns） -- **挂起待用户输入（批次解锁点）**：① 真人试玩批次（并入 M-3 迭代 5 读数）——已解闸存档：M-1 出口闸目检（2026-09-28 通过）；**M-2 出口闸目检（2026-09-28 通过，八项全过）**；ADR-0007 裁决（裁丙，状态记录 210）；高墙档=D 投影+字体=Fusion Pixel OFL；样张 v1 否决原因四条（已断言化，样张 v2 冻结）；关卡画面独立形态（2026-09-28 用户裁决——M-2 立项依据） -- **已知挂账**：魔法道具内容批（迭代 7 承接，node-reward spec 随批出生）；元进度柜台定价标定（迭代 7）；反制批 Alpha（M-4）；迭代 5 出口三件**已全闭**（2026-09-30 收口批状态记录 290——目检 15/15 过/带改普通 L2 [10,15]+丙追认/荆棘外延否决根因改判）；完美 L1 越带处置已并入带换代承接（难度曲线与Boss.md 带换代节：落带收敛归全局难度批、M-4 排序——先带 D 悬崖修复后带值收敛；原「战斗阶段数值问题」06 条目随四带换代收口移除） +- **里程碑语义（2026-10-09 立规换代，详见下方里程碑表的换代注）**：现行里程碑 = **M3「Alpha 版本的完整实现」**——用户未明令宣布完成前停留 M3，迭代只排 M3 需求；M4=Beta 版本的完整实现，一律不排期。下文里程碑表的旧编号（M-3/M-4）保留作历史序列，语义以本节为准。 +- **迭代进度**：迭代 19 五卡全部已入库（2026-10-08，批末闸全绿）；迭代 20 尚未开工（头卡=主菜单开局缺陷修复批四件已立，待用户发令）；迭代 21/22 规划冻结（2026-10-09 用户令，重启=用户直接发令）。 +- **近期主战场**：文档治理与设计换代连续批（秘宝/奇物正文换代、件表扩容、全库术语统一、天赋树 v0.4、武器锻造成文），批次详情见 git 提交史；下一前沿=专长与秘宝实装批写卡、迭代 20 卡A，均待用户发令。 +- **实时状态**：以根目录 [active.md](active.md) 顶部「当前状态快照」节为准（`stage.txt` 已定性为旧阶段开关，仅存档）。 ## 主线路线（里程碑 × 迭代序列） diff --git a/tools/doc_term_audit.py b/tools/doc_term_audit.py index d30652c2..44d43632 100644 --- a/tools/doc_term_audit.py +++ b/tools/doc_term_audit.py @@ -47,6 +47,14 @@ RETIRED_TERMS = [ DEFAULT_DIRS = ["design/gdd", "design/registry"] +# 词级语境豁免：某词退役的只是特定机制语境，另一现行机制合法沿用同一词时， +# 命中行含豁免语境信号即不算退役词命中（不进疑似、不进留档计数）。 +# 充能：挖掘期/战斗段充能退役（2026-09-19），但秘宝主动件「每冒险充能」（同调件 +# 使用次数账，迭代 11 起在役）系现行机制共用该词——秘宝/同调/主动件等语境不算命中。 +TERM_CONTEXT_EXEMPT = { + "充能": re.compile(r"秘宝|同调|主动件|每冒险|冒险开始|充能账|充能维护|attunement"), +} + # 行级白名单信号：命中任一即归"留档类" WHITELIST_RE = re.compile( r"2026-\d{2}-\d{2}" @@ -70,6 +78,10 @@ def scan(paths): if SECTION_RE.match(line): in_version_section = True hits = [(m.group(0), t) for t in terms for m in [t[0].search(line)] if m] + hits = [ + (word, t) for (word, t) in hits + if not (t[0].pattern in TERM_CONTEXT_EXEMPT and TERM_CONTEXT_EXEMPT[t[0].pattern].search(line)) + ] # 上一 2 行带留档/作废/历史标记（如"下表留档作废"头注）→ 本行视为留档 prev = " ".join(prev_lines[-2:]) if prev_lines else "" prev_lines.append(line)