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

1.3 KiB
Raw Blame History

Windows 启动脚本交付审查计划

目标

判断 start.bat 是否能交给其他 Windows 用户直接使用,并核验脚本语法、依赖、路径、首次运行、错误提示和配套文件。

阶段

  • 阶段一:读取 Trellis 上下文并确认交付入口与配套文件
  • 阶段二:审查批处理语法、依赖、路径与首次运行行为
  • 阶段三:执行可行的 Windows 兼容性验证与启动链路核对
  • 阶段四:形成是否需要修改及交付条件的结论

约束

  • 当前先做只读审查,不擅自修改业务文件。
  • 保留用户已有未提交文件,不覆盖其他会话的计划。
  • 不使用已弃用的 graphify。

错误记录

  • 当前 WSL 环境没有 cmd.exe,无法直接执行 Windows CMD 动态测试;改用静态检查与主链路交叉验证。

最终结论

  • start.bat 的路径切换和 Node 启动语法可用于 WindowsNode 服务主入口隔离启动通过。
  • 当前脚本不适合原样交给首次使用者,关键原因是调用 npm.cmd 时没有使用 call,安装结束后可能不继续启动服务。
  • 交付前应补齐 call npm ...、Node >= 18、npm 检查、安装失败阻断和退出码提示。
  • 本轮是审查任务,未修改 start.bat 或业务源码。