merge: 完成 Sense 根目录启动脚本 (#90)

用户已于 2026-08-27 验收通过；将 #90 合入 dev，Supervisor 实例保持运行，main 不变。
2026-08-27 16:40:51 +08:00
parent 1514215729 e0ab023557
commit e14b65b586
5 changed files with 120 additions and 2 deletions
@@ -13,6 +13,15 @@ Sense 是从项目冻结的 GoAdmin 后端与 go-admin-ui 前端源码独立派

 ## 本地验证入口

+已使用 Windows 打包脚本生成 `Sense\dist\sense-windows-amd64` 后，可从 Sense 项目目录直接启动交付包：
+
+```bat
+start_sense.bat
+start_sense.bat demo
+```
+
+该入口只负责定位并调用包内 `start-sense.bat`；生产配置、迁移和 MediaMTX 编排仍由交付包处理。交付包不存在时，入口会提示先运行 `scripts\build\build-windows.bat`，不会自动构建或启动开发服务。
+
 后端：

 ```powershell
@@ -0,0 +1,17 @@
+@echo off
+setlocal
+
+set "PACKAGE_LAUNCHER=%~dp0dist\sense-windows-amd64\start-sense.bat"
+
+if not exist "%PACKAGE_LAUNCHER%" (
+    echo [ERROR] Sense Windows delivery package was not found.
+    echo Expected launcher: "%PACKAGE_LAUNCHER%"
+    echo Build it first with: "%~dp0scripts\build\build-windows.bat"
+    endlocal
+    exit /b 2
+)
+
+call "%PACKAGE_LAUNCHER%" %*
+set "SENSE_EXIT_CODE=%ERRORLEVEL%"
+
+endlocal & exit /b %SENSE_EXIT_CODE%
@@ -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: d32f00a86bb3127485b8ad4da8436bf2117352e0
-synchronized_at: 2026-08-14T01:06:22Z
+wiki_revision: 84cb91d5fb87fcb711c04c1f94b5c09ebe8c22a1
+synchronized_at: 2026-08-15T06:45:18Z
 <!-- gitea-wiki-mirror:end -->

 # 项目档案
@@ -112,3 +112,11 @@ Sense、Bell 共用的可复现技术基线记录在仓库根 `goadmin-baseline.
 - `main`：用户审核通过的最小/发布基线；禁止直接开发和未经用户明确审核的合并。
 - `dev`：集成开发与测试分支；功能分支从 `dev` 派生，并通过 PR 合回 `dev`。
 - 只有用户明确审核通过，才能把 `dev` 合入 `main`。
+
+<!-- sense-root-launcher:start -->
+## Sense Windows 项目目录启动入口
+
+工单 #90 在 `Sense/start_sense.bat` 提供项目目录快捷入口。它只使用脚本自身路径定位 `Sense/dist/sense-windows-amd64/start-sense.bat`，透传 production、demo 和其他包内启动参数，并保留包内脚本退出码；不读取配置、不自动构建，也不直接启动 Go 或 Node 开发服务。
+
+使用前必须先按 Windows 交付流程生成 `Sense/dist/sense-windows-amd64`。从仓库根目录可运行 `Sense\start_sense.bat`，进入 Sense 目录后可运行 `start_sense.bat` 或 `start_sense.bat demo`。交付包不存在时脚本返回非零并提示执行 `Sense\scripts\build\build-windows.bat`。
+<!-- sense-root-launcher:end -->
@@ -0,0 +1,80 @@
+<!-- gitea-wiki-mirror:start -->
+generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
+wiki_page: Task-90-Sense项目根目录Windows启动脚本
+wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Task-90-Sense%E9%A1%B9%E7%9B%AE%E6%A0%B9%E7%9B%AE%E5%BD%95Windows%E5%90%AF%E5%8A%A8%E8%84%9A%E6%9C%AC.-
+wiki_revision: cdfab02efe085b8e40cc19b0941e5c3d3c1ae7aa
+synchronized_at: 2026-08-27T08:40:20Z
+<!-- gitea-wiki-mirror:end -->
+
+# 90 Sense项目根目录Windows启动脚本
+
+- 类型：需求
+- 所属 Epic：#7
+- 所属 MVP / 版本：#8
+- 状态：已完成
+- 日期：2026-08-15
+- Gitea 工单：https://git.ilapage.cn/ila/yovision/issues/90
+- Wiki 页面：Task-90-Sense项目根目录Windows启动脚本
+- Wiki revision：见本地镜像头
+
+## 背景与目标
+
+#70 建立的 Windows 交付包入口位于 `Sense/dist/sense-windows-amd64/start-sense.bat`，用户从项目目录启动时需要进入多层目录。工单 #90 增加项目根目录快捷入口，同时保持包内脚本为配置、迁移和服务编排的唯一事实源。
+
+## 最终方案
+
+新增 `Sense/start_sense.bat`。脚本使用 `%~dp0` 定位同一项目下的交付包，不依赖调用者当前工作目录；通过 `call ... %*` 原样透传 production、demo 和开关参数，并保存子脚本退出码。交付包入口不存在时输出预期路径和构建命令，返回退出码 2。
+
+脚本不读取 `sense.env`、不处理密码或 token、不自动构建，也不直接启动 Go/Node 开发服务。项目 README 与 Wiki Project-Profile 记录快捷命令；#70 的包内说明和运行脚本保持不变。
+
+## 修改文件
+
+- `Sense/start_sense.bat`：项目根目录 Windows 启动入口。
+- `Sense/README.md`：增加 production/demo 快捷启动说明与职责边界。
+- Wiki `Project-Profile`、`docs/00-project-profile.md`：记录长期启动入口。
+- `wiki-docs.json`、`docs/task/90-Sense项目根目录Windows启动脚本.md`：登记任务归档镜像。
+
+## 验收结果
+
+| 验收标准 | 结果 |
+|---|---|
+| 从任意工作目录定位包内入口 | 通过；从 `C:\Windows` 使用隔离夹具和当前本地交付包验证 |
+| 参数和退出码原样传递 | 通过；`demo -SkipMigration "two words"` 原样到达假包内脚本，退出码 17 保持 |
+| 缺失交付包时明确失败 | 通过；输出预期路径和构建命令，退出码 2 |
+| 不包含秘密、不解析配置、不复制启动实现 | 通过；脚本仅 17 行定位、检查、调用和退出码逻辑 |
+| 项目说明和 Wiki 镜像一致 | 通过；受影响页面定向同步与检查通过 |
+
+## 测试
+
+- 隔离缺失包夹具：从 `C:\Windows` 调用，错误信息可行动，退出码 2。
+- 隔离假包内脚本：参数输出为 `demo -SkipMigration "two words"`，子脚本退出码 17 被根入口保留。
+- 当前 #70 本地交付包：从 `C:\Windows` 分别调用包内入口和根入口并传入安全的无效模式，两者均返回参数校验退出码 1，证明真实路径连接和退出码一致。
+- 敏感关键词扫描：脚本不含 password、token、secret、database URL 或 credential。
+- `git diff --check`：通过。
+- Wiki 受影响页面定向 `sync_wiki_docs.py --check --config .tmp-wiki-90.json`：通过。
+- **未验证部分**：未通过根入口实际启动 production/demo 服务，以避免在本工单重复操作数据库和服务进程；真实启动链已由 #70 验证。完整 Wiki 全量检查暂受待验收 PR #89 已更新但尚未合入 `dev` 的三个 #70 镜像影响，#90 只对不冲突页面做定向一致性检查。
+
+## 遗留问题
+
+- `dev` 合入 #70 后才包含根入口所调用的版本化包内构建和启动脚本；在此之前根入口会按设计提示先构建且返回 2。
+
+## 相关提交
+
+- `a865dda` 增加 Sense 根目录启动脚本。
+- `06d982d` 记录 Sense 根目录启动方式。
+
+## 最新 dev 组合回归（2026-08-27）
+
+- 分支合并 `dev@15142157299936231fc4dda9aa6624bba34aeed3`，合并提交为 `404e25584e41e4c3ba4e8850b4aa07452ae3f7af`。
+- 唯一冲突位于 `wiki-docs.json`：#90 与后续 #70/#95/#97/#99/#101/#104/#106 同时新增任务归档映射；解决时保留全部映射。Sense 业务代码和启动脚本无冲突。
+- 在仓库外隔离夹具中从 `D:\` 调用根脚本，`demo -SkipMigration "two words"` 原样到达包内脚本，退出码 17 保持。
+- 缺失交付包时输出预期路径与构建命令并返回 2；当前真实交付包入口存在于约定路径。
+- 根脚本敏感关键词扫描、`git diff --check`、Harness 31 项单测通过；全量 Wiki 镜像检查通过。
+- `check_harness.py --strict` 仍仅被既有 #66/#67 归档缺少模板章节的 4 项问题阻断，与 #90 无关。
+- 为避免与当前 Supervisor 托管的生产实例争用 18080，本轮没有通过根入口重复启动服务；`yovision-sense` 保持 Running，健康检查返回 200。
+
+## 验收确认
+
+- 2026-08-27，用户明确确认“#90 验收通过”。
+- PR #91 按规定合入 `dev`，`main` 未变更。
+- 工单 #90 状态更新为“已完成”并关闭；所属 MVP #8 的子工单索引同步勾选。
@@ -132,6 +132,10 @@
      "page": "Task-69-Sense多边形区域与方向警戒线配置",
      "path": "docs/task/69-Sense多边形区域与方向警戒线配置.md"
    },
+    {
+      "page": "Task-90-Sense项目根目录Windows启动脚本",
+      "path": "docs/task/90-Sense项目根目录Windows启动脚本.md"
+    },
    {
      "page": "Task-70-Sense-Windows配置启动与打包交付",
      "path": "docs/task/70-Sense-Windows配置启动与打包交付.md"