v1.1.0

Guide v1.1.0

新增官方一键安装器与 guide-update，让安装、升级、备份和失败回滚更方便。

新功能

• 官方 install-guide.sh 支持首次安装，并为符合条件的已有实例接入升级器。
• guide-update --check 只读检查更新；guide-update 升级到最新正式版，不自动降级。
• 下载后校验 SHA-256、归档内容和版本，校验通过才停止旧服务；新版启动失败时恢复升级前数据库与旧二进制。

安装、升级与兼容性

• **首次安装：**先确认机器上没有旧 Guide 实例，按安装文档下载并校验安装器，校验失败立即停止。首次生成的随机应急密码可能留在终端或日志中，登录后立即修改；后台应通过 HTTPS 反向代理访问。
• **已有 v1.0.0：**不要直接执行首次安装步骤。先核对原 guide.service、二进制和数据库路径，再对已校验的安装器运行 sudo sh ./install-guide.sh --check。必须识别原实例；出现 not installed 或报错时停止。确认后再执行安装器，成功后接入 guide-update，保留原数据、配置和账号。
• **已接入升级器：**先运行 sudo guide-update --check，再运行 sudo guide-update。安装器和升级器都会选择运行时的最新正式版，不会将 Hub 固定在 v1.1.0。
• 本版数据库 schema 保持 13。升级会短暂停服，备份数据库、当时存在的 WAL/SHM 文件及旧二进制；仍建议预先保存独立、可恢复的备份。备份含凭据，禁止公开；不要只复制运行中的 SQLite 主文件。
• 回滚须恢复完整数据库快照和旧二进制。断电、强制终止或磁盘故障不能保证自动恢复，请按文档人工处理。

安装与下载

安装、旧部署接入与恢复指南 · 账号恢复 · 本版附件

已知限制

• 官方安装器适用于 Linux x86_64、兼容 glibc 和 systemd，需 root 及文档列出的依赖；不支持 ARM、Windows、Alpine/musl、OpenRC 或容器内升级，暂无官方 Docker 镜像。
• 自定义服务名、手工启动、wrapper 或无法确认的数据库路径不能自动接管；不能把未识别的旧部署当成新实例安装。真实 v1.0.0 旧部署接入与整机重启恢复仍未完成完整验收。
• 部分第三方依赖的许可证证据仍待补齐，见公开披露。