docs: add Sense Windows package guidance (#37)

2026-08-12 18:21:22 +08:00
parent a076590915
commit 3bf0987ec9
1 changed files with 16 additions and 1 deletions
@@ -147,4 +147,19 @@ corepack pnpm@9.15.1 build:prod
 后端启动前必须提供独立 `BELL_DATABASE_URL` 与至少 32 字符的 `BELL_SESSION_SECRET`；`BELL_ENV` 可取 development、test、production。健康检查为 `GET /healthz`，就绪检查为 `GET /readyz`。首次管理员用 `go run . create-admin` 创建，密码通过 `BELL_BOOTSTRAP_PASSWORD` 进程环境一次性提供。

 在 Sense、Brain 停止时，development/test 可使用“合成事件测试”完成 Event 入站、规则匹配、Alert 关联、ack 和结果必填 close。production 必须验证 `/api/v1/synthetic/*` 返回 404。PostgreSQL 集成测试使用空的 Bell 专用测试数据库，禁止复用 Sense 或生产数据库。
-<!-- bell-runtime:end -->
+<!-- bell-runtime:end -->
+
+<!-- sense-windows-package:start -->
+## Sense Windows 打包与产物验证
+
+将冻结的 Go 1.26.5 放在 `PATH` 首位后，从仓库根目录运行：
+
+```powershell
+cmd /c .\Sense\scripts\package-windows.bat
+Get-FileHash .\Sense\dist\sense-windows-amd64.zip -Algorithm SHA256
+```
+
+脚本精确校验 Node 22.22.1 和 pnpm 9.15.1，冻结安装并构建前端，以 Windows amd64/CGO 关闭方式编译后端，然后生成被 Git 忽略的 `Sense\dist\sense-windows-amd64\` 和 ZIP。可重复运行只会覆盖这两个固定产物。
+
+解压后运行 `start-sense.bat demo` 可做内存模式临时预览；生产运行 `start-sense.bat` 前必须从仓库和运行包外注入 PostgreSQL URL、签名密钥、引导令牌和摄像头凭据加密密钥。包内不含 PostgreSQL、MediaMTX、系统服务、客户数据或秘密。
+<!-- sense-windows-package:end -->