docs: 记录 Sense 骨架入口与验证 (#21)

Local-Development-and-Verification.-.md

@@ -102,3 +102,25 @@ pnpm --version
 截至 2026-08-12 的本机核对结果：Go 1.23.0，不满足 go-admin `go.mod` 声明的 Go 1.26.5；Node.js 22.22.1 符合基线；pnpm 尚未安装，Corepack 0.34.6 可用。因此后端构建和 pnpm 前端构建均未完成验证。安装隔离的 Go 1.26.5 并通过 Corepack 启用 pnpm 9.15.1 后，才可执行后续骨架构建验收。
 
 `go-admin-doc` 只用于理解上游框架；项目自己的架构、开发规则和版本事实仍以 yovision Wiki、Agent 规则与 `goadmin-baseline.json` 为准。
+
+<!-- sense-runtime:start -->
+## Sense 本地构建与验证
+
+使用根 `goadmin-baseline.json` 的精确版本。当前机器可用的隔离 Go 路径为开发机临时工具目录，不应写入部署配置。
+
+```powershell
++$env:PATH = 'C:\Users\ila20\AppData\Local\Temp\yovision-tools\go1.26.5\go\bin;' + $env:PATH
++powershell -ExecutionPolicy Bypass -File .\Sense\scripts\bootstrap\check-toolchain.ps1
++cd Sense\server
++go test ./...
++go build ./...
++cd ..\ui
++corepack pnpm@9.15.1 install --frozen-lockfile
++corepack pnpm@9.15.1 lint
++corepack pnpm@9.15.1 build
++cd ..\..
++powershell -ExecutionPolicy Bypass -File .\Sense\scripts\bootstrap\smoke.ps1
++```
+
+正式后端启动必须设置 `SENSE_DATABASE_MODE=postgres` 和仓库外提供的 `SENSE_DATABASE_URL`。健康检查为 `GET /healthz`，就绪检查为 `GET /readyz`。本地 smoke 明确设置 `SENSE_DATABASE_MODE=memory`，不能代替 PostgreSQL 部署验证。
+<!-- sense-runtime:end -->