更新与版本

检查更新

小荷 Client、荷视、荷阅默认在启动时检查更新，可在“设置 → 更新”中关闭。

• 有新版本时，标题栏出现更新标记；打开设置页能看到版本与说明，下载后重启完成更新。
• 小荷的设置页显示当前通道和最近检查时间。“自动下载更新”打开时会在后台下载，安装前仍会询问；“自动升级本机服务”会在没有进行中会话时重启服务并完成升级。
• 命令行用户可以直接运行 xiaohe upgrade；加 --beta 从 beta 通道取版本。

各平台更新方式

桌面端优先走应用内更新；手动安装包始终可用，适合更新失败或需要固定版本的情况。

表格可左右滑动。

iOS 版通过 App Store 更新；桌面端与 Android 的安装包见下载页。

beta 通道

beta 是预发通道，用来提前验证下一版；版本可能不稳定或不完整。正式版和 beta 各有一份版本清单，切换通道不会改变已安装的版本。

• 小荷：设置 → 更新 → “Beta 更新”。这个开关同时作用于桌面应用和本机服务，切换后会立即重新检查。
• 荷视 / 荷阅：设置 → 更新 → “从 beta 通道更新”，确认后生效。
• 命令行：xiaohe upgrade --beta；回到正式通道用 xiaohe upgrade。
• 切回正式通道后，如果已安装的 beta 版本高于正式版，客户端不会自动降级；需要等待正式版追上，或重新安装正式安装包。

更新失败怎么办

1. 在“设置 → 更新”里点“检查更新”或“重试”，确认网络和磁盘空间正常。
2. 下载中断或安装失败：从下载页重新下载对应平台的安装包，覆盖安装当前版本。会话、工作区和设置保存在本机，覆盖安装不会清空它们。
3. macOS 若提示无法验证：确认安装包来自下载页，再到“系统设置 → 隐私与安全性”允许打开。
4. Windows 安装包目前没有 Authenticode 签名，SmartScreen 可能提示；确认来源为 download.xiaohe.team 后，选择“更多信息 → 仍要运行”。
5. 仍无法完成：把版本号、平台和错误提示发给 support@xiaohe.team。

回滚与锁定版本

• 小荷 Agent：xiaohe upgrade <version> 可以切到指定的公开版本，例如 xiaohe upgrade 1.2.0；--beta 则从 beta 通道取版本。命令行切换只影响 Agent 和本机服务，不改变桌面客户端。
• 桌面应用（小荷 Client、荷视、荷阅）不提供一键降级。新版本有问题时，先保留数据并等待修复版本；确需降级请联系 support@xiaohe.team。
• 荷视维护者：make rollback-heshi [VERSION=x.y.z] 只收回 public 的更新报价，让尚未升级的客户端不再安装坏版本；已经升级的客户端不会被自动降级。普通用户不需要执行。

版本号规则

• 每个产品独立编号，采用 主.次.修订（X.Y.Z）。小荷的 Agent 与 Client 分开发布，同一次发布可以有两个 tag：agent-v1.2.0、client-v1.4.0。
• 荷视、荷阅使用 vX.Y.Z（如 v0.2.3）；荷算 v0 用 vX.Y.Z，v1 用 X.Y（如 1.3）；OpenFOAM 沿用上游年份发布号 2412，我们的打包修订追加在后面（当前 v2412.5）。
• beta 是通道，不是版本号后缀；正式版和 beta 各有一份 latest.json。
• 页面与下载清单以发布 tag 和下载目录为准；日期是发布日，不是安装日。