Version and compatibility

版本与兼容性

最新正式版从 Releases/latest 获取。近期变化与升级影响见版本更新，逐段旧版升级前提见升级版本参考。本页说明兼容条件和已知验证范围，不代替对应版本的 Release。

安装条件

项目	要求与核对方式
宿主	SandAdmin；核对所选安装包 info.ini 与插件仓库中该版本的宿主范围，0.8.4 起为 >=0.1.0，开放上限。
安装器	SandPackage；下载、上传和生命周期均通过宿主插件管理完成。
数据库	仅 PostgreSQL，使用现有宿主数据库；插件不创建数据库。
PHP	>=8.2；扩展与运行预检见安装与升级。
管理端	包内为源码，需由宿主构建、激活；安装文件存在不等于菜单页面已经可用。
业务接入	业务应用执行授权并落实数据范围，执行前复核实体；后台保存配置不等于业务已经生效。

当前发布与验证范围

2026-10-04 的 0.8.4 兼容修复版将宿主准入从 0.1.x 修复为 >=0.1.0，允许 0.2.0 等更高宿主进入安装校验。业务代码、依赖锁文件及 SQL 与 0.8.3 相同；本次验证仅覆盖包一致性和官方 SandPackage 版本准入，没有重新执行 SQL 或验证 0.2.0 业务。

2026-10-03 已公开 0.8.3 正式版。该版 Release 记录 Windows 标准升级、允许/拒绝、保存/发布、撤销与审计已验；Mac 仅验证事务回滚，未安装本版或验证界面，受限角色未实机验。该记录不证明任意宿主、数据库或协议组合都已验收。

本版使用 v1 manifest 与 SHA-256 下载校验，未提供包外签名。来源校验及额外签名要求见发布包校验。升级账本与结构前提见安装与升级。

接口与历史说明

管理 OpenAPI 的接口契约版本与插件发行版本分别维护；SDK 发布渠道与支持范围须按对应 SDK 页面核对。OIDC、SCIM、CAS、Kerberos 等对接能力需要各自配置及真实对端验证，路由存在不证明互操作通过。

旧 0.7.3 候选指南的签名契约与 42 条迁移账本不能直接作为当前正式版的安装或升级要求。历史账本前提保留在升级版本参考。

文档首页 · 安装与升级

详细操作文档的维护入口统一在本 Wiki。本次源码整改后的后续构建不再复制整套指南；已公开 v0.8.3 的 1053 条目 ZIP 保留原载荷，本轮不重打包或替换发行件。离线操作前取得所选版本对应的指南。

源码目录和构建校验见 开发入口与构建校验。