用途:诊断阿里云 OSS 大文件分片上传问题,覆盖上传卡在 0%、中途中断、反复失败、存储桶看似为空但容量被分片占用等场景。
主要能力:以只读方式查询调用者身份、用 GetBucketInfo(ListBuckets 兜底)定位存储桶真实地域、用 ListMultipartUploads 列举未完成分片上传事件、核对用户分片大小与并发是否符合官方限制,并据决策树把卡住/中断/失败归因到服务端、客户端或网络。
使用方式:所有诊断必须通过 scripts/ 下脚本执行,入口为 multipart_upload_diagnosis.py,身份检查用 sts_token.py。典型命令:cd $SKILL_DIR && python3 scripts/multipart_upload_diagnosis.py --bucket <name> [--file-size 40GB] [--part-size 10MB] [--concurrency 8] [--symptom stuck] [--prefix <object-prefix>] [--region <region>]。首次运行前执行 pip install -r scripts/requirements.txt 安装 oss2 与 alibabacloud-credentials;aliyun CLI 需 3.3.3 及以上,可用 aliyun version 与 aliyun upgrade --yes 检查升级。凭据仅走阿里云默认凭据链,绝不读取、打印或传入 AK/SK。
限制:严格只读,禁止生成或执行 AbortMultipartUpload、PutObject、DeleteObject 等任何写操作,分片清理仅提供手动指引;不处理单请求上传错误码、下载、计费明细等,应转对应技能;结论必须基于实际返回数据,查询失败则如实标注限制,不编造分片数或上传 ID。触发词包括 multipart upload stuck、upload stuck at 0%、resume interrupted upload、large file upload fails、resumable upload 等。