qianwenai-observe

用途

qianwenai-observe 用于对由 qianwenai-deploy 部署到阿里云国内站（aliyun.com）的应用做只读可观测，回答「应用运行得怎么样、预计花多少钱」，无需进入控制台。所有价格为人民币（¥）。

范围

范围内：由 qianwenai-deploy 部署的应用（存在状态文件）；单 ECS，或 ECS + RDS MySQL 8.0；只读的可用性、性能、成本概览；报告运行时状态（可用性、性能、成本）；阿里云国内站，人民币。

范围外：无 .qianwenai-deploy 状态文件的应用；其他拓扑或自建服务器；任何资源变更（改用 qianwenai-operate）；源码审查、找 bug/漏洞、判断哪行代码写错、改代码；国际站（改用 qwencloud-observe）。

本 skill 只做只读观测，报告运行时的可用性、性能和成本，不做源码审查、缺陷定位或代码修改。涉及代码时，需明确告知用户改代码属于本 skill 能力之外，由用户自行决定并执行，后果自负。

主要能力

快速路径：识别应用（读取项目目录下的 .qianwenai-deploy）、选择时间范围（默认最近 1 小时，可选 15 分钟 / 1 小时 / 24 小时）、逐层检查（应用、ECS、可选 RDS、成本）、汇报（一句话结论，然后逐层摘要、风险项、数据时间、未知项）。

各层检查彼此独立且只读，识别应用后可并行发起；同一台 ECS 上的云助手命令合并成一条脚本一次性取回。

检查层次：

应用：探测公网地址和 /healthz，检查应用和 Nginx 服务及端口，汇总近期错误。
ECS：ECS 状态，以及时间范围内的 CPU、网络、磁盘、内存。
RDS（仅当应用含 RDS）：状态、连接数、QPS/TPS、空间、行锁等待，以及脱敏慢 SQL。
公网与暴露面：EIP 状态与带宽、安全组 80/443 放行与暴露风险。
维护与备份：ECS 系统事件、系统盘快照、RDS 备份。
成本：应用的实际费用，可选本月外推。

状态与评分

每层返回一个状态——healthy（正常）· degraded（可用但有风险）· unavailable（不可用）· unknown（无法判断）——并带上检查时间、目标资源、关键证据、数据来源。单项查询失败时继续检查其他层，把失败项标记为 unknown，绝不静默省略、绝不编造数据。

每层还会打分，各层分数相加得到 0-100 的健康分并给出 A/B/C/D 分级（>=90 A · >=75 B · >=60 C · <60 D）。共评四个维度：

维度	权重（含 RDS）	权重（无 RDS）	信号
应用	35	45	可达性、/healthz、响应时间、错误率
ECS	30	45	CPU、内存、磁盘使用率、磁盘 IO、网络
RDS	25	—	连接数、慢 SQL、空间、行锁等待
可用性	10	10	ECS/RDS 运行状态、近期系统事件、EIP 状态与带宽、安全组暴露面

当应用没有 RDS 时，其权重重分配给应用和 ECS。成本从不计分，单独展示为实际账单加一段基于利用率的优化说明。备份/快照缺失和安全组收敛建议只作为风险与建议项呈现，不计入健康分；EIP 未绑定、带宽贴顶、缺 80/443 入方向规则等影响可用性的信号计入可用性维度。

使用方式

前置条件：Aliyun CLI，执行 aliyun version（需 3.x）。所有查询用驼峰原生形态直连 OpenAPI，不依赖插件。凭证仅用 aliyun configure list 查看状态。绝不读取、回显、打印或索要 AK/SK/Token。若无有效凭证配置集，停止并请用户在本会话之外配置凭证。

汇报格式：先给健康分与分级加一句话结论，再给应用、服务器、数据库（如有）、成本各一行短摘要，每行附背后的证据。点出风险项，说明有哪些没能判断以及原因，并给出数据时间。项目目录存在 operate_audit.jsonl 时，带上最近一次运维动作（时间、动作、结果）。发现真实故障时，主动提议用 qianwenai-operate 进入故障诊断，并把已采集的证据写入项目目录的 observe_handoff.json（故障层、关键指标、数据时间戳，不含任何密码/签名 URL）。

汇报示例：

健康分：87 / 100（B，良好）——应用正常，关注 RDS 连接趋势。应用：访问正常，当前响应时间 186 ms，应用和 Nginx 服务正常。 ECS：运行正常，最近一小时 CPU 平均 31%，未发现持续高负载。 RDS：运行正常，活跃连接数从 12 上升到 38，建议关注连接池趋势。成本：2026-08 账期实际费用 ¥88.30（ECS ¥52.10，RDS ¥36.20）。数据截至：2026-08-03 16:20 UTC+8

交互形态：只读信息用纯文本，每条判断后附一行证据；改状态动作使用 AskUserQuestion，确认前不执行；健康时安静，仅在有风险或真实故障时主动开口，一次只提一个后续动作。

渲染报告文件（可选）：把各层状态、分数、关键指标和证据汇总成一个 JSON 对象，交给 scripts/render_report.py 渲染。打印 schema：python3 scripts/render_report.py --schema。渲染前校验：python3 scripts/render_report.py --validate -i data.json。渲染：python3 scripts/render_report.py -i data.json -f md -o report.md（或 -f html）。

交接给运维（可选）示例：

{
  "from": "qianwenai-observe",
  "generated_at": "2026-08-03T16:20:00+08:00",
  "fault_layer": "rds",
  "symptoms": ["RDS 活跃连接从 12 升到 190，接近上限"],
  "metrics": {"rds_active_connections": 190, "app_http_code": 200}
}

fault_layer 取 app / nginx / ecs / rds / network / disk 之一。只写只读观测得到的证据，绝不写入密码、连接串或签名 URL。

安全

规则	说明
只读	云助手命令必须只读；绝不修改实例/应用状态。
不碰密码	绝不读取或输出 .qianwenai-deploy.local 中的密码。
脱敏	日志输出中的 AccessKey、Token、密码、连接串密码、Cookie 必须脱敏。
慢 SQL	只输出 SQL 模板/脱敏 SQL，限制长度；绝不展示字面参数值。
成本	只展示实际费用（¥）及账期；绝不展示预估。尚无账单时把成本标记为 unknown。

所需权限

除惰性装 agent 的 cms:InstallMonitoringAgent 外均为只读：ecs:DescribeInstances、ecs:RunCommand + ecs:DescribeInvocations（只读命令）、cms:DescribeMetricList、cms:DescribeMonitoringAgentStatuses、cms:InstallMonitoringAgent、ecs:DescribeSecurityGroupAttribute、ecs:DescribeInstanceHistoryEvents、ecs:DescribeSnapshots、vpc:DescribeEipAddresses、bssopenapi:QueryInstanceBill、bssopenapi:QueryBill，以及（含 RDS 时）rds:DescribeDBInstances、rds:DescribeDBInstanceAttribute、rds:DescribeDBInstancePerformance、rds:DescribeSlowLogRecords、rds:DescribeBackups。

技能介绍

用途

范围

主要能力

状态与评分

使用方式

安全

所需权限