Skip to content

fix(sound-power): 用现有原生接口传入真实测量面积 - #32

Merged
KyleHuangFromHZ merged 3 commits into
mainfrom
codex/sound-power-native-main
Nov 16, 2026
Merged

KyleHuangFromHZ merged 3 commits into
mainfrom
codex/sound-power-native-main

Conversation

@KyleHuangFromHZ

@KyleHuangFromHZ KyleHuangFromHZ commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

Summary

GB/T 1094.10 简易法和 GB/T 32524.2 工程法各自提供真实测量面积。宿主在 JNI 调用边界把该面积换算成等面积半球的输入,使现有 Windows 算法接口可继续使用。

标准的真实面积 S → r = √(S / 2π) → 原简易法 / 工程法 JNI
标准的测量面、点位和报告依据 → 原样保留

Evidence

  • Before: 显式面积通过未发布的 surfaceType=-1 传入,依赖定制的算法 DLL。
    After: 单测验证同一面积通过发布接口进入简易法及工程法的实时、结束计算路径,旧几何输入保持原有映射。提供显式面积时不再转发箱形或圆柱几何参数;简易法和工程法的参数记录都拒绝无效面积和面积与普通面型的混用。同步最新主线后 53 项相关单测通过。
  • Windows-huang、51 号设备、现有客户端与现有授权:两项均做 9 点、背景和正式各 15 秒,新结果文件均可读,Data Selector 和历史图谱正常。
  • 另以现有运行库做 80 个简易法、5 个工程法 JNI 数值用例,覆盖 0.75–125 m²(包括 14.5497、31.46、48.8496 m²),通过等面积输入核对面积、修正值和声功率。复测前后证书和 DLL 校验一致。设备验收使用现有客户端;没有把候选 JAR 或主线 DLL 换到实测客户端。

上一轮 Windows 全量 CI 的 24 个前端失败文件和 5 个后端失败类,与同期 main 运行以及后续 main 运行一致。本 PR 只修改声功率代码。

配套:原宿主改动 #26 已合入;插件见 OpenTest-Plugins-Internal #5。

Merge Danger

Door: two-way,可正常回退 Java 提交;不改 DLL、授权文件、数据库或插件 API 形状。

Blast Radius: 声功率中显式传入测量面积的调用。

@KyleHuangFromHZ
KyleHuangFromHZ requested a review from a team November 16, 2026 08:53

@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)

改动方向合理:在 JNI 边界把真实面积换算为等面积半球(S = 2πr²),取代依赖定制 DLL 的 surfaceType=-1。简易法、工程法实时和结束三条路径都改用同一辅助方法。工程法在换算之后才执行 removeIf(Objects::isNull),顺序正确。新增测试覆盖了面积等价、实时与结束参数一致,以及 roomSurface/absortionCoef 原样传递。

需要关注的问题:

  • 换算入口缺少防御。 soundPowerNativeSurface 只判断 area == null,没有校验面积是否为有限正数,也没有检查调用方是否同时提供了几何类型。详见行内意见。
  • 原生半球分支可能有额外约束(无法从 diff 确认)。 原生库源码不在本仓库,无法确认 surfaceType=0 是否对 sphereRadius/measureDistance 做半径范围或与声源尺寸相关的校验。如果有,小面积工况下等效半径可能触发真实几何本不会触发的状态码。PR 描述的 80 个简易法和 5 个工程法数值用例可以部分覆盖。建议在描述中注明这些用例覆盖的面积范围,尤其是较小的面积。
  • 旧接口可能残留死代码(无法从 diff 确认)。 换算后宿主不再向原生层传 -1 和 measurementSurfaceArea。如果 AlgorithmLibJNIBridgeService 或其他调用方仍有针对 -1 的专门分支,建议确认后一并清理,或者明确拒绝该值,避免以后误走定制接口。

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

@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)

整体思路清晰:只在 JNI 边界把真实面积 S 换算为等面积半球(r = √(S/2π)),对外 API 和插件配置不变,显式面积不再依赖未发布的 surfaceType=-1 DLL。简易法和工程法的实时、结束路径都改为同一换算,新增测试覆盖了参数集合、面积还原以及实时/结束两条路径的一致性,可以回退。

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

  • 新测试只验证 Java 侧的编码结果(surface == 0,且 2πr² == S),没有约束原生库对半球参数的理解。例如原生库是否只用 sphereRadius 或 measureDistance 之一,还是会把两者相加。描述中提到用现有运行库做了 80 + 5 个 JNI 数值用例,但没有说明面积取值范围,也没有纳入仓库。建议至少把其中的边界用例沉淀为可在 Windows 运行库上执行的集成或回归测试,或在代码注释中写明所依赖的原生行为及其来源。
  • 按 CONTRIBUTING.zh-CN.md,拉取请求描述应使用 Refs #<编号> 关联需求或缺陷。当前描述只引用了已合入的 #26 和插件仓库的拉取请求,缺少对应 Issue 的 Refs。

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

@KyleHuangFromHZ
KyleHuangFromHZ merged commit 04a838d into main Nov 16, 2026
11 of 13 checks passed
@KyleHuangFromHZ
KyleHuangFromHZ deleted the codex/sound-power-native-main branch November 16, 2026 10:11
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.

3 participants