Skip to content

重构(上位机)：迁移 Rust TController 并补齐构建、CI 与文档 - #1

Merged
ZhiYi-R merged 14 commits into
masterfrom
refactor/ControllerRIIR
Aug 25, 2026
Merged

重构(上位机)：迁移 Rust TController 并补齐构建、CI 与文档#1
ZhiYi-R merged 14 commits into
masterfrom
refactor/ControllerRIIR

Conversation

@ZhiYi-R

@ZhiYi-R ZhiYi-R commented Aug 25, 2026 •
edited
Loading

Copy link
Copy Markdown
Owner

这个 PR 承载的内容

本分支相对 master 共有 13 个提交，覆盖固件修复、上位机从 Python 迁移到 Rust/Tauri、CI 构建矩阵，以及面向人类的文档与算法报告。代码逻辑之外的改动只有注释和文档。

固件

  • 1bffa39 修复 IWDG 初始化死锁

上位机迁移与功能

  • 6ff3cd5 重构：把 Python 上位机迁移为 Rust TController（controller-core 后端 + Tauri 壳 + Next.js 前端）
  • 4925633 更新 TController 使用说明
  • 0e051dd 清理：移除旧 Python 上位机依赖配置
  • 5d8934d 修复 Tauri 自动构建 Next.js 前端
  • e7b3e38 改进：显示进样背景进度
  • 5f29d24 改进：浓度自动计算与视觉柔化

持续集成

  • cce0304 固件与上位机四平台构建矩阵
  • aef9f91 添加 macOS 构建，下限压到 10.13
  • 0a54ae1 任意分支推送均触发构建

文档与表述打磨

  • e0beb9b 清理文档与注释里的 AI 味和翻译腔
  • e0565de 新增面向人类的文档（使用手册、协议、固件开发指南、硬件接线、数据格式）并配英文版，中英互链
  • 82a3b93 新增多模态融合算法技术报告（LaTeX 公式 + mermaid 图），继续打磨中文表述

说明

  • 这是 draft PR，先合入前请按上面分组逐段核对。
  • 其中 6ff3cd5 是一次大的上位机迁移，建议优先 review。

ZhiYi-R added 14 commits August 24, 2026 07:29
@ZhiYi-R
修正(光谱)：按 calibre.npz 修正波长范围并去除验证脚本硬编码路径
5ecddfe 
- reconstructor 文档注释改为 380–1100 nm、721 点（实测矩阵 (721,10)，1 nm 步长），清理行内乱码
- SpectrumWidget 初始 x 轴从 1000 放宽到 1100 nm，与数据范围一致
- validate_endpoint.py / validate_online.py 数据文件改为 --input 必选参数，与 validate_online_multimodal.py 范式统一
@ZhiYi-R
修复(IWDG)：避免独立看门狗初始化死锁
1bffa39
@ZhiYi-R
重构(上位机)：迁移 Rust TController 项目
6ff3cd5
@ZhiYi-R
文档(上位机)：更新 TController 使用说明
4925633
@ZhiYi-R
清理(Python)：移除旧上位机依赖配置
0e051dd
@ZhiYi-R
修复(Tauri)：自动构建 Next.js 前端
5d8934d
@ZhiYi-R
改进(上位机)：显示进样背景进度
e7b3e38
@ZhiYi-R
改进(上位机)：浓度自动计算与视觉柔化
5f29d24 
- 顶栏新增滴定剂浓度与计量比 a∶b 输入，终点后自动计算分析物浓度
  c = c滴定剂 × V终点 × (a/b) ÷ V样品，浓度行附带终点置信度徽标，
  计算式收进悬浮提示
- 移除工作台事件日志卡片：结果面板独占右列整高，一屏放完不滚动；
  T=1 初判在最终结果出来后折叠为摘要行
- 日志分流：仅泵手动操作入 store（维护页动作记录），其余事件走 console
- 深色主题柔化为暖灰纸面：背景抬离纯黑并带微量暖度、前景柔白、
  边框与图表网格减淡、状态色降饱和；嵌套输入簇改透明底消除内陷黑块
- 图表修复：dE/dV 右轴刻度按步长自适应小数位（不再出现重复标签），
  双终点标记标签向外侧排布防重叠，标定散点图 X 轴末端刻度不再被裁
- 数据记录页空状态图标与文字组合居中
- 修复(mock)：callMock 丢失 this 导致 disconnect 抛异常卡死运行
@ZhiYi-R
构建(CI): 固件与上位机四平台构建矩阵
cce0304 
- 合并 firmware-build.yml 到统一的 build.yml：固件与上位机各平台并行构建
  （fail-fast: false），RELEASE-* 标签时由单个 release job 汇总全部产物、
  生成 SHA256SUMS 并创建 Release。原工作流自己建 Release，会与汇总 job
  抢同一个 tag
- 上位机矩阵四条腿全部跑原生架构 runner（windows-latest / windows-11-arm /
  ubuntu-24.04 / ubuntu-24.04-arm）：Tauri 的 AppImage 与 MSI 打包器无法跨
  架构工作。Windows 出 msi/nsis/portable.zip，Linux 出 deb/rpm/tar.gz/AppImage
- 修掉 Linux 打包必崩的图标问题：bundle.icon 只有一帧 16×16 的 .ico，而
  tauri-bundler 的 Linux 分支会跳过非 PNG 图标，AppImage 打包器随后在图标集
  为空时 panic。新增 icons/icon.svg 与 scripts/gen_app_icons.mjs，生成
  32/128/256/512 PNG 与六尺寸 ICO，产物一并提交
- tar.gz 由 CI 用 dpkg-deb -x 解出 deb 文件树重新打包（Tauri 无此目标），
  内容与 deb 一致
- Windows aarch64 只出 NSIS：WiX v3 的 arm64 支持未在 Windows on ARM 上验证，
  且打包器失败会连带丢掉同条腿已编好的 NSIS 产物
- Linux 选 24.04 而非 22.04：22.04 镜像自 2026-09-17 起进入弃用期，代价是
  glibc 下限升到 2.39
- 修正 license 元数据：workspace 的 MIT 改为 LicenseRef-PolyForm-Shield-1.0.0
  （该字段会写进 rpm 的 License 标签），bundle.licenseFile 指向根 LICENSE；
  deb 补 libudev1 依赖（serialport 4 需要）
@ZhiYi-R
构建(CI): 添加 macOS 构建，下限压到 10.13
aef9f91 
- 新增 macos-aarch64 / macos-x86_64 两条腿，各出 .dmg 与 .app.zip。.app 是
  目录，upload-artifact 会丢掉可执行位和符号链接，所以用 ditto 打 zip
- bundle.macOS.minimumSystemVersion 显式设为 10.13（同时写入
  LSMinimumSystemVersion 与 MACOSX_DEPLOYMENT_TARGET），这是工具链能压到的
  最低值：Apple SDK 支持表里 Xcode 16.x 的 deployment target 是 10.13–15，
  Tauri 打包器默认下限也是 10.13
- runner 固定 macos-15 / macos-15-intel 而非 macos-latest：Xcode 27 起最低
  deployment target 抬到 macOS 12.0，用 latest 会随镜像升级悄悄丢掉旧系统支持
- 不需要额外的 .icns：bundle.icon 里没有 .icns 时，打包器会用 icns crate 把
  现有 PNG 打成 ICNS（含 is32/il32 这类需要 RLE 编码的旧格式）
- 产物未签名未公证（仓库无 Apple 证书，Tauri 仅在设置 APPLE_CERTIFICATE 时
  签名），README 记录了 Gatekeeper 绕过方式与启用签名所需的 secret
@ZhiYi-R
构建(CI): 任意分支推送均触发构建
0a54ae1 
- push 的 branches 过滤从 [master, main] 放开为 ["**"]，pull_request 去掉
  base 分支限制
- branches 必须显式写 "**" 而不能整段删掉：push 下一旦有 tags 过滤器，
  缺省的 branches 就等于「不匹配任何分支」，分支推送会静默不触发
@ZhiYi-R
打磨(文档与注释)：清理 AI 味与翻译腔表达
e0beb9b 
- README 项目简介补充功能说明
- 统一 innovation 译为新息、contract 译为约定、floor 译为下界
- 去除破折号、比喻与 LLM 黑话（对齐/契约/地板/确保/显著/核心等）
- 修正语序与选词（当量点、ICNS、带跑→带动等）
@ZhiYi-R
文档(项目文档)：新增面向人类的文档与英文版
e0565de 
- 新增上位机使用手册、通信协议、固件二次开发指南、硬件接线、标定与数据格式五份文档
- 全部文档配备同内容英文版，文件名以 _EN 结尾
- 中英文文档互相链接，根 README 补充文档索引
- 新增根 README 英文版
- 公式以 LaTeX 嵌入，流程图与时序图以 mermaid 绘制
@ZhiYi-R
文档(算法报告)：新增多模态融合算法技术报告
82a3b93 
- 新增算法技术报告（中英双语），描述电位/光谱双通道、KF 融合、AMPD 微调与可靠性诊断
- 公式以 LaTeX 嵌入，架构图以 mermaid 绘制
- 中英文文档互相链接，根 README 文档索引补充算法报告
- 打磨文档与代码注释的中文表述（微调、假阳性、推送给、防止回归等）
- 消除对仓库外本地数据 tmp_diff 的悬空引用
@ZhiYi-R ZhiYi-R changed the title 文档：新增多模态融合算法技术报告并打磨中文表述 重构(上位机)：迁移 Rust TController 并补齐构建、CI 与文档 Aug 25, 2026
@ZhiYi-R
ZhiYi-R marked this pull request as ready for review August 25, 2026 21:46
@ZhiYi-R
ZhiYi-R merged commit 747a5ab into master Aug 25, 2026
16 checks passed
@ZhiYi-R
ZhiYi-R deleted the refactor/ControllerRIIR branch August 25, 2026 22:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@ZhiYi-R