fix: harden Windows startup and rebuild release

This commit is contained in:
shiyue
2026-07-28 08:01:14 +08:00
parent efe7c02ec3
commit 4d97446a6f
7 changed files with 166 additions and 6 deletions

View File

@@ -0,0 +1,29 @@
# Windows 启动脚本交付审查计划
## 目标
判断 `start.bat` 是否能交给其他 Windows 用户直接使用,并核验脚本语法、依赖、路径、首次运行、错误提示和配套文件。
## 阶段
- [x] 阶段一:读取 Trellis 上下文并确认交付入口与配套文件
- [x] 阶段二:审查批处理语法、依赖、路径与首次运行行为
- [x] 阶段三:执行可行的 Windows 兼容性验证与启动链路核对
- [x] 阶段四:形成是否需要修改及交付条件的结论
## 约束
- 当前先做只读审查,不擅自修改业务文件。
- 保留用户已有未提交文件,不覆盖其他会话的计划。
- 不使用已弃用的 graphify。
## 错误记录
- 当前 WSL 环境没有 `cmd.exe`,无法直接执行 Windows CMD 动态测试;改用静态检查与主链路交叉验证。
## 最终结论
- `start.bat` 的路径切换和 Node 启动语法可用于 Windows,Node 服务主入口隔离启动通过。
- 当前脚本不适合原样交给首次使用者,关键原因是调用 `npm.cmd` 时没有使用 `call`,安装结束后可能不继续启动服务。
- 交付前应补齐 `call npm ...`、Node >= 18、npm 检查、安装失败阻断和退出码提示。
- 本轮是审查任务,未修改 `start.bat` 或业务源码。