Sand Core 0.2.4

0.2.4（2026-10-05）

• 修复插件安装后页面已恢复但全屏加载遮罩仍不退出的问题；加载状态随当前导航收尾，旧导航取消或失败不会关闭新导航的遮罩。
• 原生 Windows Chrome 实际安装 SandIAM 0.8.4、SandLicense 0.1.2，均无需手动刷新恢复插件仓库；两次恢复后持续观察超过 110 秒。Core 导航回归 36 项通过。
• 无数据库、宿主骨架或依赖变更。需发布并构建匹配的管理端源码；发布版本不会自动升级已有部署。建议配套 SandPackage 0.2.4 获得仓库读取的暂态恢复。

本次仅发布修复版本与系统更新契约，不自动部署或升级已有宿主。

固定发行源码：7ea906743f9c912d03cc9f0fc1e68366c310c393。system-update.json SHA-256：e769d7546b9fd229021e00075a7d295d457666ff8f2dc96e0a9d7a2a36a21664。

Sand Core 0.2.3

修复登录页在 1920×1080、2560×1440 和 3840×2160 下的布局比例，表单卡片随内容定高、桌面内容限宽，品牌与圆环保持对齐；补齐中间断点与短屏滚动。深色登录卡片采用深青灰半透明背景，保留浅色主题与窄屏布局。

构建、类型、样式检查及独立浏览器三档、断点、主题和 DPR 验收通过。发行两登录文件与验收版本 SHA256 一致；验证码使用测试数据，未验证实际登录业务。本版本无数据库及宿主骨架变更，已有实例需正常 Composer 更新并重新构建、发布匹配前端。发布不会升级已有部署。

固定源码：1939ac2c8b796c0aa74680b9eefbc1aad2bc4728。system-update.json 从该干净 Git 提交生成，549 项载荷摘要经独立核验，SHA256：47d140968bdf017746c0956a54e5527394c17062c7a7d692228198c5ec95df5a。

Sand Core 0.2.2

• 修复数据库安装成功后，前端未运行仍直接跳到拒绝连接页面的问题。完成页检查管理端专属静态资源，失败时保留安装结果并提供启动或部署恢复步骤；点击进入前再次检查。
• 支持 SANDADMIN_FRONTEND_URL 指定公开后台地址或同源子路径，默认继续读取开发端口与基础路径。开发端口占用时明确失败，不再悄悄切换端口。
• 已安装实例重新访问安装入口可继续恢复，不重复初始化数据库或展示初始密码。
• 恢复步骤推荐已验证的 Node.js 22（≥22.12.0），固定 pnpm 11.19.0，修正 pnpm 9.15.9 无法读取当前工作区配置的安装指引；保留 Node.js 原最低兼容声明，依赖及锁文件不变。
• 公开后台地址在服务端渲染前拒绝非法协议和包含用户名、密码或控制字符的配置，不向安装页面输出被拒绝的原始值。
• 静态检查不执行管理端、修改登录状态或保证登录业务正常；无数据库迁移。升级需要发布匹配的前端源码并重新构建，以包含专属静态标记。

Sand Core 0.2.1

• 修复插件安装触发服务重载后，管理端核心初始化因短暂连接失败停留在 500 页的问题；初始化读取在共享 15 秒窗口内最多尝试六次，已成功请求不重复读取。
• 恢复期间不重复弹出暂态错误；权限拒绝、取消、超时、真实业务错误及持续不可用保留原失败边界。
• 已在原生 Windows Chrome 通过 SandIAM 0.8.4 标准市场安装、自动恢复、菜单及列表访问切片验收；持续故障和权限等负例按既定边界验证，不代表所有插件及平台已验收。
• 本版本无数据库或宿主骨架变更。升级需发布并构建匹配的管理端前端源码；仅更新后端 Composer 包不足以让旧管理端获得修复。

Sand Core 0.2.0

• 核心版本线升至 0.2.0，与 SandPackage 0.2.0 配套交付后台系统更新。
• 修正核心运行版本声明，使后台宿主版本与 Composer 发行版本一致，避免插件兼容检查读取旧版本。
• 提供与本发行提交绑定的系统更新契约；本版本不变更数据库结构或宿主骨架。后台更新功能由 SandPackage 0.2.0 提供，初次使用仍需管理员配置更新执行环境。

Sand Core 0.1.9

修复菜单初始化失败后，访问首页或重新登录仍进入 404 的问题。初始化错误保留为 500，权限拒绝和空授权菜单保留为 403。

登录时重新初始化路由，取消上次退出的延迟清理，并忽略旧会话的初始化结果，避免快速重新登录后新路由被移除。

验证：真实 Vue Router 路由链在 macOS、物理 Windows Node 20.14.0 及独立审查中均 7/7 通过；完整前端类型检查和生产构建通过。本次不包含数据库迁移。

0.1.8

安装时明确提示 PostgreSQL 数据库不存在、用户不存在、身份认证失败、权限不足、主机名解析失败、连接被拒绝、连接超时和 PDO 驱动缺失。认证失败时提示检查用户名和密码；仅明确报告用户不存在时单独提示用户名问题。

支持中文 UTF-8 和 Windows CP936/GBK 数据库诊断，失败返回有效 JSON 和固定提示，避免暴露原始连接异常或密码。安装页区分响应格式异常、HTTP 请求失败和无法连接服务。

验证：29 项真实 Webman HTTP JSON 回归、6 项真实 Chrome 页面提示验收，PHP 语法与 Composer 包检查通过。

Sand Core 0.1.7

Fix the dashboard project documentation link after SandAdmin documentation moved to the GitHub Wiki.

Sand Core 0.1.6

Fix the installation completion link to use the frontend port from its environment configuration. Publish missing frontend environment files from examples on first install without overwriting existing configuration.

Sand Core 0.1.5

修复 Windows 首次访问 /core/install 时文件缓存锁路径错误。runtime/file/ 的锁文件现在创建在 runtime/file.lock，不再尝试打开不存在的 runtime/file/.lock。