Repository navigation
feat(hardware): 优化设备列表、协议版本和固件升级 - #63
Merged
KyleHuangFromHZ merged 1 commit intoNov 18, 2026
Merged
Conversation
There was a problem hiding this comment.
AI 代码审查(claude-opus-5-5)
整体实现与描述一致:离线批量清空逐条独立事务并复核状态,SDK 版本查询只读取已生效的运行内容,固件上传和确认前增加了占用检查,前后端都补了单元测试。主要风险在固件升级的空闲检查:
- 设备定位依赖 IP 字符串精确相等,可能误拦截合法升级。
- 代理里临时构造的
Device能否与采集、播放登记的身份对上,没有测试覆盖。 - 检查与转发之间不是原子操作。
其他意见:
- 缺少必要测试:
CppHttpController中拦截upload及action=confirm的分支没有测试。CppHttpProxyService.assertUpgradeIdle的设备匹配也没有测试,包括 IPv6、找不到设备、非 confirm 动作放行等情况。现有测试都用device("Sono-A")直接构造设备,没有经过代理里的 driver→Device 映射,无法证明真实链路能识别出正在采集或播放的设备。 - 无关格式改动:
en.ts和zh-CN.ts中有大量与本功能无关的重排。我逐段核对过,嵌套结构没有变化。但这些改动会明显扩大 diff,回移到release/*时容易冲突,建议拆成单独的拉取请求。 - 贡献授权未勾选:拉取请求描述中“贡献授权”一项未勾选,合并前请提交者确认。
因篇幅限制未审查 5 个文件:
apps/frontend/src/stores/ota-upgrade.ts、docs/specs/hardware-device-actions.md、docs/specs/hardware-device-actions.zh-CN.md、docs/verification/hardware-device-actions.md、docs/verification/hardware-device-actions.zh-CN.md
由 AI 自动生成,仅供参考,不作为合并依据。审查提交:
83a88c0。维护者可评论/review重新审查。
mingtaojin
approved these changes
Nov 18, 2026
cuimmm
self-requested a review
November 18, 2026 07:10
cuimmm
approved these changes
Nov 18, 2026
KyleHuangFromHZ
deleted the
feature/hardware-device-actions-implementation
branch
November 18, 2026 07:18
KyleHuangFromHZ
added a commit
that referenced
this pull request
Nov 18, 2026
## 改了什么,为什么 / What changed and why
固件上传和确认原先在空闲检查通过后仍可能与采集或播放启动重叠。本改动用同一设备占用登记覆盖检查与 HTTP
转发,采集、有限播放和持续播放启动都检查该占用,转发结束或失败后释放。
```text
设备驱动 → 规范化地址匹配 → 实际驱动身份
├─ 升级上传 / 确认 → 独占,持有至转发结束
└─ 采集 / 播放启动 → 检查升级占用
```
补充处理 PR #63 的其余 AI 建议:等价升级路径和确认大小写统一校验;取消继续放行;错误 JSON
返回参数错误;清空响应丢失后刷新设备和通道;版本查询增加诊断;内层动作改为 Upload;还原无关语言文件排版,修复受入口变化影响的旧测试。
Refs #36. Follow-up to #63.
## 怎么验证的 / How it was verified
- [x] 后端 99 项定向测试及增量打包通过。包含真实服务的 driver→Device 身份链路、IPv4/IPv6/scoped
IPv6、占用互斥和失败释放,以及控制器转发期间占用、路径规范化和取消放行。
- [x] 前端整个硬件模块及相关回归 174 项通过。新增真实 Element Plus 确认框的清空响应丢失、确认前取消测试。
- [x] SDK 构建、前端生产构建、改动文件 ESLint/格式和 docs-policy 通过。
- 原 PR 后端 CI 的失败用例与基线 main `404f249c` 的
[CI](https://github.com/crysound/OpenTest/actions/runs/44218810513)
完全一致;本地完整前端测试类型检查仍有同基线的 9 处既有错误。完整 CI 未通过。
- 之前的 Windows 与物理 SonoDAQ 实测记录属于
#63。本次新增占用互斥尚未作真机验收,自动化结果及边界见[验证记录](docs/verification/hardware-device-actions.zh-CN.md#ai-审查修复验证)。
## 影响 / Impact
- [x] 用户可见的改动,已更新中英文规格和验证记录。
- 影响设备 HTTP
升级、采集/播放启动的占用登记,以及硬件配置中的清空和上传入口。无数据库迁移,应用改动可回退。设备端升级完成判据沿用既有逻辑。
## 贡献授权 / Contribution license
- [x] 沿用本任务 PR #63 中已确认的 OpenTest 社区许可协议第 11 条“社区贡献”授权声明。
---------
Co-authored-by: kyle.huang <324400663+KyleHuangFromHZ@users.noreply.github.com>
Co-authored-by: 黄凯 <huangkai@huangkaideMacBook-Air.local>
5 tasks done
KyleHuangFromHZ
added a commit
that referenced
this pull request
Nov 20, 2026
## 改了什么,为什么 / What changed and why 修复停采失败后升级误放行、上传取消后后端持续占用、取消失败无反馈和重开详情丢失成功结果。停止状态未确认时继续拦截升级;上传按任务取消并限制转发时长;错误和完成结果保存在设备会话状态中。 ```text 停止失败 → 保留设备/通道故障 → 真实停止或成功断开后解除 上传任务 → 有限等待 / 按任务取消 → HTTP 结束 → 释放升级占用 升级结果 → 设备会话状态 → 关闭重开详情后恢复 ``` Refs #36. Follow-up to #65. ## 怎么验证的 / How it was verified - [x] 已合入 main `4731cb53`,无冲突。当前提交 `06e48d5e`,PR 相对 main 仍仅包含本次固件故障恢复的 15 个文件。 - [x] 合并后后端 95 项、前端硬件和状态相关 38 项定向回归全部通过;完整前端测试类型检查通过(6 GB Node 堆);框架依赖检查和 docs-policy 通过。后端使用 JDK 21 增量编译,未执行 clean。 - [x] 2026-11-19 真机验证:windows-huang(192.168.5.224),物理 SonoDAQ Pro(192.168.5.157,设备 51),配套 native 材料和 SonoDAQ SDK 1.4.0,用户提供的 V1.2.8 / 64,200,304 字节固件。后端、前端生产构建及改动文件 ESLint/格式检查也在该轮通过。本次合并未修改固件生产源码;没有把之前的真机结果描述为合并后重新实测。 - **Before → After:**真实采集启动后注入停止失败,升级从可准入变为拒绝;真实停止成功后恢复。真实上传校验响应被代理暂扣,取消后从长期占用变为可以启动真实采集;临时设定 8 秒超时后,连接在 8003 毫秒结束,随后真实采集成功。取消请求网络故障从无反馈变为行内错误;真实确认成功响应在详情关闭重开后送达,从结果丢失变为版本行显示成功。 - 真机执行与人工故障注入分别记录,未伪造设备成功响应,未在刷写期间断电。测试后恢复默认超时、取消设备待确认包、停止代理并完整重启清除测试 agent。详见[验证记录](docs/verification/hardware-device-actions.zh-CN.md#固件故障恢复复测)。 - 当前提交的 CodeQL 和 docs-policy 已通过;新一轮前后端完整 CI 仍在运行。AI 审查服务连续两次返回 HTTP 524,未生成代码意见。旧基线的 CI 失败记录不作为新提交的结果。 ## 影响 / Impact - [x] 用户可见的改动,已更新中英文规格和验证记录。 - 新增宿主上传取消入口和可选上传标识头,保留旧调用兼容;设备端协议与确认成功判据沿用原逻辑。无产品数据库迁移;真机测试环境仅在备份后补执行已有缺失字段迁移。 - **Door:** two-way,应用代码可回退。 - **Blast Radius:** hardware,影响固件 HTTP 转发和采集停止后的升级准入。 ## 贡献授权 / Contribution license - [x] 沿用本任务 PR #63 中已确认的 OpenTest 社区许可协议第 11 条“社区贡献”授权声明。 Co-authored-by: 黄凯 <huangkai@huangkaideMacBook-Air.local>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
改了什么,为什么 / What changed and why
把设备刷新放到 Devices 标题栏,给 Offline 设备增加批量清空,并在 Protocol 表头悬停展示 SDK 或驱动版本。SonoDAQ 固件升级移到 Firmware Version 旁,可以在设备详情内选文件、上传并确认升级。
NI-DAQmx 版本无法读取时显示
--。离线清空沿用单条移除的通道处理规则。上传和确认升级会检查设备是否正在采集或播放。怎么验证的 / How it was verified
影响 / Impact
贡献授权 / Contribution license