build: add Sense Windows package script (#37)

2026-08-12 18:19:08 +08:00
parent 6d90d54592
commit e80180e2b6
5 changed files with 194 additions and 1 deletions
@@ -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 服务。
@@ -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