Repository navigation
feat(v2.5): integrate order-analysis JNI contract - #59
Conversation
There was a problem hiding this comment.
AI 代码审查(claude-opus-5-5)
总体评价:Java 侧的 JNI 改名基本机械、一致,错误码数值保持不变,调用方和测试替身也已同步改名。主要风险不在改名本身,而在本 PR 夹带的以下内容:授权材料与原生材料布局调整、公开 SDK 的破坏性变更,以及若干文档改动。建议拆分,或在描述中逐项说明并补充验证。
不能定位到具体行的意见:
-
文档规范(CONTRIBUTING)
- 变更列表含
docs/handoffs/math-fs-2026-11-12.md。文件名包含日期2026-11-12,正是贡献指南明确禁止的示例格式。如果是新增文件,docs-policy必需检查会拒绝。请改名,把日期写入正文。 - 同时请确认
docs/handoffs/和docs/specs/math-fs-evaluation-and-result-units.md是否同目录提供了*.zh-CN.md对应版本。新增文档必须中英双语。 - 本 PR 删除了
apps/native/docs/modules/plugins/OptDevHost/tests/README.md。如果同目录存在README.zh-CN.md,须一并删除;若该项在tools/docs-policy-baseline.txt中,也须同步移除。
- 变更列表含
-
范围过大
- 标题和描述只涉及阶次分析 JNI 合同和改名,实际还改动了 Windows 授权文件、原生材料目录布局、桌面启动逻辑、大量
apps/native/docs和docs/handoffs、docs/specs。 - 这些改动来自
feature/order-analysis-jni-update-v2.5.0的继承基线,但描述的 What changed 未列出授权与材料布局变更。建议拆分 PR,至少在描述中逐项说明。 - 描述中缺少
Refs #<编号>。标题范围v2.5是版本号而非模块范围,建议改为如feat(algorithm): ...。
- 标题和描述只涉及阶次分析 JNI 合同和改名,实际还改动了 Windows 授权文件、原生材料目录布局、桌面启动逻辑、大量
-
公开 SDK 破坏性变更
OrderTrackingAlgorithmService位于opentest-algorithm-api,属于插件消费的公开 SDK。移除analyzeFromRpmFixed会让基于旧接口编译的插件在加载或调用时失败。- 请确认
OpenTest-Plugins中(如fft-tools)没有调用方,并说明插件兼容版本(package.json的A.B.C)是否需要相应提升。
-
未覆盖的验证
- 新增合同测试只用反射校验 Java 签名,没有在真实 v2.5.0 Windows 运行时上验证
Java_com_opentest_core_jni_*导出与新签名一致。签名中的任一参数类型或顺序偏差,都只会在运行时以UnsatisfiedLinkError暴露。 - 合入前建议至少在 Windows 上做一次加载冒烟:调用每个 native 方法,或校验
RegisterNatives结果。
- 新增合同测试只用反射校验 Java 签名,没有在真实 v2.5.0 Windows 运行时上验证
-
未能审查的文件:
OrderTrackingModels.java、OrderTrackingBindingsTest.java和tools/__tests__/*.test.mjs未提供。新模型的默认值、空值约束、axis取值含义,以及打包测试对prd/移除的覆盖情况均无法评估。
跳过 14 个文件(锁文件、生成文件、二进制或无文本 diff)
因篇幅限制未审查 35 个文件:apps/backend/opentest-algorithm-api/src/main/java/com/opentest/algorithm/api/OrderTrackingModels.java、apps/backend/opentest-plugin-runtime/src/test/java/com/opentest/runtime/OrderTrackingBindingsTest.java、apps/native/docs/architecture.md、apps/native/docs/code-review-standard.md、apps/native/docs/framework-boundary-audit.md、apps/native/docs/framework-boundary-validation-2026-10-22.md、apps/native/docs/framework-plugin-contract-v240.md、apps/native/docs/linux-arm64-foundation-validation-2026-10-16.md、apps/native/docs/modules/plugins/AUDIO_OTPLUGIN_HANDOFF.zh-CN.md、apps/native/docs/modules/plugins/DEVICE_PLUGIN_RELEASE.zh-CN.md、apps/native/docs/modules/plugins/OpenTestDevicePluginSDK/API_REFERENCE.zh-CN.md、apps/native/docs/modules/plugins/OpenTestDevicePluginSDK/ERROR_MESSAGES.zh-CN.md、apps/native/docs/modules/plugins/OpenTestDevicePluginSDK/EXTENSIONS.zh-CN.md、apps/native/docs/modules/plugins/OpenTestDevicePluginSDK/README.md、apps/native/docs/modules/plugins/OpenTestDevicePluginSDK/README.zh-CN.md、apps/native/docs/modules/plugins/Plugins/OpenTestNiDaqDevicePlugin/MIGRATION.md、apps/native/docs/modules/plugins/Plugins/OpenTestNiDaqDevicePlugin/README.zh-CN.md、apps/native/docs/modules/plugins/Plugins/OpenTestSonoDaqDevicePlugin/README.zh-CN.md、apps/native/docs/modules/plugins/Plugins/OpenTestSonoDaqDevicePlugin/package/README.md、apps/native/docs/modules/plugins/RELEASE_LAYOUT.zh-CN.md
由 AI 自动生成,仅供参考,不作为合并依据。审查提交:
fef0783。维护者可评论/review重新审查。
There was a problem hiding this comment.
AI 代码审查(claude-opus-5-5)
总体评价:本 PR 让宿主 Java 层对接 v2.5.0 的中性 JNI 名称和新的 FS/OT 阶次分析契约,主体改动方向清楚,错误码数值也保持不变。下面几项风险需要在合入前处理或确认。
1. 公开 SDK 的破坏性变更需要和插件仓库协调
OrderTrackingAlgorithmService删除了analyzeFromRpmFixed。它原来只有一个抽象方法,可以用 lambda 实现;现在有 5 个抽象方法,不能再用 lambda 实现。OpenTest-Plugins中凡是调用或实现该接口的插件都会编译失败。旧版插件在新宿主上运行时会抛出NoSuchMethodError或AbstractMethodError。- 请确认:插件仓库是否已有配套改动并打同名标签;插件兼容性版本(
package.json中的A.B.C)是否需要提升,使旧插件被明确拒绝加载,而不是在运行时失败。
2. 文档规范(docs-policy 必需检查)
- 改动列表包含
docs/handoffs/math-fs-2026-11-12.md,但内容未提供。如果它是本 PR 新增的文件,会违反CONTRIBUTING.zh-CN.md的两条规则:- 文件名禁止包含日期(
2026-11-12); - 新增文档必须同时提供英文版和
*.zh-CN.md中文版。
- 文件名禁止包含日期(
- 这会被
docs-policy检查拦截。请改为不含日期的文件名并补齐中文版。如果是存量文件,也请说明为何在本 PR 中修改。
3. 未能审查的内容
OrderTrackingModels.java的改动未提供。无法确认各模型字段与原生端GetFieldID所需字段名和类型是否一致。- 也无法确认
axis参数的取值是否有常量定义。
4. 验证范围不足
crydaq-service和crydaq-algorithm-runtime只运行了少数几个测试类。- 本 PR 把大量调用点从
*Bk*包装方法改为直接调用中性 native 方法。凡是仍覆写旧包装方法的测试替身,都会被静默绕过(详见行内意见)。 - 建议至少完整运行这两个模块以及
crydaq-server的单元测试。 - PR 描述中“no old names remained in the Java backend”与实际不符:
createBkFftTask等兼容包装方法仍然存在且为 public,契约测试还断言了它们的存在。请修正描述,或者删除这些包装方法。
5. 流程规范(低)
- 标题的范围写成版本号
v2.5。规范要求“类型(范围): 说明”,范围应为模块,例如feat(algorithm): ...。 - 描述中缺少
Refs #<编号>,无法关联需求或缺陷。
因篇幅限制未审查 2 个文件:
apps/backend/opentest-algorithm-api/src/main/java/com/opentest/algorithm/api/OrderTrackingModels.java、docs/handoffs/math-fs-2026-11-12.md
由 AI 自动生成,仅供参考,不作为合并依据。审查提交:
0cb4bcf。维护者可评论/review重新审查。
0cb4bcf to
465b198
Compare
There was a problem hiding this comment.
AI 代码审查(claude-opus-5-5)
总体评价
AlgorithmLibJNIBridge的 45 个名称改动、调用方替换和JNIErrorCodeMapper的分支迁移基本一致,错误码数值未变。契约测试也随之更新。- 剩余风险集中在三方面:兼容性、运行时验证,以及残留的旧入口。
不能定位到具体行的意见
- 公共 SDK 破坏性变更缺少兼容说明。
opentest-algorithm-api中的OrderTrackingAlgorithmService删除了analyzeFromRpmFixed。它原本是只有一个方法、可用 lambda 实现的接口,现在变为 5 个抽象方法。- 依赖它的插件(
OpenTest-Plugins或第三方插件)会编译失败;已构建的插件会在运行时抛出AbstractMethodError或NoSuchMethodError。 - 描述只说明设备插件另行交付,没有说明业务插件、SDK 版本号和插件兼容版本(
package.json中的A.B.C)如何调整。请补充,并确认插件仓库同步合入的顺序。
- 运行时未验证。
- 描述明确未在 Windows 上执行 DLL,签名检查也只核对了名称。
- JNI 签名不一致在编译期和现有单元测试中都发现不了。建议合入前在 Windows 日常包环境做一次冒烟:加载库,并调用每个新入口(至少 create/dispose 各一次)。
- 测试范围不足。
- 验证只用
-Dtest=运行了指定测试类,没有运行受影响模块的完整测试套件。 - 本次把调用目标从
xxxBk*包装方法改成了中性 native 方法。仍覆写旧名称的测试替身(test double)会被静默绕过(见行内意见)。建议对crydaq-algorithm-runtime、crydaq-service、opentest-plugin-runtime完整运行test。
- 验证只用
- 描述与实现不一致。
- 描述称 “no old names remained in the Java backend”,但
AlgorithmLibJNIBridge仍保留全部createBkFftTask等公开包装方法,compatibilityMethodsMatchNeutralJniSignatures还要求它们存在。请修正描述,或删除这些包装方法。
- 描述称 “no old names remained in the Java backend”,但
- 流程规范。
- 描述中没有
Refs #编号,无法关联需求或缺陷。 - 标题范围
v2.5是版本号而不是模块范围,按CONTRIBUTING.zh-CN.md建议改为类似feat(algorithm): ...。
- 描述中没有
- 未能审查的文件。
OrderTrackingModels.java未提供,无法审查新模型的字段、默认值、枚举码和空值约定。
因篇幅限制未审查 1 个文件:
apps/backend/opentest-algorithm-api/src/main/java/com/opentest/algorithm/api/OrderTrackingModels.java
由 AI 自动生成,仅供参考,不作为合并依据。审查提交:
465b198。维护者可评论/review重新审查。
There was a problem hiding this comment.
AI 代码审查(claude-opus-5-5)
总体评价:本 PR 把宿主 Java 层切到 v2.5.0 的中性 JNI 名称,并以 FS/OT 五个入口替换旧的 analyzeFromRpmFixed。错误码数值和映射分支逐项对照无误,AlgorithmLibJNIBridgeService、业务服务与适配器的调用点替换也一致。合入前建议处理以下问题。
不能定位到具体行的意见:
- JNI 签名未经运行验证:新增 11 个 native 方法(8 个
AdvancedFftChannel*、3 个*SelectedResults),并且全部 native 方法改为直接调用。验证只在 macOS 上编译并跑了模拟测试。JNI 按短名查找符号时不校验参数签名,签名一旦与 DLL 不一致,调用时会损坏内存或导致 JVM 崩溃,不会在加载时报UnsatisfiedLinkError。建议合入前在 Windows 上用 v2.5.0 运行时至少冒烟调用一次每个新增入口,或在原生侧用RegisterNatives显式登记签名。 - 公开 SDK 破坏性变更需跨仓库协调:
OrderTrackingAlgorithmService位于opentest-algorithm-api,属于插件消费的公开 SDK,本次删除了analyzeFromRpmFixed和旧模型类型。按贡献指南,日常社区包使用OpenTest-Plugins的main构建。若插件仓库仍引用旧接口,合入后的日常构建会失败。请确认插件仓库已同步,或在描述中说明迁移顺序。 OrderTrackingModels.java未提供:新模型的字段、默认值、枚举码和空值约定无法审查,以下与模型相关的意见均基于接口签名。- 缺少工单关联:PR 描述没有按贡献指南用
Refs #编号关联需求或缺陷。 - 描述与实现不一致:描述称“no old names remained in the Java backend”,实际
createBkFftTask等Bk*包装方法仍保留,见行内意见。
因篇幅限制未审查 1 个文件:
apps/backend/opentest-algorithm-api/src/main/java/com/opentest/algorithm/api/OrderTrackingModels.java
由 AI 自动生成,仅供参考,不作为合并依据。审查提交:
6524c1c。维护者可评论/review重新审查。
Why
OpenTest 2.5.0's Windows runtime delivers neutral analysis exports and a new FS/OT order-analysis JNI contract. The host Java layer still exposed the removed
analyzeFromRpmFixedentry and the old BK JNI identities, so the delivered runtime could not be consumed through the public backend API.What changed
bkInfo,bkRetCode, andretCodeunchanged.Scope
feature/order-analysis-jni-update-v2.5.0.Tradeoffs
The old order entry has no compatibility alias because the delivery document states that the old native export is absent. Keeping it would allow compilation while failing at runtime with
UnsatisfiedLinkError.Blast Radius
The change updates public backend Java types and every host caller of the renamed JNI methods. The result-key contract stays stable, and the numeric error-code mapping is unchanged. Native execution still requires the matching v2.5.0 Windows runtime.
Verification
mvn -pl opentest-algorithm-api,crydaq-algorithm-runtime,crydaq-core,opentest-plugin-runtime -am -DskipTests compilepassed.mvn -pl crydaq-algorithm-runtime,opentest-plugin-runtime -am -Dtest=OrderTrackingContractTest,AlgorithmLibBridgeContractTest,OrderTrackingBindingsTest -Dsurefire.failIfNoSpecifiedTests=false testpassed with 6 tests.mvn -pl crydaq-service -am -Dtest=BkCpbBatchResultAdapterTest,BkFftSelectedResultAdapterTest -Dsurefire.failIfNoSpecifiedTests=false testpassed with 4 tests.mvn -pl crydaq-server -am -Dskip.crowdin.download=true -DskipTests compilepassed. The default server compile requires the unavailable local Crowdin configuration.