docs: 完成 ApiState workflow 输出收口

2026-07-17 04:24:46 +02:00
parent 213edcc286
commit 858ae6fc77
3 changed files with 32 additions and 1 deletions
@@ -52,6 +52,10 @@ bun scripts/cli.ts platform-infra sub2api codex-pool runtime get --target PK01 -
 - Secret 只输出对象名、key 名、presence、fingerprint 或 redacted prefix；禁止打印完整 token/key。
 - 默认 active target 以 YAML `defaults.targetId` 和 target role 为准；当前 `api.pikapython.com` 对应 PK01 host-Docker target。
 - 原生运维快照统一走 `ops diagnosis|channels`：默认输出紧凑文本，显式 `--json` 输出结构化结果；命令只读且不在前台模拟自动刷新。
+- ApiState 评分 workflow 的状态查询走 `/root/apistate/scripts/apistate-cli.ts workflow status --id <workflow-id>`：
+  - 默认文本只披露 workflow 身份、终态、错误、评分窗口和分组/账号计数；
+  - 需要完整 `groups/accounts` 结果时显式增加 `--json`；
+  - 禁止为确认终态先展开完整评分 payload。
 - `ops diagnosis` 的指标来自原生 admin/ops API；v0.1.155 没有独立 diagnosis/advice endpoint，CLI 必须把官方前端投影建议与 API 已验证事实分开呈现。
 - `ops channels` 使用原生渠道监控的 `7d`、`15d`、`30d` 窗口，支持平台、渠道和模型下钻；渠道历史固定分页并用 `--page-token <record-id>` 向更早记录翻页，`--record <record-id>` 精确下钻，不提供手工 `--limit`；原生响应未提供刷新倒计时时必须显示 unsupported。
 - Codex pool、统一 API key、master `~/.codex` 配置、FRP/Caddy 暴露、账号增删都必须走本技能的受控 CLI。