Repository navigation
plugin updates
面向准备安装或升级的管理员：先找到要使用的组件，阅读最近公开版本的变化与升级影响，再打开完整历史核对目标版本。以下日期按 Asia/Shanghai 时区记录；公开版本于 2026-10-04 核对；源码记录和公开发行均不等于目标宿主已升级或通过业务验收。
0.2.2 公开版本 修复数据库安装成功后，在前端尚未启动时直接跳向不可访问登录页的问题。完成页保留结果和前端启动步骤，启动后重检进入登录；重新访问安装入口仍可恢复，不重复安装数据库或回显初始密码。明确后台URL支持独立域名及子路径，开发端口占用时明确报错，不再自动漂移。
升级影响：不执行数据库迁移、不重置账号、不自动启动前端。宿主最低Core约束提高为 ^0.2.2，通过正常Composer钩子发布匹配前后端源码并重新构建、发布管理端；旧静态构建缺少入口检查图像时无法自动确认。前端固定pnpm 11.19.0，推荐Node.js 22（至少22.12.0）。配置与恢复步骤见完成安装并进入后台。静态资源响应不证明登录、认证或业务正常。
SandAdmin 0.2.1 锁定Core0.2.2和Package0.2.2；Package系统更新与Windows配置说明沿用下方记录。完整历史：Core更新日志 · 公开发行。
0.2.1 公开版本 修复插件安装触发 Webman 重启后，管理端初始化遇到短暂连接中断而停留在 500 页的问题。初始化请求会在共享 15 秒窗口内恢复，每个请求最多 6 次；仅对连接中断或明确为空的 500/502/503 响应重试。持续故障仍进入 500，登录失效、权限拒绝和业务错误保持原有处理。
升级影响：不执行数据库迁移，也不修改插件生命周期 SQL。已有宿主需要将 Core 约束提高到 ^0.2.1，通过正常 Composer 安装/更新钩子发布前后端，并重新构建、发布管理端；只更换后端 vendor 文件不会让浏览器获得修复。SandPackage 保持 0.2.1。先备份私有配置与自行修改的管理端文件；前端发布器会拒绝覆盖未登记或已修改的受管文件。
已从 公开 SandAdmin 固定 revision 在 Windows 执行正常 composer install，Core 0.2.1 / Package 0.2.1 版本、源码引用、前端发布清单和四个修复文件摘要一致；前端构建及类型检查通过。原生 Chrome 正常登录后，通过真实仓库按钮安装公开 SandIAM 0.8.4，初始化遇到空 500 后自动恢复至已安装页，没有停留在 500 或弹出重复错误。持续故障、权限、业务拒绝和登录失效边界已在同一修复候选独立验收。此记录验证安装后重载恢复，不代表已有部署自动升级，也不代表 SandIAM 全业务验收通过：本次总览应用列表另返回业务 404，根因与归属尚未确定。完整历史：Core 更新日志 · 全部公开版本。
此前 0.2.0 配套后台系统更新，修正运行版本信息，并提供不改变数据库及宿主骨架的官方文件契约。0.1.9 修复菜单初始化失败后首页或重新登录进入 404 的问题。
Package 0.2.0 增加后台「插件管理 → 系统更新」，可检查宿主核心及插件管理器版本，执行受控升级，保存进度并提供失败恢复。Package 0.2.1 修复已安装版本仍出现在目标选择中的问题。Windows 后台更新需先接入 Package 0.2.2 公开版本（Windows 最低约束 ^0.2.2），配合 Core 0.2.0 或更高版本。
升级前由宿主管理员按 后台系统更新 完成实际 PHP、静态部署、服务重载和健康检查配置。Linux/macOS 沿用现有执行器；Windows 新增独立后台执行及恢复；官方稳定发行必须附有效 system-update.json，明确不改变数据库及宿主骨架，并高于已安装版本。旧宿主 Core 或 Package 的 ^0.1 系列约束排除 0.2.0；首次接入应通过正常 Composer 安装更新约束，核对锁文件及实际运行版本，再使用后台入口。安装器只清理摘要匹配的官方旧测试文件，修改过的文件会拒绝覆盖。
公开包已提供发行契约及正常 Composer 下载源。在隔离 macOS 宿主完成默认 Composer 安装（102 个依赖、安装脚本启用），实际 Core 0.2.0 / Package 0.2.1 后端与前端清单、官方发行文件摘要及自动加载路径均通过。另从公开 0.1.9 使用正式独立工具升级到双 0.2.0；再由真正已安装的 0.2.0 后台协调器预检并升级到 0.2.1，健康失败时成功恢复，重新执行升级成功。前端构建和类型检查、独立 HTTP 服务重载及静态页面健康检查通过；最终状态无重复升级目标。此证据来自临时宿主，未部署到既有运行宿主，未执行数据库迁移或登录业务验收。
Package 0.2.2 补齐 Windows 独立后台更新、进程树超时与异常退出收尾、PID 身份检查，以及高频查询进度时记录保存的有限重试，修复读句柄短暂占用导致任务误失败。Windows 使用系统 PowerShell 5.1、PHP CLI ≥8.2 的 proc_open，不需要 pcntl/posix；本地盘符路径及原生 .exe 入口的配置见首次配置。Windows 8 / Server 2012 是实现最低条件，本次原生验收为 Windows 10 / PHP 8.2.12 / PowerShell 5.1。服务账户须允许独立后台进程脱离宿主作业；并非全部服务部署方式均已验收。
本次发行源码在原生 Windows 的 59 项定向检查及 macOS 的 43 项回归通过，并完成独立审查。0.2.2 已正式发布，Packagist 已索引相同源码 revision 4d4d2607602b5b63b3aa06bfe7a0aa4d58af3847；公开包安装到实际验收宿主后的消费结果仍需单独核对。以上不是已有生产宿主的部署、服务重载或登录业务验收。
稳定版 0.1.9 修复 Windows 安装插件时已有后端载荷被误判为“插件后端目录缺失”的问题，原待安装候选可继续预检，无需删除或重新下载。
0.1.10-rc.1 公开预发布（2026-10-01）增加：
- 通过
host-payload.json精确声明并交付宿主应用和专属配置，校验摘要、归属、冲突，关联安装、升级、卸载和失败恢复。 - 已有 PostgreSQL schema 的只读预检和确认重接；不重放安装 SQL，并保护接管前的数据。带额外宿主应用载荷的组合重接仍拒绝。
- Windows 应用载荷和恢复备份相对路径修复，合法目录尾分隔符修复，以及旧候选复制文件的持久化处理。
升级影响：稳定消费继续使用 0.1.9；rc.1 供 SandAI 集成验证，不替代稳定发行。已有 Composer 资产消费和原生 Windows 定向证据，但真实 PostgreSQL 生命周期、HTTP、浏览器、业务及 Windows UNC 共享验收仍未完成。Composer 安装只发布源码，不建库、不执行插件 SQL、不启停服务。
需要验证本预发布版时，在已有宿主的 server/ 目录运行以下命令，保留现有 Webman 安装/更新钩子并先备份配置和前端修改：
composer require supdger/sand-package:0.1.10-rc.1 --with-all-dependencies
composer show supdger/sand-package确认版本为 0.1.10-rc.1 后，单独安排目标宿主的安装、升级、恢复及卸载验证；依赖更新不执行这些数据库动作。普通稳定版安装入口仍按包 README 操作。
完整历史：Package 更新日志 · 全部公开版本。安装与发行操作沿用 仓库插件分发。
最近公开预览包 sand-ai-v0.1.0-preview-2821503（2026-09-21）从独立 SandAI 仓库重新构建，并在包文档中明确源码归属。该包采用插件独立布局，不含当前统一宿主应用载荷候选；模型、文件、解析、任务、用量及追溯由插件内代码承担，身份与服务授权依赖 SandIAM。
升级影响：这是开发与隔离测试预览包，真实宿主升级和完整业务链验收仍未完成，暂不建议用于正式环境。由维护者先核实 SandAdmin、SandPackage、SandIAM 的版本组合和包摘要；不能仅凭版本号相近认定兼容。当前工作区的 0.1.2、0.1.3 及可续跑会议模式属于未发布源码候选，不能从本公开预览包获得，也不能拿候选教程操作旧包。
完整公开历史：SandAI 全部发布记录。使用目标预览包前阅读 该版本源码 README，安装边界以对应版本为准。
回到 Wiki 首页。
开始使用
基础包参考
开发插件
版本更新
版本和维护