天工AI文档上传卡在37%是典型阻塞现象，需强制终止进程、清空缓存、重置凭证并规避命名陷阱，再通过控制台或curl验证服务状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你正准备用天工AI翻译三份PDF技术文档，上传到文档库时进度条停在37%、光标闪烁但无响应，文件名已按规范改好、大小也确认没超50MB——这不是网络波动，而是天工AI文档上传模块的典型阻塞现象，必须针对性干预才能释放通道。
强制中断上传并清空本地缓存
第一步：立即关闭当前浏览器标签页或退出天工AI桌面客户端；
第二步：打开任务管理器（Windows按Ctrl+Shift+Esc，macOS按Command+空格→输入“活动监视器”），搜索“tiangong”或“Electron”，结束所有相关进程；
第三步：清空临时上传缓存——Windows用户进入%LOCALAPPDATA%\Tiangong\UploadCache\，删除该文件夹下全部内容；macOS用户前往~/Library/Caches/tiangong/Upload/执行同样操作；
第四步：重启浏览器或客户端，不要立刻上传，先访问www.tiangong.cn首页，确认右上角显示已登录状态。
天工AI (iOS) 5.2.1版本新增 PPT 生成页数配置、十余种专业视频模板，并且支持设置视频比例与时长；定时任务可指定模型并推送到 IM 渠道。修复了下载失败等问题，提升了稳定性与内容创作体验，让创作更自由、更高效。
绕过UI层直连上传服务验证
方法一（浏览器控制台）：按F12打开开发者工具→切换到Network标签页→勾选“Preserve log”→点击上传按钮→在请求列表中找到以/upload开头的XHR请求→右键→Copy→Copy as fetch；粘贴到Console中回车执行，观察返回是否含"status":"success"字段；
方法二（命令行轻量验证）：终端中执行：curl -X POST "https://api.tiangong.cn/v3/document/upload/init" -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" --data '{"file_name":"test.pdf","file_size":1024}'；若返回401说明Token失效，需重新登录获取；若返回503说明服务端上传网关临时不可用，需等待5分钟再试。
重置上传会话凭证与规避命名陷阱
第一步：网页端右上角点击头像→选择“退出登录”；
第二步：清除浏览器中tiangong.cn域名下的所有Cookie和Storage（Chrome设置→隐私和安全→Cookies和其他网站数据→搜索tiangong.cn→全部移除）；
第三步：重新扫码登录后，上传前务必检查文件名——【禁止使用中文括号、全角符号、连续下划线（如__2025）、首字符为数字】，正确示例：“2025_Qualcomm_Patent_CN.pdf”，错误示例：“专利_2025（终稿）.pdf”；
第四步：单次仅上传1个文件，上传完成且右侧文档库列表出现缩略图后再进行下一个；
第五步：若仍卡住，将PDF用Adobe Acrobat“另存为”→选择“最小文件大小”预设，再上传。
