平台与采集能力覆盖矩阵（平台超管）

GET /api/v1/research/capabilities · listResearchCapabilities

返回服务端 Capability Registry 的当前投影。能力粒度是 source × capability，而不是整个平台一个开关；包含公开数据语义、刷新计划、新鲜度、停采状态与 Coverage Gap。只返回 secretRef 是否已配置，不返回任何凭据。仅平台超管可访问。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

响应字段 · 200

items（必填）: ResearchCapability[]
items[].id（必填）: string
items[].source（必填）: string —— 来源注册名，如 steam / taptap / apple / wechat_competitor
items[].platform（必填）: enum；取值：steam / taptap / apple / wechat_minigame
items[].capability（必填）: string —— 能力名，如 ccu / game_detail / reviews / ranking / rss_feed
items[].metricKey（必填）: string —— 该能力产出的稳定指标 key
items[].evidenceKind（必填）: enum —— metric 是结构化观测值；claim 是带出处的内容主张。本期 Claim 只锁合同，不接采集源。；取值：metric / claim
items[].metricClass（必填）: enum —— Qualifier 决定的指标类别。旧 estimated=true 迁移为 estimate；旧 estimated=false 一律为 legacy_unclassified，禁止猜成 fact，且不可进入 V2 快照。；取值：fact / signal / estimate / legacy_unclassified
items[].contractVersion（必填）: string —— 来源响应合同 / fingerprint 的版本
items[].status（必填）: enum；取值：active / disabled / requires_authorization / unauthorized / policy_blocked / quarantined / rate_limited / failed / unsupported
items[].enabled（必填）: boolean
items[].dataScope（必填）: enum —— 数据作用域。V1 全局市场快照只允许 public_market。；取值：public_market / tenant_first_party
items[].truthTier（必填）: enum —— 来源真值等级；等级定义由版本化 qualifier policy 管理。；取值：T0 / T1 / T2 / T3 / T4 / T5
items[].schedule（必填）: string —— 持久化调度表达式；空调度的能力不会运行
items[].freshnessSloMinutes（必填）: integer
items[].cohort: string[]
items[].rateLimitPerMinute: integer
items[].parserVersion（必填）: string
items[].policyVersion（必填）: string
items[].secretConfigured（必填）: boolean —— 只返回是否配置，永不返回 secretRef 或明文
items[].canaryOnly（必填）: boolean —— 首次启用或 429 暂停窗口结束后只运行 canary，成功后才进入常规调度
items[].consecutiveRateLimits: integer
items[].rateLimitedUntil: string
items[].lastSuccessAt: string
items[].lastFailureAt: string
items[].nextRunAt: string
items[].coverageGap: boolean
items[].statusReason: string
items[].version（必填）: integer —— Capability Runtime 的 CAS 版本。
items[].updatedAt（必填）: string

错误

401：Problem 错误响应
403：Problem 错误响应

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/research/capabilities" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "items": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "source": "示例文本",
      "platform": "steam",
      "capability": "示例文本",
      "metricKey": "示例文本",
      "evidenceKind": "metric",
      "metricClass": "fact",
      "contractVersion": "示例文本",
      "status": "active",
      "enabled": true,
      "dataScope": "public_market",
      "truthTier": "T0",
      "schedule": "示例文本",
      "freshnessSloMinutes": 1,
      "parserVersion": "示例文本",
      "policyVersion": "示例文本",
      "secretConfigured": true,
      "canaryOnly": true,
      "version": 1,
      "updatedAt": "2026-08-01"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引