OpenCodex Windows 服务“控制台窗口“问题全解析：根因定位、方案取舍与隐藏启动器落地

【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址https://gitcode.com/gh_mirrors/ope/opencodex点击查看免费下载本文以 OpenCodex 仓库开发日志 devlog/_fin/260720_windows_service/001_research.md 为核心骨架结合 src/service 下 Task Scheduler 后端与 src/lib/winsw.ts 原生服务后端的实际源码与测试完整还原关闭代理的控制台窗口会导致所有模型包括 GPT断连这一 Windows 典型故障的根因、排查方法与最终修复方案。读者读完后将掌握Windows 服务化进程的控制台生命周期模型、Task Scheduler XML 各关键字段的真实语义以及窗口不可见且不可被窗口关闭杀死的两条工程化解决路径VBS 隐藏启动器 WinSW 原生服务。1. 症状与复现路径一个窗口关闭引发的全模型断连2026-07-15 的 DC 画廊用户报告直接触发了本次调查closing the proxys console window can make every model (even gpt models) disconnect。即用户在 Windows 上关闭代理控制台窗口后所有经由本地代理路由的模型请求全部失败——包括 GPT 系列因为代理注入状态下 GPT 请求同样经过 localhost 代理转发。完整的复现路径共 6 步如下在 Windows 上执行ocx service install安装服务。Task Scheduler 任务opencodex-proxy以登录触发器LogonTrigger运行~/.opencodex/opencodex-service.cmd→cmd 控制台窗口直接显示在桌面上。用户点击窗口右上角 X 关闭代表性路径会话注销、任务管理器结束进程属于同一类强制终止。Windows 向该控制台关联的所有进程广播CTRL_CLOSE_EVENT默认处理程序直接终止进程。包装批处理以同步方式执行 Bun%OCX_BUN% %OCX_CLI% start --port port见 src/service/windows-taskxml.ts 的buildWindowsServiceScript因此包装进程与代理子进程被绑定在同一控制台生命周期上一起被杀死批处理内部的 5 秒重启循环:loopping -n 6 127.0.0.1见 src/service/windows-taskxml.ts因为批处理自身已死而完全失效。Codex 所依赖的 localhost 代理消失 → 被路由的所有模型含 GPT断连。需要 Windows 实测验证的悬置项needs-verification这种强制终止是否会被 Task Scheduler 记录为 task failure 并触发RestartOnFailurePT1M × 3即 1 分钟间隔重启 3 次官方语义仅定义 RestartOnFailure 在 task failure 时生效未明确窗口关闭是否归类为 task failure。需要观测的项目包括schtasks /query /v输出的LastTaskResultTaskScheduler Operational 事件日志Microsoft-Windows-TaskScheduler/Operational包装进程/子进程 PID 跟踪代理 health 端点窗口关闭后经过 PT1M 是否真正发生重启。2. 根因拆解三个因素的组合而非单一原因调查结论明确指出这是三个因素叠加的结果单独任何一个都不足以解释故障。#因素代码位置aLogonTypeInteractiveToken/LogonType—— 任务在用户交互会话中运行等价于 Run only when user is logged onsrc/service/windows-taskxml.tsbTask action直接执行作为控制台程序的.cmd批处理 —— 交互会话 控制台子系统 可见控制台窗口任务 XML 的Actions原本直接指向 wrapper .cmdc缺少隐藏启动机制无 VBS/PowerShell-WindowStyle Hidden启动器、无 conhost 分离等——三个常见误解的排除排查过程中三个看似可疑的配置点被逐一排除Hidden当前为false见 src/service/windows-taskxml.ts它只控制任务在 Task SchedulerUI 列表中是否可见与控制台窗口完全无关。把Hidden改成true不会让窗口消失。windowsHide: truerunFile中见 src/service/windows-scheduler.ts它只在 opencodex管理调用schtasks.exe时生效隐藏管理进程自己的窗口对已注册任务后续运行弹出的窗口没有任何影响。wrapper 脚本中 The wrapper runs in its own hidden console 的注释在InteractiveToken下实际并不 hidden注释与真实行为矛盾这一点在后续修复中已随代码一起纠正见下文第 5 节。3. 对照ocx stop为什么正常停止路径是完整闭环的故障的另一个关键问题是为什么手动停止服务没问题唯独关窗口会出事因为ocx stop走的是完整的三段式优雅终止研究报告引用src/cli/index.ts的handleStop该逻辑现经重构分布于 src/service/cli.ts 的stop分支与 src/service/orchestration.tsstopServiceIfInstalled()—— 先停止服务管理器阻断 respawnstopProxy(pid)—— 走 management-API drain 优先的优雅关闭这是 Windows 上 shutdown handler 真正运行的唯一路径taskkill /F只是内部兜底命令还会调用stopWindowsChecked()/killWindowsServiceWrapperProcesses()见 src/service/windows-ops.ts处理schtasks /end杀不干净的 wscript/cmd 包装进程restoreNativeCodex()revertSystemEnv()—— 恢复原生 Codex 配置。也就是说正常终止路径本身是完备的问题只存在于关闭控制台窗口这一类的强制终止路径——它绕过了所有 drain 与清理逻辑直接由 Windows 控制台子系统结束进程。4. 候选方案对比与取舍研究报告对四类候选方案做了系统对比ocx stop与注册方式均以当前仓库实现为准选项窗口消除性质约束/成本A. LogonType 改为S4UO非交互执行最小 diff 候选需要 batch-logon 权限无法访问网络凭据/EFS当前 XML 无显式UserId直接替换的稳定性未验证MS 账户 passwordless 注册兼容性未知B. WinSW 包装器O真正的 SCM 服务结构性解法二进制随附/分发成本服务注册需要管理员权限stable 版为 v2.12.020233.x 仍属 prerelease 系列C. NSSM 包装器O社区建议可用但官方正式版 2.24 停在 2014-08-31推荐的 prerelease 也停留在 2017 年 —— 对新采纳而言劣于 WinSWD. 单独使用 sc.exe——不适用Node/Bun 进程未实现 SCM 握手服务控制协议无法以 sc.exe 注册为服务参考. VBS/PS 隐藏启动器O仅隐藏窗口症状缓解进程寿命问题窗口关闭即死会随窗口本身消失而解除但不是真正的服务选项 AS4U采纳前必做的验证矩阵本地账户 / Microsoft 账户passwordless分别在schtasks /create /xml注册下能否成功Log on as a batch job权限是否为默认授予普通用户/企业 GPO 环境wrapper 使用的%USERPROFILE%/%APPDATA%环境间接化相关实现见 src/lib/win-paths.ts 的windowsEnvIndirectBatchValue在 S4U 会话中能否正确解析token 文件读取ACL 加固路径 日志写入是否正常EFS 加密主目录、UNC/自定义OPENCODEX_HOME、企业认证代理环境。最终仓库选择了两条并行路径详见第 5 节默认后端采用 VBS 隐藏启动器选项参考的工程化实现同时提供WinSW--native可选后端选项 B作为结构性解法S4U 未获采纳。5. 当前代码已具备的防护 / 仍缺失的能力已具备现状盘点重复实例防护MultipleInstancesPolicyIgnoreNew/...src/service/windows-taskxml.ts失败重启RestartOnFailurePT1M × 3src/service/windows-taskxml.ts——但窗口关闭场景下是否触发仍是第 1 节的悬置项崩溃自愈循环wrapper 批处理内的 5s 重启循环src/service/windows-taskxml.ts用ping而非timeout做延时——timeout在 Task Scheduler 下会因 Input redirection is not supported 直接死掉把 5 秒冷却变成热重启风暴资产重写容错writeServiceAssetWithRetryEBUSY/EPERM/EACCES 重试见 src/service/windows-ops.ts应对刚结束的 cmd.exe 或杀毒扫描仍占用文件句柄的瞬时错误过期路径诊断bakedServicePathsDiagnosticnpm prefix/nvm 迁移检测服务重启不还原 Codex 配置OCX_SERVICE1环境契约wrapper 内set OCX_SERVICE1见 src/service/windows-taskxml.ts服务托管重启时 shutdown handler 不执行还原由重启后的实例重新注入。缺失本次调查识别的真正缺口不可见、且无法被窗口关闭杀死的执行模式——这是本问题的直接答案强制终止后的自动恢复保证——RestartOnFailure是否覆盖窗口关闭路径需要实测确认。6. 落地实现VBS 隐藏启动器与会话恢复触发器源码级验证研究报告发布后仓库把隐藏启动器方案落进了 src/service/windows-taskxml.ts 与 src/service/windows-ops.ts可以从源码逐行验证其机制。6.1 机制wscript.exe VBS 启动器窗口样式 0 常驻buildWindowsLauncherVbssrc/service/windows-taskxml.ts生成~/.opencodex/opencodex-service-launcher.vbs核心两行Set shell CreateObject(WScript.Shell) shell.Run wrapper.cmd 路径, 0, Truewscript.exe是GUI 子系统可执行文件任务直接执行它不会产生控制台窗口VBS 再以窗口样式 0隐藏启动批处理双重确保窗口不可见bWaitOnReturnTrue第三个参数是常驻启动器的关键wscript 会存活到批处理结束为止从而让计划任务实例保持 running 状态——MultipleInstancesPolicyIgnoreNew的去重语义和schtasks /end的终止目标才有依托。若改为Falsewscript 立即退出任务看起来已结束去重失效VBS 文件必须以UTF-16LE BOM写入writeServiceAssetWithRetry(..., utf16le)见 src/service/windows-ops.ts无 BOM 的 UTF-8 VBS 在部分 WSH/代码页组合下会误读非 ASCII如韩文用户路径任务 XML 的Exec随之改为Command...\System32\wscript.exe/CommandArguments/b /nologo launcher.vbs/Arguments/b为批处理模式抑制脚本错误弹窗launcher 路径经taskXmlString()独立转义。6.2 会话恢复触发器让随会话死亡变得可恢复需要特别说明的是隐藏启动器并不改变 InteractiveToken 的会话绑定——窗口消失了但代理仍活在交互会话里会话结束注销、RDP 断开时 Windows 仍会将它连同会话一起销毁。当前源码为这一现实补上了第二层WINDOWS_SESSION_RECOVERY_STATE_CHANGESsrc/service/windows-taskxml.ts为任务增加了三类SessionStateChangeTriggerRemoteConnect远程会话连接SessionUnlock会话解锁ConsoleConnect控制台会话连接。这些触发器不能阻止会话销毁代理代码注释记录了实测InteractiveToken 下代理随会话被撕毁wrapper 记录退出码1073807364即STATUS_CONTROL_C_EXIT但它们能让代理在下一次连接/解锁时自动复活——把断连后只能等下次登录实测某机器 19 次被杀造成最长约 60 小时的缺口压缩成断连后下一次会话事件即恢复。MultipleInstancesPolicyIgnoreNew保证仍在运行的代理不会被重复拉起。触发器还以安装账户 SID 显式限定UserId作用域避免被任意账户的会话事件触发src/service/windows-taskxml.ts。6.3 健康校验与测试印证windowsTaskRegistrationHealthysrc/service/windows-taskxml.ts把上述全部契约LogonTrigger InteractiveToken IgnoreNew PT0S 三类会话恢复触发器 wscript 动作 SID 作用域固化为一套注册健康判定tests/windows/windows-scheduler-install-verification.test.ts 用buildWindowsTaskXml构造的 XML 直接断言了这些字段含SessionStateChangeTrigger缺失即判不健康、GBK 代码页下 CJK 账户名解码后仍能匹配触发器作用域等回归用例。schtasks /query /xml输出按 UTF-16/GBK 兜底解码decodeSchtasksOutputsrc/service/windows-scheduler.ts避免代码页导致的 mojibake 使健康检查误判。7. 结构性解法WinSW--native可选后端对于需要开机即起、真正无窗口、不与会话绑定的场景仓库还实现了报告中的选项 B——WinSW 原生服务后端通过ocx service install --native显式启用源码见 src/lib/winsw.ts。其安全设计值得展开二进制按需获取 SHA-256 固定ensureWinswBinary首次使用时从官方 Releases 下载WinSW.NET461.exe固定 v2.12.0常量WINSW_VERSION/WINSW_SHA256见 src/lib/winsw.ts哈希不匹配即删除文件并 fail-closed 抛错离线环境会提示把官方二进制手动放到指定位置后重试禁止 LocalSystem服务以用户账户运行WinSW v2 的serviceaccountdomain/user/allowservicelogon 模式见buildWinswXmlsrc/lib/winsw.ts。理由是 token 文件的 ACL 加固只授予用户 SIDsrc/lib/windows-secret-acl.tsSYSTEM 服务读不到 token安装后用sc.exe qc校验SERVICE_START_NAME一旦落入 LocalSystem 立即winsw uninstall回滚密码不进 XMLXML 中不含 password靠winsw install /p在控制台交互式输入需要 stdin 继承非交互会话直接报错assertWindowsNativeServiceAccountSupported会拒绝 Microsoft 账户登录SCM 无法为其认证见 src/service/windows-ops.ts后端切换是事务性的install --native会先移除已有 scheduler 后端stopWindowsuninstallWindows失败时明确报告无服务安装状态绝不静默回退反向install --scheduler同理先移除 nativesrc/service/windows-ops.ts。8. 后续 SoT 更新清单研究报告同时标记了本次调查不应遗漏的文档单一事实源SoT更新点本期未改动README.md支持平台表中 Fully supported 措辞应加 Windows known limitation 注释README.mdstarts on boot 表述不准确——实际是登录触发器LogonTrigger并非开机启动docs/codex-path-investigation.mdWindows 服务章节需在 S4U/WinSW 决策落定后同步刷新。小结关闭控制台窗口 → 全模型断连的本质是 InteractiveToken 直接执行控制台批处理 无隐藏启动机制三者叠加让代理进程的生命周期被绑定在用户可见的 cmd 控制台上。仓库给出的答案是双轨制默认 Task Scheduler 后端以 wscript.exe VBS 隐藏启动器消除窗口、以会话恢复触发器消除随会话死亡的长时间空窗并辅以完整的注册健康校验与代码页兜底解码对强服务化需求则提供 WinSW 原生服务作为显式可选后端。排查过程中对Hidden、windowsHide、RestartOnFailure 等配置的真实语义逐一澄清为同类 Windows 后台化问题提供了可复用的排查范式。赞分享【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址https://gitcode.com/gh_mirrors/ope/opencodex点击查看免费下载相关推荐OpenCodex Windows 服务隐藏启动器改造wscript VBS 实现无控制台窗口的 Task Scheduler 后台服务OpenCodex Windows 服务隐藏启动器改造wscript VBS 实现无控制台窗口的 Task Scheduler 后台服务 本指南围绕 Op5分钟完全解锁Cursor Pro终极免费无限使用指南5分钟完全解锁Cursor Pro终极免费无限使用指南 你是否在使用Cursor AI编程助手时频繁遇到试用次数已达上限的提示是否因为设备绑定限制而无法LenovoLegionToolkit中RunAutomationStep隐藏控制台窗口的问题分析与解决方案LenovoLegionToolkit中RunAutomationStep隐藏控制台窗口的问题分析与解决方案 问题背景 在使用LenovoLegionToolk桌面应用上一篇无需安装image2cpp在线工具让Arduino OLED开发效率提升10倍下一篇Android应用体积优化终极指南R8编译器的10个核心技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考