常见问题排除指南
按任务、文件、模板、升级、登录和工具现象逐步定位问题。
更新于
本页目录
先做 60 秒检查
- 保存当前工作，记录原始错误、发生时间、模式和客户端版本。
- 确认账号和企业身份正确，网络与额度可用。
- 确认项目目录、附件和输出位置仍存在且有访问权限。
- 停止当前失败任务，不连续点击发送、刷新或提交。
- 在新会话使用一个小文件或最短步骤复现，判断是数据问题还是环境问题。
按现象排查
| 现象 | 先检查 | 再处理 |
|---|---|---|
| 任务一直无响应 | 网络、额度、任务大小、当前会话是否忙碌 | 停止任务，在新会话用最小输入复现；保留时间和日志 |
| 大项目刷新卡住 | 文件数量、超大文件、磁盘和目录权限 | 不反复点击刷新；缩小目录或拆分项目后重试 |
| 附件一直显示“解析中” | 附件是否已加入输入区、任务是否已经发送 | 发送明确的读取任务；仍无进度时检查加密、损坏、大小和文件锁定 |
| 文件读取不完整 | 长图、扫描件、超大文档、低分辨率 | 分页或拆图，使用 OCR（光学字符识别），要求返回已读取范围 |
| 中间文件散落在项目目录 | 是否指定输出文件夹和最终文件名 | 使用单独输出目录，结束时区分最终文件与可清理文件 |
| 原文件被修改 | 任务是否允许覆盖、是否有备份 | 立即停止写入，检查版本历史或备份；后续明确输出新文件 |
| 模板附件缺失 | 附件是否真正保存、模板是否来自旧版本迁移 | 重新添加源附件并另存新版本，保留原模板和字段说明 |
| 无法创建或编辑共享模板 | 当前角色、模板所有者和企业策略 | 查看是否有“另存为”入口；没有入口时联系模板作者或管理员 |
| 升级后应用未打开 | 安装程序是否结束、进程是否仍在运行 | 手动启动并核对版本；未更新时退出全部进程后重装 |
| 登录页面被关闭 | 安全软件提示、浏览器防护、企业策略 | 完成身份验证后允许回调；由管理员配置可信规则，不绕过组织防护 |
| Python（编程语言）沙盒报错 | 工作目录、运行环境、依赖和完整错误 | 用最小脚本验证；企业沙盒配置问题交由管理员处理 |
| Windows（微软操作系统）脚本乱码 | 文件与终端编码、脚本来源 | 统一为 UTF-8（统一字符编码），避免混用不兼容命令 |
| 命令窗口黑屏或无输出 | 命令是否适用于当前系统、是否等待输入 | 停止任务，换用当前系统支持的命令并保留完整输出 |
| MCP（模型上下文协议）结果不完整 | 服务状态、筛选条件、分页和超时 | 缩小查询，返回总数与未返回范围，长结果保存为文件 |
| CUA（计算机使用代理）无法点击 | 辅助功能、屏幕录制、窗口、缩放和安全桌面 | 完成系统授权；登录、验证码和账号选择由用户处理 |
文件问题的最小复现
复制一个无敏感信息的小文件到新项目，使用同一操作处理。小文件成功通常说明原文件的格式、大小、加密或内容存在差异；小文件也失败则更可能是权限、环境或版本问题。不要为了测试覆盖唯一的原文件。
什么时候必须停止重试
出现以下任一情况时立即停止：同一操作连续失败、可能重复提交、文件可能已部分写入、原文件被覆盖、结果数量不一致，或操作涉及删除、支付和授权。先确认真实外部状态，再决定恢复方式。
提交支持请求
请提供：
- 问题发生时间、客户端版本、操作系统和使用模式；
- 最短复现步骤，以及预期结果和实际结果；
- 原始错误全文、任务是否可以停止、是否修改了文件；
- 脱敏后的样本、截图和诊断日志；
- 已尝试的处理方式及结果。
不要发送密码、验证码、访问令牌、客户原始数据或未脱敏截图。快速问题也可先查看常见问题与快速处理。