docs: 收敛 Performance 权威观测模型 SPEC (#504)

Co-authored-by: Codex <codex@noreply.local>

project-management/PJ2026-01/specs/PJ2026-01060505-workbench-performance.md

@@ -19,7 +19,7 @@
 | 短名 | Workbench性能 |
 | 层级 | L3 子课题 |
 | 状态 | 已生效 |
-| 实现引用版本 | draft-2026-06-17-p0 |
+| 实现引用版本 | draft-2026-06-19-p0 |
 | 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) |
 | 上级规格 | [PJ2026-010605 运维监控](PJ2026-010605-observability-monitoring.md) |
 | 关联规格 | [PJ2026-010401 Web工作台](PJ2026-010401-web-workbench.md)、[PJ2026-010403 API契约](PJ2026-010403-api-contract.md)、[PJ2026-010205 HWLAB接入](PJ2026-010205-hwlab-dispatch.md) |
@@ -31,9 +31,9 @@
 
 ### 2.1 目的
 
-Workbench性能负责把 HWLAB Cloud Web 工作台中用户直接感知的等待时间、实时消息投递时间、session 切换加载时间和首屏打开时间转化为可查询、可告警、可回归的 Prometheus/RUM 指标。
+Workbench性能负责把 HWLAB Cloud Web 工作台中用户直接感知的等待时间、实时消息投递时间、session 切换加载时间和首屏打开时间转化为可查询、可告警、可回归的权威性能观测。该观测必须先进入单一权威 observation history 或等价 read model，再由窗口化 summary、Prometheus 指标、dashboard、告警和 drill-down 消费；不得让 RUM summary、Prometheus raw query、浏览器实时 probe、后端日志或前端诊断互相覆盖同一个展示事实。
 
-本规格的目标状态是：用户从 Web 发起动作后，浏览器、Cloud API、Workbench SSE、trace/read model、AgentRun adapter 和 Prometheus 之间拥有同一套低基数性能事件口径；平台运维可以用这些指标判断 D601 v0.3 Workbench 是否变慢，客户端和 Agent编排可以用同一 traceId/runId 的脱敏诊断继续定位，但监控本身不替代业务功能闭环。
+本规格的目标状态是：用户从 Web 发起动作后，浏览器、Cloud API、Workbench SSE、trace/read model、AgentRun adapter 和性能观测存储之间拥有同一套低基数性能事件口径；平台运维可以按时间窗口判断 D601 v0.3 Workbench 是否变慢，客户端和 Agent编排可以用同一脱敏 correlation 继续定位，但监控本身不替代业务功能闭环。直接探针、synthetic check、Prometheus histogram、RUM field data 和服务端 request metric 分属不同 metric family；它们可以在同一 dashboard 中并列展示，不能用一个 family 的结果裁判或覆盖另一个 family 的结果。
 
 相关运维必须按 UniDesk YAML-first ops 设计：scrape target、recording rule、alert rule、dashboard summary、Prometheus 查询 endpoint、采样/保留/阈值和 D601 node/lane 归属都进入 UniDesk owning YAML；受控 UniDesk CLI 只负责读取 YAML、校验结构、渲染计划、apply/status/summary，并通过共享 ops helper 执行。运行面 Kubernetes 对象、Prometheus target 状态和 Grafana/Prometheus 查询结果只能作为观测对象，不得反向成为配置 source of truth。
 
@@ -46,6 +46,7 @@ Workbench性能负责把 HWLAB Cloud Web 工作台中用户直接感知的等待
 - Workbench REST、SSE、trace pagination、turn snapshot、API proxy、AgentRun adapter 操作的常规 RED 指标。
 - 运行中 Code Agent turn 的无响应空闲时间、最近活动时间和投影刷新活性口径；该口径只衡量“多久没有新事实或可见进展”，不把 turn 总运行时长作为前端超时。
 - 前端 RUM 与后端 Prometheus 指标的关联键、脱敏边界、低基数 label、histogram bucket、recording rule 和低样本告警边界。
+- 权威 observation history 或等价 read model、时间窗口查询、窗口内精确分位、桶化估算标记、样本数、freshness、source family 和数据质量字段。
 - UniDesk YAML-first ops 形式的 D601 v0.3 Workbench 监控接入、scrape/render/status/summary CLI、告警/recording rule 配置和受控运维验证。
 - D601 v0.3 Cloud Web `/performance` 性能监控工作台：以同一权威 summary/series 数据源展示中文化概览卡、趋势图、分布图、TopN 排行、数据新鲜度、采集健康和可访问表格 drill-down。
 - dashboard 图表、表格、tooltip、legend、空状态、错误状态、加载状态、单位、状态和既有数值的中文化展示；默认 UI 不直接暴露未经产品确认的英文 raw 值。
@@ -55,6 +56,7 @@ Workbench性能负责把 HWLAB Cloud Web 工作台中用户直接感知的等待
 - 工作台布局、消息投影、Trace阅读视图和会话权威 API 的功能正确性仍由 [PJ2026-010401 Web工作台](PJ2026-010401-web-workbench.md) 和 [PJ2026-010403 API契约](PJ2026-010403-api-contract.md) 定义。
 - AgentRun run、command、runner、backend profile 和 provider 事件事实归 [PJ2026-0102 Agent编排](PJ2026-0102-agent-orchestration.md) 与 [PJ2026-010205 HWLAB接入](PJ2026-010205-hwlab-dispatch.md)。
 - Prometheus 具体采样间隔、保留周期、阈值、Grafana 面板 URL 和告警路由以 YAML/config 为准，不在本规格硬编码。
+- 浏览器即时 probe、管理员手工 curl、后端日志 grep、Prometheus raw dump 或 synthetic check 不得作为 `/performance` 同一展示字段的替代权威；这些只能作为独立 metric family、定位证据或运维检查。
 - 长 trace、完整 prompt、assistant 正文、tool 参数、命令输出、Secret、token、DSN 和原始 provider payload 不进入性能指标 label 或默认日志。
 
 ## 3. 术语表
@@ -71,6 +73,14 @@ Workbench性能负责把 HWLAB Cloud Web 工作台中用户直接感知的等待
 | RUM | 浏览器端 Real User Monitoring，通过 Web Performance API、Navigation Timing、Long Task、SSE 接收和 DOM paint ack 采集真实用户性能。 |
 | Server-Timing | HTTP 响应头中的阶段耗时摘要，用于把 API 总耗时拆成 read model、DB、AgentRun adapter、projection 等后端阶段。 |
 | Chart-ready summary | `/v1/web-performance/summary` 或后续等价公开 summary/series 入口返回的前端图表直用数据结构，包含时间桶、series、histogram bins、TopN rows、freshness、source、observedAt 和 sample window 等字段。 |
+| 权威观测模型 | Performance 页唯一消费的窗口化性能读模型；它由 observation history 或等价持久事实聚合生成，承载 metric family、窗口、样本、分位、近似程度和数据质量。 |
+| Observation history | RUM、API timing、Workbench journey、Long Task、Web Vitals、server request metric 或 synthetic check 按 family 归一化后的低基数观测历史。它是窗口查询和 trend/TopN/drill-down 的事实来源。 |
+| Metric family | 互不覆盖的指标族，例如 `rum_web_vitals`、`rum_api_timing`、`workbench_journey`、`server_request`、`synthetic_check`。不同 family 可以关联展示，但不能竞争同一状态字段。 |
+| Windowed summary | 按 `windowFrom/windowTo` 和 metric family 从 observation history 聚合出的摘要；同一页面刷新、图表、表格和 drill-down 必须消费同一窗口语义。 |
+| 数据质量字段 | 每个 summary、series 或 row 必须携带的可信度字段，至少包括 `sampleCount`、`lowSample`、`freshness`、`generatedAt`、`aggregationKind`、`approximation` 和 `sourceFamily`。 |
+| 桶化估算 | 从 histogram bucket 推导出的近似分位。它必须显式标记 `approximation=bucketed` 或等价字段，并提供 bucket 边界或估算说明；不得显示成精确耗时。 |
+| 低样本 | 当前窗口内样本数量不足以支持健康判断。低样本是可信度状态，不是慢路径根因，也不能被升级为阻塞或正常结论。 |
+| 采集健康 | 当前窗口观测是否足够新鲜、是否有样本、是否可聚合的状态；它来自同一权威 summary 的数据质量字段，不是第二套 collectorStatus 事实源。 |
 | 性能监控工作台 | Cloud Web `/performance` 中面向管理员和值守人员的 dashboard 视图，用概览卡、趋势、分布、排行和表格 drill-down 展示 Workbench/RUM/API/Long Task 性能健康。 |
 | 低基数 label | Prometheus label 只能取有限稳定集合，例如 route template、journey、phase、eventKind、status，不包含 traceId、sessionId、runId 或用户输入。 |
 | YAML-first UniDesk ops | UniDesk 自有运维事实先进入 YAML，再由受控 CLI 渲染、校验和下发；运行面对象只作为观测面，不反推配置真相。 |
@@ -81,8 +91,8 @@ Workbench性能负责把 HWLAB Cloud Web 工作台中用户直接感知的等待
 | --- | --- |
 | 外部使用者 | 平台管理员、Workbench owner、Agent编排 owner、D601 v0.3 值守人员和性能回归调查者。 |
 | 外部输入 | 浏览器 navigation/RUM event、Workbench REST/SSE event、DOM visible ack、Cloud API route timing、AgentRun event createdAt/sourceSeq、Prometheus scrape。 |
-| 受控资源 | Workbench RUM buffer、`/v1/web-performance` 接收入口、Cloud API Prometheus metrics、SSE 连接状态、AgentRun adapter timing、recording rule 和性能摘要。 |
-| 外部输出 | Prometheus histogram/counter/gauge、低噪声性能摘要、Server-Timing header、中文化 Web performance dashboard、issue closeout 可引用的查询结果。 |
+| 受控资源 | Workbench RUM buffer、`/v1/web-performance` 接收入口、权威 observation history、窗口聚合 read model、Cloud API Prometheus metrics、SSE 连接状态、AgentRun adapter timing、recording rule 和性能摘要。 |
+| 外部输出 | Windowed summary、Prometheus histogram/counter/gauge、低噪声性能摘要、Server-Timing header、中文化 Web performance dashboard、issue closeout 可引用的查询结果。 |
 | 用户接口 | D601 v0.3 Cloud Web `https://hwlab.pikapython.com/workbench` 和 `/performance`、同源 Workbench REST/SSE API、Prometheus 查询入口和受控运维 CLI。 |
 | 系统边界 | Workbench性能只定义性能采集、指标和可见性口径；不改变消息事实、AgentRun 事实、用户权限、会话 authority、业务完成标准或发布流程。 |
 
@@ -106,14 +116,21 @@ flowchart LR
 
   subgraph CloudAPI[HWLAB Cloud API]
     ROUTE[REST/SSE Routes]
-    PERF[/v1/web-performance/]
+    PERF["/v1/web-performance/"]
+    OBS[(Authority Observation History)]
+    AGG[Window Aggregator]
+    SUM["/v1/web-performance/summary"]
     TRACE[Trace Store]
     READ[Workbench Read Model]
     MET[Prometheus Metrics 9100]
     ROUTE --> READ
     ROUTE --> TRACE
+    ROUTE --> OBS
     ROUTE --> MET
-    PERF --> MET
+    PERF --> OBS
+    OBS --> AGG
+    AGG --> SUM
+    OBS --> MET
   end
 
   subgraph UniDeskOps[UniDesk YAML-first Ops]
@@ -137,6 +154,7 @@ flowchart LR
   ROUTE -- SSE / REST --> ES
   API -- REST --> ROUTE
   RUM -- batched RUM --> PERF
+  SUM -- chart-ready summary --> PERFUI[Performance dashboard]
   HELP -- scrape/rule/render --> PROM
   MET --> PROM[Prometheus / Rules / Dashboard]
 ```
@@ -157,13 +175,17 @@ flowchart TD
   I --> J[nextTick + requestAnimationFrame + requestAnimationFrame]
   J --> K[Visible ack]
   K --> L[RUM event batch]
-  D --> M[Prometheus backend metrics]
-  L --> N[/v1/web-performance]
-  N --> M
-  M --> O[PromQL / recording rules / alerts]
+  D --> M[server request observation]
+  L --> N[/v1/web-performance ingest]
+  M --> H[Authority observation history]
+  N --> H
+  H --> W[Windowed summary/read model]
+  W --> DASH[/performance dashboard]
+  H --> P[Prometheus metrics export]
+  P --> O[PromQL / recording rules / alerts]
 ```
 
-数据流必须保证：client journey 起点、后端 phase timing、AgentRun source metadata 和 visible ack 可以在诊断时通过脱敏 correlation id 对齐；Prometheus label 不使用高基数业务 ID，traceId/sessionId/runId 只允许进入 debug payload、日志摘要或 exemplar 类受控扩展，不进入默认 label。
+数据流必须保证：client journey 起点、后端 phase timing、AgentRun source metadata 和 visible ack 可以在诊断时通过脱敏 correlation id 对齐；Prometheus label 不使用高基数业务 ID，traceId/sessionId/runId 只允许进入 debug payload、日志摘要或 exemplar 类受控扩展，不进入默认 label。`/performance` 的卡片、趋势、TopN、表格和采集健康只能读取同一 windowed summary/read model，不能从 Prometheus raw query、browser probe、localStorage、workspace snapshot 或日志 grep 临时推导展示状态。
 
 ### 4.3 用户消息到首个可见事件时序图
 
@@ -255,6 +277,9 @@ session 切换必须分别记录 `first_visible` 和 `full_load`。first visible
 | PJ2026-0106050506 | 代码引用 | 本规格 6.6 | SPEC-first、代码文件头部 SPEC 标注和 issue 回写要求 | 规格治理、全部实现模块 | 后续实现和 review |
 | PJ2026-0106050507 | TurnStatus预算 | 本规格 6.7 | turn status、trace refresh 和 AgentRun result/events 同步的用户可感知预算 | API契约、HWLAB接入、Agent编排 | Web poll、TraceTimeline、性能回归 |
 | PJ2026-0106050508 | Dashboard可视化 | 本规格 6.8 | `/performance` 中文化图表、chart-ready summary、低基数维度、空态/错误态和表格 drill-down | Web工作台、API契约、运维监控 | D601 v0.3 Performance 原入口验收 |
+| PJ2026-0106050509 | 权威观测 | 本规格 6.9 | observation history、metric family、windowed summary 和跨族不可覆盖边界 | 运维监控、Web工作台、API契约 | `/performance`、告警、审计 |
+| PJ2026-0106050510 | 窗口质量 | 本规格 6.10 | 时间窗口、样本数、freshness、aggregationKind、approximation 和 lowSample 语义 | 运维监控、API契约 | dashboard、TopN、drill-down |
+| PJ2026-0106050511 | 分叉禁令 | 本规格 6.11 | 禁止 collectorStatus 旁路、读侧 repair、fallback、bucket 上界冒充精确值和跨族仲裁 | Workbench唯一投影、Web工作台 | 后续迁移和回归 |
 
 ## 6. 原子需求
 
@@ -348,14 +373,50 @@ Workbench 前端、Cloud API 投影层和性能监控不得维护或展示“运
 
 D601 v0.3 Cloud Web `/performance` 应提供 dashboard 级可视化，不得只把 RUM summary 展示成表格或 CSS 比例条。默认视图必须至少包含概览卡、Workbench 体感趋势、Backend event visible 延迟趋势、API timing 趋势或 TopN、Web Vitals 概览、Long Task 分布、问题分布、数据新鲜度和采集健康；表格只作为 drill-down 和可访问 fallback。
 
-图表数据必须来自同一权威 Web performance summary/series 契约。`/v1/web-performance/summary` 或后续等价公开入口应返回前端可直接渲染的 chart-ready 结构，包括时间桶、series、histogram bins、TopN rows、freshness、source、observedAt、sample window 和低样本信息。默认 UI 不得依赖未公开的 raw metrics 路径、内部 Prometheus raw dump、workspace snapshot、localStorage 或测试专用后门；当 series 缺失、低样本、采集降级或数据源不可用时，必须显示中文诊断状态而不是用 fallback 推断正常。
+图表数据必须来自同一权威 Web performance summary/series 契约。`/v1/web-performance/summary` 或后续等价公开入口应返回前端可直接渲染的 chart-ready 结构，包括时间桶、series、histogram bins、TopN rows、freshness、source、observedAt、sample window、低样本信息、aggregationKind、approximation 和 sourceFamily。默认 UI 不得依赖未公开的 raw metrics 路径、内部 Prometheus raw dump、workspace snapshot、localStorage 或测试专用后门；当 series 缺失、低样本、采集降级或数据源不可用时，必须显示中文诊断状态而不是用 fallback 推断正常。采集健康只能是同一 summary 的数据质量投影，不得实现为第二套 collectorStatus 事实源。
 
 Performance dashboard 的图表、表格、概览卡、tooltip、legend、空状态、错误状态、加载状态和既有数值必须中文化。单位统一使用 `毫秒`、`秒`、`次`、`条`、`个`、`%`、`请求/分钟`、`样本`、`序列` 等中文语义；状态统一映射为 `正常`、`预警`、`阻塞`、`等待数据`、`低样本`、`暂无数据`、`采集降级` 或等价中文文案。raw 枚举值可放入 debug tooltip 或复制字段，但默认页面不得直接暴露 `Metric`、`Route`、`Count`、`Status`、`Samples`、`Problems`、`Workbench`、`Web Vitals`、`API Timing`、`Long Tasks` 等未经产品确认的英文 UI。
 
 Performance 指标展示必须保持低基数和脱敏。默认 label、图表维度、TopN 名称和表格列不得包含 sessionId、traceId、runId、conversationId、userId、prompt、assistant 正文、tool 参数、stdout/stderr、Secret、token、DSN 或账号身份。长 route、event type、problem、outcome、statusClass 等维度必须使用 template、归一化枚举或低基数中文映射；无法确认脱敏的字段只能进入受控诊断证据，不得进入默认 dashboard。
 
+### 6.9 OPS-WBPERF-REQ-009 单一权威观测模型
+
+| 编号 | 短名 | 主责模块 | 关联模块 |
+| --- | --- | --- | --- |
+| OPS-WBPERF-REQ-009 | 权威观测 | PJ2026-0106050509 权威观测 | [运维监控](PJ2026-010605-observability-monitoring.md)、[Web工作台](PJ2026-010401-web-workbench.md)、[API契约](PJ2026-010403-api-contract.md) |
+
+Performance 页必须以权威 observation history 或等价持久 read model 作为唯一展示事实源。浏览器 RUM、Cloud API route timing、Workbench journey、Web Vitals、Long Task、server request metric 和 synthetic check 进入该模型前必须先归入明确的 metric family；同一 summary row、series point、TopN item 或健康状态只能由一个 family 的窗口聚合生成。
+
+Metric family 可以在同一页面中并列展示和关联 drill-down，但不能互相覆盖。例如直接同源 API probe 可以作为 `synthetic_check` 或 `latest_check` 展示，用于说明当前入口可达性；它不能覆盖 `rum_api_timing` 的 P95，也不能把 RUM 低样本解释成 API 正常。Prometheus histogram 可以作为 metrics export 和告警输入；若 `/performance` 使用它生成分位，必须保留 `aggregationKind=histogram` 和近似字段，不得把 bucket 上界当成真实 observation。
+
+权威模型必须支持列表轻量、详情补充的窗口化查询模式：默认 summary 返回当前窗口的主要卡片、趋势和 TopN；详情或 drill-down 继续携带同一 `windowFrom/windowTo/sourceFamily/routeTemplate/journey` 约束，不能另拉 raw endpoint 形成第二真相。该模式可以借鉴 status page 的 history -> latest/availability/timeline 聚合，但 HWLAB Performance 的事实源必须是自身 observation history，而不是 UI 组件或探针输出。
+
+### 6.10 OPS-WBPERF-REQ-010 时间窗口和数据质量字段
+
+| 编号 | 短名 | 主责模块 | 关联模块 |
+| --- | --- | --- | --- |
+| OPS-WBPERF-REQ-010 | 窗口质量 | PJ2026-0106050510 窗口质量 | [运维监控](PJ2026-010605-observability-monitoring.md)、[API契约](PJ2026-010403-api-contract.md)、[Web工作台](PJ2026-010401-web-workbench.md) |
+
+`/performance` 必须把时间窗口作为一等输入。summary、series、TopN、分布、问题行和表格 drill-down 都必须返回并展示同一窗口的 `windowFrom`、`windowTo`、`generatedAt`、`sampleCount`、`sourceFamily` 和 `freshness`；用户切换窗口后，页面不得复用旧窗口 summary 冒充新窗口数据。
+
+每个可判定健康的指标行必须携带数据质量字段。`sampleCount` 低于当前指标族的最低可信阈值时，状态应是 `低样本` 或 `等待数据`，而不是 `阻塞`、`正常` 或 `慢路径`。窗口内没有 observation 时，应显示 `暂无数据`；采集入口失败或聚合不可用时，应显示 `采集降级` 或等价诊断。低样本、暂无数据和采集降级只能说明可信度或采集状态，不能被当成慢路径根因。
+
+分位数优先从窗口内 observation 精确计算，并返回 `aggregationKind=exact` 或等价字段。若使用 histogram bucket、Prometheus `histogram_quantile` 或其他近似聚合，summary 必须返回 `aggregationKind=histogram`、`approximation=bucketed`、相关 bucket 边界或误差说明；前端必须用中文标注“桶化估算”或等价文案，禁止显示成精确的 `5.0 秒`、`10 秒`、`30 秒` 结论。
+
+### 6.11 OPS-WBPERF-REQ-011 防分叉、无 repair 和迁移边界
+
+| 编号 | 短名 | 主责模块 | 关联模块 |
+| --- | --- | --- | --- |
+| OPS-WBPERF-REQ-011 | 分叉禁令 | PJ2026-0106050511 分叉禁令 | [Workbench唯一投影](PJ2026-0104010803-workbench-unique-projection.md)、[Web工作台](PJ2026-010401-web-workbench.md)、[API契约](PJ2026-010403-api-contract.md) |
+
+Performance 页必须吸收 Workbench 唯一投影的失败教训：不得在 Web reducer、summary API、fake-server、probe 脚本或 dashboard 组件中保留多个事实源，再通过“优先级、覆盖、fallback、字段缺失时改走另一端点、刷新后 repair、测试专用后门”等方式决定展示状态。字段缺失、投影滞后、采集失败或样本不足时，必须暴露数据质量或 blocker，并修 observation writer、aggregator、read model 或正式 API 契约。
+
+禁止实现独立 collectorStatus 旁路系统来解释同一批性能指标。采集健康应由 windowed summary 的数据质量字段派生；如果需要展示 synthetic/latest check，它必须有独立 metric family、独立标题和独立说明，不能覆盖 RUM/API/Workbench journey 的窗口聚合。Performance UI、fake-server 和 web-probe 必须使用同一 summary 契约；mock fixture 只按正式 API 契约重放，不访问 live Cloud API、数据库、Prometheus 或 Kubernetes 作为通过条件。
+
+迁移阶段必须删除或改写旧的分叉路径。旧 summary 缺少窗口字段、近似字段或 source family 时，不得由前端补造；旧 bucket 上界显示、二次单位换算、localStorage 真相、raw metrics fallback、hidden probe repair 和 collectorStatus 仲裁都应作为 P1/P4 的负向扫描对象。任何保留的临时兼容都只能作为只读审计输入，不能参与默认 dashboard 展示。
+
 ## 7. 过程控制
 
-本规格的执行 issue 为 [#1392](https://github.com/pikasTech/HWLAB/issues/1392)，性能问题修复执行 issue 为 [#1422](https://github.com/pikasTech/HWLAB/issues/1422)，Performance dashboard 中文化可视化执行 issue 为 [#1609](https://github.com/pikasTech/HWLAB/issues/1609)。该类 issue 的 P0 阶段必须以本 SPEC 为前置：先确认本规格、父级 [PJ2026-010605 运维监控](PJ2026-010605-observability-monitoring.md)、[PJ2026-010401 Web工作台](PJ2026-010401-web-workbench.md) 和 [PJ2026-010403 API契约](PJ2026-010403-api-contract.md) 的引用关系，再进入后续实现。
+本规格的执行 issue 为 [#1392](https://github.com/pikasTech/HWLAB/issues/1392)，性能问题修复执行 issue 为 [#1422](https://github.com/pikasTech/HWLAB/issues/1422)，Performance dashboard 中文化可视化执行 issue 为 [#1609](https://github.com/pikasTech/HWLAB/issues/1609)，单一权威观测模型架构治理 issue 为 [#1638](https://github.com/pikasTech/HWLAB/issues/1638)，P0 SPEC 先行 issue 为 [#1639](https://github.com/pikasTech/HWLAB/issues/1639)。该类 issue 的 P0 阶段必须以本 SPEC 为前置：先确认本规格、父级 [PJ2026-010605 运维监控](PJ2026-010605-observability-monitoring.md)、[PJ2026-010401 Web工作台](PJ2026-010401-web-workbench.md)、[PJ2026-0104010803 Workbench唯一投影](PJ2026-0104010803-workbench-unique-projection.md) 和 [PJ2026-010403 API契约](PJ2026-010403-api-contract.md) 的引用关系，再进入后续实现。
 
 后续实现 issue 或 PR 收口时必须回写：使用的 SPEC 编号和实现引用版本、触达的源码文件头部标注情况、Prometheus 指标/label 审查结果、D601 v0.3 public origin 的原入口验证结果，以及是否需要继续修订本规格。