🚀 AIStarter 脚本终极改造指南：Bat 脚本无缝无坑集成方案
在将本地 AI 项目的 .bat 启动命令移植到 AIStarter 脚本的过程中，我们经常会遇到启动崩溃、不转圈、不弹窗、控制台无日志、僵尸进程卡端口等一系列由于 Node.js 子进程与 Python 环境交互产生的“暗坑”。
本指南提供了一套经过深度验证的自动化改造方案。你只需要使用下方的“终极提示词模板”，直接发给大模型（如 Gemini、GPT、Claude 等），它就能自动为你输出完美适配的 AIStarter JavaScript 代码。
🛑 我们解决了哪些致命暗坑？
- 环境变量“空格”陷阱：在 CMD 中使用
& 拼接命令时，set PYTHONUTF8=1 & 会把尾随空格也算作变量值，导致 Python 抛出 invalid environment variable 致命错误。
- Python 日志缓冲死锁：Python 默认开启标准输出缓冲。如果不加
-u 参数并设置 PYTHONUNBUFFERED="1"，Node.js 无法实时监听到日志，导致脚本一直“盲等”，永远不会触发浏览器弹窗。
- 异步 Loading 假死：原版脚本经常在抛出异步命令后直接调用
zn.showLoading(false)，导致点击瞬间圈圈就消失，给用户“秒退”的错觉。必须依靠正则精准监听 stdout/stderr 才能安全关闭。
- 多实例按钮状态不同步：对于包含 ComfyUI / WebUI 自定义启动按钮的复杂脚本，由于 Vue/前端 UI 刷新机制，必须通过
runbutton.pid 动态自适应判断状态，才能保证“启动/关闭”按钮的文本与样式正确。
🛠️ 核心工具：自动化改造提示词（Prompt Template）
使用说明：复制下方黑框内的全部内容，将你实际项目的 Bat 代码和原始 JS 代码填入底部对应的区域，然后发送给 AI 即可。
🛠️ 自动化改造提示词模板
你是一个精通 Windows CMD 脚本和 Node.js 子进程管理的 AI 助手。帮我把下面的 Bat 启动命令整合到提供的 AIStarter 脚本中，并输出完整可用的 JavaScript 代码。
核心改造与避坑要求（必须严格遵守）：
1. 命令拼接与环境变量（致命暗坑）：
- 提取 bat 里的所有 `set` 变量和启动命令，用 `&` 串联在一行。
- ⚠️ 警告：`set` 语句的值和 `&` 之间绝对不能有空格（例如必须写成 `set PYTHONUTF8=1&`，禁止写成 `set PYTHONUTF8=1 &`），否则会导致 Python 启动报 invalid environment variable 致命错误。
2. 解除 Python 日志缓冲（关键）：
- 必须在 `options.env` 中追加 `PYTHONUNBUFFERED: "1"`。
- 必须在拼接好的执行命令中，给 `python.exe` 加上 `-u` 参数（如 `python.exe -u main.py`），以确保终端日志能实时输出，防止监听死锁。
3. 智能监听与防抖弹窗：
- 给相关模块声明独立的防抖变量（如 `this.browserOpened = false`），在启动和退出时重置。
- 监听 `stdout` 和 `stderr`，必须先加上 `console.log(data.toString())` 确保终端有显示。
- 放宽匹配特征：使用正则检测类似 `http://127.0.0.1:端口`、`0.0.0.0:端口` 或常见启动成功提示。一旦触发，立即锁定防抖变量，自动关闭 loading，并使用 `start` 命令打开 127.0.0.1 对应的地址。
4. Loading 状态防卡死：
- 启动时的 loading 圈圈时间设置长一些（如 200000 毫秒）。
- ⚠️ 警告：绝对不要在 `try-catch` 执行完 `zn.execute` 的正下方同步调用 `zn.showLoading(false)`。必须且只能在监听到成功特征时，或 `catch` 到报错时才能关闭 loading。
5. 动态识别设置项（自适应）：
- 检查 AIStarter 脚本的 `addSetting` 方法。如果内部不存在类似 `newbutton` 等自定义启动按钮，则只处理主 `run` 方法。
- 如果存在自定义启动按钮（例如用于启动 ComfyUI），请对其对应的回调方法（如 `onRunBtnClicked`）执行与主 `run` 方法相同的“命令拼接、解除缓冲、智能监听弹窗、错误处理”改造。
- 在 `addSetting` 中渲染按钮状态前，需动态判断对应进程的 pid 是否存在，以此决定显示“启动 (success)”还是“关闭 (danger)”，解决UI状态刷新不同步的问题。
---
【Bat命令（主服务）】：
（在这里粘贴主程序的 bat 代码，例如 run.bat / webui.bat）
【Bat命令（可选：如存在额外设置项服务如ComfyUI，请贴这里，没有则留空）】：
（如果你的 AIStarter 原脚本的设置里带有类似 ComfyUI 的额外启动按钮，请在这里粘贴它对应的 bat 代码）
【AIStarter原脚本】：
（在这里粘贴 AIStarter 模板生成的或需要改造的原始 JSON/JS 脚本代码）
💡 进阶避坑指南：僵尸进程与端口占用
如果你在调试过程中发现：“再次点击启动时瞬间报错”，或者日志提示 [WinError 32] 另一个程序正在使用此文件 / Port is already in use。
这通常意味着你之前的进程虽然在 UI 上关闭了，但底层的 python.exe 成为了僵尸进程，死死占用了端口和文件锁。
✅ 终极抢救方案：随时在你的 Windows 终端（CMD 或 PowerShell）中运行以下命令，强制清空所有残留的 Python 进程，即可满血复活继续调试：
taskkill /F /IM python.exe /T
声明：本站部分文章来源于网络，如有侵犯您的合法权益，请您即时与我们联系，我们将在第一时间处理。如需转载本站文章，请在转载时标明出处并保留原文链接，否则我们将保留追究法律责任的权利。
