Files
cc-web/.planning/windows-start-audit/task_plan.md

30 lines
1.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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