v9.9.9-root-reset

严重警告：这是 ROOT/ADMIN 密码恢复专用固件

这不是正常 TianShanOS 发布，不是生产固件，不是普通升级包。

禁止用途

• 禁止用于生产环境。
• 禁止作为普通用户升级固件。
• 禁止分发给其他用户或用于其他人的设备。
• 禁止把它当作 TianShanOS 9.9.9 正式版本使用。

唯一允许用途

仅限授权设备所有者在受控恢复场景中临时刷入，用于把 root 和 admin 密码都重置回默认值 rm01。

行为说明

• 这是 app-only 临时恢复固件。
• 只写入 NVS 中的 ts_auth/cred_root 和 ts_auth/cred_admin。
• 不擦除网络配置、证书、SSH key 或其他 NVS 数据。
• 不启动 WebUI、API、网络、SSH 或 console。
• 成功写入并读回校验后，会切回另一个有效 OTA app 分区并重启。

使用方式

WebUI 手动 OTA 上传此 bin 时，必须取消“包含 WebUI”，不要上传或刷写 www.bin。如果 OTA 认证不可用，只能使用串口恢复流程。

资产

• 文件：TianShanOS-RootReset-v9.9.9.bin
• 构建版本：9.9.9-root-reset.172435.339f05
• SHA256：75a4cfe92ceebe3433792c97b65cfec537b91b390f1d0b7a5ba5c84200c843a3
• 提交：339f05e0ebda01172bea9b95651c9158db1812b0

再次强调：这个固件只能用于 root/admin 密码恢复，不能用于任何生产或普通用户场景。

Full Changelog: v0.5.1...v9.9.9-root-reset

v0.5.1

What's Changed

• fix: 接入上层网络前校验 USB MUX by @massif-01 in #33
• chore: update prebuilt firmware to v0.4.9 (Jun 11 2026) by @massif-01 in #34
• 发布 v0.5.0：修复 OTA 与 SD 卡 WebUI 升级 by @massif-01 in #35
• 修复浏览器代理 OTA 竞态并发布 0.5.1 by @massif-01 in #36
• 发布 v0.5.1：恢复静态资源缓存、root 密码管理与 UI 优化 by @massif-01 in #37

Full Changelog: v0.4.8...v0.5.1

v0.5.0

TianShanOS v0.5.0

本版本重点修复 OTA 与 SD 卡升级链路，避免固件版本显示 unknown，以及从 SD 卡升级时只更新应用、不更新 WebUI 导致页面不一致的问题。

更新内容

• OTA Server 直接解析 TianShanOS.bin 内嵌的 ESP-IDF app desc，/version 与 /info 可显示真实固件版本、IDF 版本、编译时间和 SHA256。
• SD 卡 OTA 会复制升级路径，避免异步任务引用已释放的 JSON 字符串。
• SD 卡恢复升级默认要求 TianShanOS.bin 与 www.bin 同时存在；如需只刷应用，需要在 manifest.json 中显式设置 "www": ""。
• WebUI 的 SD 卡升级输入支持 /sdcard/、/sdcard/TianShanOS.bin 和 /sdcard/www.bin，会自动匹配同目录的固件与 WebUI 文件。
• 勾选包含 WebUI 时，会在启动固件升级前校验 www.bin 是否存在，避免半升级后自动重启。
• WebUI 静态资源取消 JS/CSS 长期 immutable 缓存，并加入版本参数，减少升级后浏览器继续使用旧 app.js 的问题。
• 调整 build 目录跟踪规则：不再忽略整个 build/，只忽略中间产物，并保留 Release 所需构建产物。

构建说明

此 Release 发布后会由 GitHub Actions 重新编译固件，并自动把 TianShanOS.bin、www.bin、bootloader.bin、partition-table.bin、ota_data_initial.bin 和 flasher_args.json 上传到本 Release。

What's Changed

• fix: 接入上层网络前校验 USB MUX by @massif-01 in #33
• chore: update prebuilt firmware to v0.4.9 (Jun 11 2026) by @massif-01 in #34

Full Changelog: v0.4.8...v0.5.0

What's Changed

• fix: 接入上层网络前校验 USB MUX by @massif-01 in #33
• chore: update prebuilt firmware to v0.4.9 (Jun 11 2026) by @massif-01 in #34

Full Changelog: v0.4.8...v0.5.0

v0.4.9

主要变更

• 新增 LPMU 接入前置 USB MUX 校验：network.lpmu_access.start 只有在当前 USB 目标为 LPMU 时才进入 SSH/SCP 流程。
• USB MUX 未配置时快速失败：USB MUX 未配置，无法确认是否已切换到 LPMU。
• 当前 USB 目标不是 LPMU 时快速失败：请先将 USB 切换到 LPMU 后再接入上层网络。
• 失败路径不创建后台任务、不加载 SSH key、不建立 SSH/SCP、不触碰嵌入 tarball。

固件资产

• TianShanOS.bin
• www.bin
• bootloader.bin
• partition-table.bin
• ota_data_initial.bin
• flasher_args.json

验证

• 本地 ESP-IDF v5.5.2：idf.py reconfigure build 通过。
• GitHub Actions：TianShanOS Build 在 v0.4.9 tag 上构建并发布成功。
• GitHub Actions：合并后的 main 构建与 Release 更新成功。

相关链接

• PR：#33
• 完整变更对比：v0.4.8...v0.4.9

v0.4.8

What's Changed

• 支持 root 恢复 admin 密码并发布 0.4.8 by @massif-01 in #32

Full Changelog: v0.4.7...v0.4.8

v0.4.7

What's Changed

• fix(security): evict same-user sessions when slots full on login by @massif-01 in #23
• fix(webui): 修复刷新后登录状态丢失与 i18n 覆盖用户名 by @massif-01 in #24
• feat(webui): 设备面板支持长按 3 秒后拖拽排序 #25 by @massif-01 in #26
• feat: 风扇曲线多变量加权绑定 & 固件 v0.4.5 by @massif-01 in #27
• feat: 添加 LPMU 接入上层网络 by @massif-01 in #28
• 添加自适应自动风扇控制 by @massif-01 in #29
• fix: 优化自动风扇温度失效降速 by @massif-01 in #31

Full Changelog: v0.4.3...v0.4.7

v0.4.6+fa50320.05250712

What's Changed

• 添加自适应自动风扇控制 by @massif-01 in #29

Full Changelog: v0.4.6+7971c61.05191343...v0.4.6+fa50320.05250712

v0.4.6+7971c61.05191343

What's Changed

• feat: 添加 LPMU 接入上层网络 by @massif-01 in #28

Full Changelog: v0.4.5+29573c0d.04061331...v0.4.6+7971c61.05191343

v0.4.6

主要变更

• 新增 LPMU 接入上层网络能力：ESP32-S3 固件内嵌 lpmu-agx-network-setup.tar.gz，无需新增 SPIFFS 分区或运行时解压到本地。
• 新增 network.lpmu_access.start/status API：使用已保存 SSH key、known-host 校验和单后台任务完成远端检查、SCP 上传、解包、chmod 与 sudo -n ./setup-smart-route.sh 执行。
• 网络页面新增「接入上层网络」面板和「通过LPMU接入」按钮，运行中仅轮询短状态和输出摘要。
• 固件版本升至 0.4.6，Release workflow 固定 ESP-IDF v5.5.2。
• Release 发布现在会自动构建固件并上传 .bin 资产，同时上传 flasher_args.json 方便按偏移烧录。

固件资产

• TianShanOS.bin
• www.bin
• bootloader.bin
• partition-table.bin
• ota_data_initial.bin
• flasher_args.json

验证

• GitHub Actions：TianShanOS Build 在 v0.4.6 tag 上构建并发布成功。
• 本地 ESP-IDF v5.5.2 构建通过，TianShanOS.bin 大小 0x209cf0，app 分区剩余 0xf6310（约 32%）。
• 已创建 PR：#28。

v0.4.5+29573c0d.04061331

What's Changed

• feat: 风扇曲线多变量加权绑定 & 固件 v0.4.5 by @massif-01 in #27

Full Changelog: v0.4.4+4a3a734d.03130821...v0.4.5+29573c0d.04061331