Repository navigation
fix(backend): 修复随附插件启动冲突并忽略生成译文 - #61
Conversation
There was a problem hiding this comment.
AI 代码审查(claude-opus-5-5)
总体评价:本 PR 用忽略规则解决"构建后工作区出现译文改动"的问题,但同时把已跟踪的 messages_en.properties 移出版本控制。这样英文后端文案的来源从"提交中的固定内容"变成"构建时 Crowdin 上的当前内容",影响构建的可复现性、发布分支补丁和离线或无凭据构建。建议在合并前重新评估方案。
无法定位到具体行的意见:
- 测试覆盖与验证:描述中的"本地化资源打包检查:6 项通过"是在本机已有 11 份译文的前提下执行的。它没有覆盖"新检出 +
skip.crowdin.download=true"这一新增的降级路径。请补充或说明以下两种场景的验证结果:- 后端测试(如按
Locale.ENGLISH断言错误文案的用例)在干净检出上是否仍能通过; - 缺少
messages_en.properties时,英文界面实际回退到哪种语言。
- 后端测试(如按
- CI 与发布流程:
community-package的日常、rc 和正式构建,以及 fork 提交的拉取请求,是否都具备 Crowdin CLI 和凭据,本 diff 中无法确认。- 如果任一流程跳过下载,产出的安装包会缺少英文后端文案,且不会报错。
- 如果不跳过,fork 拉取请求可能因拿不到凭据而构建失败。
- 请在描述中说明各工作流的实际行为,必要时让打包检查在缺少预期语言文件时失败。
- 贡献授权:描述中"社区贡献"授权复选框未勾选,合并前需要提交者确认。
跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)
由 AI 自动生成,仅供参考,不作为合并依据。审查提交:
77e9759。维护者可评论/review重新审查。
There was a problem hiding this comment.
AI 代码审查(claude-opus-5-5)
总体评价:忽略 Crowdin 下载产物的方向合理,CI 与文档的说明基本一致。合并前需要处理以下问题。
- 删除
messages_en.properties可能改变英文界面的实际语言,详见.gitignore处的意见。 - 混入了与标题无关的行为变更:
PluginRuntime把“随附插件与已安装插件同版本但内容不同”从启动失败改为告警后继续启动。这与fix(i18n)无关,描述里也没有提到。“影响”一节写的是“不修改插件 API、协议”,但插件运行时行为已经变了。合并方式是 squash,标题会成为唯一的提交说明,这项变更以后在历史中很难追溯。建议拆成独立的fix(plugin-runtime)拉取请求,并单独关联 Issue。 - 验证记录不完整:“怎么验证的”只列了 Crowdin/打包检查和文档检查,没有说明是否运行了
opentest-plugin-runtime模块的测试,也没有说明OctaveStartValidationI18nTest在本机存在下载译文时是否通过。 - 发布范围需要确认:按新文档,社区安装包的日常包、候选版和正式版都跳过 Crowdin 下载,只含英文和补充语言包。这是产品交付决策,建议由发布负责人确认后再合并。
- 贡献授权未勾选:描述中“社区许可协议第 11 条”的复选框没有勾选,合并前应由提交者确认。
跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)
由 AI 自动生成,仅供参考,不作为合并依据。审查提交:
c6b7b75。维护者可评论/review重新审查。
There was a problem hiding this comment.
AI 代码审查(claude-opus-5-5)
整体改动方向清晰:随附插件同版异内容不再阻断启动,后端 Crowdin 译文改为生成产物,并为两项改动补充了回归测试和中英文文档。合入前建议确认以下几点。
- 英文差异是否完整迁移,无法从 diff 核实。
messages_en.properties(1303 行)的 diff 已截断。描述称只有 8 条英文仅存在于该文件,但其余键在两个文件中取值是否完全一致,这里看不到。若有键在messages.properties中仍是旧措辞或中文,删除覆盖包后英文用户看到的文案会变化。建议在合入前用脚本对比两份文件的键值。另建议增加一个测试,断言messages.properties不含 CJK 字符,防止默认英文源再次混入中文。 - 其他语言文件是否已取消跟踪。 改动列表中只删除了
messages_en.properties。.gitignore不会让已跟踪的文件停止跟踪。如果仓库中还跟踪着messages_zh_CN.properties等文件,需要一并执行git rm --cached,否则与描述中的“Git 不再跟踪”不一致。如果这些文件原本就未跟踪,请忽略此条。 - 社区正式版和候选版不含后端 Crowdin 译文。 跳过下载后,非英文用户会看到“前端已翻译、后端报错为英文”的混合界面。这属于产品决策,建议在拉取请求中明确由谁确认。
- 流程项。 描述中没有
Refs #编号关联工单(见CONTRIBUTING.zh-CN.md)。社区贡献授权复选框未勾选。本次修改了.github/workflows/,按规范还需要 CODEOWNERS 指定的维护者审查。
跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)
由 AI 自动生成,仅供参考,不作为合并依据。审查提交:
e1524a0。维护者可评论/review重新审查。
There was a problem hiding this comment.
AI 代码审查(claude-opus-5-5)
总体评价:插件运行时的改动范围清晰,新增的回归测试覆盖了“同版异内容随附包不替换已安装包、宿主保持就绪”这一路径。OctaveStartValidationI18nTest 用 @Isolated 隔离了对默认 JVM 语言的修改,并完整恢复了各类别的默认语言。测试改为依赖 I18nConfig 自身的 fallbackToSystemLocale 设置。由于夹具中存在 messages_zh,在默认语言为 zh_CN 时请求英文,可以真实验证“不按系统语言回退”。
主要风险在本地化交付策略:
- 不再跟踪
messages_*.properties,社区 CI 又固定跳过下载。因此社区日常包、候选版和正式版的后端都只有英文默认包和补充包,见行内意见。 - 维护者打包时,译文取自构建时 Crowdin 的最新状态。这些译文没有经过 Git 审查,也无法按标签复现。
其他说明:
- 本次只运行了定向后端测试。删除 10 份译文文件后,如果其他测试读取
lang/messages_<语言>.properties或断言非英文后端文案,新检出的 CI 会失败。建议在新检出的源码上完整运行一次mvn verify -Dskip.crowdin.download=true确认。 - 拉取请求描述中“贡献授权”复选框未勾选,合并前请确认提交者已同意社区许可协议第 11 条。
跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)
由 AI 自动生成,仅供参考,不作为合并依据。审查提交:
0147a6c。维护者可评论/review重新审查。
e5e3242
There was a problem hiding this comment.
AI 代码审查(claude-opus-5-5)
总体评价:随附插件同版异内容的处理从拒绝启动改为告警并保留已安装包,逻辑简单,新增回归测试能区分两种行为:冲突包为 fail-start,如被误装会导致宿主未就绪。默认英文包补齐 8 条英文、OctaveStartValidationI18nTest 去掉全限定类名并加 @Isolated,这些改动符合项目规范。主要风险在发布策略:社区正式包将不再含后端 Crowdin 译文,而且下一节的问题需要在合并前确认。
不能定位到具体行的意见:
- CI 状态:描述中说明 PR 与
main的后端 CI 都在插件运行时测试上失败。本 PR 正好修改PluginRuntime并新增BundledPluginRuntimeTest用例,这个用例尚无 CI 通过记录,只有本地结果。建议先确认失败与本改动无关,或先修复main。按CONTRIBUTING.zh-CN.md,必需检查通过后才能合并。 - 旧断言可能残留:原实现在启动时抛出
PACKAGE_VERSION_CONFLICT,diff 中没有看到删除或修改对应的旧断言。请确认没有其他测试,或启动诊断逻辑,仍期望启动时出现该失败码。 - 8 条默认源由中文改为英文:
messages.properties是 Crowdin 源文件。这些键原来的源文本是中文,在重新执行upload sources之前,Crowdin 中对应的译文可能基于中文源或已过期。建议在合并后的首次同步时明确上传并复核,不要只依赖“后续同步”。 - 贡献授权:描述中“贡献授权”的复选框未勾选,请提交者确认。
跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)
由 AI 自动生成,仅供参考,不作为合并依据。审查提交:
e5e3242。维护者可评论/review重新审查。
There was a problem hiding this comment.
AI 代码审查(claude-opus-5-5)
总体评价:随附插件同版异内容改为告警并继续启动,这一改动范围清楚,回归测试覆盖了核心场景。后端译文改为不跟踪的部分影响较大,需要发布负责人明确决策,并修正下面列出的回退问题后再合并。
不能定位到具体行的意见
- 社区包将失去全部后端非英语译文(含简体中文)。删除 10 份已跟踪的
messages_*.properties后,CI 和社区包都使用skip.crowdin.download=true,三平台日常包、候选版和正式版的后端提示(设备状态、错误码、结果名称等)在简体中文界面下也会显示英文,前端仍是中文,界面会中英混杂。描述中已请发布审核确认,但这是面向最终用户的明显回退,建议拿到发布负责人的明确批准后再合并,或在社区发布流程中提供可信的译文来源,例如在受保护环境中用 Crowdin 凭据下载。 - 可复现性与陈旧译文:译文不再随提交固定,同一提交在不同时间构建,结果可能不同。本机跳过下载时,未跟踪的旧译文也会入包,维护者在本地出包有误交付陈旧译文的风险。建议打包脚本在跳过下载但目录中存在
messages_*.properties时给出警告。 - 范围与描述不一致:PR 同时把 CAN 相关的 65 个键从
messages.properties拆到新的can-errors*补充包,并新增 8 种语言文件。描述完全没有提到这部分,也没有说明这些键从 Crowdin 源文案中移除后的影响(见行内意见)。建议在描述中补充,或拆成单独的 PR。 - 流程:描述没有按贡献指南用
Refs #编号关联工单;“贡献授权”复选框未勾选,合并前需要提交者确认。
跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)
由 AI 自动生成,仅供参考,不作为合并依据。审查提交:
8a0a04e。维护者可评论/review重新审查。
73d7f9a
There was a problem hiding this comment.
AI 代码审查(claude-opus-5-5)
本次改动主要涉及两部分:一是随附插件与已安装插件同版本但内容不同时,宿主由拒绝启动改为告警并继续启动;二是后端 Crowdin 按语言生成的译文不再纳入 Git,CAN 文案迁入源码维护的 can-errors 补充包。整体思路可以接受,插件运行时的回归测试覆盖了关键路径。需要关注以下几点:
- 繁体中文回退为简体(中):
can-errors_zh_TW只包含 28 个键。按 JavaResourceBundle的候选链zh_Hant_TW → zh_Hant → zh_TW → zh → 根,缺少的can.error.*和error.jni.native.131030xx会命中can-errors_zh,繁体中文用户将看到简体中文。详见行内意见。 - 社区包后端译文退化为英文(中,需要发布决策):Git 不再跟踪
messages_*.properties,社区包又不下载 Crowdin 译文,因此日常包、候选版和正式版的后端提示(中文等所有非英文语言)都会回退到英文。这是用户可见的行为变化。描述中已提请发布审核确认,建议在合并前取得产品或发布负责人的明确批准。另外,完整包的译文取决于构建时的 Crowdin 状态,同一提交在不同时间构建的结果不可复现,建议在发布流程中记录所用的 Crowdin 版本或快照。 - 其他测试可能依赖已删除的资源(不确定):本次只修改了
CanControllerTest和OctaveStartValidationI18nTest。仓库中如有其他测试直接读取/lang/messages_*.properties,在跳过下载的新检出中会失败。建议用rg 'lang/messages_'全量检索确认。 - CI 是否跳过下载的说明前后不一致:PR 描述称后端 CI 不使用 Crowdin 凭据,文档却写后端测试工作流沿用 Maven 默认行为,即会下载。若后者属实,在没有凭据的 CI 中下载应当失败并停止构建。请核实实际行为,并统一描述与文档。
跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)
由 AI 自动生成,仅供参考,不作为合并依据。审查提交:
73d7f9a。维护者可评论/review重新审查。
改了什么,为什么 / What changed and why
lang/messages_*.properties。默认英文源messages.properties、独立的后端补充语言包和前端译文保持跟踪。下载后的本机文件仍会入包。main同步时,将 CAN 功能新增的 60 个文案键及已有各语言内容迁入受 Git 管理的can-errors补充包。CAN 控制器测试验证接口返回这个补充包里的中英文文案;前端译文继续沿用main。怎么验证的 / How it was verified
main前的三平台社区构建已通过;最新结果以 PR 检查为准。I18nConfig:简体中文请求的设备离线提示回退为英文Offline;Math 和 CAN 补充包保留各自文案,包括繁体中文 CAN 提示。CAN 控制器的 27 项定向测试通过。messages_*.properties由 10 份降至 0 份。git diff --check通过;前端目录无差异。BundledPluginRuntimeTest通过 11 项、按条件跳过 1 项,PluginPackageManagerTest通过 99 项(包括手动导入同版异内容包仍返回PACKAGE_VERSION_CONFLICT)。该错误码仍由手动导入使用。全量后端 CI 也报告了main已有的失败;后端译文测试已在无译文源码快照中单独通过。影响 / Impact
贡献授权 / Contribution license