Alicloud CLI 中文索引技能（alicloud_cli）

目标

把当前离线文档 md_mirror/zh/cli 作为唯一主源，先按“章节索引”定位范围，再定位具体页面，避免在全量目录盲搜。

强制工作流（速查优先，索引兜底）

1. 先使用本文件“CLI 常见用法速查”直接回答高频问题，减少读文件次数。
2. 若问题超出速查范围，再读 references/docs_index.md 确认章节。
3. 再进入章节目录（如 use-cli/、installation-guide/、configure-cli/）定位具体页面。
4. 输出命令、参数、选项时，必须来自“速查”或已命中的正文页面；找不到时明确“证据不足”。
5. 不新增需求外资源，不做“顺手增强”。

文档索引主链

1. references/docs_index.md：统一入口与章节映射（主链起点）
2. references/cli-official-links-index.md：官方链接索引（通过链接 ID 引用）
3. references/links.md：链接 ID -> 官方 URL
4. md_mirror/zh/cli/<section>/...：章节正文与子页面

章节路由（意图归类）

• 产品定义与能力概览：优先 md_mirror/zh/cli/what-is-cli/
• 快速起步与支持产品：优先 md_mirror/zh/cli/quick-start/
• 安装、升级、卸载：优先 md_mirror/zh/cli/installation-guide/
• 凭证、代理、自动补全：优先 md_mirror/zh/cli/configure-cli/
• 命令结构、参数格式、输出过滤、分页聚合、轮询：优先 md_mirror/zh/cli/use-cli/
• 脚本实践、跨地域迁移、容器运行：优先 md_mirror/zh/cli/best-practices/
• 编辑器与终端工具：优先 md_mirror/zh/cli/common-tools/
• 故障诊断与版本变更：优先 md_mirror/zh/cli/cli-troubleshooting/ 和 md_mirror/zh/cli/version-updates/

CLI 常见用法速查（默认优先使用）

帮助与发现

• 查看 CLI 总帮助：aliyun --help
• 查看产品帮助：aliyun ecs --help
• 查看 API 帮助：aliyun ecs DescribeInstances --help

配置与凭证

• 初始化/交互配置：aliyun configure
• 指定 AK/SK 非交互配置： aliyun configure set --profile <name> --mode AK --access-key-id <ak> --access-key-secret <sk> --region <region-id>
• 查看当前配置列表：aliyun configure list
• 切换配置：aliyun configure switch --profile <name>

高频查询与调用

• 查询 ECS 实例： aliyun ecs DescribeInstances --RegionId <region-id>
• 按 JSON 传复杂参数： aliyun <product> <api> --SomeJsonParam '[{"key":"value"}]'
• 仅模拟调用不落资源： aliyun <product> <api> --dryrun

常用全局选项

• 输出过滤/表格化：--output cols=<...>,rows=<...>
• 聚合分页结果：--pager
• 结果轮询：--waiter expr='<jmes>' to='<target>' timeout=<sec>
• 强制调用未收录 API：--force --version <date>
• 调试日志：设置 DEBUG=sdk（按需配合命令执行）

检索建议

# 1) 先在统一索引中收敛章节
rg "安装|配置|命令结构|参数格式|输出|分页|轮询|故障排查" references/docs_index.md