plugin updates

Core、Package 与 SandAI 版本更新

面向准备安装或升级的管理员：先找到要使用的组件，阅读最近公开版本的变化与升级影响，再打开完整历史核对目标版本。以下日期按 Asia/Shanghai 时区记录；公开版本于 2026-10-04 核对；源码记录和公开发行均不等于目标宿主已升级或通过业务验收。

Sand Core：0.2.1

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 修复已安装版本仍出现在目标选择中的问题。推荐安装 Package 0.2.1 或更高版本，配合 Core 0.2.0 或更高版本。

升级前由宿主管理员按 后台系统更新 完成实际 PHP、静态部署、服务重载和健康检查配置。当前支持 Linux/macOS；官方稳定发行必须附有效 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.1.9 与 0.1.10-rc.1

稳定版 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 更新日志 · 全部公开版本。安装与发行操作沿用 仓库插件分发。

SandAI：0.1.0 公开预览包

最近公开预览包 sand-ai-v0.1.0-preview-2821503（2026-09-21）从独立 SandAI 仓库重新构建，并在包文档中明确源码归属。该包采用插件独立布局，不含当前统一宿主应用载荷候选；模型、文件、解析、任务、用量及追溯由插件内代码承担，身份与服务授权依赖 SandIAM。

升级影响：这是开发与隔离测试预览包，真实宿主升级和完整业务链验收仍未完成，暂不建议用于正式环境。由维护者先核实 SandAdmin、SandPackage、SandIAM 的版本组合和包摘要；不能仅凭版本号相近认定兼容。当前工作区的 0.1.2、0.1.3 及可续跑会议模式属于未发布源码候选，不能从本公开预览包获得，也不能拿候选教程操作旧包。

完整公开历史：SandAI 全部发布记录。使用目标预览包前阅读 该版本源码 README，安装边界以对应版本为准。

其他组件与宿主

• SandAdmin 宿主版本更新
• SandIAM 版本更新
• SandWorkflow 版本更新

回到 Wiki 首页。