技术手册

AI 工具访问指南

先确认地区与账号资格,再查连接、流式传输和接口配额。页面打不开、回复中途停住和模型不可调用,通常不是同一类问题。

首次配置 LiuVPN,请按使用指南完成客户端安装、订阅导入和连通验证。本手册用于系统查阅:从下方目录选择故障发生的环节,不必从头重做安装。需要按工具了解常见使用场景时,也可参阅 AI 工具专题。

AI 访问故障分层

从最后一个成功动作开始

先把“这个工具用不了”改写成可复现的描述。例如:主页能打开,身份提供方也完成了验证,但回到产品页面后仍显示未登录。这个描述划出了故障边界:首页下载和身份验证的前半段已经完成,接下来应查回跳地址、浏览器会话及工作区选择,而不是先换线路。记录最后成功的动作、最先失败的动作,以及失败时的原文。能看到明确提示时,优先保留提示,不要只记一个笼统的错误名称。

网页打开只说明页面资源或缓存能够使用。发送消息时,浏览器可能访问另一个服务地址;上传文件、读取会话历史、持续接收文本,也可能走不同的连接。首页加载快,不能证明生成链路稳定。相反,如果正文仍在刷新,只有历史列表没有更新,先把问题记为界面同步异常,不要立即判定生成服务整体不可用。遇到只有旧会话失败的情况,用不含私人资料的新会话复测,保留旧会话作为对照。

分开看地区、身份和传输

地区资格指产品是否向用户所在地区及对应账户或组织开放。服务商可能结合出口地址、账户资料、账单归属及组织所属区域判断,具体依据以服务商规则为准。网络出口只是请求抵达服务端时看到的来源之一;它不改变账户归属、合同权限或付款资格。遇到明确的地区提示,应读所用产品入口的官方说明。不要从基础网页可打开,推断同一品牌的模型、接口或企业功能也已开放。

身份层回答“这是谁的请求”,权限层回答“这个身份能做什么”。个人能登录,不代表加入了正确的组织;组织成员能看见入口,不代表管理员已经为其分配许可。传输层则回答请求能否抵达、响应能否完整返回。域名解析失败、证书校验失败或代理连接超时,通常发生在应用判定权限之前。若收到了可识别的产品错误,应保留响应内容,并核对错误来自产品本身还是中间网关,再决定在哪一层继续排查。

理解出口地址与风险判断

同一个网络出口可能承载来自多个用户的流量。服务端观察到的是请求的来源及其行为,不会因为客户端里的地区名称相同,就把所有会话视作同一环境。同一次登录若在不同接入路径之间反复迁移,服务也可能要求重新验证。出现验证提示时,先在本人平常使用的设备和经批准的网络环境中完成官方流程。若账户已被明确限制,频繁切换出口并不会恢复权限,还会让原始故障难以追溯。

只改动能验证假设的变量

建立对照时,明确保持哪些条件不变。怀疑浏览器拦截,就保留账号、网络和操作,换用干净的浏览器配置;怀疑接入不稳定,就保留客户端、工作区和测试文本,在允许使用的接入环境中重复同一动作。若同时更换账号、设备和线路,即使操作成功,也无法知道是哪项变化有效。排查期间应关闭额外的自动重试,避免上一轮后台请求仍在运行,干扰下一轮观察。

另外记下故障的范围:只有本机、只有同一组织成员,还是官方状态通告也报告了相应功能中断。范围比单次测速更有诊断价值。若只有本机失败,从本地时钟、代理配置和浏览器日志入手;若同一组织统一失败,先确认管理策略和项目状态;若官方确认中断,记录受影响的功能并等待恢复,再用原环境复测,不要把临时成功当作配置改动的效果。

平台资格与产品入口

先查入口,再查开放范围

查官方文档时,用完整的产品和入口名称,不要只查品牌。浏览器助手、开发者接口、云平台托管模型和企业编辑器插件,可能分别维护支持地区、账户类型与计费规则。阅读条目时核对它讲的是用户所在地、账单资料还是资源部署区域,并区分开放注册和开放某项功能。即使文档提到一个地区,也要看该条适用于个人账户还是组织租户,以及该地区能否使用所需的具体模型或工具。

平台入口与优先核对项
工具容易混淆的入口先核对
ChatGPT对话网页与开发者 API工作区、API 项目与计费
Claude对话入口与开发者控制台账号类型、组织和模型权限
Gemini个人应用、开发者入口与云平台身份类型、项目与资源位置
CopilotMicrosoft Copilot 与 GitHub Copilot订阅、组织授权与编辑器身份
Midjourney网页与官方支持的 Discord 入口绑定身份、订阅和任务状态
Cursor编辑器内功能与账户管理页当前团队、登录状态与模型可见性

对话助手与开发者产品分开核对

使用 ChatGPT 或 Claude 时,如果对话网页可用,而程序返回项目未授权,先到开发者控制台检查该凭据所属组织、可见模型及账单状态。不要用网页订阅是否生效来判断接口额度,也不要把网页会话当作脚本的认证材料。只有某个模型失败时,应在同一项目内对照一个已明确授权的模型,并检查产品给出的错误代码。这样才能区分项目整体不可用、模型名称不匹配和该模型尚未授权。

Gemini 的排查尤其要分清个人应用、开发者产品与云平台。在个人浏览器中成功对话,并不能证明云项目已允许对应接口。进入云项目后,核对当前操作者是否确实在目标项目下执行,再读接口对资源位置、身份角色和计费的要求。若组织托管身份只对某些资源开放,应请管理员确认并授权,不应改用个人项目处理组织数据。对照时用无敏感内容的输入,避免把排障样本复制到未批准的环境。

插件与创作工具要核对身份绑定

Copilot 要先写明是 Microsoft 产品还是 GitHub 的开发工具,再确定失败发生在网页、桌面应用还是编辑器。浏览器当前登录的身份,可能与编辑器扩展正在使用的身份不同。扩展显示已登录时,也应核对账号标识和许可来源。如果个人仓库能补全而组织仓库不能,优先检查组织策略、授权范围和当前仓库的配置;总是重新安装扩展,会掩盖真正的权限差异。

Midjourney 若能提交任务但图像迟迟未出现,先在官方入口查看任务是否已经受理、任务是否结束,以及预览资源能否加载。已生成但下载失败与任务根本未送达,不应使用同一处理方法。Cursor 若账户页可用、编辑器只有某些模型不能调用,应检查当前团队和模型授权,再确认问题是否来自本机或远程编辑器的运行环境。编辑器界面显示在线,只能证明部分请求成功。

开户注册与会话恢复

在开户前核对归属

开展正式工作前先决定账号归谁管理:个人试用使用本人身份,团队项目使用管理员指定的组织身份。填写资料前核对官方入口、使用资格和账单主体,不借用他人身份,也不在来历不明的代开渠道提交资料。如果之后要共享仓库或交接工作,让管理员通过组织授权分配角色,而不是把个人账号交给多位同事。账号归属和导出权限越早确定,故障时越容易找到能处理问题的人。

LiuVPN 无需邮箱地址,用户名+密码即可注册。这只描述 LiuVPN 用户面板的开户要求,与 AI 服务商的身份验证分开。创建面板账号和创建第三方账号时,应使用独立密码;面板凭据不能用于登录第三方服务。团队成员需要获取 LiuVPN 订阅时,应按使用指南从用户面板操作,不要把订阅链接转发到 AI 对话、共享仓库或公开工单中。身份凭据和网络订阅都应按各自用途保管。

处理登录回跳与会话存储

使用单点登录时,产品会把浏览器送往身份提供方,验证结束后再把浏览器带回产品。如果身份验证成功,回到产品却仍显示未登录,先确认回到预期域名,以及验证前后的操作是否在同一个浏览器配置中完成。系统默认浏览器、应用内置窗口和企业受管浏览器可能使用不同的会话存储。跨窗口打开链接并不一定有问题,但两个配置之间不共享会话时,回跳可能无法与原来的登录动作匹配。

可用隔离的浏览器配置做对照:只开启本次需要的官方入口,不复制旧站点数据,不加载不必要的扩展。若干净配置能登录,再回原配置检查隐私扩展和站点权限。调整只针对相关站点,受组织管理的设置交给管理员处理,不全局取消安全保护。确需清除站点数据时,先确认本地草稿已经妥善保存,仅清除相关站点。清除完成后,从产品入口重新发起,不复用此前登录过程中的回跳地址。

区分登录成功、会话过期与授权失败

看到头像只说明界面认出某个身份。继续检查账号菜单中的组织与工作区,以及操作所需的角色。使用不同身份提供方进入的相似账号,可能具有不同的历史记录和许可。若页面间歇回到登录界面,先看会话是否过期、系统时间是否正确,以及身份提供方是否有公告。若提示管理员审批,保留申请状态与组织名称并联系管理员;多次退出重进通常不会改变审批结果。

交接记录中只写失败步骤和脱敏提示,不附密码、恢复资料、会话值或带身份参数的完整回跳地址。可记下回跳前后的公开域名、浏览器类别和发生时间。若在陌生设备操作,完成后退出会话;若发现未授权的登录活动,按服务商的账号恢复流程撤销异常会话并检查相关凭据,再讨论网络问题。安全事件和普通登录失败应分别记录,以免把应当立即处理的凭据问题误记为线路波动。

网页加载与流式响应

观察响应停在哪个阶段

一次对话并不是等服务器生成完毕才显示结果。流式接口通常让客户端先收到响应,再按服务的事件格式接收后续文本及最终状态。浏览器可能使用服务端发送事件或其他流式机制,编辑器也可能把事件交给扩展进程处理。排查时分别观察请求是否发出、是否收到响应头、是否收到正文片段、是否等到结束标记。不同环节停住,对应的问题不同,不能只看界面上的等待提示。

迟迟没有响应头,可能是连接尚未完成,也可能是请求已抵达、服务正在排队。已经收到正文片段,说明本次请求至少建立了部分响应,但仍可能在生成过程中中断。回复总在一段时间没有新内容后断开,应检查中间网关或客户端的空闲超时;一有响应就很快断开,则应观察是否收到应用错误、用户取消信号或工作进程退出。若服务明确结束并给出结束原因,先按该原因解释,不要把达到输出边界误记为传输故障。

用浏览器网络面板观察对照请求

在官方网页打开浏览器开发者工具,切到网络面板,重新发送一条不包含个人内容的短文本。按发起时间定位请求,先看失败条目的状态和时间线,再对照产品界面的提示。若网络面板显示请求由本地扩展拦截,可在受控的干净配置中验证;若连接被浏览器的证书校验阻止,检查系统时间、受信任证书及组织网关配置,不通过忽略证书错误来继续访问。某些页面的数据处理由后台工作进程发起,界面报错的时间可能晚于实际请求失败。

接下来在同一模型和会话类型下测试一项稍长的普通任务。若短任务完整而长任务经常截断,记录最后收到文本的时刻、结束状态和失败范围,再检查是否有统一的截止时间或空闲超时。若回答总在结束时一次性出现,应考虑中间层缓冲、客户端显示策略或服务本身并非逐段返回。不要仅凭页面上文字出现的节奏判断线路延迟;要用同一次请求的记录区分数据何时到达、界面何时呈现。

单独检验上传和后台切换

纯文本正常而附件失败时,先测试符合平台规则的小型无敏感样本,记录失败在上传前、上传后处理阶段,还是生成阶段。前者需要检查浏览器是否能读该文件、上传目的地址能否连接及组织是否允许上传;后者应检查文件格式、服务端处理结果和当前工具的授权。把附件删掉后请求成功,只能说明问题与附件路径有关,不足以判断文件过大或网络拥堵。不同附件用同一会话逐项对照,才容易定位条件。

设备从前台切到后台或进入休眠时,浏览器可能暂停页面任务,系统也可能更换接入。应先在前台保持测试稳定,再单独复现切换。失败后先查看原会话是否已有生成结果,确认任务是否仍在执行,尤其不要立即重复提交可能计费或触发动作的操作。提交工单时,可以提供已脱敏的状态、时间和请求标识。未经检查的网络记录可能含对话、附件地址和认证信息,不应直接发送。

API 请求、超时与配额

把网页测试和接口测试拆开

网页由浏览器维护会话,API 调用则由应用持有服务商为项目签发的凭据,并按接口文档指定模型、输入格式和返回方式。网页能够生成回复,只能说明网页入口可用。调试接口前,核对配置所用的官方端点、接口类别和项目环境,确认凭据通过环境变量或密钥管理系统注入,没有混用测试与生产项目。凭据不得写进前端页面、测试样例或提交记录;排错时也不要通过打印所有请求头检查是否加载成功。

先执行一条文档支持的最小非流式请求,使用已授权的模型和不含私有数据的短输入,记录状态、服务端请求标识及过滤敏感字段后的错误代码。确认能完整返回后,再以同样的输入切换流式模式。若非流式成功、流式失败,检查客户端是否正确读取事件边界、是否把每次读取当成一个完整事件,以及网关是否缓冲。流式响应可能把一次事件分成多段送达,应用应该依照协议解析,而不是按任意网络分片直接解码。

分别设置连接、读取和总时限

接口时限的边界
参数类别控制的阶段触发时先查看
连接时限建立连接所用时间解析、网关和证书握手
读取空闲时限等待后续数据的空闲时间缓冲行为、生成间隔和代理空闲设置
总截止时间一次任务允许占用的总时间排队、生成时长和调用方预算

各客户端对超时参数的命名和计时起点并不一致。选用 SDK 时,要核对读取时限是针对相邻读取,还是覆盖整个响应;连接是否复用也会影响计时。总截止时间应由业务决定,而且要给后续处理留出时间。若外层任务先取消,而内层客户端还在不断等待或重试,调用会继续占用资源。应把取消明确传到内层,并在日志区分主动取消、超时和远端关闭,避免都报成同一个网络错误。

先读错误,再决定是否重试

认证错误先确认凭据是否属于当前项目、是否被吊销以及进程加载的是哪个配置。权限错误先确认模型与组织角色,参数校验错误则先对照文档修正请求体。在没有改变条件之前,这些响应不适合重试。达到速率限制时,查看错误正文和服务端给出的重试提示,区分短时并发过高与总额度用尽。前者可以降并发并让请求排队,后者应暂停任务、核对预算与配额,等待条件恢复或走官方申请流程。

对明确可重试的短暂故障,使用有上限的退避并加入随机间隔,避免多个工作进程同步再次发送请求。如果 SDK 已经重试,外层调度不要再无限重投。收到超时并不等同于服务端没有执行;对可能创建任务或计费的动作,优先查任务状态。只有服务商明确支持幂等标识时才按其规则使用,不能假设自定义请求头会去重。已有部分流式结果时,应标出内容未完成,把业务动作与文本接收状态分开管理。

命令行、编辑器与 CI 配置

在实际发起请求的进程里验证

命令行、桌面编辑器和流水线可能运行在不同主机上。远程开发插件可以把界面画在本地,却让扩展进程在远程机器或容器内发起请求。先确定发起请求的进程、所在网络和采用的配置入口,再在相同环境中做基础诊断。开发者本机浏览器的连通性不是执行代理的连通性。若命令由脚本包装,应确认启动时读取的是预期工作目录和配置,而不是此前实例遗留的环境。

在装有 curl 的环境中,可用公开示例站点验证基本的解析、连接与 TLS 路径。下面的命令不发送账号信息,也不需要访问 AI 接口。错误原文可帮助区分解析失败、接入网关失败和远端返回。成功只说明该进程能访问这个示例目标,不能证明目标 AI 服务开放,也不能证明流式响应不中断。随后再在同一环境中运行服务商提供的最小接口测试,并按正式文档读取错误。

curl --silent --show-error --fail --output /dev/null \
  --write-out '%{http_code}\n' \
  https://example.com/

核对代理生效范围与证书信任

查看所用工具是否读取系统代理,还是要求为进程设定 HTTPS_PROXY 等变量。并非所有 SDK 都读取同名变量,NO_PROXY 的匹配规则也会随运行时而不同。修改前先查该工具的配置优先级,弄清命令参数、用户设置和环境变量谁覆盖谁。修改后重新启动目标进程,再验证应用是否采用新配置;已经运行的扩展或任务通常不会从另一个终端自动获得新变量。

编辑器应分别检查主程序、扩展和远程环境。扩展日志提示连接失败时,先确认错误属于身份验证页面、模型调用还是后台索引,必要时核对对应模块的配置范围。公司网关若要求指定受信任的证书,应使用管理员分发并核验过的证书,配置到实际发起请求的运行时,而非只装到本地浏览器。不要为了让错误消失而关闭校验。若某条代理规则会把内部地址送出组织网络,应停止测试并请管理员核对规则范围。

将 CI 访问约束放进流水线配置

为 CI 使用专门的项目身份以及所需的最小授权,将凭据保存在受保护的密钥存储中,只在获准的任务注入。对外部贡献触发的任务,不应把生产身份暴露给未经审核的代码。服务若要求审核接入来源,应由管理员按组织方案配置执行代理和出口策略,而不是将个人会话交给流水线。日志中只输出配置是否存在、目标环境类别和脱敏后的服务错误,不输出环境变量全量,不把请求体和响应原文作为默认构建产物。

故障复测从一个隔离的任务开始,先确认相同执行代理的基础网络,再做最小调用,最后恢复并发。多个任务同时启动时,应由调度控制合计并发,而不是只在每个任务里限制。对开发分支,优先使用可预测的测试响应验证错误处理与解析;需要真实调用时,将任务限制在经过审批的环境。这样即使上游中断,也能区分应用本身的回归、共享配额不足和执行代理的接入故障。

账号限制与请求限流

先确定限制作用在哪个对象上

“封号”常被用来描述几种不同现象:账号被停用、组织取消了权限、支付状态发生变化、当前操作需要验证、接口因配额拒绝请求。先阅读产品提示的主语:是账户、组织、项目、凭据,还是当前请求。看产品的正式通知及控制台状态,不凭一次页面报错下结论。能进入账号页却看不到团队资源,优先让管理员核对成员身份;若项目内所有成员都被拒绝,则应核对项目配置和账单状态,而非找成员逐个重置密码。

临时校验通常要求完成官方身份流程;执行完仍失败时,保存通知中的请求标识或申诉入口,从原有身份联系官方渠道。若明确显示账号停用,应停下自动任务,等待说明和处理,不通过新建或借用账号继续原有活动。若没有状态通知,而错误只出现在某个操作,使用同一身份尝试一项已知获准的普通操作,对比权限范围。不要反复触发已被拒绝的原操作,这不会增加有效证据,还可能给服务方排查造成干扰。

减少可预防的告警来源

风险判断常结合身份连续性、请求方式和使用模式。共享账号、把个人会话用于后台脚本、重复发起身份校验、短时间突然启动大量任务,都可能让正常使用看起来异常。团队宜为成员分别授权,自动化使用明确允许的接口和项目身份,人工操作与批处理分开。离职或项目结束时,及时撤销相应权限。不要把浏览器保存的会话转移到其他设备或进程;需要在新客户端操作时,使用产品提供的认证流程。

发现负载突然上升,先看作业调度是否重复触发、多个执行进程是否共享同一凭据,以及 SDK 内外是否同时重试。达到配额时,应避免把同一批工作转移到另一个未获批准的项目。更有效的做法是暂停低优先级请求,把重复作业合并到同一队列,核查是否有可以复用的非敏感结果,并按服务商的正式流程调整额度。恢复前先处理引发请求突增的调度原因,否则限额一恢复,积压任务仍可能再次挤满队列。

准备申诉与泄露处置记录

联系服务商时,提供产品入口、发生时间与时区、错误原文的脱敏摘录、受影响的工作区以及可公开的请求标识。补充哪些操作仍然正常,能帮助区分账户限制与局部功能故障。组织账号由管理员确认工单权限;若问题来自第三方 AI 服务的账号或计费,LiuVPN 无法代为修改权限或处理申诉。网络侧的问题另行记录,避免把两类支持请求混成一个无法验证的问题。

若发现无法解释的调用、异常计费或项目中出现陌生凭据,应按可能泄露处理。先停止使用受影响凭据,通过官方控制台撤销并轮换,再检查任务日志、构建产物和共享文档中是否有暴露来源。删除一条日志不等于撤销已经公开的凭据。修复后,从获准环境发起最小请求,检查监控中是否还出现旧身份的活动,并确认正常任务确实改用新凭据,再恢复生产流量。

国际线路选择与复测

按任务验证,不按地区名称下结论

LiuVPN 覆盖 120+ 国家 / 220+ 线路。可先查线路页了解地区与线路类型,再回客户端核对当前可选项。直连、中转和 IEPL 专线描述的是路径组织方式,并不直接说明第三方 AI 账户是否符合使用条件。直连的实际表现仍取决于接入和对端;中转涉及额外的转发环节;专线标识也不代表从本地到第三方服务的每个环节都处在同一条专用链路上。选线前先确认地区资格与组织网络政策,再比对完整任务表现。

以同一已获准的工作区做对照。若日常主要是文字问答,就记录登录、新会话、回复首段、结束状态及会话能否打开。若主要做编辑器协作,则核对登录状态、一次模型调用和正常取消是否都按预期工作。若涉及文件,另用无敏感内容的样本验证上传和访问结果。只改变接入路径,保留其他条件;换线后不要复用未结束的请求,把原请求的状态先确认清楚,再建立新一轮测试。

区分线路现象、权益与容量

复现不稳定问题时,记录客户端显示的线路名、使用平台、故障时段和观察到的动作,不要把一次成功或失败当成长时间表现。如果同一线路上多个目标都断开,可以进一步检查本地接入与客户端状态;若只有某个产品的某个功能失败,且给出了明确的权限或计费提示,应回到产品控制台核对。若测试从移动网络切到无线网络,再回到原环境做对照,避免把接入变化误判为第三方故障。

同时在线设备不限台数。用不同设备交叉验证时,要记录平台差异,不把各端的会话和授权视为自动同步。容量评估应以自己的使用记录为基础:短文本、附件上传、图像下载和编辑器后台任务消耗的流量不同,不能根据模型账单或输入字符推算网络流量。需要比较时,在同类任务中查看实际消耗,把后台更新等无关流量排除在记录之外,再依据套餐页核对月订阅与流量包规则。

把恢复标准写进记录

一次复测至少应讲清环境、故障动作、原始信号、所做变更和复测结果。环境包括设备、入口与组织;信号可以是公开的错误代码、阶段和时间;变更写到能还原操作,不必记录任何秘密。判断恢复时,重复原失败动作,并确认结果真实可用:网页不能只看头像,流式回复不能只看开头,接口任务不能只看已发出。若仍无法固定复现,就标记为待观察,不把暂时正常写成已经修复。

客户端尚未完成基础连通验证,可先按首次使用检查清单检查订阅导入和连接,再回到本手册继续。若故障已定位到刘VPN 客户端或线路,请从用户面板工单提交脱敏记录;若定位到第三方的资格、账户或模型授权,则交由该服务商或组织管理员处理。保留本轮已经验证过的条件,下一轮从未验证的环节开始,不必重新改变整套配置。