常见问题与快速处理

任务卡住或一直没有响应怎么办？

可能原因： 网络连接中断、项目目录或附件已不可访问，都可能让任务无法继续；任务本身范围过大、一次处理的文件过多，或服务暂时异常，也可能表现为长时间没有新进度。在 Windows（微软操作系统）的 Code（代码）模式中使用本地项目时，任务也可能卡在发送前的项目准备阶段，表现为一直显示“正在处理”或“正在思考”，并且点击“停止”后仍无法恢复。

建议处理： 先点击一次“停止”，不要连续点击发送，以免产生重复任务。确认网络正常，项目目录可以打开，附件没有被移动或删除；然后新建会话，用一个小文件或更短的任务重新尝试。如果点击“停止”后仍一直显示处理中，先记录发生时间、使用模式和客户端版本，再完全退出 TuriX 并重新启动，重新打开项目后下发任务。重启后仍反复出现时，请保留完整错误提示，并按常见问题排除指南提交排查材料。

为什么找不到文件或读取内容不完整？

可能原因： 文件没有真正添加为附件、不在当前项目目录、已被移动或重命名，或者操作系统没有授予访问权限时，系统会提示找不到文件。长图、低清晰度扫描件、版式复杂或页数很多的文档，也可能只能读取到部分内容。

建议处理： 先确认附件名称和当前项目目录，检查文件仍位于原位置并且可以正常打开；必要时重新添加附件或授予目录访问权限。遇到读取不完整时，将长图或大文档按页拆分，提高扫描图片清晰度，并要求任务列出“已读取范围”和“未读取范围”，最后人工核对关键页和关键字段。

生成的中间文件为什么出现在项目目录？

可能原因： 读取、识别或转换文件时，任务可能需要先生成分页图片、缓存、解压内容或格式转换文件。如果没有指定输出位置，这些中间文件通常会保存在当前项目目录中。

建议处理： 开始任务前指定单独的输出文件夹和最终文件名，并要求任务结束时分别列出“最终交付文件”和“可清理的中间文件”。任务完成后先打开并核对最终文件，再删除明确标记为可清理的内容；无法确认用途的文件不要直接删除。

跳转浏览器登录失败，或登录成功后无法返回客户端怎么办？

可能原因： TuriX 调起浏览器登录时，跳转请求可能被安全软件、浏览器防护或企业策略拦截。即使已经在浏览器中登录成功，返回 TuriX 的客户端回调仍可能被安全软件（如 360）拦截，导致客户端没有完成登录。

建议处理： 先查看浏览器和安全软件的拦截提示或防护记录，允许浏览器打开 TuriX，并将 TuriX 的登录跳转和回调加入可信规则，然后重新发起登录。企业设备无法自行调整规则时，请把拦截时间、提示内容和客户端版本提供给企业管理员处理；不要直接关闭组织要求的安全防护。

首次执行 Python（编程语言）失败怎么办？

可能原因： 首次执行 Python 时，沙盒需要先下载并初始化 Python 运行环境。如果当前网络较慢、不稳定或下载请求超时，本次执行可能会失败。

建议处理： 检查当前网络连接，确认网络稳定后重新下发原指令，或直接让 TuriX 重试。首次下载完成后，后续 Python 任务通常可以直接使用已经准备好的运行环境；如果多次重试仍然失败，请保留完整错误提示和发生时间，并联系企业管理员检查网络限制。

CUA（计算机使用代理）点不动怎么办？

可能原因： 系统没有授予辅助功能或屏幕录制权限、目标窗口被遮挡或最小化、显示器缩放发生变化，都会导致 CUA（计算机使用代理）无法准确识别和点击。登录、安全桌面、验证码和账号选择等受保护步骤也不能由代理代替用户完成。

建议处理： 在系统设置中确认 TuriX 已获得辅助功能和屏幕录制权限，授权后按系统提示重新启动应用。保持目标窗口可见，不要在执行中移动窗口、切换显示器或调整缩放；遇到登录、验证码或账号选择时先由用户完成，回到可正常操作的页面后再让 TuriX 继续。

如何避免原文件被意外修改？

可能原因： 任务没有明确要求保留源文件，或批量改名、格式转换和内容写入使用了原文件路径，可能造成覆盖、移动或重命名。没有备份时，继续执行写入操作还可能扩大影响范围。

建议处理： 开始前先备份源文件，并在任务中明确写明“只读取源文件，结果输出为新文件，不得覆盖、移动或重命名源文件”。执行批量改名、覆盖或格式转换前，先要求列出影响文件和目标路径，确认后再继续。如果原文件已经被修改且没有备份，立即停止后续写入，并检查系统版本历史、回收站或其他备份来源。