version scope

版本与验证范围

2026-09-30 核对公开 GitHub API、Wiki Git 仓库与锁定源码。版本号、源码 commit、Composer 包版本和插件版本是不同身份，不能混用。

当前指南的来源

2026-10-04核对以下公开tag及依赖来源；正常Composer消费、实际发布文件和Windows运行结果分别记录，不以版本存在代替实际安装。

对象	公开版本	范围
SandAdmin宿主	0.2.1	固定源码 830da4b1f6d46a45406339f76b09ffd4923fb191
Sand Core	0.2.2	精确引用 5956228296e419814996ae13af4f37bd807ef22d
SandPackage	0.2.2	保持已有公开版本及精确依赖，不在本次更新它
前端packageManager	pnpm@11.19.0	当前安装须使用固定版本；旧pnpm9不能替代
推荐Node.js	22系列 >=22.12.0	Windows实测22.23.3与pnpm11.19.0，推荐不等于扩大引擎最低声明

来源：宿主0.2.1、Core0.2.2。宿主锁文件仅Core从0.2.1升到0.2.2，Package与其他依赖不变。macOS从公开宿主0.2.1重新clone并正常Composer安装102包及标准钩子，工作树保持干净；发布397项Core及9项Package受管前端文件，静态标记、后端控制器、模板和入口JS与正式包一致，严格校验及17项JS/18项PHP回归通过；Windows从公开宿主0.2.1（830da4b）与Core0.2.2（5956228）在新空测试库完成真实安装（HTTP200/code200）；前端未启动时保留完成页，按正常pnpm11.19.0开发启动后重检进入3006登录页，使用页面验证码正常登录并获得token，用户、字典、菜单及首页统计接口均HTTP200/code200。此为Windows开发模式安装与登录验收；生产构建登录表单入口另有候选证据，不扩大为生产部署或全平台通过。

历史快照：2026-09-30

以下值仅记录当时指南来源，不用于当前安装要求：

对象	核查值	说明
最新公开宿主 Release	0.1.1，2026-09-27 发布	无 Release 附件；不能据此推定所有主线修改已进入该版本
本 Wiki 操作指南来源	276c89e188c5346df8535eb9b90608f189a3e572	核查时公开 main，固定 SHA 便于复核
主线锁定核心	sand-core 0.1.8，43b547a5651ec8912ad28792a577c5ea7f05de38	由 server/composer.lock 确认
主线锁定安装器	sand-package 0.1.9，3d5a25363ff75298b7e2fa4689984cb8ac89a287	与核心包分开版本化
主线 Webman framework	v2.2.4	不是宿主版本号
主线前端声明	Node.js >=20.19.0，pnpm >=8.8.0	未声明 packageManager；声明下限不足以证明锁定依赖可用
实际锁文件约束	lockfileVersion: 9.0，Vite 7.1.7	pnpm 8 不兼容 v9 锁文件；Vite 要求 Node `^20.19.0
当时指南选定组合	Node.js 22 系列 >=22.12.0，pnpm 9.15.9	依据工具链约束选定，未宣称已完成平台运行验收

来源：公开 Release、固定主线、Composer 锁文件、前端声明。

工具链依据：公开 pnpm 锁文件、pnpm 9 锁格式常量、pnpm 8 锁格式常量、Vite 7.1.7 Node 要求。

候选与正式版本

未提交源码、开发候选、公开主线和 Release 可能使用不同工具链与基础包组合。选择候选时应另行记录 revision、依赖锁文件和实际验收，不能把候选版本作为公开 Release 的安装要求，也不能为了追随文档而降级已锁定的基础包。

验证范围

此指南的依据是公开锁定源码、配置和接口契约，不提供当前组合的全平台运行或生产就绪保证。PHP/前端构建、macOS/Windows/Linux 启动、数据库初始化、登录、插件升级卸载与业务链均须在实际环境验证，并分别记录结果。历史页面所列环境与结果仅适用于其原版本，不能自动覆盖当前组合。

插件 host_min / host_max 声明兼容范围，真实验收记录须另外绑定宿主 revision、插件版本、平台、生命周期和业务路径。页面中的设计契约也不表示相应自动化入口已经实现，特别是前端载荷激活。