Repository navigation
Releases: CH-ZHOU-0512/codex-proxy-guardian
Release list
Codex Proxy Guardian v1.6.1
v1.6.1 正式修复：当代理出口被 GitHub API 限流或返回 403 时，Windows 更新器会明确使用 curl --noproxy "*" 直连回退，不再把同一个受限代理重复当成默认网络；诊断会记录 WindowsDirectRoute。其余监听、更新心跳和安全保持能力与 v1.6.0 相同。
Codex Proxy Guardian v1.6.0
v1.6.0 正式版：新增 Codex 日志与更新结果事件监听、重连信号实时归因与即时代理复核；自动更新加入 60 分钟心跳和安装目录兜底；Windows 更新请求优先使用系统 curl.exe，修复部分 PowerShell 网络栈导致的 GitHub 403；macOS/Linux 更新检查间隔同步支持配置。监听只负责验证和提示，不会因“正在重新连接”擅自关闭 Codex。
Codex Proxy Guardian v1.5.4
Codex Proxy Guardian v1.5.4
自动更新完成后会告诉你
Guardian 以前会在后台完成校验、安装和自身重启，但成功结果只写入日志。v1.5.4 会在自动更新完成后发送一次简洁通知：
- 显示从哪个版本更新到哪个版本；
- 明确 Codex 无需重启，可以继续使用；
- 不要求点击确认，不打断正在进行的任务；
- 同一版本只通知一次，不会每次开机重复出现。
Windows 使用通知区域消息，macOS 使用系统通知中心，Linux 会按环境使用 notify-send、Zenity 或 KDialog。通知不可用不会影响已经完成的更新，失败原因会写入更新日志。
首次升级即可生效
v1.5.4 的 Windows 安装器能识别由旧版静默更新器启动的安装进程。因此从 v1.5.3 自动升级到 v1.5.4 时就会收到通知，不需要等到下一次更新。
新安装不会显示“已自动更新”，手动检查更新仍使用设置窗口原有的完成提示。高级用户可以在 config.json 中将 NotifyAfterAutomaticUpdate 设为 false。
Codex Proxy Guardian v1.5.3
Codex Proxy Guardian v1.5.3
重启确认不再像故障警报
旧确认框使用黄色警告图标、“Codex 即将重启”标题和系统级模态样式。即使默认选择“否”，也容易让用户误以为任务马上会被强制中断。
v1.5.3 改为 Guardian 品牌确认窗口：
- 使用项目一致的米白、深墨绿、青绿色与荧光黄主题；
- 只说明“发现更合适的连接、重启可能更稳定、现在还是稍后”；
- 操作为“重启Codex”和“60分钟后再提醒我”；
- 默认焦点、关闭窗口、Esc 与倒计时结束全部选择稍后提醒；
- 只有明确点击“重启Codex”，才会进入原有的受控重启流程。
高分屏显示更清晰
窗口启用 Per-Monitor V2 DPI 感知和自动文字测量，在 125%、150% 等缩放比例下使用显示器原生分辨率绘制，避免文字发虚或字形边缘被固定高度遮挡。
如果品牌窗口因系统组件异常无法加载，会回退到温和的系统信息提示：不使用黄色警告图标，不使用系统级强制模态，仍默认选择“否”。安全边界没有改变。
Codex Proxy Guardian v1.5.2
Codex Proxy Guardian v1.5.2
这次修复的是“自动更新看似开启，实际没有跟上”
旧版在检测到 Codex 更新后，会启动 Guardian 的更新计划任务，但只要计划任务成功启动，就把这个 Codex 版本永久记成“已经请求过”。如果随后访问 GitHub 失败，同一 Codex 版本不会再次触发即时检查；用户看到的结果就是 Guardian 没有自动更新，Codex 更新后仍然重连。
v1.5.2 改为核对更新任务的真实终态：
Running：更新任务仍在运行；Current：已成功访问 GitHub，确认当前没有更高正式版；Installed：新 Guardian 已校验并安装；FailedRetryScheduled：本次失败，已安排针对同一 Codex 版本再次重试；Retrying：重试已经开始。
新安装默认每 15 分钟重试，已有用户自定义的间隔仍会保留；每日检查继续作为第二层兜底。
更新请求会使用已经验证的代理
Windows 更新器现在优先读取 Guardian 当前已经验证成功的代理：HTTP/HTTPS 使用 Windows PowerShell，SOCKS5/SOCKS5H 使用 Windows 11 自带的 curl.exe。失败时会进行有限次数重试，并尝试 Windows 默认网络路径。整个过程不会改写系统代理、DNS、路由或永久环境变量。
Status.ps1、Doctor.ps1 和设置页会显示最近结果、网络路径与下一次重试时间。“已经是最新版”只会在 GitHub 检查真实成功后出现。
Codex 更新后仍然重连怎么办
自动更新只能安装仓库中已经发布的 Guardian 版本；没有新 Release 时，它不会凭空生成新的适配代码。Guardian 仍会重新解析 Codex 的 MSIX 入口并重新验证当前通用适配。
如果 StreamingProxyGuaranteed=false，说明普通启动可能只让 HTTP 走了系统代理，WebSocket/流式连接尚未取得受管启动证据。可以在设置页点击“修复流式代理”，或打开 Codex (Managed Proxy)。Codex 正在运行时会再次弹窗确认；只有明确同意才会重启，未确认不会打断当前任务。
如果已经是 ManagedTrafficObserved 且没有同时出现 codex_restart / proxy_changed，剩余重连更可能来自代理服务商节点的 TLS/WebSocket 重置或上游超时，需要在代理软件中更换稳定节点。
从 v1.5.1 升级的重要说明
v1.5.1 的缺陷正好位于旧更新器本身。能正常访问 GitHub 的安装会自动收到 v1.5.2；如果某台电脑的旧更新器一直无法访问 GitHub，需要从最新正式版手动原位安装一次。已有配置会保留，升级到 v1.5.2 后后续检查才会使用已验证代理并按结果重试。
Codex Proxy Guardian v1.5.1
Codex Proxy Guardian v1.5.1
修复什么
新版 Codex 在 Windows 上可能出现一种隐蔽状态：普通启动后的 HTTP 请求可以通过系统代理，但 WebSocket/流式子进程没有继承显式代理环境，于是界面仍会先显示多次“正在重新连接”，再回退到 HTTP。旧版 Guardian 看到 HTTP 流量后会过早认为代理已经完整生效。
v1.5.1 不再接受这项误判。状态会明确区分：
SystemProxyHttpTrafficOnly：仅观察到系统代理 HTTP 流量，流式代理尚未保障；ManagedTrafficObserved：受管启动参数匹配，并观察到实际代理流量；StreamingProxyGuaranteed/StreamingRepairRequired：直接告诉设置页和诊断报告是否需要一次受管修复。
用户会看到什么
Safe 模式会先防抖观察，然后弹出前台确认框。请先完成正在运行的任务；只有明确点击“是”才会关闭并重启 Codex。点击“否”、等待超时或提示框异常都会保留当前 Codex，并至少延后 60 分钟再询问。
Windows 用户也可以关闭 Codex 后，从开始菜单打开 Codex (Managed Proxy)。受管启动会为 Codex 进程树注入 HTTP/HTTPS/ALL/WS/WSS 代理环境和 Chromium 代理参数，不修改 Windows 系统代理、DNS、路由、防火墙或永久环境变量。
后续 Codex 更新
兼容判断不使用已知版本号白名单。每个新 Codex 包版本都会让旧证据失效，重新解析 MSIX 入口、执行新鲜关键目标验证，并在 Windows 上同时要求“受管启动匹配 + 新进程真实代理流量”。旧进程的流量不会跨启动复用。无法确认时 Guardian 保留当前任务、进入安全保持并立即检查经过版本、所有权和 SHA-256 校验的适配更新；每日自动更新继续兜底。
这能自动处理兼容机制仍然成立的未来更新，也能在未知破坏出现时精确停止和报告。若上游删除现有机制或引入全新协议，新适配仍需要先被开发和发布；Guardian 不会用反复重启假装已经解决。
仍可能重连的情况
如果状态已经是 ManagedTrafficObserved 且 StreamingProxyGuaranteed=true，同一时间 Guardian 日志也没有 codex_restart / proxy_changed，剩余重连更可能是代理服务商节点的 WebSocket/TLS 重置或上游超时。Guardian 不会擅自切换代理软件里的订阅节点；请在代理软件中换稳定节点。
Codex Proxy Guardian v1.5.0
Codex Proxy Guardian v1.5.0
本版将“Codex 更新后再人工追着修”改造成长期兼容生命周期：自动重解析、自动审计、自动检查 Guardian 适配更新，无法确认时失败安全地保持 Codex。
更新后连续验证
新版 Codex 进程首次出现后，Guardian 默认至少观察 60 秒并完成 3 次新鲜关键入口验证。缓存不重复计数；观察完成前，一次本地代理连接不足以让 Safe 模式判定“已经稳定”。
自动适应与自动更新
每次发现 Store/MSIX Codex 包版本变化，Guardian 会：
- 从新包清单重新解析应用 ID、真实可执行文件和根进程，不依赖写死的 WindowsApps 版本路径；
- 生成版本能力指纹并重新审计关键入口、启动参数和真实代理流量；
- 立即启动当前安装拥有的、经过路径与任务动作校验的 GitHub Release 更新任务；
- 若当时还没有新适配，保留每日自动检查，适配发布后由现有 SHA-256、标签、版本和包内容校验链自动安装。
如果 Codex 完全改变未公开的启动机制，社区工具不可能凭空生成未知适配。但普通用户不需要手动重装或反复试错：一次用户已批准的 Managed 启动若仍无法确认，Guardian 会进入 CodexCompatibilityReviewRequired，保持 Codex 打开并停止进一步自动重启；Codex 或 Guardian 版本变化后再自动重新审计。
疑似上游异常不动 Codex
本地代理监听存在、但关键外部验证失败时显示 UpstreamSuspected。Guardian 不会因此重启 Codex、切换 Clash/Mihomo/v2rayN 订阅节点或修改系统代理；持续重连时应在代理软件中换稳定节点。一次新的关键入口验证通过后会自动恢复。
更诚实的状态
Settings、Status.ps1 与 Doctor.ps1 现在拆分报告端点可达性、流式稳定性限制、更新后观察、兼容能力证据、即时更新检查和安全保持。短 HTTPS 探测与本地 TCP 元数据仍只能提供间接证据，不能从外部证明登录态长时 SSE/HTTP 流绝对稳定。
Codex Proxy Guardian v1.4.5
Codex Proxy Guardian v1.4.5
这次更新把“正在重新连接到底是谁造成的”从故障排查深处提升为产品级说明，避免 Guardian 为代理服务商节点自身的断流背锅，也避免向用户承诺无法控制的结果。
先看证据，再归因
Codex 的“正在重新连接”表示流式连接正在重试，并不能证明 Guardian 重启了应用。README 首页、Windows 设置界面、Status、Doctor、Issue 模板与 Wiki 现在统一要求按同一时间的证据判断：
- Guardian 日志出现
codex_restart或proxy_changed：Guardian 生命周期操作可能相关； - 没有上述事件，但出现 TLS EOF、WebSocket reset、Windows
10054、请求超时或代理软件上游i/o timeout：更可能是当前代理服务商节点或其上游链路断流； ProxyCriticalTargetsPassed=false：chatgpt.com关键入口没有通过验证，应查看ProxyCriticalFailures并检查节点。
承诺范围写得更准确
项目首页与宣传图改为“减少因代理未继承或端点变化造成的重连”。Guardian 会发现、验证并为 Codex 采用可用代理，也会尝试其他已经发现的候选；但不会擅自切换 Clash、Mihomo、v2rayN 等代理软件里的订阅节点，不会修改系统网络设置，也无法修复服务商节点自身的丢包。
Codex Proxy Guardian v1.4.4
Codex Proxy Guardian v1.4.4
本版本修复两个会直接影响用户信任的问题：Settings 更新判断含糊，以及代理“端口可用”但 Codex 流式入口并不稳定时仍被标成有效。
更新检查给出可核对的结论
Windows Settings 的“立即检查更新”现在显示本机版本、远端版本、实际检查通道、检查时间和 GitHub Releases 来源。另一个更新任务占用更新器时，会明确显示“本次尚未完成检查”，不会再误报“已经是最新版”。按钮按照界面当前选择的 Stable 或 Prerelease 通道检查，不要求先点击“应用”。
把 Codex 的关键入口当成硬条件
默认验证仍要求多个 HTTPS 目标成功，同时要求 chatgpt.com 这个关键目标必须通过。API 与登录页成功、但 Codex 流式入口超时的代理不再被过度乐观地标成有效。Status.ps1 与 Doctor.ps1 会公开关键目标是否通过及失败主机。
在混合端口上，更高优先级且通过关键验证的 HTTP/SOCKS 协议可以成为后续自然启动的首选；这类协议调整不会关闭当前 Codex，也不会触发受控重启。真正不同的主机或端口仍沿用确认、防抖、冷却、次数限制与熔断。
Guardian 能发现代理入口和关键目标是否稳定，但不能修复代理服务商上游节点自身的丢包、超时或 WebSocket reset。遇到这种情况应切换代理软件中的节点；Guardian 不会擅自修改节点或系统网络配置。
Codex Proxy Guardian v1.4.3
Codex Proxy Guardian v1.4.3
这是针对 Windows Codex 意外关闭问题的第二次稳定性热修复。它同时解决“同一混合端口仍会切换协议”和“自动重启前没有提醒”两个问题。
不再因同端口协议波动关闭 Codex
Guardian 现在把代理的主机与端口作为生命周期身份。http://127.0.0.1:7897 与 socks5h://127.0.0.1:7897 即使验证结果交替变化，也不会被视为需要关闭 Codex 的代理端点变化。另一个协议验证成功时可作为同端点健康证据，但当前正在运行的 Codex 与其启动参数保持不动。
真正换到其他主机或端口时，原有防抖、冷却、重启次数限制和熔断仍然有效。
重启前必须明确同意
Windows 上所有会关闭现有 Codex 的路径现在默认显示前台确认框：
- 点击“是”：保存好任务后立即执行受控重启；
- 点击“否”：保持 Codex 运行，默认延后 10 分钟；
- 45 秒内没有选择：按延后处理；
- 提示框无法显示：安全失败，保持 Codex 运行。
状态文件会显示 RestartApprovalRequired 或 RestartDeferred，并记录下一次允许提醒的时间。高级用户只有在明确接受无人值守自动重启时，才应将 NotifyBeforeCodexRestart 设为 false。
本版本不修改 Windows 系统代理、WinHTTP、DNS、路由或永久环境变量。