Guide v1.2.0

Guide v1.2.0

新增 Cloudflare“检测受限”状态与独立分类管理，支持分类排序、空分类和前台同步。

新功能

• **检测受限（protected）：**明确遇到 Cloudflare 验证挑战时显示“检测受限”，不显示虚假响应时间。正常响应仍显示在线，普通 403、429、503 不会仅凭错误码判为受限。网站链接仍可访问，但受限状态不代表已确认网站可用。
• **分类管理：**后台支持新增、编辑、删除、上下移动排序、空分类及关联网站计数；服务编辑可选择已创建的分类。
• **前台同步：**分类栏按后台顺序显示，“全部”始终在首位并默认选中。有关联网站的分类必须先迁移网站才能删除，计数包含私有和停用网站。

优化与修复

• 改进分类更名后的数据同步，避免编辑网站时恢复旧分类；统一新写入分类名称的校验。
• 保持原在线检测周期、超时规则与安全防护。

升级与兼容性

• 已接入官方升级器的实例，先运行 sudo guide-update --check，再运行 sudo guide-update；v1.0.0 首次接入须按安装文档核对旧部署。
• 数据库 schema 13 → 14 在新版首次启动时自动迁移，无需手工操作。保留原网站、分类、网站排序和检测数据，旧 Service API 继续兼容。
• 升级前保存可恢复的备份。官方升级器停服后备份数据库及 WAL/SHM 和旧二进制，启动失败时整体回滚；手工回退也必须恢复升级前完整快照，不能只替换旧二进制。恢复快照会覆盖备份后的修改，请先另存需要保留的数据。
• 已有管理分类时，会拒绝恢复缺少分类表的旧备份，以保护空分类和排序；不要删除分类或网站来绕过保护。

安装与下载

安装、升级与数据恢复指南 · 账号恢复 · 本版附件

下载时使用同一版本的归档、独立 .sha256 和 sha256sums.txt；安装器也须校验，校验失败立即停止。

已知限制

• 官方安装与升级支持 Linux x86_64、兼容 glibc 和 systemd；ARM、Windows、Alpine/musl、OpenRC 和容器内升级不受支持，暂无官方 Docker 镜像。断电、强制终止或磁盘故障不能保证自动回滚。
• 部分第三方依赖的许可证证据仍待补齐，见公开披露。

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 旧部署接入与整机重启恢复仍未完成完整验收。
• 部分第三方依赖的许可证证据仍待补齐，见公开披露。

v1.0.0

Full Changelog: https://github.com/NSJLUCAS/Guide/commits/v1.0.0