Skip to content

fix(parsers): 恢复中英文双语解析,修复中文规范无法校验的回归 (#31)#32

Merged
studyzy merged 1 commit into
studyzy:mainfrom
HerbertGao:contrib/bilingual-parsing-issue-31
Jul 13, 2026
Merged

fix(parsers): 恢复中英文双语解析,修复中文规范无法校验的回归 (#31)#32
studyzy merged 1 commit into
studyzy:mainfrom
HerbertGao:contrib/bilingual-parsing-issue-31

Conversation

@HerbertGao

Copy link
Copy Markdown

问题

合并上游 v1.5.0 后,解析/校验层退回为仅匹配英文关键字,导致中文标题的 spec/change 解析出 0 个需求,无法 validate / list / archive —— 即 #31

根因:v1.5.0 合并后重做汉化时,只翻译了面向用户的提示文案,漏掉了 1.4.1 里的中英文双语匹配逻辑,结果结构关键字匹配退回成"仅英文"。

修复

按 1.4.1 的双语逻辑恢复匹配层(仅补匹配逻辑,不改现有中文提示文案):

文件 恢复内容
parsers/markdown-parser.ts 目的/需求/为什么/变更内容 章节回退;中文 delta 操作识别(并把 1.4.1 过宽的裸 收窄为 新增|新建,避免 更新/刷新 被误判为 ADDED)
parsers/requirement-blocks.ts ### 需求:(含全角冒号 )、## 需求;delta 章节中文↔英文等价映射;项目符号 / FROM·TO 重命名双语
parsers/change-parser.ts 四类 delta 章节双语查找;FROM/TO 重命名双语
specs-apply.ts 归档/应用时修改需求头的双语匹配
schemas/base.schema.ts · validation/validator.ts 需求关键字接受 必须/禁止(连同 SHALL/MUST

刻意保留:提示文案不改(既有测试对其精确断言);新建章节默认标题仍为英文 ## Requirements(兼容骨架生成器与既有测试);已存在的 ## 需求 标题会被正确识别并原样保留。

测试

新增 test/core/parsers/chinese-bilingual.test.ts(13 用例):纯中文 spec/change 解析、全角冒号、中文 delta 章节、必须/禁止 关键字、validateSpecContent / validateChangeDeltaSpecs 端到端中文校验。本地全量 1798 用例通过tsc --noEmiteslint src/ 均通过。

Closes #31

含 AI 辅助生成代码(Claude Code / Opus 4.8),已本地测试与验证。

合并上游 v1.5.0 后,解析/校验层退回为仅匹配英文关键字,导致中文标题的
spec/change 解析出 0 个需求,无法 validate / list / archive(studyzy#31)。
按 1.4.1 的双语逻辑恢复匹配层(仅补匹配,不改现有中文提示文案):

- markdown-parser:目的/需求/为什么/变更内容 章节回退;中文 delta 操作识别
  (其中把 1.4.1 过宽的裸 `新` 收窄为 `新增|新建`,避免 更新/刷新 被误判为 ADDED)
- requirement-blocks:`### 需求:`(含全角冒号 `:`)、`## 需求`、中文 delta 章节等价映射
- change-parser:中文 delta 章节与 FROM/TO 重命名双语匹配
- specs-apply:归档/应用时修改需求头的双语匹配
- base.schema / validator:需求关键字接受 `必须`/`禁止`

新建章节默认标题仍为英文 `## Requirements` 以兼容骨架生成器与既有测试。
新增 test/core/parsers/chinese-bilingual.test.ts(13 用例)覆盖回归。

Closes studyzy#31

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@studyzy
studyzy merged commit 7e53a99 into studyzy:main Jul 13, 2026
5 checks passed
@HerbertGao
HerbertGao deleted the contrib/bilingual-parsing-issue-31 branch July 13, 2026 02:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1.5.0 无法验证中文标题的 spec/change(1.4.1 正常,疑似回归)

2 participants