From 1eb27d082ebf892343c9a5eed6f9363363234903 Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Wed, 12 Aug 2026 09:26:35 +0800
Subject: [PATCH] docs: document fixed GoAdmin toolchain (#5)

---
 Local-Development-and-Verification.-.md | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/Local-Development-and-Verification.-.md b/Local-Development-and-Verification.-.md
index bf34e51..7589b52 100644
--- a/Local-Development-and-Verification.-.md
+++ b/Local-Development-and-Verification.-.md
@@ -9,7 +9,7 @@
 | Gitea | 工单与 Wiki | 浏览仓库或调用 MCP |
 | Gitea PAT | Wiki 写入 | 仅由 MCP 或 `GITEA_TOKEN` 提供，不打印 |
 
-Go、Node、CUDA、PostgreSQL、MediaMTX 的精确要求将在对应项目骨架工单冻结；当前不把旧仓库环境当作新项目事实。
+Sense/Bell 的 Go、Node 与 pnpm 基线已冻结并记录于下文；Brain 的 Python/CUDA 以及 PostgreSQL、MediaMTX 精确版本仍将在对应骨架工单冻结。旧仓库环境不自动成为新项目事实。
 
 ## 第一次运行
 
@@ -80,3 +80,25 @@ git status --short
 ```
 
 业务工单还必须运行其声明的子项目测试；跨契约工单必须运行所有受影响项目的契约测试。未执行部分写入工单。
+
+## Sense/Bell 固定工具链与只读参考源
+
+根 `goadmin-baseline.json` 是机器可读基线。开始 Sense/Bell 骨架或升级工作前，先核对：
+
+```powershell
+Get-Content .\goadmin-baseline.json
+
+git -C D:\github\goadmin\go-admin rev-parse HEAD
+git -C D:\github\goadmin\go-admin-ui rev-parse HEAD
+git -C D:\github\goadmin\go-admin-doc rev-parse HEAD
+
+go version
+node --version
+pnpm --version
+```
+
+`D:\github\goadmin` 下三个仓库只允许读取和核对，不允许在其中开发或提交 yovision 产品代码。本机路径不是跨机器事实；缺少该路径时，应从清单中的上游 URL 检出相同 commit 到仓库外目录。
+
+截至 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` 为准。