SuperAPI AI 工具集

alibabacloud-oss-image-processing-diagnosis

部署与运维

查看项目

更新于 10-15 19:54

技能介绍

用途:诊断阿里云 OSS 图片处理(IMG)问题,例如 x-oss-process 返回 BadRequest、保存的图片样式不生效、浏览器下载而非预览、水印未应用、原图保护返回 403、WebP 转换报错、HEIC 缩略图 400、处理动作顺序与动态 WebP 等。

主要能力:离线校验 x-oss-process 参数串是否符合官方语法与取值范围;按三步 SOP 核验源对象(声明的 Content-Type、对象大小是否超 20 MB 官方上限、文件头魔数字节);再以只读 GET 携带渲染参数探测渲染结果,把“处理不生效”归因到具体原因(源格式不支持、超出大小限制、参数非法、对象不存在、原图保护 403、默认域名强制下载等),仅给出有证据支撑的结论。

使用方式:诊断须通过 scripts/ 下脚本执行,入口为 scripts/image_processing_diagnosis.py,身份检查用 scripts/sts_token.py。先运行 python3 scripts/sts_token.py 校验凭据并推导 UID(仅作追溯标签)。参数校验:python3 scripts/image_processing_diagnosis.py --process "<x-oss-process-value>"。源与渲染探测:python3 scripts/image_processing_diagnosis.py --bucket <name> --object <key> [--process "<x-oss-process-value>"] [--endpoint <endpoint>] [--region <region>]。需要官方文档核验时用 --question "<客户原话>"。凭据只由默认凭据链解析(环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET,可选 ALIBABA_CLOUD_SECURITY_TOKEN),禁止读取、打印或传入 AK/SK/STS。脚本依赖 aliyun CLI,要求 3.3.3 或更高版本(aliyun version 检查,aliyun upgrade --yes 升级)。退出码:0 表示有结论(OK 或 DEGRADED),1 表示无可用结论(FAIL),2 为参数用法错误。自动填充参数(查询端点、探测端点、UID)须在报告中明确声明。

适用场景:图片处理参数、源格式与大小、渲染失败、预览与下载、原图保护等归因问题。

限制:严格只读,禁止生成或执行任何写操作 OSS API 命令(上传、删除、改 ACL、创建或修改样式、改 Bucket 配置),创建或修改样式只能给控制台手工指引;不处理视频处理、盲水印、文档预览(属 IMM)、CDN 域名配置与计费问题,只作边界说明;缺少 bucket 与 object 时不猜测、不枚举对象,先要求补充对象键与处理串或具体症状;脚本查询失败或为空时如实记录限制并给出 STATUS: DEGRADED,绝不编造格式、大小或错误原因。