$ man ai-network.requirements
AI 工具真正检查什么
多数问题不是“网页能不能打开”这么简单。认证、对话、文件处理和开发接口可能经过不同的请求路径，需要分别判断。
地区判定与出口一致性
AI 服务通常会结合出口 IP 所在地区、账户地区、浏览器会话和服务政策决定页面内容。登录前后频繁更换国家或线路，可能让认证流程反复校验，表现为跳回登录页、要求重新确认或功能入口缺失。更稳妥的做法是先选择符合服务开放范围的地区，完成登录后继续使用同一地区的线路，不在会话中途来回切换。
长连接与流式输出
对话回答通常不是一次下载完整内容，而是持续接收分段结果。连接短暂抖动、代理规则只覆盖部分域名、浏览器休眠或系统切换网络，都可能导致回答停在中途。此时单纯追求更大的带宽意义有限，更值得观察的是连接是否连续、DNS 与请求是否走同一路径，以及客户端在后台是否仍保持隧道。
账户状态与网络问题分离
地区提示、账户权限、服务侧繁忙和本地网络故障可能出现相似界面。排查时先确认官方状态与账户页面，再检查出口地区，最后更换线路。不要看到错误就连续切换多个国家，也不要在短时间内反复提交登录请求。把账户问题和线路问题分开，才能避免无效操作干扰判断。
工具政策优先于线路能力
线路可以改善跨境链路，但不会改变工具本身的服务范围、账户资格、内容规则或付费地区要求。使用前应查看对应工具的官方地区说明与账户政策。支付资料、账户地区和出口地区之间存在冲突时，应按官方流程处理，而不是依赖频繁换线掩盖冲突。
$ matrix.read --tools
工具 × 线路需求对照
下表不提供可用率承诺，也不把单次连通当作长期结论。工具政策和地区开放情况会变化，使用时应同时核对官方说明。
| 工具 | 主要网络特征 | 线路选择重点 | 常见异常 |
|---|---|---|---|
| ChatGPT | 网页认证、持续对话、文件处理与流式输出 | 选择服务开放地区，保持登录前后出口地区一致，优先观察长连接连续性 | 登录循环、回答中断、地区提示、文件请求失败 |
| Claude | 长文本对话、持续流式响应、账户地区校验 | 避免会话中途换区，保持浏览器与系统代理路径一致 | 页面可开但对话失败、输出停止、会话重新验证 |
| Gemini | 账户体系、地区能力差异、网页资源分域加载 | 确认账户地区与服务范围，检查分流规则是否漏掉关联请求 | 入口缺失、页面反复刷新、部分资源无法加载 |
| Copilot | 网页、系统集成与编辑器扩展可能使用不同链路 | 让编辑器进程和扩展进程明确使用代理，不只配置浏览器 | 网页正常但编辑器无响应、登录回调未完成 |
| Midjourney | 账户认证、交互平台连接、图片资源加载 | 保持认证与资源访问走同一地区，检查媒体域名是否进入隧道 | 认证成功但资源空白、交互请求停滞 |
| Cursor | 编辑器登录、模型请求、代码上下文上传与流式返回 | 确认桌面应用继承系统代理，项目终端与编辑器网络配置不要互相冲突 | 浏览器可用但编辑器超时、补全停顿、登录回调失败 |
对照表的核心不是给工具贴“快”或“慢”的标签，而是确认请求从哪里发出。浏览器、桌面应用、编辑器扩展、项目终端和自动化任务可能使用不同代理设置。只有入口、认证和业务请求都经过预期线路，连接结果才具有可重复性。
$ auth.session --stable
注册登录阶段的处理顺序
认证阶段对出口变化更敏感。先固定地区，再处理账户；不要把每个提示都理解为线路故障。
先确定使用地区
打开工具前先查看官方开放地区，选择相符的线路。完成地区选择后再启动浏览器或桌面应用，使登录页、身份验证回调和登录后的主界面使用同一出口。若浏览器已保留旧会话，可先退出账户并关闭相关页面，再按固定线路重新进入。
只清理必要的站点状态
遇到循环登录时，优先清理对应工具的站点数据，而不是一次删除所有浏览器资料。随后检查系统时间、浏览器隐私扩展和脚本拦截规则。某些登录回调会打开新标签页或跳转到关联域名，过度拦截可能让认证停在最后一步。
核对账户与服务政策
如果页面明确给出账户、地区或资格提示，应先按官方说明处理。更换线路不能修改账户本身的地区资料，也不能替代工具要求的验证流程。连续切换出口只会增加变量，让后续排查更难复现。
$ compare web api
网页端与 API不是同一条路径
网页能完成对话，不等于命令行或服务端调用已经配置正确。两者的认证方式、网络出口和失败提示都不同。
网页端关注会话完整性
网页端通常由浏览器管理登录状态，并同时加载脚本、接口请求和静态资源。若只代理主域名，关联请求仍可能从本地网络直连，最终表现为页面框架出现但内容区空白，或者按钮点击后没有返回。
排查时可先暂时关闭复杂分流，让相关请求统一经过同一线路；确认功能恢复后，再逐项收紧规则。浏览器扩展也可能自带代理或请求过滤功能，需避免与系统隧道重复接管。
API 关注进程出口与超时
API 调用可能来自本地脚本、容器、远程主机或自动化任务。它不一定继承浏览器代理，也不一定读取桌面客户端设置。应先确认发起请求的进程位于哪台机器，再检查该环境的 DNS、代理变量、证书链和出口地区。
流式接口还需要调用方持续读取返回内容。如果客户端库、反向代理或任务运行器提前结束连接，现象看起来像网络中断，实际原因可能位于程序配置。密钥只应放在受控的密钥管理或环境配置中，不要写进网页、仓库和日志。
分层检查顺序
- 请求来源：明确是浏览器、桌面应用、本地终端、容器还是远程任务在发起连接。
- 解析路径：确认域名解析与业务请求使用一致的网络路径，避免解析结果和出口地区相互冲突。
- 代理继承：检查目标进程是否读取系统代理，或是否需要在应用内部单独配置。
- 认证结果：区分网络超时、权限不足、账户限制和请求参数错误，不要把所有失败都归因于线路。
- 流式读取：确认调用方会持续消费响应，并允许任务在输出期间保持连接。
$ dev.environment inspect
命令行、IDE 与 CI配置要点
开发者场景最常见的问题，是不同进程看到的网络环境并不相同。按运行位置配置，而不是按屏幕上看到的应用名称配置。
23VPN(AI) / DEV-ROUTE
从进程边界开始检查
命令行：终端通常继承启动时的环境。连接线路后，已打开的终端可能仍保留旧配置。重新启动终端，再确认代理变量是否由当前工具读取。若项目脚本自带网络配置，应避免它覆盖系统设置。
IDE 插件：编辑器主体、扩展宿主和内置终端可能是不同进程。网页认证成功但补全无响应时，应分别检查编辑器代理、扩展日志和登录回调。不要只用浏览器访问结果判断插件网络。
容器：容器拥有独立网络边界，宿主机已连接并不代表容器自动使用相同出口。需要明确容器如何访问代理、如何解析域名，以及重建后配置是否仍然存在。
CI：自动化任务运行在远程执行环境时，本地 23VPN 线路不会自动延伸到该环境。应依据任务所在平台的网络政策配置合规出口，并通过平台提供的密钥管理保存凭据。日志中只记录必要状态，不输出完整认证信息。
开发环境还应避免“全局代理”和“应用代理”同时叠加。双重接管可能引起回环、连接被重复封装或请求落到意外出口。建立配置时应保留一条清晰原则：由哪一层负责转发，就让其他层保持默认；需要分流时，再按工具域名和进程逐步添加规则。
$ diagnose common-failures
常见失败现象与成因
先记录现象，再改配置。一次只改变一个变量，才能知道是哪一步产生效果。
页面可以打开，但提交问题后一直没有输出
登录完成后又返回登录页面
网页端正常，Cursor 或 Copilot 仍然超时
API 在本地可用，放进 CI 后失败
回答经常在中途停止
更换多个地区后，错误反而更多
$ route.select --final
AI 加速选线方法
先满足地区与会话一致性，再判断连接连续性，最后才比较日常使用体验。
按官方开放范围选地区
工具政策是第一约束。先确认目标服务支持的地区，再从对应地区线路中选择。不要把线路名称当作可用保证，也不要用频繁换区代替账户与政策核对。
一次会话保持同一出口
登录、授权回调、主界面和持续对话尽量使用同一地区。需要换线时，先结束当前会话，再重新打开工具，减少旧连接与新出口混用。
确认真实发起请求的进程
浏览器测试只代表浏览器。IDE、终端、容器和 CI 应分别验证代理继承与出口路径。开发者尤其要检查应用级设置是否覆盖系统配置。
用相同任务比较线路
选择固定工具、固定账户与固定操作流程，分别观察登录、首段响应和长输出是否连续。一次只更换线路，不同时改浏览器、DNS 与代理规则。