fix-chatgpt-deep-research-vpn

免费的 CLI 和 Codex skill，用来诊断 ChatGPT 深度研究、深度搜索在 VPN/代理环境下卡住或加载失败的问题。

它不是 Shadowrocket 专用工具。它会先判断真实失败路径，再把修复思路翻译到 Shadowrocket、Clash/Mihomo、Clash Verge、Surge、sing-box、V2Ray/Xray、浏览器扩展代理、PAC、公司代理等不同客户端。

核心价值是让 AI agent 能自己判断：

• 哪个 host 真正失败；
• 是 WebSocket、connector、DNS、fake-IP、TUN、HTTP CONNECT 还是上游节点坏；
• 应该改 exact host、fake-ip-filter、DNS policy、route rule、proxy bypass 还是公司 allowlist；
• 怎么验证和回滚。

安装 Codex skill

npx fix-chatgpt-deep-research-vpn install

它会把 skill 安装到：

~/.codex/skills/fix-chatgpt-deep-research-vpn

然后在 Codex 里说：

Use $fix-chatgpt-deep-research-vpn to diagnose and fix why ChatGPT Deep Research is stuck behind my VPN/proxy.

也可以直接用中文说：

用 $fix-chatgpt-deep-research-vpn 帮我诊断为什么 ChatGPT 深度研究在代理/VPN 后面卡住。

给其他 AI 使用

npx fix-chatgpt-deep-research-vpn prompt

把输出贴给 Claude、Cursor、Gemini 或任何能读终端输出、能帮你改代理配置的 AI。

直接运行只读诊断

npx fix-chatgpt-deep-research-vpn diagnose --proxy http://127.0.0.1:1082

诊断命令只读，不会改配置。它会对比直连、本地代理、DNS、fake-IP、connector host 等路径。

Shadowrocket/macOS 自动修复 adapter

自动 apply 目前只针对 macOS + Shadowrocket。其他客户端请让 AI 根据诊断结果和 skill 里的代理客户端矩阵翻译规则。

先 dry-run：

npx fix-chatgpt-deep-research-vpn apply

确认后修改 Shadowrocket 数据库：

npx fix-chatgpt-deep-research-vpn apply --apply --restart

如果诊断证明 fake-IP 或 hostname 代理路径是坏点，再加 /etc/hosts pin：

npx fix-chatgpt-deep-research-vpn apply --apply --apply-hosts --restart

修复脚本会在修改前创建时间戳备份。