v1.1.2 · 一键还原可靠性修复 / Restore reliability fixes

ChatGPT 代理助手 v1.1.2 — 一键还原可靠性修复

ChatGPT 代理助手 v1.1.2（中文）

修复「一键还原」的两个失效场景（v1.1.0/v1.1.1 用户建议更新）：

🐞 修复内容

1. 跨路径接管的还原识别失效：如果用户用旧位置/旧版本的程序「开启」桌面快捷方式，再用新位置/新
   版本的程序「还原」，还原逻辑会识别不到自己创建的快捷方式（它只认"指向当前进程 exe 路径"），
   导致环境变量被还原了、快捷方式却还留着 —— 表现为"一键还原失效"。
   现在还原逻辑按启动器家族识别（ChatGPTProxyManager.exe + --launch 参数），不再依赖路径一致。
2. 启动临时系统代理的遗留：启动 ChatGPT 时会临时打开系统代理 20 秒（给登录跳转用）。如果在这
   20 秒内执行了「一键还原」（或收尾进程被意外终止），还原后系统代理会保持打开——这也是"还原了
   却还开着代理"的症状。现在还原时会检查：系统代理若指向本工具配置的端口，则一并关闭；
   用户自己设置的其它代理地址不受影响。

🐞 同日早些时候的 v1.1.1 修复（仍未过时）

• ChatGPT 26.1007+ 登录页跳转浏览器被墙 → 启动时 20 秒临时系统代理窗口

✨ 其它功能不变

一键开启 / 一键还原 / 环境检测 / 真实连通性测试 / 浅色·深色·跟随系统主题 / 命令行开关。

📦 安装

下载 ChatGPTProxyManager.exe（单文件，免安装）→ 运行 → 点「一键开启」。
旧版本升级：先点旧版「一键还原」，再用新版「一键开启」也可以；直接覆盖 %LOCALAPPDATA% 下的
exe 同样可以（快捷方式路径不变）。

SmartScreen 未签名提示：「更多信息」→「仍要运行」；或自行用源码构建。

🖥 系统要求

Windows 10 19041+ / Windows 11（x64）· .NET Framework 4.8(系统自带) · 本地代理客户端运行中 ·
ChatGPT 桌面版（MSIX 包 OpenAI.Codex，26.908.x / 26.1007.x 均适配）

📄 校验和

SHA256  ChatGPTProxyManager.exe
5ce4c8a6a7e08a1264b85e73aad7bf0929927dc55b12f99fce2a322777759572

---

---

ChatGPT Proxy Assistant v1.1.2 (English)

Two fixes to "One-click restore" (recommended for v1.1.0/v1.1.1 users):

🐞 Fixed

1. Cross-path takeover was not recognized by Restore. If the desktop shortcut had been taken over by
   a copy of the tool at another location and restore was run from a different copy, the tool could not
   recognize its own shortcut (it only matched its currently running exe path) — shortcuts survived the
   restore, which looked like "restore is broken". Restore now matches the launcher family
   (ChatGPTProxyManager.exe + --launch argument) instead of an exact path.
2. Leftover transient system proxy. Launching ChatGPT briefly enables the system proxy for 20 seconds
   (login redirect fallback). If restore ran inside that window — or the reversion helper was killed —
   the system proxy stayed on after restore. Restore now closes the system proxy only when it points at
   the port this tool configured; user-configured proxies on other ports are untouched.

🐞 Also in v1.1.1 (same day, still relevant)

• ChatGPT 26.1007+ opened the login page in the default browser and the redirect was blocked — fixed with
  a 20-second transient system proxy window at launch.

✨ Everything else unchanged

One-click enable/restore, environment detection, real connectivity test, light/dark/follow-system
themes, CLI switches.

📦 Install

Download ChatGPTProxyManager.exe, run it, press "One-click enable".
Upgrading: either press restore on the old version first, or simply overwrite the exe in
%LOCALAPPDATA%\ChatGPTProxyManager.

SmartScreen: "More info" → "Run anyway", or build from source.

🖥 Requirements

Windows 10 19041+ / Windows 11 (x64) · .NET Framework 4.8 (built-in) · running proxy client ·
ChatGPT desktop app (MSIX OpenAI.Codex; both 26.908.x and 26.1007.x supported)

📄 Checksum

SHA256  ChatGPTProxyManager.exe
5ce4c8a6a7e08a1264b85e73aad7bf0929927dc55b12f99fce2a322777759572

License

MIT · Not affiliated with OpenAI in any way.

v1.1.1 · 修复 26.1007+ 登录跳转问题（Fix sign-in redirect for 26.1007+）

ChatGPT 代理助手 v1.1.1 — 修复更新版（适配 26.1007+ 登录）

Bilingual release notes. Chinese first, English after the divider.

ChatGPT 代理助手 v1.1.1

ChatGPT 桌面版更新到 26.1007+ 后，「代理启动会要求重新登录且不跳浏览器」的问题已修复。
建议所有 Windows 用户从 v1.1.0 / v1.0.0 升级到本版本。

🐞 修复内容

• 登录页跳转被墙的问题：新版 ChatGPT（26.1007+）把登录页放在默认浏览器里打开，而 Edge/Chrome
  只认 Windows 系统代理、不认环境变量——系统代理关闭时浏览器直连 auth.openai.com 会被墙，
  表现为「要求重新登录，点了登录浏览器却不跳转」。
  本版本在启动 ChatGPT 时会临时打开系统代理（20 秒窗口），由一个独立的小进程保证到期自动还原，
  让登录跳转不再被墙；窗口结束后系统代理立即恢复为关闭状态，其它软件不受影响。

✨ 继承自 v1.1.0 / v1.0.0 的能力

• 一键开启 / 一键还原：环境变量、托管快捷方式、原快捷方式备份，全程可逆
• 环境检测 7 项实时探测 + HTTP CONNECT 真实连通性测试（chatgpt.com:443）
• 三档主题：浅色（默认）/ 深色 / 跟随系统；Windows 11 Mica 材质界面
• 命令行开关：--launch / --enable / --restore / --test / --detect

📦 安装与使用

1. 下载本 Release 的 ChatGPTProxyManager.exe（单文件，免安装，约 460 KB；macOS 版见 macos/ 目录）
2. 双击运行 → 确认代理地址（默认 127.0.0.1:7897）→ 点「测试连通性」确认"可用"
3. 点「一键开启」，之后直接双击桌面 ChatGPT 快捷方式即可，无需系统代理或 TUN

SmartScreen 可能提示"未知发布者"（未签名）：「更多信息」→「仍要运行」。
也可以用源码自行构建，产物与本附件一致（同一份源码）。

🖥 系统要求

• Windows 10 19041+ / Windows 11（x64），.NET Framework 4.8（系统自带）
• 一个正在运行的本地代理客户端（Clash Verge / mihomo / sing-box / v2rayN …）
• ChatGPT 桌面版（Microsoft Store MSIX 包 OpenAI.Codex，26.908.x 与 26.1007.x 均已适配）

🔐 安全与可逆性

• 不需要管理员权限，不装服务/驱动，不改代理客户端配置
• 启动时临时系统代理只持续 20 秒，由独立进程保证恢复；系统代理最终保持关闭
• 卸载：「一键还原」后删除 %LOCALAPPDATA%\ChatGPTProxyManager

📄 校验和

SHA256  ChatGPTProxyManager.exe
1855877511f7d98e9829abfb0cef2325062e744ddb9abbfb9be7d29cead76291

---

---

ChatGPT Proxy Assistant v1.1.1 (English)

Fixes "ChatGPT asks to log in again and the browser never opens" when launching through the proxy
after the 26.1007+ update. All Windows users on v1.1.0 / v1.0.0 should upgrade.

🐞 What's fixed

• Sign-in redirect blocked: newer ChatGPT builds (26.1007+) open the login page in the default
  browser, and Edge/Chrome only honour the Windows system proxy (not environment variables) — with the
  system proxy off the browser cannot reach auth.openai.com, so the login page never appears.
  This release briefly enables the system proxy during the 20-second launch window; a separate helper
  process guarantees it reverts afterwards, so other apps are unaffected and the system proxy ends up
  disabled again.

✨ Carried over from v1.1.0 / v1.0.0

• One-click enable / restore (env vars, managed shortcuts, original-shortcut backup — fully reversible)
• 7-item live environment detection + real HTTP CONNECT connectivity test (chatgpt.com:443)
• Three themes: light (default) / dark / follow system; Windows 11 Mica UI
• CLI switches: --launch / --enable / --restore / --test / --detect

📦 Install & use

1. Download ChatGPTProxyManager.exe (single file, ~460 KB); macOS build lives in macos/
2. Run it, confirm the proxy address (default 127.0.0.1:7897), press Test connectivity
3. Press One-click enable, then just double-click the desktop ChatGPT shortcut

SmartScreen warning is expected (unsigned): "More info" → "Run anyway", or build from source.

🖥 Requirements

• Windows 10 19041+ / Windows 11 (x64), .NET Framework 4.8 (built-in)
• A running local proxy client (Clash Verge / mihomo / sing-box / v2rayN …)
• ChatGPT desktop app (MSIX package OpenAI.Codex; both 26.908.x and 26.1007.x supported)

🔐 Safety & reversibility

• No admin rights, no service/driver, no proxy-client changes
• The transient system proxy lasts 20 seconds and is reverted by a dedicated helper process;
  the system proxy ends up disabled again
• Uninstall: press One-click restore, then delete %LOCALAPPDATA%\ChatGPTProxyManager

📄 Checksum

SHA256  ChatGPTProxyManager.exe
1855877511f7d98e9829abfb0cef2325062e744ddb9abbfb9be7d29cead76291

License

MIT · Not affiliated with OpenAI in any way.

v1.1.0 · 新增 macOS 版（SwiftUI 原生应用）

What's Changed

Features

• 2e7520d feat: 新增 macOS 版（SwiftUI 原生应用，open --args --proxy-server 方案）

Documentation

• df18239 docs: README 双平台化，新增 macOS 版介绍、截图与已知限制

v1.1.0 · 新增 macOS 版

在 Windows 版基础上，新增 macOS 原生版本（SwiftUI，零第三方依赖），界面与功能保持一致：
一键开启 / 还原、7 项环境检测、真实连通性测试、代理地址可改（HTTP / SOCKS5）、三档主题、运行日志、命令行开关。

macOS 版实现原理

mac 版 ChatGPT（bundle id com.openai.codex）与 Windows 版同源，内核同样是 Chromium。
macOS 的 open 命令原生支持透传启动参数与环境变量，因此无需 COM 激活、无需写注册表：

open /Applications/ChatGPT.app --args --proxy-server=http://127.0.0.1:7897

不修改系统代理、不创建 TUN 网卡；可选创建「ChatGPT（代理）」启动器到「应用程序」（复用 ChatGPT
官方图标），双击即得以代理方式启动，原应用零改动，一键还原即清空。

下载

• Windows：ChatGPTProxyManager.exe —— 与 v1.0.0 相同，无改动，可继续使用旧版
• macOS：ChatGPT-Proxy-Helper-macos-arm64-1.1.0.zip（Apple Silicon；Intel 机器请在 macos/ 目录下从源码构建）

SHA-256: 682985d31320a87805e4ebd48880ffd52f9db4138a146b61f5f11c8ac2d86f9f

macOS 安装说明

1. 解压后将「ChatGPT 代理助手.app」拖入「应用程序」；

2. 未做代码签名 / 公证，首次打开若提示"无法验证开发者"，在终端执行后重新打开：

   xattr -cr "/Applications/ChatGPT 代理助手.app"

3. 打开后确认代理地址 → 「测试连通性」→「一键开启」。

已知限制（macOS）

• ChatGPT 的「检查更新」由内置 Sparkle 框架走系统网络，不认 --proxy-server 也不认环境变量 ——
  需要更新 ChatGPT 时请临时开启系统代理，更新完成后再关闭（助手界面有「工具边界」提示）；
• 语音通话走 UDP，HTTP 代理无法转发此类流量。

Full Changelog: v1.0.0...v1.1.0

ChatGPT 代理助手 v1.0.0

ChatGPT 代理助手 v1.0.0

让 ChatGPT 桌面版直接走本地代理启动，从此不用再开 Windows 系统代理，也不用开 TUN 模式。

✨ 这个版本能做什么

• 一键开启：写入用户级代理环境变量、创建「ChatGPT（本地代理）」快捷方式、接管桌面原「ChatGPT」快捷方式（自动备份），并按需立即启动 ChatGPT；配置动作 1 秒内完成
• 一键还原：环境变量、快捷方式、原始快捷方式全部按记录恢复，系统回到安装前的状态
• 环境检测：ChatGPT 版本与安装方式 / 代理端口占用进程 / 系统代理 / TUN / 环境变量 / 快捷方式 / 运行状态，共 7 项实时探测
• 真实连通性测试：用 HTTP CONNECT 实际打通道 chatgpt.com:443，不是只探测端口
• 三档主题：浅色（默认）/ 深色 / 跟随系统，实时跟随系统深浅色切换
• 原生质感界面：无边框窗口 + Windows 11 Mica 材质 + 自绘标题栏与图标
• 命令行开关：--launch / --enable / --restore / --test / --detect

📦 安装与使用

1. 下载本 Release 里的 ChatGPTProxyManager.exe（单文件，免安装，约 460 KB）
2. 双击运行 → 确认代理地址（默认 127.0.0.1:7897）→ 点「测试连通性」确认显示"可用"
3. 点「一键开启」，之后直接双击桌面 ChatGPT 快捷方式即可，无需系统代理或 TUN

首次运行 Windows SmartScreen 可能提示"未知发布者"（未做代码签名）：点「更多信息」→「仍要运行」。
介意的话可以 clone 源码用 build\build.ps1 自行编译，编译产物与本附件完全一致（同一份源码）。

🖥 系统要求

• Windows 10 19041+ / Windows 11（x64）
• .NET Framework 4.8（Win10 1903+ 与 Win11 系统自带）
• 一个正在运行的本地代理客户端（Clash Verge / mihomo / sing-box / v2rayN …，占本地 HTTP 混合端口即可）
• 已安装 ChatGPT 桌面版（Microsoft Store 的 MSIX 应用，包名 OpenAI.Codex）

🔍 为什么需要它（背景）

ChatGPT 桌面版是 MSIX 打包应用，内部有 Chromium 外壳 + Rust/Node 组件两套网络栈：
Chromium 只认系统代理或 --proxy-server 启动参数，不认 HTTP_PROXY 环境变量；
而 MSIX 应用的快捷方式不允许附加启动参数。所以只设环境变量时，界面仍会卡在启动画面——
这就是"必须去开系统代理 / TUN"的根本原因。

本工具用 COM 激活接口 IApplicationActivationManager::ActivateApplication 带参数启动应用
（保留应用标识，登录/通知/自动更新不受影响），再补齐环境变量覆盖另一半网络栈，
并把快捷方式指向自身作为启动器 —— 于是"双击 ChatGPT"就等于"带代理启动 ChatGPT"。

🔐 安全与可逆性

• 全程不需要管理员权限，不装服务、不装驱动、不改动代理客户端配置
• 只写：用户级环境变量、桌面/开始菜单快捷方式（均有还原路径）
• 系统代理与 TUN 始终是关闭状态（程序界面里可直接看到检测结果）
• 卸载：点「一键还原」后删除 %LOCALAPPDATA%\ChatGPTProxyManager 即可

📄 文件校验

SHA256  ChatGPTProxyManager.exe
f3e3ac562ab13755d298090dc7165ef8689e237f767a0949baa4f07b38258f9c

许可

MIT · 本项目与 OpenAI 无任何关联，仅使用其公开安装的桌面应用。

---

---

ChatGPT Proxy Assistant v1.0.0 (English)

Launch the ChatGPT desktop app through your local proxy — no Windows system proxy, no TUN mode.

✨ What's in this release

• One-click enable — writes the user-level proxy environment variables, creates a "ChatGPT (Local Proxy)" shortcut, takes over the desktop ChatGPT shortcut (original backed up) and optionally launches the app; the configuration itself takes under a second
• One-click restore — removes the environment variables, deletes the created shortcuts and restores the original one, returning the system to its pre-install state
• Environment detection — 7 live checks: ChatGPT version & install type, proxy-port owner, system proxy, TUN, environment variables, shortcuts, running state
• Real connectivity test — performs an HTTP CONNECT to chatgpt.com:443 instead of merely probing the port
• Three themes — light (default) / dark / follow system, live-following Windows theme changes
• Native-feeling UI — borderless window with Windows 11 Mica material, custom title bar and icon
• CLI switches — --launch / --enable / --restore / --test / --detect

📦 Install & use

1. Download ChatGPTProxyManager.exe from this release (single file, ~460 KB, no installer)
2. Run it, confirm the proxy address (default 127.0.0.1:7897) and press Test connectivity until it reports "available"
3. Press One-click enable — from then on just double-click the desktop ChatGPT shortcut, no system proxy or TUN needed

Windows SmartScreen may warn about an unknown publisher (the exe is not code-signed): choose
"More info" → "Run anyway". You can also build it yourself from source with build\build.ps1; the build
is reproducible from this repository and matches this attachment (same source tree).

🖥 Requirements

• Windows 10 19041+ / Windows 11 (x64)
• .NET Framework 4.8 — included with Windows 10 1903+ and Windows 11
• A running local proxy client (Clash Verge / mihomo / sing-box / v2rayN …) listening on a local HTTP/mixed port
• The ChatGPT desktop app installed (Microsoft Store MSIX package OpenAI.Codex)

🔍 Why it's needed

The app is an MSIX package with two network stacks: its Chromium shell only honours the Windows system
proxy or a --proxy-server launch switch and ignores HTTP_PROXY, while MSIX shortcuts cannot carry
arguments — so environment variables alone leave the UI stuck on the splash screen. This tool activates the
packaged app through IApplicationActivationManager::ActivateApplication with --proxy-server (package
identity preserved, so sign-in / notifications / auto-update keep working), sets the user-level proxy
environment variables for the bundled Rust/Node parts, and repoints the ChatGPT shortcuts at itself as the
launcher — so "double-click ChatGPT" equals "launch ChatGPT proxied".

🔐 Safety & reversibility

• No administrator rights, no service, no driver, no changes to your proxy client's configuration
• Writes only user-level environment variables and desktop/Start-Menu shortcuts — both with a revert path
• System proxy and TUN stay disabled (visible in the detection panel)
• Uninstall: press One-click restore, then delete %LOCALAPPDATA%\ChatGPTProxyManager

📄 Checksum

SHA256  ChatGPTProxyManager.exe
f3e3ac562ab13755d298090dc7165ef8689e237f767a0949baa4f07b38258f9c

License

MIT · Not affiliated with OpenAI in any way; it only drives the publicly installed desktop app.