qwencloud-operate

Qwen Cloud 运维

对部署在阿里云国际站、由 qwencloud-deploy 部署的应用进行故障诊断和经确认的恢复。诊断为只读操作，无需确认；任何会改变云端或应用状态的操作都需要明确确认。

交互流程

Identify app & resources
→ Minimal diagnosis (read-only)
→ Give cause, evidence, recommended action
→ Show impact and request confirmation
→ Execute one recovery action
→ Verify application, ECS, RDS
→ Return result + audit info
→ Offer to re-score via qwencloud-observe (before → after)

交互形式

• 只读信息（诊断、原因、证据、验证）：使用纯文本，并在每项判断后附上一行证据（指标、状态、RequestId）。
• 状态变更操作（启动 / 停止 ECS、重启应用、重新加载 Nginx——任何写入调用）：首先提出 AskUserQuestion，说明操作内容 · 影响（停机时间 / 是否不可逆）· 验证方式；确认前不得执行任何操作，并且每次只提出一个恢复操作。
• 主动响应原则：恢复后，如果结果正常，就不再打扰用户；只有在仍有风险或恢复失败时，才提出下一步建议，并由用户选择。

范围

范围内	范围外
由 qwencloud-deploy 部署的应用（存在状态文件）	没有 .qwencloud-deploy 状态文件的应用
单台 ECS，或 ECS + RDS MySQL 8.0	其他拓扑 / 自行管理的服务器
诊断 + 经确认的恢复（启动 ECS、重启应用、重新加载 Nginx）	会破坏数据的操作、扩缩容、配置重新设计
精确定位应用层错误（出错的层以及错误内容）	源代码审查、查找错误 / 漏洞、判断哪一行有问题、编辑代码
阿里云国际站	阿里云中国站 → 使用 qianwenai-operate

代码问题不在处理范围内

此技能用于处理基础设施和运行时故障；不审查源代码、不定位缺陷，也不编辑代码。诊断可以精确定位应用层错误及其抛出的内容，以缩小排查范围，但不会判断哪一行有问题，也不会修改代码。

涉及代码时，请明确告知用户：编辑代码不在此技能的处理范围内，用户必须自行判断并进行修改，相关后果也由用户自行承担。绝不能将代码修改混入恢复操作。

前提条件

阿里云 CLI：aliyun version（需要 3.x）。所有命令均直接使用 PascalCase 原生命令调用 OpenAPI——不依赖插件。凭证：仅运行 aliyun configure list。 绝不读取、回显、打印或索要 AK / SK / token。没有有效配置文件 → 停止操作，并请用户在本次会话之外配置凭证。参见 references/cli_installation_guide.md。

工作方式

1. 识别应用：从 .qwencloud-deploy 获取信息。参见工作流。
2. 诊断（只读，无需确认）。找出故障位置、可能原因、证据以及处理方法。参见诊断。
3. 每次只恢复一项，并先获得确认。 选择与诊断结果相符的操作，向用户说明影响并取得同意，然后只执行该项操作：
   • 启动已停止的服务器 → recover-ecs
   • 重启无响应的服务器 → recover-reboot
   • 重启应用服务 → recover-app
   • nginx -t 通过后重新加载 Nginx → recover-nginx
   • EIP 解绑后重新绑定 → recover-eip
   • 允许安全组的 80 / 443 入站流量 → recover-securitygroup
   • 数据库相关故障 → recover-rds
   • 证书过期 / HTTPS 握手失败 → recover-cert
   • 根磁盘空间接近耗尽 / 清理后空间仍不足（扩容） → recover-disk
4. 验证应用是否恢复，然后记录所做的操作。参见 工作流。

确保恢复安全的规则

• 诊断为只读；恢复仅使用一小组固定的已知安全命令。
• 每项会造成任何更改的操作都必须先征得用户确认，取消操作不会造成任何更改。
• 每次只执行一项操作，验证后再决定下一步 — 绝不批量执行恢复步骤。
• 恢复操作可以安全地重复执行。
• 遇到超时、权限错误或意外状态更改时，停止后续所有更改。
• 绝不将密码、令牌或完整连接字符串写入审计记录或聊天中。

进行任何更改前，确认信息会告知用户：涉及什么资源、要执行什么操作、是否会短暂中断应用、版本是否会更改、是否会产生新的费用，以及将如何验证（如果失败会如何处理）。

所需权限

请参阅 references/ram_policies.md。读取权限：ecs:DescribeInstances、ecs:DescribeInvocations、 ecs:DescribeSecurityGroupAttribute、ecs:DescribeDisks、vpc:DescribeEipAddresses、 RDS 描述/性能/慢日志。写入权限（恢复）：ecs:StartInstance、ecs:RebootInstance、 ecs:AuthorizeSecurityGroup、ecs:ResizeDisk、vpc:AssociateEipAddress、ecs:RunCommand （仅限白名单中的恢复命令）。重新签发证书还需要 alidns 记录读写权限（DNS-01 挑战）。

更多详情

分步指南链接位于上方的“工作方式”部分。另有两份设置参考资料：

• CLI 设置 — 安装和凭据检查。
• CLI 注意事项 — 参数格式、时间格式、响应解析。
• RAM 策略 — 此技能所需的权限。