Skip to content

fix(backend): 修复随附插件启动冲突并忽略生成译文 - #61

Merged
KyleHuangFromHZ merged 8 commits into
mainfrom
fix/backend-crowdin-translations
Nov 18, 2026
Merged

KyleHuangFromHZ merged 8 commits into
mainfrom
fix/backend-crowdin-translations

Conversation

@KyleHuangFromHZ

@KyleHuangFromHZ KyleHuangFromHZ commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

改了什么,为什么 / What changed and why

  • 安装版启动时,如果随附插件与已安装插件同版但内容不同,宿主现在记录告警、保留已安装包并继续启动。避免重装宿主时仅因随附插件版本没有增加而无法打开应用。随附包要自动更新插件仍需提高版本;插件管理手动导入同版异内容包仍会拒绝覆盖。
  • Git 不再跟踪 Crowdin 下载的后端 lang/messages_*.properties。默认英文源 messages.properties、独立的后端补充语言包和前端译文保持跟踪。下载后的本机文件仍会入包。
  • 与最新 main 同步时,将 CAN 功能新增的 60 个文案键及已有各语言内容迁入受 Git 管理的 can-errors 补充包。CAN 控制器测试验证接口返回这个补充包里的中英文文案;前端译文继续沿用 main。
  • 社区日常包、候选版和正式版沿用无凭据打包策略,仍显式跳过 Crowdin 下载。新检出时缺少的 Crowdin 译文回退到默认英文,补充语言包仍随包交付。后端已禁用按 JVM 系统语言回退;将原英文覆盖包中 8 条原先仅在那里有英文的提示迁入默认包,保留原文与参数。需要 Crowdin 译文的维护者打包仍默认下载。
  • PR 不修改 GitHub Actions 工作流。后端测试 CI 沿用 Maven 的默认下载行为;无 Crowdin 凭据的定向测试通过显式跳过下载运行。
  • 本机跳过下载时,会把已有译文一并入包;要验证无译文时的回退,用新检出的源码。使用已下载译文的正式包应以成功的 Crowdin 下载为准。

怎么验证的 / How it was verified

  • 随附插件运行时回归:同版异内容的随附包不替换已安装包,宿主保持就绪。
  • 无 Crowdin 译文的源码快照定向后端测试,验证互谱错误文案及默认语言回退。
  • 合并最新 main 前的三平台社区构建已通过;最新结果以 PR 检查为准。
  • 在无 Crowdin 译文的后端构建目录运行实际的 I18nConfig:简体中文请求的设备离线提示回退为英文 Offline;Math 和 CAN 补充包保留各自文案,包括繁体中文 CAN 提示。CAN 控制器的 27 项定向测试通过。
  • 用 Java Properties 比对旧英文覆盖包的 1196 个键:默认包无缺失,迁入 8 条原英文并保留参数数量,其余 4 处措辞差异沿用默认源的现有文本。Git 中该目录的 messages_*.properties 由 10 份降至 0 份。
  • Crowdin Maven 流程和本地化资源打包检查:6 项通过。
  • 文档策略和 git diff --check 通过;前端目录无差异。
  • 不涉及设备。
  • 上次 PR CI 中,BundledPluginRuntimeTest 通过 11 项、按条件跳过 1 项,PluginPackageManagerTest 通过 99 项(包括手动导入同版异内容包仍返回 PACKAGE_VERSION_CONFLICT)。该错误码仍由手动导入使用。全量后端 CI 也报告了 main 已有的失败;后端译文测试已在无译文源码快照中单独通过。

影响 / Impact

  • 已更新中英文的开发打包与本地化文档。
  • 未修改插件 API、通信协议或数据格式。
  • 发布审核请一并确认:三平台社区日常包、候选版和正式版继续使用无凭据构建,缺少的后端 Crowdin 译文回退到英文;前端译文及后端补充包仍随包交付。若社区正式包必须交付完整后端译文,请在批准前说明所需的发布材料来源。
  • 完整版打包的译文来自当次 Crowdin 下载,同一源码提交在不同时间构建时译文可能不同。合并后的首次 Crowdin 源文案同步,请维护者上传更新的默认英文源并复核这 8 条译文。
  • 随附插件同版本异内容会在日志中告警;界面和版本规则保持原样。发布更新仍需提高插件版本。

贡献授权 / Contribution license

  • 我已阅读并同意 OpenTest 社区许可协议第 11 条“社区贡献” / I have read and agree to section 11, Community Contributions, of the OpenTest Community License

@KyleHuangFromHZ
KyleHuangFromHZ requested a review from a team November 17, 2026 08:10

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

总体评价:本 PR 用忽略规则解决"构建后工作区出现译文改动"的问题,但同时把已跟踪的 messages_en.properties 移出版本控制。这样英文后端文案的来源从"提交中的固定内容"变成"构建时 Crowdin 上的当前内容",影响构建的可复现性、发布分支补丁和离线或无凭据构建。建议在合并前重新评估方案。

无法定位到具体行的意见:

  1. 测试覆盖与验证:描述中的"本地化资源打包检查:6 项通过"是在本机已有 11 份译文的前提下执行的。它没有覆盖"新检出 + skip.crowdin.download=true"这一新增的降级路径。请补充或说明以下两种场景的验证结果:
    • 后端测试(如按 Locale.ENGLISH 断言错误文案的用例)在干净检出上是否仍能通过;
    • 缺少 messages_en.properties 时,英文界面实际回退到哪种语言。
  2. CI 与发布流程:community-package 的日常、rc 和正式构建,以及 fork 提交的拉取请求,是否都具备 Crowdin CLI 和凭据,本 diff 中无法确认。
    • 如果任一流程跳过下载,产出的安装包会缺少英文后端文案,且不会报错。
    • 如果不跳过,fork 拉取请求可能因拿不到凭据而构建失败。
    • 请在描述中说明各工作流的实际行为,必要时让打包检查在缺少预期语言文件时失败。
  3. 贡献授权:描述中"社区贡献"授权复选框未勾选,合并前需要提交者确认。

跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:77e9759。维护者可评论 /review 重新审查。

Comment thread apps/backend/.gitignore Resolved
Comment thread apps/backend/.gitignore Resolved
Comment thread docs/localization.md Resolved
@KyleHuangFromHZ
KyleHuangFromHZ requested a review from a team as a code owner November 17, 2026 08:28

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

总体评价:忽略 Crowdin 下载产物的方向合理,CI 与文档的说明基本一致。合并前需要处理以下问题。

  1. 删除 messages_en.properties 可能改变英文界面的实际语言,详见 .gitignore 处的意见。
  2. 混入了与标题无关的行为变更:PluginRuntime 把“随附插件与已安装插件同版本但内容不同”从启动失败改为告警后继续启动。这与 fix(i18n) 无关,描述里也没有提到。“影响”一节写的是“不修改插件 API、协议”,但插件运行时行为已经变了。合并方式是 squash,标题会成为唯一的提交说明,这项变更以后在历史中很难追溯。建议拆成独立的 fix(plugin-runtime) 拉取请求,并单独关联 Issue。
  3. 验证记录不完整:“怎么验证的”只列了 Crowdin/打包检查和文档检查,没有说明是否运行了 opentest-plugin-runtime 模块的测试,也没有说明 OctaveStartValidationI18nTest 在本机存在下载译文时是否通过。
  4. 发布范围需要确认:按新文档,社区安装包的日常包、候选版和正式版都跳过 Crowdin 下载,只含英文和补充语言包。这是产品交付决策,建议由发布负责人确认后再合并。
  5. 贡献授权未勾选:描述中“社区许可协议第 11 条”的复选框没有勾选,合并前应由提交者确认。

跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:c6b7b75。维护者可评论 /review 重新审查。

Comment thread apps/backend/.gitignore Resolved
@KyleHuangFromHZ KyleHuangFromHZ changed the title fix(i18n): 不再跟踪下载的后端译文 fix(backend): 修复随附插件启动冲突并忽略生成译文 Nov 17, 2026

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体改动方向清晰:随附插件同版异内容不再阻断启动,后端 Crowdin 译文改为生成产物,并为两项改动补充了回归测试和中英文文档。合入前建议确认以下几点。

  1. 英文差异是否完整迁移,无法从 diff 核实。 messages_en.properties(1303 行)的 diff 已截断。描述称只有 8 条英文仅存在于该文件,但其余键在两个文件中取值是否完全一致,这里看不到。若有键在 messages.properties 中仍是旧措辞或中文,删除覆盖包后英文用户看到的文案会变化。建议在合入前用脚本对比两份文件的键值。另建议增加一个测试,断言 messages.properties 不含 CJK 字符,防止默认英文源再次混入中文。
  2. 其他语言文件是否已取消跟踪。 改动列表中只删除了 messages_en.properties。.gitignore 不会让已跟踪的文件停止跟踪。如果仓库中还跟踪着 messages_zh_CN.properties 等文件,需要一并执行 git rm --cached,否则与描述中的“Git 不再跟踪”不一致。如果这些文件原本就未跟踪,请忽略此条。
  3. 社区正式版和候选版不含后端 Crowdin 译文。 跳过下载后,非英文用户会看到“前端已翻译、后端报错为英文”的混合界面。这属于产品决策,建议在拉取请求中明确由谁确认。
  4. 流程项。 描述中没有 Refs #编号 关联工单(见 CONTRIBUTING.zh-CN.md)。社区贡献授权复选框未勾选。本次修改了 .github/workflows/,按规范还需要 CODEOWNERS 指定的维护者审查。

跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:e1524a0。维护者可评论 /review 重新审查。

Comment thread apps/backend/.gitignore Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 重新审查。

Comment thread .github/workflows/community-package.yml Resolved
Comment thread apps/backend/.gitignore Resolved
mingtaojin
mingtaojin previously approved these changes Nov 17, 2026
cuimmm
cuimmm previously approved these changes Nov 17, 2026
@KyleHuangFromHZ
KyleHuangFromHZ dismissed stale reviews from cuimmm and mingtaojin via e5e3242 November 17, 2026 09:41

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

总体评价:随附插件同版异内容的处理从拒绝启动改为告警并保留已安装包,逻辑简单,新增回归测试能区分两种行为:冲突包为 fail-start,如被误装会导致宿主未就绪。默认英文包补齐 8 条英文、OctaveStartValidationI18nTest 去掉全限定类名并加 @​Isolated,这些改动符合项目规范。主要风险在发布策略:社区正式包将不再含后端 Crowdin 译文,而且下一节的问题需要在合并前确认。

不能定位到具体行的意见:

  1. CI 状态:描述中说明 PR 与 main 的后端 CI 都在插件运行时测试上失败。本 PR 正好修改 PluginRuntime 并新增 BundledPluginRuntimeTest 用例,这个用例尚无 CI 通过记录,只有本地结果。建议先确认失败与本改动无关,或先修复 main。按 CONTRIBUTING.zh-CN.md,必需检查通过后才能合并。
  2. 旧断言可能残留:原实现在启动时抛出 PACKAGE_VERSION_CONFLICT,diff 中没有看到删除或修改对应的旧断言。请确认没有其他测试,或启动诊断逻辑,仍期望启动时出现该失败码。
  3. 8 条默认源由中文改为英文:messages.properties 是 Crowdin 源文件。这些键原来的源文本是中文,在重新执行 upload sources 之前,Crowdin 中对应的译文可能基于中文源或已过期。建议在合并后的首次同步时明确上传并复核,不要只依赖“后续同步”。
  4. 贡献授权:描述中“贡献授权”的复选框未勾选,请提交者确认。

跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:e5e3242。维护者可评论 /review 重新审查。

Comment thread .github/workflows/community-package.yml Resolved
Comment thread apps/backend/.gitignore Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

总体评价:随附插件同版异内容改为告警并继续启动,这一改动范围清楚,回归测试覆盖了核心场景。后端译文改为不跟踪的部分影响较大,需要发布负责人明确决策,并修正下面列出的回退问题后再合并。

不能定位到具体行的意见

  1. 社区包将失去全部后端非英语译文(含简体中文)。删除 10 份已跟踪的 messages_*.properties 后,CI 和社区包都使用 skip.crowdin.download=true,三平台日常包、候选版和正式版的后端提示(设备状态、错误码、结果名称等)在简体中文界面下也会显示英文,前端仍是中文,界面会中英混杂。描述中已请发布审核确认,但这是面向最终用户的明显回退,建议拿到发布负责人的明确批准后再合并,或在社区发布流程中提供可信的译文来源,例如在受保护环境中用 Crowdin 凭据下载。
  2. 可复现性与陈旧译文:译文不再随提交固定,同一提交在不同时间构建,结果可能不同。本机跳过下载时,未跟踪的旧译文也会入包,维护者在本地出包有误交付陈旧译文的风险。建议打包脚本在跳过下载但目录中存在 messages_*.properties 时给出警告。
  3. 范围与描述不一致:PR 同时把 CAN 相关的 65 个键从 messages.properties 拆到新的 can-errors* 补充包,并新增 8 种语言文件。描述完全没有提到这部分,也没有说明这些键从 Crowdin 源文案中移除后的影响(见行内意见)。建议在描述中补充,或拆成单独的 PR。
  4. 流程:描述没有按贡献指南用 Refs #编号 关联工单;“贡献授权”复选框未勾选,合并前需要提交者确认。

跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:8a0a04e。维护者可评论 /review 重新审查。

Comment thread docs/development-and-packaging.md Resolved
yangdekun2026
yangdekun2026 previously approved these changes Nov 17, 2026
mingtaojin
mingtaojin previously approved these changes Nov 17, 2026
cuimmm
cuimmm previously approved these changes Nov 17, 2026

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

本次改动主要涉及两部分:一是随附插件与已安装插件同版本但内容不同时,宿主由拒绝启动改为告警并继续启动;二是后端 Crowdin 按语言生成的译文不再纳入 Git,CAN 文案迁入源码维护的 can-errors 补充包。整体思路可以接受,插件运行时的回归测试覆盖了关键路径。需要关注以下几点:

  1. 繁体中文回退为简体(中):can-errors_zh_TW 只包含 28 个键。按 Java ResourceBundle 的候选链 zh_Hant_TW → zh_Hant → zh_TW → zh → 根,缺少的 can.error.* 和 error.jni.native.131030xx 会命中 can-errors_zh,繁体中文用户将看到简体中文。详见行内意见。
  2. 社区包后端译文退化为英文(中,需要发布决策):Git 不再跟踪 messages_*.properties,社区包又不下载 Crowdin 译文,因此日常包、候选版和正式版的后端提示(中文等所有非英文语言)都会回退到英文。这是用户可见的行为变化。描述中已提请发布审核确认,建议在合并前取得产品或发布负责人的明确批准。另外,完整包的译文取决于构建时的 Crowdin 状态,同一提交在不同时间构建的结果不可复现,建议在发布流程中记录所用的 Crowdin 版本或快照。
  3. 其他测试可能依赖已删除的资源(不确定):本次只修改了 CanControllerTest 和 OctaveStartValidationI18nTest。仓库中如有其他测试直接读取 /lang/messages_*.properties,在跳过下载的新检出中会失败。建议用 rg 'lang/messages_' 全量检索确认。
  4. CI 是否跳过下载的说明前后不一致:PR 描述称后端 CI 不使用 Crowdin 凭据,文档却写后端测试工作流沿用 Maven 默认行为,即会下载。若后者属实,在没有凭据的 CI 中下载应当失败并停止构建。请核实实际行为,并统一描述与文档。

跳过 9 个文件(锁文件、生成文件、二进制或无文本 diff)

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:73d7f9a。维护者可评论 /review 重新审查。

Comment thread docs/localization.md Resolved
@KyleHuangFromHZ
KyleHuangFromHZ removed the request for review from a team November 17, 2026 11:11
@KyleHuangFromHZ
KyleHuangFromHZ merged commit d61c569 into main Nov 18, 2026
11 of 13 checks passed
@KyleHuangFromHZ
KyleHuangFromHZ deleted the fix/backend-crowdin-translations branch November 18, 2026 00:38
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.

4 participants