version scope

版本与验证范围

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

当前指南的来源

对象	核查值	说明
最新公开宿主 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、插件版本、平台、生命周期和业务路径。页面中的设计契约也不表示相应自动化入口已经实现，特别是前端载荷激活。