ila/yovision
1
0
Fork 0
Code Issues 14 Pull Requests 14 Actions Packages Projects Releases Wiki Activity

[SEN] 添加 Windows 前后端一键打包脚本 #39

Open
ila wants to merge 4 commits from agent/codex/37-sense-windows-package into agent/codex/21-sense-mvp
pull from: agent/codex/37-sense-windows-package
merge into: :agent/codex/21-sense-mvp
Conversation 0 Commits 4 Files Changed 13
+392 -19
13 changed files with 392 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Sense/README.md
+15
View File
@@ -53,3 +53,18 @@ corepack pnpm@9.15.1 build
The frontend automatically discovers project-local route and store modules.
Feature tickets add one route module without exposing unrelated GoAdmin demo
pages.
## Windows package
With the frozen Go toolchain first in `PATH`, build the backend, frontend and
ZIP archive with one command from the repository root:
```powershell
cmd /c .\Sense\scripts\package-windows.bat
```
The ignored local artifact is `Sense\dist\sense-windows-amd64.zip`. It contains
the Windows amd64 server, compiled UI, empty example configuration, upstream
licenses, a start script and an operations note. Run `start-sense.bat demo` only
for a temporary local preview; production startup requires externally supplied
PostgreSQL and secret environment variables.
Sense/config/sense.env.example
+9 -1
View File
@@ -4,4 +4,12 @@ SENSE_DATABASE_MODE=postgres
SENSE_DATABASE_URL=
SENSE_LOG_LEVEL=info
SENSE_UI_STATIC_DIR=
SENSE_IDENTITY_SIGNING_KEY=
SENSE_BOOTSTRAP_TOKEN=
SENSE_COOKIE_SECURE=true
SENSE_CREDENTIAL_KEY=
SENSE_ONVIF_DISCOVERY_IP=
SENSE_MEDIAMTX_BINARY=
SENSE_MEDIAMTX_CONFIG=
SENSE_MEDIAMTX_API=http://127.0.0.1:9997
SENSE_MEDIAMTX_WEBRTC_BASE=http://127.0.0.1:8889
Sense/scripts/package-windows.bat
+93
View File
@@ -0,0 +1,93 @@
@echo off
setlocal
for %%I in ("%~dp0..") do set "SENSE_ROOT=%%~fI"
for %%I in ("%SENSE_ROOT%\dist") do set "OUTPUT_ROOT=%%~fI"
for %%I in ("%OUTPUT_ROOT%\sense-windows-amd64") do set "PACKAGE_DIR=%%~fI"
for %%I in ("%OUTPUT_ROOT%\sense-windows-amd64.zip") do set "ZIP_PATH=%%~fI"
for %%I in ("%SENSE_ROOT%\ui\dist") do set "UI_DIST=%%~fI"
if /I not "%PACKAGE_DIR%"=="%SENSE_ROOT%\dist\sense-windows-amd64" (
echo [ERROR] Unsafe package directory: %PACKAGE_DIR%
exit /b 1
)
if /I not "%ZIP_PATH%"=="%SENSE_ROOT%\dist\sense-windows-amd64.zip" (
echo [ERROR] Unsafe ZIP path: %ZIP_PATH%
exit /b 1
)
where go >nul 2>nul || goto :missing_go
for /f "tokens=3" %%V in ('go version') do set "GO_VERSION=%%V"
if not "%GO_VERSION%"=="go1.26.5" (
echo [ERROR] Go 1.26.5 is required, found %GO_VERSION%.
exit /b 1
)
where node >nul 2>nul || goto :missing_node
for /f "delims=" %%V in ('node --version') do set "NODE_VERSION=%%V"
if not "%NODE_VERSION%"=="v22.22.1" (
echo [ERROR] Node.js 22.22.1 is required, found %NODE_VERSION%.
exit /b 1
)
where corepack >nul 2>nul || goto :missing_corepack
for /f "delims=" %%V in ('corepack pnpm@9.15.1 --version') do set "PNPM_VERSION=%%V"
if not "%PNPM_VERSION%"=="9.15.1" (
echo [ERROR] pnpm 9.15.1 is required, found %PNPM_VERSION%.
exit /b 1
)
echo [1/5] Installing frozen frontend dependencies...
pushd "%SENSE_ROOT%\ui" || goto :failed
call corepack pnpm@9.15.1 install --frozen-lockfile || goto :failed_popd
echo [2/5] Building frontend...
call corepack pnpm@9.15.1 build || goto :failed_popd
popd
if exist "%PACKAGE_DIR%" rmdir /s /q "%PACKAGE_DIR%"
if exist "%ZIP_PATH%" del /q "%ZIP_PATH%"
mkdir "%PACKAGE_DIR%\config" || goto :failed
echo [3/5] Building Windows backend...
set "CGO_ENABLED=0"
set "GOOS=windows"
set "GOARCH=amd64"
pushd "%SENSE_ROOT%\server" || goto :failed
go build -trimpath -ldflags "-s -w" -o "%PACKAGE_DIR%\sense-server.exe" . || goto :failed_popd
popd
echo [4/5] Assembling package...
robocopy "%UI_DIST%" "%PACKAGE_DIR%\ui" /E /NFL /NDL /NJH /NJS /NP >nul
if errorlevel 8 goto :failed
robocopy "%SENSE_ROOT%\LICENSES" "%PACKAGE_DIR%\LICENSES" /E /NFL /NDL /NJH /NJS /NP >nul
if errorlevel 8 goto :failed
copy /y "%SENSE_ROOT%\config\sense.env.example" "%PACKAGE_DIR%\config\sense.env.example" >nul || goto :failed
copy /y "%SENSE_ROOT%\scripts\runtime\start-sense.bat" "%PACKAGE_DIR%\start-sense.bat" >nul || goto :failed
copy /y "%SENSE_ROOT%\scripts\runtime\README-WINDOWS.md" "%PACKAGE_DIR%\README-WINDOWS.md" >nul || goto :failed
echo [5/5] Creating ZIP...
powershell -NoProfile -ExecutionPolicy Bypass -Command "Compress-Archive -Path '%PACKAGE_DIR%' -DestinationPath '%ZIP_PATH%' -Force" || goto :failed
echo.
echo Package directory: %PACKAGE_DIR%
echo ZIP archive: %ZIP_PATH%
exit /b 0
:failed_popd
popd
:failed
echo [ERROR] Packaging failed.
exit /b 1
:missing_go
echo [ERROR] Go was not found in PATH.
exit /b 1
:missing_node
echo [ERROR] Node.js was not found in PATH.
exit /b 1
:missing_corepack
echo [ERROR] Corepack was not found in PATH.
exit /b 1
Sense/scripts/runtime/README-WINDOWS.md
+32
View File
@@ -0,0 +1,32 @@
# Sense Windows 运行包
此目录同时包含 Sense 后端和已经构建好的前端静态页面。Brain、Bell 无需启动。
## 快速查看
在命令提示符中运行：
```bat
start-sense.bat demo
```
然后访问 <http://127.0.0.1:18080>。`demo` 使用内存数据，进程退出后数据会丢失，仅用于本机查看，不能用于生产。
## 生产启动
生产环境必须先安装并准备独立 PostgreSQL，然后在仓库和运行包之外安全设置以下环境变量：
- `SENSE_DATABASE_URL`：PostgreSQL 连接地址。
- `SENSE_IDENTITY_SIGNING_KEY`：至少 32 个字符的会话签名密钥。
- `SENSE_BOOTSTRAP_TOKEN`：首次初始化使用的引导令牌。
- `SENSE_CREDENTIAL_KEY`：Base64 编码的 32 字节摄像头凭据加密密钥。
按需要设置 `SENSE_HTTP_ADDRESS`、MediaMTX 和 ONVIF 参数后运行：
```bat
start-sense.bat
```
完整变量名可参考 `config\sense.env.example`。示例文件只有空值和非秘密默认值，启动脚本不会自动读取它；请使用 Windows 环境变量或外部秘密管理工具注入真实值。
健康检查为 `GET /healthz` 和 `GET /readyz`。MediaMTX 仍是独立程序，本运行包不会安装 PostgreSQL、MediaMTX 或 Windows 服务。
Sense/scripts/runtime/start-sense.bat
+45
View File
@@ -0,0 +1,45 @@
@echo off
setlocal
cd /d "%~dp0"
set "SENSE_UI_STATIC_DIR=%~dp0ui"
if /I "%~1"=="demo" goto :demo
set "SENSE_DATABASE_MODE=postgres"
if "%SENSE_DATABASE_URL%"=="" goto :missing_database_url
if "%SENSE_IDENTITY_SIGNING_KEY%"=="" goto :missing_identity_key
if "%SENSE_BOOTSTRAP_TOKEN%"=="" goto :missing_bootstrap_token
if "%SENSE_CREDENTIAL_KEY%"=="" goto :missing_credential_key
echo Starting Sense in production mode at %SENSE_HTTP_ADDRESS%...
"%~dp0sense-server.exe"
exit /b %ERRORLEVEL%
:demo
set "SENSE_DATABASE_MODE=memory"
if "%SENSE_HTTP_ADDRESS%"=="" set "SENSE_HTTP_ADDRESS=127.0.0.1:18080"
echo Starting Sense in temporary demo mode at http://%SENSE_HTTP_ADDRESS% ...
echo Demo data is discarded when the process stops. Do not use this mode in production.
"%~dp0sense-server.exe"
exit /b %ERRORLEVEL%
:missing_database_url
echo [ERROR] SENSE_DATABASE_URL is required in production mode.
goto :configuration_help
:missing_identity_key
echo [ERROR] SENSE_IDENTITY_SIGNING_KEY is required in production mode.
goto :configuration_help
:missing_bootstrap_token
echo [ERROR] SENSE_BOOTSTRAP_TOKEN is required in production mode.
goto :configuration_help
:missing_credential_key
echo [ERROR] SENSE_CREDENTIAL_KEY is required in production mode.
:configuration_help
echo Set the required environment variables outside this directory.
echo See README-WINDOWS.md and config\sense.env.example.
exit /b 1
docs/00-project-profile.md
+13 -4
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Project-Profile
wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Project-Profile.-
wiki_revision: 3f5324fdcb32700a628b7434f1d7800e4bb0f64f
synchronized_at: 2026-08-12T08:50:45Z
wiki_revision: 8d21b036c7a4077560b44790bb55602c84caaab1
synchronized_at: 2026-08-12T10:21:47Z
<!-- gitea-wiki-mirror:end -->
# 项目档案
@@ -19,7 +19,7 @@ synchronized_at: 2026-08-12T08:50:45Z
| 首期客户场景 | 民办寄宿学校，默认 16 路高风险点位 |
| 首期规则 | 越线、危险区域、聚集等匿名安全规则；不启用人脸 |
| 产品形态 | Sense 与 Bell 两个独立销售产品，Brain 为独立推理交付单元 |
| 当前阶段 | 新仓库文档与开发流程初始化，业务代码尚未迁移 |
| 当前阶段 | Sense 与 Bell 首个独立 MVP 纵切已实现并待验收；Brain 尚未初始化 |
| 历史来源 | `D:\OPC\yovision_old`，只读追溯 |
## 子项目与交付单元
@@ -42,7 +42,7 @@ synchronized_at: 2026-08-12T08:50:45Z
- 证据：客户侧 MinIO/S3 兼容对象存储；常态录像优先留在客户已有 NVR。
- 首期验证平台：NVIDIA x86/Jetson；M1-M3 不承诺 GB/T 28181、信创或原生 App。
业务代码尚未初始化；Sense/Bell 的 Go/Node 基线已冻结并记录于下文，Brain 的 Python/CUDA 版本仍须在对应骨架工单中冻结。
Sense 与 Bell 的独立业务骨架及首个 MVP 纵切已实现并待验收；Brain 尚未初始化。Sense/Bell 的 Go/Node 基线已冻结并记录于下文，Brain 的 Python/CUDA 版本仍须在对应骨架工单中冻结。
## 阅读入口
@@ -98,3 +98,12 @@ Sense、Bell 共用的可复现技术基线记录在仓库根 `goadmin-baseline.
Sense 已从冻结的 GoAdmin 基线初始化为独立产品：后端使用 Go 1.26.5 与 PostgreSQL，管理端使用 Node.js 22.22.1、pnpm 9.15.1、Vue 3.5.41、Element Plus 2.14.4 和 Vue CLI 5.0.9。产品代码只位于 `Sense/`，不依赖 Brain 或 Bell 启动；`D:\github\goadmin` 仍为只读参考。
<!-- sense-runtime:end -->
<!-- bell-runtime:start -->
## Bell 当前实现基线
Bell 已从冻结的 GoAdmin 基线实现独立 Event → Alert → ack → close 纵切：后端使用 Go 1.26.5 与独立 PostgreSQL 数据库，管理端使用 Node.js 22.22.1、pnpm 9.15.1、Vue 3.5.41、Element Plus 2.14.4 和 Vue CLI 5.0.9。产品代码只位于 `Bell/`，不依赖 Sense 或 Brain 启动；`D:\github\goadmin` 仍为只读参考。
Bell 不提供默认账户、默认密码或默认会话密钥。部署时必须从进程环境提供独立 `BELL_DATABASE_URL` 和至少 32 字符的 `BELL_SESSION_SECRET`；Cookie 固定为 `bell_session`，不接受 Sense 的用户会话。
<!-- bell-runtime:end -->
docs/02-architecture-and-code-map.md
+20 -4
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Architecture-and-Code-Map
wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Architecture-and-Code-Map.-
wiki_revision: 45c9a75d6044a918d7da6b236cb7b1625c5713e3
synchronized_at: 2026-08-12T09:32:01Z
wiki_revision: 1712a8053f365781aef9cbf33c576c97491f31d4
synchronized_at: 2026-08-12T10:21:55Z
<!-- gitea-wiki-mirror:end -->
# 架构与代码地图
@@ -33,13 +33,13 @@ Bell 也可接收合成事件、传感器平台或第三方系统事件；Sense
|---|---|---|---|---|
| Sense 产品 | `Sense/` | `Sense/AGENTS.md`；后续 README/入口 | `Sense/` 内测试 | 高：设备、媒体、凭据、并发对账 |
| Brain 推理 | `Brain/` | `Brain/AGENTS.md`；后续包入口 | `Brain/` 内测试与契约测试 | 高：模型、GPU、隐私、事件语义 |
| Bell 产品 | `Bell/` | `Bell/AGENTS.md`；后续 README/入口 | `Bell/` 内测试 | 高：认证、事件、告警状态机、通知 |
| Bell 产品 | `Bell/` | `Bell/README.md`、`Bell/server/main.go`、`Bell/web/src/main.js` | `Bell/server` Go 测试与 `Bell/web` lint/build | 高：认证、不可变事件、告警状态机、并发处置 |
| 共享契约 | `contracts/` | `contracts/AGENTS.md` | 三端消费者/生产者测试 | 高：兼容性与跨项目影响 |
| Harness | `dev_scripts/` | `check_harness.py` | `tests/` | 中 |
| 工单模板 | `.gitea/issue_template/` | `task.md` | Harness 严格检查 | 中 |
| Wiki 镜像 | `docs/` | `docs/README.md` | `sync_wiki_docs.py --check` | 低；禁止直接编辑 |
业务代码尚未迁入；具体函数、路由和测试入口必须随各项目骨架工单更新，不复制旧仓库代码地图。
Sense 与 Bell 已建立独立业务入口；Brain 的具体函数、路由和测试入口仍须随骨架工单更新，不复制旧仓库代码地图。
## 两条主要执行路径
@@ -108,3 +108,19 @@ Sense 后端功能以 `Sense/server/app/sense/` 为根，并通过 `Sense/server
前端在 `Sense/ui/src/{api,views,router/modules,components}/sense/` 使用对应模块；通用页面复用 Element Plus 表单、表格、分页、Dialog、Tag 和应用容器，只为播放器与区域画布新增局部业务组件。项目内 `identity.RecordAudit`、`device.ReadCredential`、`admission.VerifiedProfile`、`media.PlaybackRoute` 和 `area.ExportCurrent` 是窄适配端口，不是跨项目契约。
<!-- sense-mvp:end -->
<!-- bell-mvp:start -->
## Bell MVP 模块地图
- `Bell/server/main.go` 与 `cmd/bell/root.go`：命令入口、配置、迁移、HTTP 注册和优雅退出。
- `Bell/server/app/auth/`、`rbac/`、`audit/`：Bell 独立账户、bcrypt 密码、服务端会话、管理员/操作员/只读角色与只追加审计。
- `Bell/server/app/event/`、`receipt/`：不可变 Event、`(producer_id, source_event_id)` 永久幂等回执和游标查询。
- `Bell/server/app/synthetic/` 与 `server/testdata/events/`：只在 development/test 注册的匿名合成事件，复用正式 Event 服务。
- `Bell/server/app/rule/`：规则版本、每次评估解释、实际规则快照和按规则/地点关联 Alert。
- `Bell/server/app/alert/query/`、`alert/lifecycle/`：Event/Alert 双向追溯、单一 ack 获胜者、结果必填的 close、幂等重复和只追加时间线。
- `Bell/server/migrations/`：事务迁移与数据库不可变触发器；所有表只属于 Bell 数据库。
- `Bell/web/src/{api,views,store,layout}/`：Vue 3 + Element Plus 管理端，一级导航为工作台、预警管理、事件查询、规则配置；系统与合成入口按权限/环境出现。
Event 写入、幂等 Receipt、规则评估和 Alert 创建/关联处于同一数据库事务；规则或关联失败时不保留半成品 Event。一个 Event 可匹配多个规则，一个未关闭 Alert 可聚合相同规则与地点的多个 Event。
<!-- bell-mvp:end -->
docs/03-business-rules-and-glossary.md
+18 -2
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Business-Rules-and-Glossary
wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Business-Rules-and-Glossary.-
wiki_revision: 36a49f985cdd6ebd93759273fbc53158ba13b152
synchronized_at: 2026-08-12T09:32:06Z
wiki_revision: 2b222ffc8c2d943fa2a27d9e28ffaf4896143950
synchronized_at: 2026-08-12T10:21:57Z
<!-- gitea-wiki-mirror:end -->
# 业务规则与术语
@@ -80,3 +80,19 @@ synchronized_at: 2026-08-12T09:32:06Z
- **播放会话**：由当前 Sense 用户创建，最长两分钟；设备分页和媒体路径不以 16 路作为硬上限，页面一次只打开一路流。
- **区域版本**：坐标为 0..1 归一化值，并绑定 Device、Profile、宽高。每次发布或停用形成新版本；范围、点数、自交、退化、方向和期望版本由后端校验。Profile 分辨率变化后旧版本必须标记为需要重新校准。
<!-- sense-mvp:end -->
<!-- bell-mvp:start -->
## Bell MVP 业务与安全规则
- **独立身份**：Bell 仅接受自己的 `bell_session`；管理员管理用户、角色与规则，操作员读取事件/预警并处置，只读用户仅查询。后端权限是最终边界。
- **安全初始化**：系统没有默认用户、密码或签名密钥；首次管理员密码只通过一次性进程环境传入，密码至少 12 位且包含大小写字母和数字。
- **Event 与 Receipt**：Event 正文不可更新或删除。相同 `(producer_id, source_event_id)` 与相同 payload 返回原回执；相同键但不同 payload 返回冲突，跨进程重启仍成立。
- **合成事件**：只在 development/test 注册，使用虚构匿名 fixture，并走与未来生产者适配器相同的 Event/Receipt 服务；production 直接请求返回 404。
- **规则评估**：每个已接收 Event 都记录匹配或未匹配解释。匹配时固化实际规则快照；未匹配 Event 保持可查询，不能标成已通知或已处置。
- **Alert 关联**：同一 Event 可产生多个 Alert；同一规则与地点的多个 Event 可聚合到同一未关闭 Alert，Event 与 Alert 双向可追溯。
- **处置状态**：界面“待处理”对应新 Alert，“处理中/已看到”对应首个成功 ack，“已完成”对应记录现场结果后的 close。普通用户不需要理解 Event/Alert 内部模型，技术详情仍保留完整事实链。
- **并发 ack**：PostgreSQL 条件更新只允许首个操作员成为处置人；后来者得到真实处置人，不能覆盖。
- **close**：只有处置人或管理员可以完成；必须选择“确认有危险、误报、现场正常、无法确认”之一，可附备注。相同重复请求幂等，其他改变结果的请求被拒绝。
- **审计事实**：成功生命周期事实只追加；失败、重复和拒绝尝试写入安全审计，但不记录令牌、密码或连接密钥。
<!-- bell-mvp:end -->
docs/04-local-development-and-verification.md
+43 -4
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Local-Development-and-Verification
wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Local-Development-and-Verification.-
wiki_revision: 0a0354b0fed4c7edc68a1c6c887a0f2886e47541
synchronized_at: 2026-08-12T08:50:58Z
wiki_revision: 3bf0987ec9d7ddf543602e465faa088aead46531
synchronized_at: 2026-08-12T10:22:02Z
<!-- gitea-wiki-mirror:end -->
# 本地开发与验证
@@ -59,7 +59,7 @@ Sense/Bell 的 Go、Node 与 pnpm 基线已冻结并记录于下文；Brain 的
|---|---|---|---|---|
| Sense | 待骨架工单冻结 | 待冻结 | 待冻结 | 未初始化业务代码 |
| Brain | 待骨架工单冻结 | 待冻结 | 待冻结 | 未初始化业务代码 |
| Bell | 待骨架工单冻结 | 待冻结 | 待冻结 | 未初始化业务代码 |
| Bell | `go build ./...`；`pnpm build:prod` | `go test ./...`；`pnpm lint` | `go run . migrate`；`go run . serve`；`pnpm dev` | 首个独立纵切已实现，待验收 |
不得复制旧仓库命令来填空。每个骨架工单必须同时建立 README、可复制命令和最小测试。
@@ -107,7 +107,7 @@ 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 后，才可执行后续骨架构建验收。
截至 2026-08-12，系统 Go 1.23.0 仍不满足基线；开发机已在仓库外安装并校验隔离 Go 1.26.5，并通过 Corepack 使用 pnpm 9.15.1。Sense、Bell 的后端测试/构建与前端 lint/build 已在该隔离工具链完成。隔离目录是开发机临时事实，不得写入部署配置；其他机器应从官方来源安装相同精确版本。
`go-admin-doc` 只用于理解上游框架；项目自己的架构、开发规则和版本事实仍以 yovision Wiki、Agent 规则与 `goadmin-baseline.json` 为准。
@@ -132,3 +132,42 @@ 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 -->
<!-- bell-runtime:start -->
## Bell 本地构建与验证
先从根 `goadmin-baseline.json` 核对精确版本，再从仓库外环境设置 Bell 专用数据库与会话密钥。命令中的值只能使用本地测试凭据，不得提交：
```powershell
powershell -ExecutionPolicy Bypass -File .\Bell\scripts\bootstrap\check-toolchain.ps1
Set-Location Bell\server
go test ./...
go build ./...
go run . migrate
go run . serve
Set-Location ..\web
corepack pnpm@9.15.1 install --frozen-lockfile
corepack pnpm@9.15.1 lint
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 -->
<!-- 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 -->
docs/06-troubleshooting.md
+15 -2
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Troubleshooting
wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Troubleshooting
wiki_revision: 3ee073ae07bb2ab04f02b1178b6d289f6f5a2063
synchronized_at: 2026-08-12T09:32:15Z
wiki_revision: a076590915040eae0d165be6254c6302f308fc5a
synchronized_at: 2026-08-12T10:22:09Z
<!-- gitea-wiki-mirror:end -->
# 故障排查
@@ -58,3 +58,16 @@ synchronized_at: 2026-08-12T09:32:15Z
自动测试不访问真实摄像头或未授权网络。PostgreSQL、MediaMTX、目标浏览器与实验室摄像机的联合验证必须在获准部署环境完成。
<!-- sense-mvp:end -->
<!-- sense-windows-package:start -->
## Sense Windows 打包与启动排错
| 现象 | 检查与处理 |
|---|---|
| 打包提示 Go/Node/pnpm 版本不符 | 对照根 `goadmin-baseline.json` 安装精确版本，并把 Go 1.26.5 放到 `PATH` 首位；不要修改脚本绕过版本检查。 |
| 生产启动提示缺少环境变量 | 在运行包外设置 `SENSE_DATABASE_URL`、`SENSE_IDENTITY_SIGNING_KEY`、`SENSE_BOOTSTRAP_TOKEN`、`SENSE_CREDENTIAL_KEY`；启动脚本不会读取示例文件。 |
| 本机健康检查被代理返回空响应 | localhost 可能被 `HTTP_PROXY` 接管；测试工具应对 `127.0.0.1` 使用 no-proxy，再检查 `SENSE_HTTP_ADDRESS` 端口占用。 |
| 页面可打开但视频不可用 | Windows 运行包不包含 MediaMTX；按包内说明配置独立 MediaMTX 二进制、配置和 Control API。 |
`demo` 只用于临时查看。生产数据持久性、真实设备和媒体链路不能用 demo 验证替代。
<!-- sense-windows-package:end -->
docs/delivery/README.md
+13 -2
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Delivery-Documentation-Guide
wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Delivery-Documentation-Guide.-
wiki_revision: 9847e4c065e513107f8f79617c6529a8300874cb
synchronized_at: 2026-08-12T09:32:40Z
wiki_revision: 8127e9a6e6a92ed192639232bdc8813f5a9dea51
synchronized_at: 2026-08-12T10:25:18Z
<!-- gitea-wiki-mirror:end -->
# 交付文档指南
@@ -91,3 +91,14 @@ Sense 面向网管、实施人员和非技术现场人员，菜单按日常任
交付验收必须使用仓库外测试账户和获准实验室设备；文档、截图、工单和日志不得包含摄像机密码、Cookie、令牌、含凭据 URI 或客户真实画面。当前自动化已覆盖内部状态和安全边界；真实 PostgreSQL、MediaMTX、摄像机兼容与目标浏览器画面仍需实施人员验证。
<!-- sense-mvp:end -->
<!-- sense-windows-package:start -->
## Sense Windows 运行包交付
交付对象为实施和运维人员。`sense-windows-amd64.zip` 包含后端程序、已构建前端、空值示例配置、上游许可证、启动脚本与包内说明；不包含 PostgreSQL、MediaMTX、Windows 服务、生产数据或秘密。
- 临时查看必须显式运行 `start-sense.bat demo`，其内存数据在进程结束后丢失，不能当作生产部署。
- 生产启动前由运维在运行包外安全注入数据库、身份签名、初始化令牌和凭据加密配置，再运行 `start-sense.bat`。
- 交付时记录 ZIP SHA-256，并至少验证 `/healthz` 与首页；真实 PostgreSQL、MediaMTX、摄像机和目标浏览器仍需在获准环境验收。
- 包内 `README-WINDOWS.md` 是现场操作入口；不得把真实连接串、密码或令牌回填进示例文件后重新分发。
<!-- sense-windows-package:end -->
docs/task/37-Sense-Windows前后端一键打包.md
+72
View File
@@ -0,0 +1,72 @@
<!-- gitea-wiki-mirror:start -->
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Task-37-Sense-Windows前后端一键打包
wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Task-37-Sense-Windows%E5%89%8D%E5%90%8E%E7%AB%AF%E4%B8%80%E9%94%AE%E6%89%93%E5%8C%85.-
wiki_revision: 50a1b74dd33ccd52b8642599b3b579cbf4ac870e
synchronized_at: 2026-08-12T10:33:06Z
<!-- gitea-wiki-mirror:end -->
# 37 Sense Windows前后端一键打包
- 类型：需求
- 所属 Epic：#7
- 所属 MVP / 版本：#8
- 状态：待验收
- 日期：2026-08-12
- Gitea 工单：https://git.ilapage.cn/ila/yovision/issues/37
- Wiki 页面：Task-37-Sense-Windows前后端一键打包
- Wiki revision：见本地镜像头
## 背景与目标
客户需要在 Windows 上快速查看和交付 Sense。目标是用一个简单 BAT 从冻结工具链构建 Vue 前端和 Go 后端，组装不含秘密的 Windows amd64 运行目录及 ZIP，并提供临时预览和生产配置边界。
## 最终方案
- `Sense/scripts/package-windows.bat` 精确校验 Go 1.26.5、Node 22.22.1、pnpm 9.15.1，执行冻结安装、前端构建、CGO 关闭的 Windows amd64 后端编译、白名单文件组装和 ZIP 压缩。
- 产物固定为被 Git 忽略的 `Sense/dist/sense-windows-amd64/` 与 `Sense/dist/sense-windows-amd64.zip`；路径保护确保重建只清理这两个目标。
- 包内包含后端 EXE、前端静态资源、空值示例配置、上游许可证、`start-sense.bat` 和 `README-WINDOWS.md`。
- `start-sense.bat demo` 是明确的内存临时预览；无参数生产启动强制要求外部 PostgreSQL URL、身份签名密钥、引导令牌和凭据加密密钥。
- Wiki 增加本地打包、交付边界与排错说明；全量镜像同步同时带入其他已完成工单的最新 Wiki revision。
## 修改文件
- `Sense/scripts/package-windows.bat`：一键构建、组装与压缩。
- `Sense/scripts/runtime/start-sense.bat`：demo/生产双模式启动入口。
- `Sense/scripts/runtime/README-WINDOWS.md`：包内运行说明。
- `Sense/config/sense.env.example`：补齐身份、凭据、ONVIF 与 MediaMTX 空值示例。
- `Sense/README.md`：增加 Windows 打包入口。
- `docs/04-local-development-and-verification.md`、`docs/06-troubleshooting.md`、`docs/delivery/README.md`：Wiki-first 镜像。
- `wiki-docs.json`、`docs/task/37-Sense-Windows前后端一键打包.md`：任务归档登记和镜像。
## 验收结果
| 验收标准 | 结果 |
|---|---|
| 冻结工具链一键生成前后端 ZIP | 通过；连续执行两次均成功 |
| ZIP 含 EXE、UI、空值配置、许可证、启动脚本与说明 | 通过；共 14 个条目 |
| 包内不含秘密或生产数据 | 通过；敏感示例值为空且文本扫描未发现令牌、私钥或带密码 PostgreSQL URL |
| 包内后端加载 UI，健康检查与首页可访问 | 通过；`/healthz` 200，`/` 200 且包含 Vue 挂载点 |
| 固定路径安全重复覆盖 | 通过 |
| Brain、Bell 离线可构建和验证 | 通过 |
## 测试
- `cmd /c Sense\scripts\package-windows.bat`：连续两次通过；前端仅有既有 vendor bundle 体积建议警告。
- ZIP：7,281,398 bytes；SHA-256 `1BAEB17F1976DD925D8C01A245C951081FAE149E5151DA5523190F24E0B6AA6D`。
- 包内后端：内存模式绑定 `127.0.0.1:18082`，绕过本机代理后 `/healthz` 与 `/` 均为 200。
- `python -m unittest discover -s tests -v`：31 项通过。
- `python dev_scripts/check_harness.py --strict`：通过。
- `python dev_scripts/sync_wiki_docs.py --check`：通过。
- `git diff --check`：通过。
- **未验证部分**：未连接真实 PostgreSQL、MediaMTX 或摄像机；未用真实生产秘密运行生产模式；未由目标实施/运维人员完成解压和人工验收。
## 遗留问题
- 前端 vendor bundle 超过 Vue CLI 建议体积阈值，本工单不改变现有分包策略，不阻塞 Windows 打包。
## 相关提交
- `e80180e` build: add Sense Windows package script (#37)
- `efb48b4` docs: document Sense Windows package workflow (#37)
- `6d35fa7` docs: create task 37 acceptance archive (#37)
wiki-docs.json
+4
View File
@@ -111,6 +111,10 @@
{
"page": "Task-27-Sense区域与方向警戒线版本配置",
"path": "docs/task/27-Sense区域与方向警戒线版本配置.md"
},
{
"page": "Task-37-Sense-Windows前后端一键打包",
"path": "docs/task/37-Sense-Windows前后端一键打包.md"
}
]
}