裁定记录:关键词普查原未定 25 项
依据:所有者 2026-10-24 的三种允许做法;集成者 R1–R10;来源身份和基线见 总纲。本页保留原推荐,并记录 2026-10-24 的裁定。U01–U18、U21–U23、U25 由集成者(模型负责人)按推荐裁定;U19、U20、U24 由所有者裁定。裁定不修改原普查的 A/B/C/D 计数,也不表示运行时已整改。
- 分支和工作树:本次
keyword-remediation-pages,目录circle-hub-keyword-pages;裁定记录补在本页,后续实现进入各责任任务分支,不在此分支改代码。 - 可以改的路径:仅本页及同批
kw-*.md的依赖/依据链接;不改原普查、源代码、模型或真实数据。 - 模型先做:通用值已有情况与缺口见总纲 M0–M11;没有正式 grammar/identity 政策不能靠生成新标签解决。本页裁定已齐,由集成者更新模型条文/闭集,再分派实现。
- 测试/验证:裁定前各项只是待实现回归场景,不记通过;实施后逐项改前失败、改后通过,只用合成原件。本文档用
npm run test:docs检查;业务验证归各责任页。
逐条推荐与已定结论
U01:推荐 B 要改
- 普查位置:
packs/product/famx/functions/command-tree.ts:117。 - 原问题:检查/分类:optional 字段 yes/y/true/1 同义映射,未知按必填或 false。
- 理由与允许边界:optional 的多个拼写目前只有实现容错,缺权威来源支持,删同义映射和未知默认必填;如以后给出正式语言语法,再单独裁定 C。
- 后续任务、测试与模型碰头:R4;M4;把非法 optional 变结构违规,合成 yes/y/true/1 与未知字面量各有测试。
- 裁定:B 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U02:推荐 B 要改
- 普查位置:
scripts/real/gold/command-diff.ts:120。 - 原问题:检查/分类:optional 字段 yes/y/true/1 同义映射,未知按必填或 false。
- 理由与允许边界:gold 同源复制 optional 容错,不能以独立实现替代权威布尔语法。
- 后续任务、测试与模型碰头:R9 依赖 R4;独立解析冻结 optional grammar,不读生产映射。
- 裁定:B 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U03:推荐 B 要改
- 普查位置:
scripts/real/gold/compile-check.ts:406。 - 原问题:检查/分类:optional 字段 yes/y/true/1 同义映射,未知按必填或 false。
- 理由与允许边界:compile gold 的 optional 别名不是新版合约证明;按结构 schema 精确值读。
- 后续任务、测试与模型碰头:R9;缺声明不能 false/必填兜底。
- 裁定:B 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U04:推荐 B 要改
- 普查位置:
scripts/real/gold/catalog-marks.ts:116。 - 原问题:检查/分类:optional 字段 yes/y/true/1 同义映射,未知按必填或 false。
- 理由与允许边界:catalog gold 同样接受别名;optionalRaw 只披露未消除先行映射。
- 后续任务、测试与模型碰头:R9;未知值停在结构错误/未核,不判合法签名。
- 裁定:B 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U05:推荐 B 要改
- 普查位置:
scripts/real/gold/command-domains.ts:43。 - 原问题:检查/分类:optional 字段 yes/y/true/1 同义映射,未知按必填或 false。
- 理由与允许边界:domains gold 的 optional 同义映射需与其他 oracle 同步删。
- 后续任务、测试与模型碰头:R9;独立精确解析,变体不得悄悄等价。
- 裁定:B 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U06:推荐 A 要改
- 普查位置:
packs/product/famx/functions/ids.ts:14。 - 原问题:待核:编号数字及分隔语法可以是 C;但该正则显式容错 but/bugt/ro/c[a-z]{0,5},注释仅说从真实标题见过,未见作者授权的正式 grammar。先不把整段列为允许。删除错拼猜测,给版本化 grammar;超出 grammar 的由模型带引文提编号,重算 3/6 及来源绑定。
- 理由与允许边界:but/bugt/ro 和 c[a-z]{0,5} 是错拼猜测,不因写在注释里变成正式 grammar;保留单独声明的完整编号语法。
- 后续任务、测试与模型碰头:R6/R9;变体留未关联,不提同种缺陷 id;正式 grammar 给 source/version。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U07:推荐 A 要改
- 普查位置:
packs/workflow/case-location/functions/ids.ts:1。 - 原问题:待核:同样混有声明编号 grammar、回归前缀、年份/单位/CJK 排除;语法与启发式需拆分,不能整文件许可。影响能力 3/6。
- 理由与允许边界:编号 grammar 与回归词、单位/CJK/年份排除混在一起;移除这些文字启发式,显式字段优先。
- 后续任务、测试与模型碰头:R6;同数字在散文中不自动定 kind;未知附补编号出口。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U08:推荐 A 要改
- 普查位置:
scripts/real/gold/locations.ts:67。 - 原问题:待核:独立编号 oracle 同样带错拼与活动前缀、单位/CJK 排除,不能仅因不 import pack 就独立正确。语法外用独立标注。
- 理由与允许边界:locations 的独立 oracle 复刻文字排除同样违反 R9。
- 后续任务、测试与模型碰头:R9;独立完整目录/编号 grammar 与冻结语义标注,不复刻错拼表。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U09:推荐 A 要改
- 普查位置:
scripts/real/gold/trace-stories.ts:9。 - 原问题:待核:同上;影响能力 6 的需求追溯。需版本化正式编号语法或独立带引文标注。
- 理由与允许边界:trace-stories 的错拼标记和单位/日期语义排除不算权威编号来源。
- 后续任务、测试与模型碰头:R9;追溯用明确 story 字段或预标引用。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U10:推荐 A 要改
- 普查位置:
scripts/real/gold/cases.ts:95。 - 原问题:待核:bug-to-case 错拼扩展不能凭函数注释认定正式 grammar;影响缺陷 join。与 vague/negative 两项独立计数。
- 理由与允许边界:gold/cases 的 bug 文本容错不能证明缺陷关联完整。
- 后续任务、测试与模型碰头:R9;保留 rawId 数字语法与边界声明,删除错拼猜类。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U11:推荐 A 要改
- 普查位置:
scripts/real/gold/id-text.ts:10。 - 原问题:待核:数字长度和边界是 grammar;跳日期/年月/字母等约束是否是作者声明未核准,需语法来源,不直接判 C。
- 理由与允许边界:id-text 的数字解析可保留为 C 的子规则,但当前日期/年/月/字母排除用来猜是否编号,整条推荐 A。
- 后续任务、测试与模型碰头:R9;声明数字 grammar 与上下文独立标注分开,非语法外形不得推出类型。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U12:推荐 A 要改
- 普查位置:
packs/product/famx/functions/manual.ts:154。 - 原问题:待核:粗体/斜体、占位符和完整命令树身份部分是结构;但 CJK 拒绝和样式猜测是否构成完整权威签名 grammar 尚缺证据,不能把整段抽取等同权威结构。
- 理由与允许边界:以粗体/英文/CJK 外形决定命令身份违反 R4;格式只能给候选结构跨度,完整树解析才认命令。
- 后续任务、测试与模型碰头:R4;不得按样式或 CJK 排除决定 catalog 身份。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U13:推荐 A 要改
- 普查位置:
packs/product/famx/functions/adoc/k1-model.ts:143。 - 原问题:待核:AsciiDoc AST 是 D;命令签名的 GROUP/WORD 与强调/字面 code 到命令身份的规则仍须补手册正式 grammar。不能靠英文外形证明命令。
- 理由与允许边界:AsciiDoc AST 解析本身允许;GROUP/WORD/强调形状不能证明命令,完整锁定树解析才可。
- 后续任务、测试与模型碰头:R4;保持 AST 来源跨度,移除外形推命令分支。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U14:推荐 A 要改
- 普查位置:
scripts/real/gold/catalog-marks.ts:63。 - 原问题:待核:XML 属性引号的 tail 外形恢复可能接受非完整真实语法,需对比来源声明的受支持 XML grammar;失败应报结构缺口,不能靠猜属性边界提升目录准确率。
- 理由与允许边界:按 tail 外形猜未闭合 XML 引号会改变原声明结构,推荐去容错而非当解析成功。
- 后续任务、测试与模型碰头:R4/R9;受支持 grammar 完整解析,畸形 XML 报结构缺口;如确有非标准 grammar 先给权威出处再审。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U15:推荐 C 允许
- 普查位置:
hub/rules/interpreters/pattern.ts:1。 - 原问题:待核:通用 pattern 引擎本身是机制;只可用于已声明标识符/语言 grammar,不能用于自由文本语义。现有调用表需绑定 grammar/source 以防重引入。
- 理由与允许边界:仅作为显式声明 grammar 的引擎允许;每次调用有语法/版本/出处并限长,不许用于自由文本语义。
- 后续任务、测试与模型碰头:M0/M4;用在文本类别检查仍是 A,不能整文件豁免;测试语法字段类型/作用域。
- 裁定:C 允许(只限本项写明的结构用途,不豁免整个文件或自由文本判定)。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U16:推荐 C 允许
- 普查位置:
hub/rules/interpreters/membership.ts:1。 - 原问题:待核:member/mapping/prefix 机制需逐输入区分:闭集字段相等允许,自由文本包含和前缀语义禁止。不能按解释器名判断合规。
- 理由与允许边界:闭集字段精确 membership、正式路径 grammar 的 prefix 允许;这里 C 是通用结构规则用途,原报告机制分类 D 不因此变全文件许可。
- 后续任务、测试与模型碰头:M0;对正文 contains/前缀判类仍 A,对声明字段 synonym mapping 仍 B;分别列调用范围。
- 裁定:C 允许(只限本项写明的结构用途,不豁免整个文件或自由文本判定)。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U17:推荐 A 要改
- 普查位置:
hub/knowledge/calibration.ts:149。 - 原问题:待核:正则遮蔽影响模型输入和校准,但本身不输出语义判定;是否纳入这次禁止范围须明确。建议使用权威 AST/精确跨度遮蔽,并重新校准;packs/workflow/knowledge-contribution/tools/jev/lib/calibration.ts 有同类副本。
- 理由与允许边界:maskLiterals 用关键词/词边界改写判断输入,影响校准和召回,推荐改为权威 AST 或显式原文跨度遮蔽。
- 后续任务、测试与模型碰头:补充结构证据页;同改 Hub 与 jev 副本并重校准;实施路径由集成者另行分派。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U18:推荐 A 要改
- 普查位置:
scripts/real/lib/circle-session.ts:13。 - 原问题:待核:终端画面正则猜 busy/composer 属运行状态观察,非业务文本,但用于验收等待而非权威完成回执;不可据此证明任务完成。应改结构化状态/结果身份,不能把 UI 可见当结果。
- 理由与允许边界:busy/composer 由画面关键词猜状态不能作为验收完成事实;采样可保留为 UI 观察,完成以结构回执。
- 后续任务、测试与模型碰头:R9/补充结构证据页;先补协议完成身份,禁止因 busy 消失判通过。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U19:推荐 需要所有者
- 普查位置:
packs/system/openkm/functions/webdav.ts:331。 - 原问题:待核:名称检索词的命中数及罕见度排序控制取前五个来源,不直接判业务;按严格禁止“抽取/分类”理解有问题。manual-store/functions/webdav.ts 为同类。改模型带引文提检索候选,结果只作线索,来源召回另验证。
- 原推荐及裁定差异:原建议将检索边界交所有者;现已明确连候选来源选择也禁止关键词检索,不保留“只作线索”入口。
- 后续任务、测试与模型碰头:R6/R9;删除文件名/标题关键词评分和 top-N 候选入口;合成测试验证检索结果完全不能进入输入列表,也不能支持任何查全结论;显式 id 或带逐字引文、经 Hub 核验的模型候选可进入。
- 裁定:A 要改;关键词检索选候选来源一律禁止。输入来源只来自显式声明的来源 id,或模型带逐字引文提出、经 Hub 核验的候选;关键词检索结果不作任何输入或查全依据。
- 裁定来源:所有者,2026-10-24。实施状态:未实施,按责任任务分派。
U20:推荐 需要所有者
- 普查位置:
packs/system/agile-platform/functions/agile.ts:564。 - 原问题:待核:标题关键词打分取历史文档,影响评审输入召回;检索与语义判定边界待明确。不得当全量来源证明。
- 原推荐及裁定差异:原建议将检索边界交所有者;现已明确连候选来源选择也禁止关键词检索,不保留“只作线索”入口。
- 后续任务、测试与模型碰头:R6/R9;删除文件名/标题关键词评分和 top-N 候选入口;合成测试验证检索结果完全不能进入输入列表,也不能支持任何查全结论;显式 id 或带逐字引文、经 Hub 核验的模型候选可进入。
- 裁定:A 要改;关键词检索选候选来源一律禁止。输入来源只来自显式声明的来源 id,或模型带逐字引文提出、经 Hub 核验的候选;关键词检索结果不作任何输入或查全依据。
- 裁定来源:所有者,2026-10-24。实施状态:未实施,按责任任务分派。
U21:推荐 A 要改
- 普查位置:
tools/gen-contracts.ts:221。 - 原问题:待核:用有无 CJK 字符检查“Chinese text”是语言外形启发式,不是内容语义;如规矩涵盖文案语言检查,改作者 locale 声明/模型评审。STAR_EXPORT/TYPE_DECLARATION 正则也不是完整 TS grammar,宜用已有 TS AST。
- 理由与允许边界:含 CJK 即中文是语言外形猜测;STAR_EXPORT/TYPE_DECLARATION 正则识别 TS 也不能代替真实 AST。
- 后续任务、测试与模型碰头:补充结构证据页;语言由作者显式 locale/模型主张,源码导出结构改 TS AST;语法 ID 规则仍 C。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U22:推荐 A 要改
- 普查位置:
packs/product/lumen-api/functions/endpoints.ts:21。 - 原问题:待核:示例产品表格 values 字段中出现“可选”就设 optional;文件头声称是 grammar,但未给完整范围/枚举/可选组合语法。若正式声明该结构语言可按 D,否则属 A;优先拆显式 optional 布尔字段。
- 理由与允许边界:values 散文出现“可选”就设 optional,缺完整声明语法;拆显式 optional 布尔/精确类型字段,不从词提取。
- 后续任务、测试与模型碰头:R4;示例产品同受规矩约束,合成“并非可选”等不得误判。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U23:推荐 B 要改
- 普查位置:
packs/system/plm/functions/plm.ts:235。 - 原问题:待核:产品名称 NFKC、大小写、斜杠别名匹配;有显式 aliases 语法来源可 D,否则为声明字段同义映射 B。最稳用产品 id 精确绑定。
- 理由与允许边界:对产品声明名字做宽窄/大小写/斜杠别名归并不满足身份完全相等;推荐产品 id 或显式 alias identity schema 精确解析。
- 后续任务、测试与模型碰头:R6;未经正式 alias grammar 裁定不合并;不同精确 id 永不靠名字相似合并。
- 裁定:B 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
U24:推荐 需要所有者
- 普查位置:
packs/product/famx/functions/naming.ts:86。 - 原问题:待核:去前导零/末尾 .0 合并版本身份需要权威版本规范;它不是简单的身份完全相等。列为待核,不能把该合并当 C 的自动许可。
- 原推荐及裁定差异:原建议等所有者决定版本身份等价,现已获明确命名规则;版本线的前导零与末尾 .0 是同一版本线的允许写法,不推广到不同构建 id 或产品 alias。
- 后续任务、测试与模型碰头:R6/M6/R9;规则进入 FAMX README 与 naming 文件头,按语法对数字段解析、去前导零并处理末尾零段;合成验证等价写法归同一版本线,不同非零数字段不合并;独立 gold 按同一声明语法另写解析。
- 裁定:C 允许;版本线末尾 .0 和前导零不改变版本线,按 FAMX 包显式命名规则解析,不是启发式。将规则写入包 README 和 functions/naming.ts 文件头。
- 裁定来源:所有者,2026-10-24。实施状态:未实施,按责任任务分派。
U25:推荐 A 要改
- 普查位置:
hub/rules/quote-width.ts:45。 - 原问题:待核:现有引文宽窄/空白正规化是否满足本次“逐字”要求未得到新规则豁免;case-compile/quote-width.ts、gold/quote-widths.ts 有独立副本。需冻结原字节+精确跨度,比对时不能吞掉有意义差异。
- 理由与允许边界:逐字引用默认原始文本序列精确;宽窄、空白吞并能接受非逐字片段,推荐关闭该同义正规化。
- 后续任务、测试与模型碰头:B03/M0;编码解码与换行 grammar 单独声明,原字节身份仍保存;Hub/compile/gold 三处共同验证,同义字符反例必须失败。
- 裁定:A 要改。
- 裁定来源:集成者(模型负责人),2026-10-24。实施状态:未实施,按责任任务分派。
裁定分布与分派边界
已裁定 C 允许 3 项(U15、U16 仅限各自结构用途;U24 为所有者声明的 FAMX 版本线命名规则);A 要改 16 项;B 要改 6 项。25 项均有来源与日期,无待定项。原普查仍保留原未定清单和旧计数,不改历史。
各实现任务按本页裁定落实;模型负责人先更新契约,R4/R6/R9/补充页各收自己范围,公共 parser、系统包、校准和 UI 驱动的实施路径由集成者明确分派。裁定不等于实现或新验收已经通过。安全扫描仍按 R8 保留防护;旧结果按 R10 追加受影响声明,不改字节。