用途:诊断阿里云 OSS 的 ossfs 挂载及容器(ACK/ACS)存储卷挂载问题,覆盖挂载失败、挂载目录消失(Transport endpoint is not connected)、容器存储卷 403、归档存储经挂载读取 403 等。核心思路是校验调用者身份、通过只读 GetBucketInfo 获取桶的真实地域、接入点与存储类型,比对挂载接入点与桶所在地域,结合存储类型判断归档直读风险,并依据知识模块做归因。
主要能力:运行 scripts/ 下脚本采集证据,入口为 ossfs_mount_diagnosis.py,身份校验用 sts_token.py;按症状或错误信息路由到 archive_read_403、container_403、dir_disappeared、mount_failed、generic 等类别;输出 JSON 报告与 STATUS: OK|DEGRADED 及 NEXT_ACTION 行;参考模块 M1 挂载归因、M2 容器卷 403、M3 归档直读、M4 只读 RAM 策略。
使用方式: cd $SKILL_DIR && python3 scripts/ossfs_mount_diagnosis.py --bucket <name> [--endpoint <mount-endpoint>] [--region <region>] [--symptom "<symptom-or-error-text>"] [--platform <ecs|ack|acs|docker|local>] 身份预检:python3 scripts/sts_token.py。身份预检要求 aliyun CLI 3.3.3 或更新版本(实测 3.4.5),可用 aliyun version 查看、aliyun upgrade --yes 升级;未安装时按官方渠道安装并执行 aliyun configure。凭据仅由默认凭据链解析(ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET,可选 ALIBABA_CLOUD_SECURITY_TOKEN),不得读取、打印或传递 AK/SK/STS。配置或使用类问题须以 --question "" 调用入口脚本,并引用脚本返回的官方文档 URL。
限制:仅诊断与建议,禁止执行 ossfs、ossfs2、fusermount、mount/umount、modprobe fuse、kubectl apply 及任何变更桶配置的命令,纠正步骤只作为人工指引输出;禁止调用任何写操作 OSS API。接入点选择、通用授权配置、归档取回与生命周期、计费争议、NAS/CPFS 卷等不在范围内,应转对应技能。所有结论须基于真实返回数据,无法验证时明确说明。参数被自动填充时须声明(如自动默认查询接入点)。退出码:0 表示有结论(OK 或 DEGRADED),1 表示无可用结论,2 仅为 argparse 用法错误。退出码、脚本细节、示例输出等资料暂未提供完整内容。