插件装不上时，不要连续重复安装。多数问题都可以归入五类：入口不可见、登录账号不一致、工作区限制、第三方授权不足，或浏览器与网络会话异常。
排查前先记录准确现象，同时遮盖 API Key、验证码、付款资料和私人文件内容。错误信息越具体，越容易找出真正原因。
第一步：确认卡在哪一个阶段
把问题分成：看不到插件、点击后无法安装、授权页面打不开、显示已连接但找不到文件、可以读取但不能写入。不同阶段对应的原因并不相同。
记录错误文字、发生时间、使用的产品与浏览器。不要只写「不能用」，否则很难判断下一步。
第二步：检查产品、账号和工作区
确认正在使用正确的 ChatGPT 或 Codex 账号，并检查个人空间与公司工作区有没有切错。插件目录、可用功能和管理员策略可能因账号或工作区而不同。
如果同一台设备登录了多个账号，先退出其他会话，再用需要安装插件的账号重新登录。
第三步：检查第三方账号与原始权限
连接 Google Drive、Dropbox 或其他服务时，授权账号必须本来就有权访问目标文件。插件不能绕过原服务的共享与权限设置。
先在第三方服务中直接打开目标文件，再检查是否选错团队、文件夹或组织账号。
第四步：用最小权限重新连接
如果授权过期或账号选错，可以先断开该连接，再重新授权。只授予完成任务真正需要的权限，不要因为报错就扩大到整个账号。
重新连接后先测试一个非敏感文件和一个只读任务，确认基本链路正常，再处理正式资料。
第五步：排除浏览器和网络会话问题
依次尝试刷新页面、退出后重新登录、使用无痕窗口，以及暂时停用可能拦截登录弹窗或 Cookie 的浏览器扩展。必要时改用受支持的新版浏览器。
公司网络若有代理、防火墙或单点登录限制，应交由管理员检查，不要自行关闭安全控制。
第六步：整理资料再升级处理
团队账号可能由管理员限制外部连接或写入权限。向管理员或支持人员提供产品名称、插件名称、出错阶段、准确错误文字、账号类型和已完成的排查步骤。
若仍无法判断，可以使用代安装服务协助检查流程，但不要发送密码、验证码、恢复码或完整密钥。
可直接复制的 Prompt
你是谨慎的 AI 插件故障排查助手。请根据资料判断问题类别，并按低风险、可逆、最小权限的顺序给出检查步骤。 产品： 插件或连接服务： 出错阶段：看不到 / 安装 / 授权 / 读取 / 写入 准确错误信息（已遮盖敏感资料）： 账号或工作区类型：个人 / 团队 / 公司 预期结果： 实际结果： 要求： 1. 不要猜测没有提供的账号状态或产品功能 2. 先列出最可能的 3 个原因，再给检查方法 3. 标明哪些步骤需要管理员权限 4. 不要要求密码、验证码、付款资料、API Key 或私人文件内容 5. 资料不足时，最后只问最多 3 个关键问题
发布前检查清单
- 已记录准确错误文字与发生阶段
- 已确认登录的是正确账号与工作区
- 已在第三方服务直接打开目标文件
- 已检查原始文件和文件夹权限
- 已用非敏感文件测试最小权限连接
- 已排除浏览器扩展或登录会话问题
- 升级处理时没有发送密码、验证码或密钥
常见问题
为什么别人有插件入口，我的账号没有？
先检查是否登录了不同账号或工作区。功能可用性也可能受产品方案、地区、组织设置或分批开放影响，应以账号内显示和官方说明为准。
插件显示已连接，为什么仍然找不到文件？
常见原因是授权了另一个第三方账号、目标文件未共享给该账号，或选错团队与文件夹。先在原服务内确认该账号能直接打开文件。
为什么可以读取，却不能建立或修改内容？
读取和写入通常是不同权限。先确认插件本身支持写入，再检查第三方服务权限和公司管理员策略，不要直接扩大为整个账号的完全访问。
可以把报错截图发给别人检查吗？
可以，但必须先遮盖邮箱、文件名、客户资料、二维码、付款信息、密钥、验证码和其他可识别内容。密码与一次性验证码永远不要发送。
把教程变成可复制的工作包
留下邮箱，选择你最想要的 AI 工作包。后续会优先发送 Prompt、模板和落地清单。