用途:检索并阅读阿里云官方帮助文档,同时用 api.aliyun.com 的公开元数据核对 OpenAPI 契约。适用于产品使用与排障、错误码含义、配额与计费规则、某 API 的精确参数/错误码/RAM 权限点,以及浏览某产品文档目录。不用于变更云资源或替代实时故障诊断。
主要能力:全文搜索(返回标题、URL、摘要,可用 -p 按产品过滤);按 URL 读取文档正文为 Markdown;列出全部产品或某产品文档目录;查询 API 产品、接口列表与接口详情。
用法:入口为 scripts/aliyun_help.py(仅 Python 3 标准库)。示例:python3 scripts/aliyun_help.py search "cross-origin" -p oss;python3 scripts/aliyun_help.py read "https://help.aliyun.com/zh/ecs/user-guide/create-a-custom-image-from-a-snapshot-1";python3 scripts/aliyun_help.py list-docs oss -n 50;python3 scripts/aliyun_help.py api-info actiontrail LookupEvents。常用参数:--site cn|intl、-L/--lang、-n、-l、--json、--raw、--timeout、--no-result-cache。
限制:两个门户产品、地域与价格不同,查询只作用于单一 (site, language),不做跨站回退;全文接口仅支持 en/zh,tc/ja/id/pt-br/fr 仅走 llms.txt 索引,按目录顺序、无更新日期、对错误码与参数名召回差;ko/de 不支持,es/th/vi/tr/ru/it 回退站点默认语言。文档为叙述性内容,与元数据冲突时以元数据为准。引用文档须附原始 URL。退出码 0 成功、1 降级后为空或该站无此产品文档、2 输入无效或后端不可用。自检:ALIYUN_HELP_SELFTEST=1 python3 scripts/aliyun_help.py。