docs: refine HWLAB spec governance

2026-06-14 15:59:39 +00:00
parent b8529abed1
commit 03b47aefff
13 changed files with 339 additions and 510 deletions
@@ -18,12 +18,25 @@ description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管
 - 将 `project-management/PJ2026-01` 下的 Markdown 视为长期规格真相源。
 - 将 GitHub issue 视为执行控制面、历史讨论入口和长证据承载处：状态、讨论、跨仓引用、PR 链接和收口证据可以在 issue 中流转，但规格正文不得只写在 issue 中。
 - 长证据、trace、CaseRun registry、运行日志、历史 issue 摘要和证据索引保留在 GitHub issue 或具体执行 issue 中，禁止以 `evidence/` 目录或长证据文件形式污染 `project-management/PJ2026-01`。
- 所有写入 Markdown 正文、issue/PR 正文或评论的 issue/PR 引用必须写成 `[#<number>](https://github.com/<owner>/<repo>/issues/<number>)` 或 `[#<number>](https://github.com/<owner>/<repo>/pull/<number>)`，显示短号、链接目标保留完整 URL；不要显示裸长链接、裸井号编号或 `owner/repo` 加井号编号。CLI 参数中的 `owner/repo#number` shorthand 只作为命令输入例外。
+- `project-management/PJ2026-01/specs/*.md` 规格文件不保留单独的迁移来源块；历史来源只写在修改历史 `v0.1` 的变更说明中，格式为 `迁移来源 <owner>/<repo>#<number>`。规格文件引用其他规格必须使用同目录相对路径 Markdown 链接，禁止引用其他规格的 GitHub issue、证据 issue、PR 或裸 `#<number>`。
+- 写入 GitHub issue/PR 正文或评论时，issue/PR 引用必须写成 `[#<number>](https://github.com/<owner>/<repo>/issues/<number>)` 或 `[#<number>](https://github.com/<owner>/<repo>/pull/<number>)`，显示短号、链接目标保留完整 URL；不要显示裸长链接、裸井号编号或 `owner/repo` 加井号编号。CLI 参数中的 `owner/repo#number` shorthand 只作为命令输入例外。
 - 不要让日报或阶段报告成为总规划。阶段报告只总结相对总规格的移动，不能替代中心规划。
 - 当任务缺少上级方向、验收标准或原始验证入口时，先归类为规划/调查，不要直接变成实现任务。
 - L1 方向必须是直接服务 L0 使命的能力域。文档整理、阶段报告、项目管理机制、看板维护、技能维护、仓库名、工具名和临时执行路径都不能作为 L1 方向。
 - L1 是验收主责，不是宽泛标签。跨方向 issue 可以列关联 L1，但必须且只能有一个主责 L1，选择依据是哪个方向定义完成标准。

+## 需求规格写作规则
+
+- 需求规格是对外系统能力、边界和职责说明，不写内部治理、issue 关闭规则、长期面板、阶段报告、执行控制面、单次验证流水、PR 过程或证据堆叠。
+- 文档控制表只保留规格自身必要字段；状态只能写 `已生效`、`已废弃` 或 `未生效`。不要在文档控制表里写长期面板、阶段规格、L1 划分、规格来源或迁移来源。
+- 修改历史只记录已经定稿的版本。用户未明确说“可以定稿”前，不新增 `待提交` 版本号，也不把每次小编辑拆成一个版本。
+- L0 系统边界必须把 HWLAB 作为完整系统看待，描述外部使用者、外部输入、受控资源、外部输出、用户接口和系统责任边界，不写内部治理材料。
+- 稳定概念用术语表表达；不要写没有判定价值的“运行概念”流水。
+- L0 的 L1 方向树和项目规格索引合并为内部模块分工与规格索引，用相对路径索引到每个内部模块规格文档。
+- 原子需求每条独立成节，信息表使用横向表格 `编号 | 需求 | 主责模块 | 职责划分`。主责模块必须带项目编号和相对路径链接；不写 `类型`、`验证方法`、`验证入口`、`必需证据`、`接受标准`，正文只说明意图和边界，不重复需求句。
+- 平台运维在 L0 中只能作为支撑后勤职责出现；对外需求应写成系统可用性、可恢复、资源可控等用户可感知能力，不写成“HWLAB 对外提供平台运维能力”。
+- 单一主责、关闭验收、规格沉淀、回写和偏离判定是治理规则，不得伪装成 L0 原子需求。
+
 ## HWLAB 标准 issue 锚点

 - L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`，历史 issue `[#1194](https://github.com/pikasTech/HWLAB/issues/1194)`。
@@ -44,7 +57,7 @@ description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管

 除非用户给出更严格的层级，否则使用以下任务树：

- L0：重大项目 / 总规格。负责使命、非目标、当前中心、L1 方向树、全局验收和偏离规则。
+- L0：重大项目 / 总规格。负责使命、范围、系统边界、内部模块分工与规格索引、全局原子需求。
 - L1：方向。负责一个稳定能力域、范围边界、成功标准、L2 课题清单和子工作验收定义权。
 - L2：课题。负责某个 L1 内的具体工作计划，包括交付物、阻塞项和验证计划。
 - L3：子课题 / 验收切片。负责一个有界验收路径，例如一条 CaseRun 线、Web 检查、CLI smoke 或部署/控制面验证。
@@ -34,7 +34,7 @@ HWLAB Cloud M1 需要一个项目控制结构，避免局部 issue/PR 工作偏
 不要把长证据正文放进项目管理目录。项目管理目录只承载规格、治理和阶段中心；长证据保留在 GitHub issue。
 规格文件和 GitHub issue 的引用规则分开处理：

- `project-management/PJ2026-01/specs/*.md` 中，每个规格文件最多保留一个 GitHub issue 链接，即迁移来源表里的自身原 issue。
+- `project-management/PJ2026-01/specs/*.md` 不保留单独的迁移来源块；历史来源只写在修改历史 `v0.1` 变更说明中，格式为 `迁移来源 <owner>/<repo>#<number>`。
 - 规格文件引用其他规格时，使用同目录相对路径 Markdown 链接，例如 `[PJ2026-0101 硬件池](PJ2026-0101-hardware-pool.md)`；不要引用其他规格的 GitHub issue、证据 issue、PR 或裸 `#<number>`。
 - GitHub issue/PR 正文和评论中的 issue/PR 引用必须写成 `[#<number>](https://github.com/<owner>/<repo>/issues/<number>)` 或 `[#<number>](https://github.com/<owner>/<repo>/pull/<number>)`，显示短号、链接目标保留完整 URL；不要显示裸长链接、裸井号编号或 `owner/repo` 加井号编号。`owner/repo#number` 只允许作为 CLI 命令参数 shorthand。

@@ -3,71 +3,79 @@
 ## L0 总规格骨架

 ```markdown
-# HWLAB 总规格
+# PJ2026-01 HWLAB 总规格

 ## 修改历史

 | 版本 | 对应 commit id | 更新日期 | 变更说明 |
 | --- | --- | --- | --- |
-| v0.1 | <commit> | <YYYY-MM-DD> | <一句话变更说明> |
+| v0.1 | <commit> | <YYYY-MM-DD> | 创建需求规格；如来自历史 issue，只在这里写迁移来源 <owner>/<repo>#<number>。 |

-编号: PJ2026-01
-短名: HWLAB
+当前正文仍在规格治理草稿中；未定稿前不新增版本号，不为单次编辑追加 `待提交` 版本。

-## 1. 项目使命
+## 正文

-用一段话描述产品目标和科研目标。
+## PJ2026-01 HWLAB 总项目需求规格

-## 2. 非目标
+## 1. 文档控制

- ...
+| 字段 | 内容 |
+| --- | --- |
+| 编号 | PJ2026-01 |
+| 短名 | HWLAB |
+| 层级 | L0 总项目 |
+| 状态 | 已生效、已废弃或未生效 |
+| 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) |
+| 规格治理索引 | [规格治理](spec-governance.md) |

-## 3. 当前中心
+## 2. 目的和范围

- 当前主验证线:
- 次级验证线:
- 明确暂停/后置的线:
+### 2.1 项目使命

-## 4. 方向树
+<用一段话描述对外系统目标和用户价值。>

-| 层级 | 标题 | GitHub issue | 规格章节 | 当前状态 |
-| --- | --- | --- | --- | --- |
-| L1 | PJ2026-0101 硬件池 | TBD | ... | ... |
-| L1 | PJ2026-0102 Agent编排 | TBD | ... | ... |
-| L1 | PJ2026-0103 HarnessRL | TBD | ... | ... |
-| L1 | PJ2026-0104 客户端 | TBD | ... | ... |
-| L1 | PJ2026-0105 用户管理 | TBD | ... | ... |
-| L1 | PJ2026-0106 平台运维 | TBD | ... | ... |
+### 2.2 范围内

-## 5. 全局验收标准
+- <系统能力范围>

- ...
+### 2.3 范围外

-## 6. 方向详情
+- <不属于本规格的对象>

-### L1: <方向短名>
+## 3. 术语表

- 目标:
- 非目标:
- 当前课题:
- 验收标准:
- 验证入口:
- 开放阻塞:
+| 术语 | 定义 |
+| --- | --- |
+| <术语> | <稳定定义> |

-## 7. issue 层级索引
+## 4. 系统边界和接口

- L0:
- L1:
- L2:
- L3/L4:
+本规格把 HWLAB 作为一个完整系统看待；本章只描述外部输入、外部输出和系统边界，不描述内部治理流程。

-## 8. 偏离规则
+| 边界项 | 内容 |
+| --- | --- |
+| 外部使用者 | <用户、外部系统、管理员或自动化任务> |
+| 外部输入 | <用户请求、业务对象、资源约束、身份凭据、文件或硬件选择> |
+| 受控资源 | <系统管理的设备、数据、运行环境或外部资源> |
+| 外部输出 | <用户可获得的状态、结果、产物、通知、报告或记录> |
+| 用户接口 | <Web、CLI、API、SDK、Webhook 等> |
+| 系统边界 | <系统负责什么；明确不替代用户或外部系统负责什么> |

- ...
+## 5. 内部模块分工与规格索引

-## 9. 阶段报告链接
+| 编号 | 内部模块 | 规格文档 | 主责边界 | 上游依赖 | 下游支撑 |
+| --- | --- | --- | --- | --- | --- |
+| PJ2026-0101 | 硬件池 | [PJ2026-0101 硬件池](PJ2026-0101-hardware-pool.md) | <主责> | <依赖> | <支撑对象> |

- ...
+## 6. 全局原子需求
+
+### 6.1 HWLAB-L0-REQ-001 <需求短名>
+
+| 编号 | 需求 | 主责模块 | 职责划分 |
+| --- | --- | --- | --- |
+| HWLAB-L0-REQ-001 | <HWLAB 应提供的对外系统能力> | [PJ2026-0101 <主责模块>](<相对路径>) | <主责负责什么；关联模块负责什么；哪些内容不属于本需求> |
+
+<正文说明该原子需求的意图、范围和边界。正文不重复需求句，不写类型、验证方法、验证入口、必需证据或接受标准。>
 ```

 ## L0 issue 正文
@@ -105,7 +113,7 @@

 | 层级 | 负责定义 | 不负责 | 回写对象 |
 | --- | --- | --- | --- |
-| L0 | 项目使命、当前中心、L1 方向树、全局验收、偏离规则 | PR 细节、CaseRun 日志、日报流水 | L0 规格文件、L1 issue |
+| L0 | 项目使命、范围、系统边界、内部模块分工、全局原子需求 | PR 细节、CaseRun 日志、日报流水、内部治理规则 | L0 规格文件、L1 issue |
 | L1 | 能力域范围、成功标准、L2 课题清单、原入口验收类型 | 单个 PR、一次 smoke、仓库/工具/运行面名称、项目管理动作 | L0 规格文件、对应 L1 规格文件 |
 | L2 | 单个方向内的具体课题、交付物、阻塞、验收计划 | 总方向定义、实现细节流水 | L1 issue，重大移动再回写 L0 |
 | L3 | 一个有界验收切片和单一验收路径 | 路线图、跨课题计划、父级范围变化 | L2/L1 issue |
@@ -4,26 +4,12 @@

 | 版本 | 对应 commit id | 更新日期 | 变更说明 |
 | --- | --- | --- | --- |
-| v0.8 | 待提交 | 2026-06-14 | 引用 ISO/IEC/IEEE 29148 需求规格模板。 |
-| v0.7 | 待提交 | 2026-06-14 | 合并内部模块分工与规格索引，拆分全局原子需求并移除重复追踪章节。 |
-| v0.6 | 待提交 | 2026-06-14 | 删除当前中心拆分文档，阶段中心口径统一回阶段规格。 |
-| v0.5 | 待提交 | 2026-06-14 | 移除规格正文中的跨 issue 引用，跨规格关系改用相对路径链接。 |
 | v0.4 | b5d8cee438a3bd66ca440a25bf5a16d9081d9efa | 2026-06-14 | 将 issue/PR 引用显示改为短号 Markdown 链接，链接目标保留完整 URL。 |
 | v0.3 | b0cbe9b721b50e9fff4d350ee50ed2af03cf0405 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
 | v0.2 | b40a37ce771811cc97d74ef0909a7ce441161c6b | 2026-06-14 | 移除项目管理目录中的 evidence 文件，长证据保留在 GitHub issue。 |
-| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从原迁移 issue 迁移到 UniDesk 项目管理目录。 |
+| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从迁移来源 pikasTech/HWLAB#1194 迁移到 UniDesk 项目管理目录。 |

-## 迁移来源
-
-| 字段 | 内容 |
-| --- | --- |
-| 原 issue | [#1194](https://github.com/pikasTech/HWLAB/issues/1194) |
-| 原标题 | PJ2026-01 HWLAB 总规格 |
-| 原状态 | open |
-| 原更新时间 | 2026-06-14T12:53:55Z |
-| 原 body SHA | 4868729f6e33eec813713e810700b510847164d799373edf01c8ff50126a04b6 |
-
-长证据不进入项目管理目录。硬件池和 Agent编排 的长证据保留在各自的 GitHub 证据 issue；规格文件只描述证据归属，不复制证据正文，也不链接其他规格的 issue。
+当前正文仍在规格治理草稿中；未定稿前不新增版本号，不为单次编辑追加 `待提交` 版本。

 ## 正文

@@ -36,15 +22,11 @@
 | 编号 | PJ2026-01 |
 | 短名 | HWLAB |
 | 层级 | L0 总项目 |
-| 状态 | active / L0 需求规格锚点 |
-| 长期面板 | HWLAB 长期总面板，仅作为 GitHub 导航面板，不作为规格正文来源 |
+| 状态 | 已生效 |
 | 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) |
-| 阶段规格 | [HWLAB Cloud SPEC / 云平台开发目标 20260601](stage-cloud-spec-20260601.md) |
 | 规格治理索引 | [规格治理](spec-governance.md) |
-| L1 划分 | 保持现有六方向：[硬件池](PJ2026-0101-hardware-pool.md)、[Agent编排](PJ2026-0102-agent-orchestration.md)、[HarnessRL](PJ2026-0103-harness-rl.md)、[客户端](PJ2026-0104-client.md)、[用户管理](PJ2026-0105-user-management.md)、[平台运维](PJ2026-0106-platform-ops.md) |
-| 规格来源 | `project-management/PJ2026-01` 与迁移前 HWLabOA 阶段材料 |

-本文采用 [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) 的 HWLAB 裁剪版：正文只保留稳定使命、范围、运行概念、系统边界、内部模块分工和全局原子需求。编号规则、层级职责、回写、偏离判定和交叉引用治理迁入 [规格治理](spec-governance.md)；阶段目标和阶段优先级由 [HWLAB Cloud SPEC](stage-cloud-spec-20260601.md) 承载。
+本文采用 [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) 的 HWLAB 裁剪版：正文只保留稳定使命、范围、术语、系统边界、内部模块分工和全局原子需求。

 ## 2. 目的和范围

@@ -59,7 +41,7 @@ HWLAB 的中心目标是把真实硬件资源、Agent 执行、Harness/RL 验收
 - Harness/RL 验收闭环：harness、CaseRun、ioProbe、evidence、评估、回放、训练反馈和 RL 闭环。
 - 用户入口：Web、CLI、HTTP API、SDK/IDE 插件、webhook、公开文档、兼容性、任务入口和结果获取。
 - 用户与运营管理：用户、注册登录、权限、API key、credit、usage、billing、admin 和租户隔离。
- 平台交付与运维：CI/CD、git mirror、YAML-first、Secret 下发、rollout、observability、GC 和平台发布。
+- 系统可用性与服务保障：入口可访问、任务可恢复、资源使用可控、运行状态可观察和故障可处理。

 ### 2.3 范围外

@@ -67,30 +49,37 @@ HWLAB 的中心目标是把真实硬件资源、Agent 执行、Harness/RL 验收
 - 单个 PR、一次 CaseRun、一次 smoke、一次部署或阶段报告流水；这些属于 L3/L4 或报告，不属于 L0 需求规格正文。
 - 具体实现设计、代码结构、临时运行面调试路径、原始日志堆叠和每日进展统计。
 - 编号、回写、偏离和管理流程全文；这些由 [规格治理](spec-governance.md) 承载。
- 当前阶段优先级和阶段主线全文；这些由 [HWLAB Cloud SPEC](stage-cloud-spec-20260601.md) 承载。
+- 当前阶段优先级和阶段主线全文；这些属于阶段计划，不属于 L0 需求规格正文。

-## 3. 运行概念
+## 3. 术语表

-1. 用户、外部系统或训练任务通过 Web、CLI、API、SDK 或 Webhook 发起硬件研发任务。
-2. 用户管理完成身份、权限、API key、额度和资源消费约束。
-3. Agent编排把任务装配到受控 workspace/session/provider/runtime 中，并连接所需硬件资源。
-4. 硬件池通过 HWPOD 标准、工具、服务和 AI 网关触达真实设备，返回原始硬件事实和错误语义。
-5. HarnessRL 使用 CaseRun、ioProbe、evidence、评估、回放和训练反馈把执行结果转化为可审计、可复验、可改进的闭环。
-6. 客户端把任务状态、结果、硬件资源、evidence、usage 和 admin 能力以一致的用户入口暴露。
-7. 平台运维保证代码、配置、密钥、发布、运行观测和资源清理可控、可追踪、可恢复。
+| 术语 | 定义 |
+| --- | --- |
+| HWLAB | 面向真实硬件研发的云端平台，覆盖硬件资源、Agent 执行、Harness/RL 验收、客户端入口、用户运营和平台运维。 |
+| HWPOD | 对真实硬件研发资源的标准化抽象，至少关联目标设备、workspace、debug probe 和 io probe，并提供可被服务端和工具引用的资源身份。 |
+| 硬件池 | 管理真实硬件资源身份、能力声明、占用释放、健康状态和原始硬件事实的内部模块。 |
+| Agent编排 | 管理 Code Agent、AgentRun、workspace、session、provider profile、任务生命周期和任务恢复的内部模块。 |
+| HarnessRL | 将硬件执行结果转化为 evidence、aggregate、评估、回放和训练反馈的内部模块。 |
+| 客户端 | 面向用户或外部系统的 Web、CLI、HTTP API、SDK/IDE 插件、webhook 和公开文档入口。 |
+| 用户管理 | 管理用户身份、权限、API key、credit、usage、billing、admin 和租户隔离的内部模块。 |
+| 平台运维 | 管理 CI/CD、git mirror、YAML-first 配置、Secret 下发、rollout、observability、GC 和平台发布的内部模块。 |
+| evidence | 可审计、可复验的执行证据，包括硬件事实、执行 trace、ioProbe 数据、case registry、评估结果和必要日志摘要。 |
+| 原入口验收 | 通过用户真实使用入口或该能力的原始执行入口完成验收，例如 Web、CLI、API、CaseRun、AgentRun 或 HWPOD 工具。 |
+| 运行面 | 承载任务执行或服务运行的实际环境，例如目标 lane、namespace、workspace、node、pod 或外部硬件节点。 |

 ## 4. 系统边界和接口

-| 类别 | 内容 |
+本规格把 HWLAB 作为一个完整系统看待；本章只描述外部输入、外部输出和系统边界，不描述内部治理流程。
+
+| 边界项 | 内容 |
 | --- | --- |
-| 用户入口 | Web、CLI、HTTP API、SDK/IDE plugin、webhook |
-| 硬件入口 | HWPOD spec、hwpod 工具、HWPOD 服务、AI 网关、debug probe、UART、board-comm、ioProbe |
-| Agent 入口 | Code Agent、AgentRun、workspace、session、provider profile、resource bundle |
-| 验收入口 | CaseRun、Harness、ioProbe evidence、aggregate、replay、evaluation、training feedback |
-| 用户管理入口 | 注册登录、session、API key、permission、credit、usage、billing、admin、tenant isolation |
-| 运维入口 | CI/CD、git mirror、YAML-first config、Secret sync、rollout、observability、GC、public exposure |
-| 长期文档 | `project-management/PJ2026-01` 规格、实施方案、测试规格、阶段报告 |
-| 执行控制面 | HWLAB GitHub issue 树、PR、trace/session/job/run/case registry 证据 |
+| 外部使用者 | 硬件研发用户、训练任务、外部自动化系统、平台管理员。 |
+| 外部输入 | 硬件研发任务、源码或工程 workspace、目标设备或 HWPOD 选择、构建/下载/调试/采样指令、用户身份凭据、API key、额度和资源约束。 |
+| 受控资源 | 真实板卡、debug probe、io probe、HWPOD node、Agent 执行环境、provider profile、用户账号、额度和任务产物存储。 |
+| 外部输出 | 任务状态、执行结果、构建/下载/调试产物、硬件采样数据、evidence 摘要、失败诊断、usage/credit 记录、可复现结果包。 |
+| 用户接口 | Web、CLI、HTTP API、SDK/IDE 插件、webhook。 |
+| 硬件接口 | HWPOD spec、HWPOD 工具、HWPOD 服务、AI 网关、debug probe、UART、board-comm、ioProbe。 |
+| 系统边界 | HWLAB 负责把用户任务连接到受控 Agent 和真实硬件，并返回可理解、可审计、可复用的结果；不替代用户对硬件设计目标、工程代码正确性和业务取舍的判断。 |

 ## 5. 内部模块分工与规格索引

@@ -109,144 +98,72 @@ L1 划分保持现有六个内部能力模块；本章同时作为内部模块

 ### 6.1 HWLAB-L0-REQ-001 硬件资源池

-| 字段 | 内容 |
-| --- | --- |
-| ID | HWLAB-L0-REQ-001 |
-| 需求 | HWLAB 应提供真实硬件资源池，使任务能发现、分配、占用、释放并验证真实设备、probe、HWPOD node 和健康状态。 |
-| 类型 | 功能 |
-| 主责模块 | [硬件池](PJ2026-0101-hardware-pool.md) |
-| 职责划分 | 硬件池负责设备身份、能力声明、占用释放、健康和原始硬件事实；平台运维提供运行与发布支撑；Agent编排、HarnessRL 和客户端消费硬件池输出。 |
-| 验证方法 | 测试、演示 |
-| 验证入口 | HWPOD 工具、HWPOD 服务、AI 网关、CaseRun |
-| 必需证据 | hwpod-id、spec、node health、probe、lease、raw hardware evidence |
-| 接受标准 | 真实设备可被发现、绑定、执行、释放和审计。 |
+| 编号 | 需求 | 主责模块 | 职责划分 |
+| --- | --- | --- | --- |
+| HWLAB-L0-REQ-001 | HWLAB 应提供真实硬件资源池，使任务能发现、分配、占用、释放并验证真实设备、probe、HWPOD node 和健康状态。 | [PJ2026-0101 硬件池](PJ2026-0101-hardware-pool.md) | 硬件池负责设备身份、能力声明、占用释放、健康和原始硬件事实；平台运维提供运行与发布支撑；Agent编排、HarnessRL 和客户端消费硬件池输出。 |

-硬件资源池是 HWLAB 的物理事实源。该能力必须把板卡、probe、HWPOD node 和设备健康状态整理为稳定、可引用、可审计的资源模型，并确保上层任务拿到的是可执行的真实硬件，而不是临时脚本输出或不可复验的运行副本。
+硬件资源池是 HWLAB 的物理事实源。它把板卡、probe、HWPOD node 和设备健康状态整理为稳定、可引用、可审计的资源模型，并确保上层任务拿到的是可执行的真实硬件，而不是临时脚本输出或不可复验的运行副本。

 ### 6.2 HWLAB-L0-REQ-002 Agent 执行编排

-| 字段 | 内容 |
-| --- | --- |
-| ID | HWLAB-L0-REQ-002 |
-| 需求 | HWLAB 应提供 Agent 执行编排，使用户任务能进入受控 workspace/session/provider/runtime，并能跟踪、恢复、取消和归档结果。 |
-| 类型 | 功能 |
-| 主责模块 | [Agent编排](PJ2026-0102-agent-orchestration.md) |
-| 职责划分 | Agent编排负责任务生命周期、workspace、session、provider profile、恢复和归档；硬件池提供可执行资源；用户管理提供身份与权限；平台运维提供运行支撑。 |
-| 验证方法 | 测试、演示 |
-| 验证入口 | Web/CLI/API 提交 Agent 任务、AgentRun trace/result |
-| 必需证据 | runId、sessionId、workspace、provider profile、trace、artifact/result pointer |
-| 接受标准 | 任务生命周期可跟踪，异常可恢复或明确失败。 |
+| 编号 | 需求 | 主责模块 | 职责划分 |
+| --- | --- | --- | --- |
+| HWLAB-L0-REQ-002 | HWLAB 应提供 Agent 执行编排，使用户任务能进入受控 workspace/session/provider/runtime，并能跟踪、恢复、取消和归档结果。 | [PJ2026-0102 Agent编排](PJ2026-0102-agent-orchestration.md) | Agent编排负责任务生命周期、workspace、session、provider profile、恢复和归档；硬件池提供可执行资源；用户管理提供身份与权限；平台运维提供运行支撑。 |

 Agent 执行编排负责把用户意图转化为可追踪的受控执行。它必须明确任务状态、运行上下文、执行凭据、结果位置和异常收口，避免用户任务只存在于一次性进程、临时容器或无法恢复的日志片段中。

 ### 6.3 HWLAB-L0-REQ-003 HarnessRL 验收闭环

-| 字段 | 内容 |
-| --- | --- |
-| ID | HWLAB-L0-REQ-003 |
-| 需求 | HWLAB 应提供 Harness/RL 验收闭环，使真实硬件任务产出可审计 evidence、aggregate、评估、回放和训练反馈。 |
-| 类型 | 功能 |
-| 主责模块 | [HarnessRL](PJ2026-0103-harness-rl.md) |
-| 职责划分 | HarnessRL 负责 evidence、aggregate、评估、回放和训练反馈；硬件池提供原始硬件事实；Agent编排提供执行上下文；平台运维提供可观测和归档支撑。 |
-| 验证方法 | 测试、检查 |
-| 验证入口 | CaseRun、Harness、ioProbe、replay |
-| 必需证据 | caseId、runId、traceId、aggregate、ioProbe samples/stats、evaluation/replay 输出 |
-| 接受标准 | evidence 可审计、可复验、可用于训练反馈。 |
+| 编号 | 需求 | 主责模块 | 职责划分 |
+| --- | --- | --- | --- |
+| HWLAB-L0-REQ-003 | HWLAB 应提供 Harness/RL 验收闭环，使真实硬件任务产出可审计 evidence、aggregate、评估、回放和训练反馈。 | [PJ2026-0103 HarnessRL](PJ2026-0103-harness-rl.md) | HarnessRL 负责 evidence、aggregate、评估、回放和训练反馈；硬件池提供原始硬件事实；Agent编排提供执行上下文；平台运维提供可观测和归档支撑。 |

 HarnessRL 把一次硬件执行转化为可复验的验证与训练材料。它不得只记录 pass/fail，而要保留可解释的硬件输入、执行过程、采样数据、评估结论和回放入口，使失败分类和成功路径能够进入后续改进闭环。

 ### 6.4 HWLAB-L0-REQ-004 统一客户端入口

-| 字段 | 内容 |
-| --- | --- |
-| ID | HWLAB-L0-REQ-004 |
-| 需求 | HWLAB 应提供统一客户端入口，使 Web、CLI、API、SDK/IDE plugin 和 Webhook 围绕同一任务模型、权限模型和结果模型协同演进。 |
-| 类型 | 功能 |
-| 主责模块 | [客户端](PJ2026-0104-client.md) |
-| 职责划分 | 客户端负责 Web、CLI、HTTP API、SDK/IDE 插件、webhook 和公开文档的一致入口；用户管理提供身份权限；Agent编排、硬件池、HarnessRL 和平台运维提供后端能力。 |
-| 验证方法 | 测试、演示 |
-| 验证入口 | Cloud Web、hwlab-cli、HTTP API、SDK/Webhook sample |
-| 必需证据 | Web smoke、CLI smoke、API response、SDK/Webhook 示例 |
-| 接受标准 | 多客户端行为和错误语义一致。 |
+| 编号 | 需求 | 主责模块 | 职责划分 |
+| --- | --- | --- | --- |
+| HWLAB-L0-REQ-004 | HWLAB 应提供统一客户端入口，使 Web、CLI、API、SDK/IDE plugin 和 Webhook 围绕同一任务模型、权限模型和结果模型协同演进。 | [PJ2026-0104 客户端](PJ2026-0104-client.md) | 客户端负责 Web、CLI、HTTP API、SDK/IDE 插件、webhook 和公开文档的一致入口；用户管理提供身份权限；Agent编排、硬件池、HarnessRL 和平台运维提供后端能力。 |

 统一客户端入口要求不同用户界面共享同一任务、权限、错误和结果语义。Web、CLI、API 和 SDK 可以有不同交互形态，但不能各自定义一套状态机、错误口径或结果读取路径。

 ### 6.5 HWLAB-L0-REQ-005 用户与运营管理

-| 字段 | 内容 |
-| --- | --- |
-| ID | HWLAB-L0-REQ-005 |
-| 需求 | HWLAB 应提供多用户与运营管理，使身份、权限、API key、credit、usage、billing、admin 和租户隔离具有统一真相。 |
-| 类型 | 功能 |
-| 主责模块 | [用户管理](PJ2026-0105-user-management.md) |
-| 职责划分 | 用户管理负责身份、权限、API key、credit、usage、billing、admin 和租户隔离；客户端负责呈现入口；Agent编排、硬件池和 HarnessRL 消费用户与额度约束。 |
-| 验证方法 | 测试、检查 |
-| 验证入口 | user-billing、auth、API key、usage、admin API |
-| 必需证据 | session、API key 摘要、preflight、usage record、credit ledger、admin 操作记录 |
-| 接受标准 | 用户和运营真相统一且可审计。 |
+| 编号 | 需求 | 主责模块 | 职责划分 |
+| --- | --- | --- | --- |
+| HWLAB-L0-REQ-005 | HWLAB 应提供多用户与运营管理，使身份、权限、API key、credit、usage、billing、admin 和租户隔离具有统一真相。 | [PJ2026-0105 用户管理](PJ2026-0105-user-management.md) | 用户管理负责身份、权限、API key、credit、usage、billing、admin 和租户隔离；客户端负责呈现入口；Agent编排、硬件池和 HarnessRL 消费用户与额度约束。 |

 用户与运营管理定义平台多用户运行的业务事实。它必须保证用户身份、权限、额度、计量、账务和管理操作可以被统一查询和审计，避免同一用户或同一资源消费在不同入口出现不同真相。

-### 6.6 HWLAB-L0-REQ-006 平台交付与运维
+### 6.6 HWLAB-L0-REQ-006 系统可用性与服务保障

-| 字段 | 内容 |
-| --- | --- |
-| ID | HWLAB-L0-REQ-006 |
-| 需求 | HWLAB 应提供平台交付与运维能力，使代码、配置、密钥、发布、入口、观测和清理通过受控入口维护。 |
-| 类型 | 支撑 |
-| 主责模块 | [平台运维](PJ2026-0106-platform-ops.md) |
-| 职责划分 | 平台运维负责 CI/CD、git mirror、YAML-first、Secret 下发、rollout、observability、GC 和平台发布；其他模块提供发布、配置和观测需求。 |
-| 验证方法 | 检查、演示 |
-| 验证入口 | CI/CD、git mirror、YAML render、Secret sync、rollout、observability、GC |
-| 必需证据 | PipelineRun、source commit、render、fingerprint、public health、logs/trace、GC summary |
-| 接受标准 | 平台发布和运行状态可控、可见、可恢复。 |
+| 编号 | 需求 | 主责模块 | 职责划分 |
+| --- | --- | --- | --- |
+| HWLAB-L0-REQ-006 | HWLAB 应作为云端服务保持可访问、可恢复、资源使用可控，使用户能够稳定提交任务、查看状态和获取结果。 | [PJ2026-0106 平台运维](PJ2026-0106-platform-ops.md) | 平台运维作为后勤模块负责发布、配置、密钥、观测、资源清理和故障恢复支撑；客户端、Agent编排、硬件池、HarnessRL 和用户管理提供各自服务健康和资源需求。 |

-平台交付与运维是所有内部模块持续运行的基础能力。它必须让源码、配置、密钥、部署、公开入口、运行观测和资源清理都有受控入口和可追踪证据，不能依赖手工热修、运行面反推或不可复现的命令序列。
+系统可用性与服务保障不是 HWLAB 对外出售的功能模块，而是用户能够持续使用 HWLAB 的基础条件。用户感知到的是入口可访问、任务不中途丢失、故障后有恢复路径、资源不会被失控占用；平台运维只作为后勤职责支撑这些对外结果。

-### 6.7 HWLAB-L0-REQ-007 用户可见能力关闭验收
+### 6.7 HWLAB-L0-REQ-007 任务状态与结果获取

-| 字段 | 内容 |
-| --- | --- |
-| ID | HWLAB-L0-REQ-007 |
-| 需求 | HWLAB 的用户可见能力关闭前必须经过真实入口验收；源码检查、PR 合并或构建通过不能单独作为关闭依据。 |
-| 类型 | 约束 |
-| 主责模块 | 全部内部模块 |
-| 职责划分 | 定义完成标准的主责模块负责原入口验收；关联模块提供必要上下游证据；执行 issue 负责记录命令、目标 lane/node 和结果摘要。 |
-| 验证方法 | 检查 |
-| 验证入口 | L1/L2/L3/L4 收口评论 |
-| 必需证据 | 原入口命令、lane/node、trace/session/job/run/URL、结果摘要 |
-| 接受标准 | 关闭证据来自真实入口。 |
+| 编号 | 需求 | 主责模块 | 职责划分 |
+| --- | --- | --- | --- |
+| HWLAB-L0-REQ-007 | HWLAB 应向用户提供任务全生命周期状态和结果获取能力，使用户能查询任务进展、当前阻塞、最终产物、关键 evidence 摘要和结果位置。 | [PJ2026-0104 客户端](PJ2026-0104-client.md) | 客户端负责统一呈现和查询入口；Agent编排提供任务状态、执行上下文和结果指针；HarnessRL 提供 evidence 摘要；用户管理保证用户只能读取有权限的任务与结果。 |

-用户可见能力必须以用户真实入口或原始验收入口为关闭依据。代码层证据可以作为辅助材料，但不能替代 Web、CLI、API、CaseRun、AgentRun 或运行面入口的实际结果。
+该需求面向用户对“任务现在到哪里了、产物在哪里、失败卡在哪一步”的基本可见性。不同入口可以有不同呈现方式，但必须围绕同一任务状态和结果模型，避免 Web、CLI、API 看到互相矛盾的进度或结果。

-### 6.8 HWLAB-L0-REQ-008 单一主责 L1
+### 6.8 HWLAB-L0-REQ-008 失败诊断与恢复建议

-| 字段 | 内容 |
-| --- | --- |
-| ID | HWLAB-L0-REQ-008 |
-| 需求 | HWLAB 的下级工作必须且只能有一个主责 L1；跨方向支撑通过关联方向和回写表达，不重复建树。 |
-| 类型 | 约束 |
-| 主责模块 | 全部内部模块 |
-| 职责划分 | 下级工作由定义完成标准的模块承担主责；其他模块只作为关联方向、上游依赖、下游支撑或回写对象出现。 |
-| 验证方法 | 检查 |
-| 验证入口 | issue 正文和回写评论 |
-| 必需证据 | 主责方向、关联方向、回写对象 |
-| 接受标准 | 每个非平凡工作只有一个主责 L1。 |
+| 编号 | 需求 | 主责模块 | 职责划分 |
+| --- | --- | --- | --- |
+| HWLAB-L0-REQ-008 | HWLAB 应把 Agent 执行、硬件操作、权限额度和平台运行中的失败转化为用户可理解的错误分类、上下文和恢复建议。 | [PJ2026-0102 Agent编排](PJ2026-0102-agent-orchestration.md) | Agent编排负责把执行失败归入任务生命周期；硬件池提供设备、probe 和 HWPOD 错误语义；HarnessRL 提供 evidence 与评估上下文；客户端负责向用户展示可操作的下一步；平台运维提供平台故障状态。 |

-单一主责规则用于防止同一工作在多个方向重复建树。跨模块协作通过依赖、支撑和回写表达，但验收标准和关闭责任只能落到一个主责模块。
+该需求要求失败信息从“底层日志碎片”提升为用户能处理的问题描述。系统应区分权限不足、额度不足、硬件不可用、probe 不匹配、构建失败、下载失败、Agent 执行失败和平台不可用等类别，并给出可执行的下一步处理方向。

-### 6.9 HWLAB-L0-REQ-009 长期规格沉淀
+### 6.9 HWLAB-L0-REQ-009 结果包与复现线索

-| 字段 | 内容 |
-| --- | --- |
-| ID | HWLAB-L0-REQ-009 |
-| 需求 | HWLAB 的稳定需求、验证标准和长期结论应沉淀到 `project-management/PJ2026-01` 的对应规格文件；阶段报告和执行流水不得替代规格。 |
-| 类型 | 约束 |
-| 主责模块 | 全部内部模块 |
-| 职责划分 | L0 负责总使命、范围和全局约束；L1 负责对应模块的稳定需求和验收边界；L2/L3/L4 issue 保留执行状态、讨论、证据链接和关闭回写。 |
-| 验证方法 | 检查 |
-| 验证入口 | 项目管理规格文件、历史 issue、阶段报告链接 |
-| 必需证据 | 长期规格链接、报告链接、issue 引用 |
-| 接受标准 | 稳定需求不只存在于评论或日报中。 |
+| 编号 | 需求 | 主责模块 | 职责划分 |
+| --- | --- | --- | --- |
+| HWLAB-L0-REQ-009 | HWLAB 应为完成的硬件研发任务提供可获取、可引用的结果包，使用户能获得产物、关键 evidence、环境摘要、资源摘要和复现线索。 | [PJ2026-0103 HarnessRL](PJ2026-0103-harness-rl.md) | HarnessRL 负责整理 evidence、评估结果和复现线索；Agent编排提供 workspace、session 和执行上下文；硬件池提供设备和 HWPOD 资源摘要；客户端负责结果包获取入口。 |

-长期规格沉淀要求把稳定要求、验收标准和可复用结论写回项目管理规格文件。阶段报告只描述阶段移动，GitHub issue 只承担执行控制面和证据锚点，不能成为长期规格正文的唯一来源。
+结果包是用户离开一次在线任务后仍能理解、复查和继续工作的交付物。它不要求完整复制所有运行日志，但必须保留足以解释结果、定位关键环境和支撑后续复现的摘要信息。
@@ -6,18 +6,7 @@
 | --- | --- | --- | --- |
 | v0.3 | b5d8cee438a3bd66ca440a25bf5a16d9081d9efa | 2026-06-14 | 将 issue/PR 引用显示改为短号 Markdown 链接，链接目标保留完整 URL。 |
 | v0.2 | b0cbe9b721b50e9fff4d350ee50ed2af03cf0405 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
-| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 [#1203](https://github.com/pikasTech/HWLAB/issues/1203) 迁移到 UniDesk 项目管理目录。 |
-
-## 迁移来源
-
-| 字段 | 内容 |
-| --- | --- |
-| 原 issue | [#1203](https://github.com/pikasTech/HWLAB/issues/1203) |
-| 原标题 | PJ2026-0101 硬件池 |
-| 原 URL | [#1203](https://github.com/pikasTech/HWLAB/issues/1203) |
-| 原状态 | open |
-| 原更新时间 | 2026-06-14T12:46:46Z |
-| 原 body SHA | dd5222a909f7259076124d89fcc532fb8a00c0014e9120a65d023cb768857cf4 |
+| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从迁移来源 pikasTech/HWLAB#1203 迁移到 UniDesk 项目管理目录。 |

 ## 正文

@@ -30,14 +19,14 @@
 | 编号 | PJ2026-0101 |
 | 短名 | 硬件池 |
 | 层级 | L1 方向 |
-| 上级总项目 | [#1194](https://github.com/pikasTech/HWLAB/issues/1194) PJ2026-01 HWLAB 总规格 |
-| 关联方向 | [#1204](https://github.com/pikasTech/HWLAB/issues/1204) Agent编排、[#1205](https://github.com/pikasTech/HWLAB/issues/1205) HarnessRL、[#1206](https://github.com/pikasTech/HWLAB/issues/1206) 客户端、[#1208](https://github.com/pikasTech/HWLAB/issues/1208) 平台运维 |
-| 证据索引 | [#1216](https://github.com/pikasTech/HWLAB/issues/1216) 硬件池证据索引：HWPOD 与 CaseRun 基线归档 |
-| 规格状态 | active / issue 规格锚点 |
+| 上级总项目 | [PJ2026-01 HWLAB 总规格](PJ2026-01-HWLAB.md) |
+| 关联方向 | [Agent编排](PJ2026-0102-agent-orchestration.md)、[HarnessRL](PJ2026-0103-harness-rl.md)、[客户端](PJ2026-0104-client.md)、[平台运维](PJ2026-0106-platform-ops.md) |
+| 证据索引 | 长证据保留在硬件池证据 issue；本文档只保留规格要求和证据归属 |
+| 规格状态 | 已生效 |
 | 核对时间 | 2026-06-14 北京时间 |
 | 主要运行面 | HWLAB v0.2，G14 runtime，D601/外部硬件节点 |

-本文采用中文 L1 需求规格模板：正文只保留稳定需求、边界、原定 L2 分配、验证矩阵和追踪关系；CaseRun 流水、阶段报告、具体 bug 排查和单次证据不在本文展开，长证据统一迁入 [#1216](https://github.com/pikasTech/HWLAB/issues/1216) 或下级 L2/L3 issue。
+本文采用中文 L1 需求规格模板：正文只保留稳定需求、边界、原定 L2 分配、验证矩阵和追踪关系；CaseRun 流水、阶段报告、具体 bug 排查和单次证据不在本文展开，长证据统一迁入硬件池证据 issue 或下级 L2/L3 issue。

 ## 2. 目的和范围

@@ -54,11 +43,11 @@

 ### 2.3 范围外

- Agent 任务生命周期、session/resume、provider profile 和调度策略，归 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)。
- CaseRun pass/fail、aggregate、评估、回放和训练反馈，归 [#1205](https://github.com/pikasTech/HWLAB/issues/1205)。
- Web/CLI/API/SDK 的通用用户入口体验和展示契约，归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)。
- 用户账号、API key、credit、usage、billing 和租户策略，归 [#1207](https://github.com/pikasTech/HWLAB/issues/1207)。
- CI/CD、GitOps、Secret、public exposure 和 runtime 运维发布，归 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
+- Agent 任务生命周期、session/resume、provider profile 和调度策略，归 [Agent编排](PJ2026-0102-agent-orchestration.md)。
+- CaseRun pass/fail、aggregate、评估、回放和训练反馈，归 [HarnessRL](PJ2026-0103-harness-rl.md)。
+- Web/CLI/API/SDK 的通用用户入口体验和展示契约，归 [客户端](PJ2026-0104-client.md)。
+- 用户账号、API key、credit、usage、billing 和租户策略，归 [用户管理](PJ2026-0105-user-management.md)。
+- CI/CD、GitOps、Secret、public exposure 和 runtime 运维发布，归 [平台运维](PJ2026-0106-platform-ops.md)。

 ## 3. 运行概念

@@ -77,31 +66,31 @@
 | 输出 | 设备可用性、node health/inventory、resolved authority、operation result、raw evidence、占用/释放状态 |
 | 用户/Agent 入口 | `hwpod-ctl spec validate`、`hwpod inspect`、`hwpod build/download/uart/io-probe`、`hwlab-cli case run ...` |
 | 服务入口 | HWLAB runtime API、`/v1/hwpod-node-ops`、case registry |
-| 原始证据 | HWPOD spec、nodeId、probe UID、job id、return code、ioProbe samples/stats、traceId、runId、registry commit；长证据索引见 [#1216](https://github.com/pikasTech/HWLAB/issues/1216) |
+| 原始证据 | HWPOD spec、nodeId、probe UID、job id、return code、ioProbe samples/stats、traceId、runId、registry commit；长证据索引保留在硬件池证据 issue |

 ## 5. 原子需求

 | ID | 需求 | 类型 | 来源 | 分配 L2 | 验证方法 |
 | --- | --- | --- | --- | --- | --- |
-| HWPOD-L1-REQ-001 | 硬件池应定义 HWPOD-SPEC，用于描述硬件资源身份、能力模型、AI 网关接入、操作能力和状态/错误语义。 | 功能 | [#1194](https://github.com/pikasTech/HWLAB/issues/1194) / [#1203](https://github.com/pikasTech/HWLAB/issues/1203) | PJ2026-010101 HWPOD标准 | 检查 |
-| HWPOD-L1-REQ-002 | 硬件池应为每个可用硬件资源维护稳定的 `hwpod-id`、HWPOD spec 和 source-of-truth 路径。 | 功能 | [#1203](https://github.com/pikasTech/HWLAB/issues/1203) | PJ2026-010101 HWPOD标准 | 检查、测试 |
-| HWPOD-L1-REQ-003 | HWPOD 工具应支持 HWPOD-SPEC 新建、修改、校验、inspect，以及 compile、download、filesystem、UART、board-comm、ioProbe 等操作入口。 | 功能 | [#1203](https://github.com/pikasTech/HWLAB/issues/1203) | PJ2026-010102 HWPOD工具 | 测试 |
-| HWPOD-L1-REQ-004 | HWPOD 工具应优先使用 HWLAB runtime API authority，并在存在 override 时暴露来源，避免遗留环境变量误路由。 | 约束 | [#1091](https://github.com/pikasTech/HWLAB/issues/1091) | PJ2026-010102 HWPOD工具 | 测试、检查 |
-| HWPOD-L1-REQ-005 | HWPOD 服务应支持服务端资源注册、管理、状态查询、必要权限/租约、请求接收、路由和结果归档。 | 功能 | [#1203](https://github.com/pikasTech/HWLAB/issues/1203) | PJ2026-010103 HWPOD服务 | 测试、检查 |
-| HWPOD-L1-REQ-006 | 当存在并发或多用户使用时，HWPOD 服务应在执行前完成占用、冲突检测、租约释放和超时安全收口。 | 功能/安全 | [#1194](https://github.com/pikasTech/HWLAB/issues/1194) | PJ2026-010103 HWPOD服务 | 测试、演示 |
-| HWPOD-L1-REQ-007 | AI 网关应暴露节点心跳、健康、inventory、命令执行、日志/artifact/IO 回传和适配器执行能力。 | 功能 | [#1203](https://github.com/pikasTech/HWLAB/issues/1203) | PJ2026-010104 AI网关 | 演示、检查 |
-| HWPOD-L1-REQ-008 | 当 download/debug 请求包含 probe 约束时，AI 网关或其适配器应验证请求 probe 与项目绑定一致；不一致时不得返回成功。 | 功能/约束 | [#1092](https://github.com/pikasTech/HWLAB/issues/1092) | PJ2026-010104 AI网关 | 测试 |
-| HWPOD-L1-REQ-009 | 当采集板外状态时，AI 网关应区分板内 echo 和外部 ioProbe 读数，并记录单位、samples、stats 和 raw evidence。 | 功能 | [#1178](https://github.com/pikasTech/HWLAB/issues/1178) | PJ2026-010104 AI网关 | 测试 |
-| HWPOD-L1-REQ-010 | 硬件池应输出原始硬件事实和错误语义，但不得定义 HarnessRL pass/fail、训练奖励或业务评分。 | 边界 | [#1205](https://github.com/pikasTech/HWLAB/issues/1205) | 全部 L2 | 检查 |
+| HWPOD-L1-REQ-001 | 硬件池应定义 HWPOD-SPEC，用于描述硬件资源身份、能力模型、AI 网关接入、操作能力和状态/错误语义。 | 功能 | [L0 总规格](PJ2026-01-HWLAB.md) / 本规格 | PJ2026-010101 HWPOD标准 | 检查 |
+| HWPOD-L1-REQ-002 | 硬件池应为每个可用硬件资源维护稳定的 `hwpod-id`、HWPOD spec 和 source-of-truth 路径。 | 功能 | 本规格 | PJ2026-010101 HWPOD标准 | 检查、测试 |
+| HWPOD-L1-REQ-003 | HWPOD 工具应支持 HWPOD-SPEC 新建、修改、校验、inspect，以及 compile、download、filesystem、UART、board-comm、ioProbe 等操作入口。 | 功能 | 本规格 | PJ2026-010102 HWPOD工具 | 测试 |
+| HWPOD-L1-REQ-004 | HWPOD 工具应优先使用 HWLAB runtime API authority，并在存在 override 时暴露来源，避免遗留环境变量误路由。 | 约束 | 遗留 node ops URL 误路由风险 | PJ2026-010102 HWPOD工具 | 测试、检查 |
+| HWPOD-L1-REQ-005 | HWPOD 服务应支持服务端资源注册、管理、状态查询、必要权限/租约、请求接收、路由和结果归档。 | 功能 | 本规格 | PJ2026-010103 HWPOD服务 | 测试、检查 |
+| HWPOD-L1-REQ-006 | 当存在并发或多用户使用时，HWPOD 服务应在执行前完成占用、冲突检测、租约释放和超时安全收口。 | 功能/安全 | [L0 总规格](PJ2026-01-HWLAB.md) | PJ2026-010103 HWPOD服务 | 测试、演示 |
+| HWPOD-L1-REQ-007 | AI 网关应暴露节点心跳、健康、inventory、命令执行、日志/artifact/IO 回传和适配器执行能力。 | 功能 | 本规格 | PJ2026-010104 AI网关 | 演示、检查 |
+| HWPOD-L1-REQ-008 | 当 download/debug 请求包含 probe 约束时，AI 网关或其适配器应验证请求 probe 与项目绑定一致；不一致时不得返回成功。 | 功能/约束 | probe mismatch 误报成功风险 | PJ2026-010104 AI网关 | 测试 |
+| HWPOD-L1-REQ-009 | 当采集板外状态时，AI 网关应区分板内 echo 和外部 ioProbe 读数，并记录单位、samples、stats 和 raw evidence。 | 功能 | PLC 71-FREQ ioProbe 造模 | PJ2026-010104 AI网关 | 测试 |
+| HWPOD-L1-REQ-010 | 硬件池应输出原始硬件事实和错误语义，但不得定义 HarnessRL pass/fail、训练奖励或业务评分。 | 边界 | [HarnessRL](PJ2026-0103-harness-rl.md) | 全部 L2 | 检查 |

 ## 6. L2 分配

 | 编号 | 短名 | 主责 | 关联 L1 | 证据引用 | 边界 |
 | --- | --- | --- | --- | --- | --- |
-| PJ2026-010101 | HWPOD标准 | 定义 HWPOD-SPEC、硬件资源身份、能力模型、AI 网关接入标准、操作能力标准、状态/错误语义和验收基线。 | 客户端、HarnessRL、Agent编排 | [#1216](https://github.com/pikasTech/HWLAB/issues/1216) 中 D601-F103 compile-only、ConStart 71-FREQ build | 这是标准/协议型交付，不是单纯文档。它定义 HWPOD 资源和 AI 网关能力声明的正确性规则。 |
-| PJ2026-010102 | HWPOD工具 | 实现硬件池领域工具侧，包括 `hwpod-ctl`、HWPOD-SPEC 新建/修改/校验，以及 compile、download、filesystem、IO 等操作入口。 | 客户端 | [#1216](https://github.com/pikasTech/HWLAB/issues/1216) 中 HWPOD build/download/UART/ioProbe 原入口证据；[#1091](https://github.com/pikasTech/HWLAB/issues/1091) | 这不是通用客户端 L1。只要完成标准由 HWPOD 语义或真实硬件执行定义，就主归属硬件池。 |
-| PJ2026-010103 | HWPOD服务 | 实现服务端 HWPOD 注册、管理、状态、必要权限/租约、请求接收、路由、结果归档，并把工具侧请求转发到 AI 网关节点。 | 用户管理、Agent编排、平台运维 | [#1216](https://github.com/pikasTech/HWLAB/issues/1216) 全部 CaseRun registry 证据；[#1129](https://github.com/pikasTech/HWLAB/issues/1129)、[#1197](https://github.com/pikasTech/HWLAB/issues/1197) | 它负责 HWPOD 服务端语义，不负责全局部署机制、用户策略或 Agent 任务调度。 |
-| PJ2026-010104 | AI网关 | 实现连接真实硬件到服务端的节点侧能力，包括 PC 客户端形态、硬件网关盒子形态、心跳、命令执行、日志/artifact/IO 结果回传和适配器执行。 | HarnessRL、Agent编排、平台运维 | [#1216](https://github.com/pikasTech/HWLAB/issues/1216) 中 probe、UART、board-comm、ioProbe、电流回采、频率源扩展证据；[#1092](https://github.com/pikasTech/HWLAB/issues/1092)、[#1097](https://github.com/pikasTech/HWLAB/issues/1097)、[#1186](https://github.com/pikasTech/HWLAB/issues/1186) | debug probe、UART、board-comm、ioProbe、电压/电流/频率/CANopen 等适配器是网关侧能力切片，通常作为本 L2 下的 L3。 |
+| PJ2026-010101 | HWPOD标准 | 定义 HWPOD-SPEC、硬件资源身份、能力模型、AI 网关接入标准、操作能力标准、状态/错误语义和验收基线。 | 客户端、HarnessRL、Agent编排 | 硬件池证据 issue 中的 D601-F103 compile-only、ConStart 71-FREQ build | 这是标准/协议型交付，不是单纯文档。它定义 HWPOD 资源和 AI 网关能力声明的正确性规则。 |
+| PJ2026-010102 | HWPOD工具 | 实现硬件池领域工具侧，包括 `hwpod-ctl`、HWPOD-SPEC 新建/修改/校验，以及 compile、download、filesystem、IO 等操作入口。 | 客户端 | 硬件池证据 issue 中的 HWPOD build/download/UART/ioProbe 原入口证据；遗留 node ops URL 误路由风险 | 这不是通用客户端 L1。只要完成标准由 HWPOD 语义或真实硬件执行定义，就主归属硬件池。 |
+| PJ2026-010103 | HWPOD服务 | 实现服务端 HWPOD 注册、管理、状态、必要权限/租约、请求接收、路由、结果归档，并把工具侧请求转发到 AI 网关节点。 | 用户管理、Agent编排、平台运维 | 硬件池证据 issue 中的全部 CaseRun registry 证据；工具包同步差异和 timeout 状态不一致风险 | 它负责 HWPOD 服务端语义，不负责全局部署机制、用户策略或 Agent 任务调度。 |
+| PJ2026-010104 | AI网关 | 实现连接真实硬件到服务端的节点侧能力，包括 PC 客户端形态、硬件网关盒子形态、心跳、命令执行、日志/artifact/IO 结果回传和适配器执行。 | HarnessRL、Agent编排、平台运维 | 硬件池证据 issue 中的 probe、UART、board-comm、ioProbe、电流回采、频率源扩展证据；probe mismatch、D601 节点稳定性和频率源扩展风险 | debug probe、UART、board-comm、ioProbe、电压/电流/频率/CANopen 等适配器是网关侧能力切片，通常作为本 L2 下的 L3。 |

 ## 7. 吸收概念和归属规则

@@ -130,33 +119,32 @@

 ## 9. 开放风险和跟踪项

-| Issue | 归属 L2 | 风险 |
+| 主题 | 归属 L2 | 风险 |
 | --- | --- | --- |
-| [#1091](https://github.com/pikasTech/HWLAB/issues/1091) | PJ2026-010102 HWPOD工具 | 遗留 node ops URL 可能导致误路由。 |
-| [#1092](https://github.com/pikasTech/HWLAB/issues/1092) | PJ2026-010104 AI网关 | probe mismatch 可能被顶层误报成功。 |
-| [#1097](https://github.com/pikasTech/HWLAB/issues/1097) | PJ2026-010104 AI网关 | D601 hwpod-node 不稳定影响长任务。 |
-| [#1129](https://github.com/pikasTech/HWLAB/issues/1129) | PJ2026-010103 HWPOD服务 | CaseRun 与 Web runner 工具包可能不同步，涉及服务端/运行面工具分发。 |
-| [#1186](https://github.com/pikasTech/HWLAB/issues/1186) | PJ2026-010104 AI网关 | PLC 真实频率源端到端扩展未完成。 |
-| [#1196](https://github.com/pikasTech/HWLAB/issues/1196) | PJ2026-010103 HWPOD服务 | commandExecution trace 主阅读区仍有 wrapper JSON 噪声。 |
-| [#1197](https://github.com/pikasTech/HWLAB/issues/1197) | PJ2026-010103 HWPOD服务 | timeout 后 AgentRun/trace/rendered 状态不一致，影响服务端安全收口。 |
-| [#1200](https://github.com/pikasTech/HWLAB/issues/1200) | 关联 [#1205](https://github.com/pikasTech/HWLAB/issues/1205) HarnessRL | final response 截断问题不改变硬件事实，但影响结果阅读。 |
+| 遗留 node ops URL | PJ2026-010102 HWPOD工具 | 遗留 node ops URL 可能导致误路由。 |
+| probe mismatch | PJ2026-010104 AI网关 | probe mismatch 可能被顶层误报成功。 |
+| D601 hwpod-node 稳定性 | PJ2026-010104 AI网关 | D601 hwpod-node 不稳定影响长任务。 |
+| 工具包同步差异 | PJ2026-010103 HWPOD服务 | CaseRun 与 Web runner 工具包可能不同步，涉及服务端/运行面工具分发。 |
+| PLC 真实频率源 | PJ2026-010104 AI网关 | PLC 真实频率源端到端扩展未完成。 |
+| trace wrapper 噪声 | PJ2026-010103 HWPOD服务 | commandExecution trace 主阅读区仍有 wrapper JSON 噪声。 |
+| timeout 状态不一致 | PJ2026-010103 HWPOD服务 | timeout 后 AgentRun/trace/rendered 状态不一致，影响服务端安全收口。 |
+| final response 截断 | 关联 [HarnessRL](PJ2026-0103-harness-rl.md) | final response 截断问题不改变硬件事实，但影响结果阅读。 |

 ## 10. 追踪关系

 | 上级 | 本层需求 | 下级/关联 | 验证入口 |
 | --- | --- | --- | --- |
-| [#1194](https://github.com/pikasTech/HWLAB/issues/1194) 硬件真实可用 | HWPOD-L1-REQ-001/002 | PJ2026-010101 HWPOD标准 | spec validate、registry |
-| [#1194](https://github.com/pikasTech/HWLAB/issues/1194) 原入口可执行 | HWPOD-L1-REQ-003/004 | PJ2026-010102 HWPOD工具 | hwpod inspect/build/download/io-probe |
-| [#1204](https://github.com/pikasTech/HWLAB/issues/1204) Agent编排 | HWPOD-L1-REQ-005/006 | PJ2026-010103 HWPOD服务 | runtime API、case run result、trace |
-| [#1205](https://github.com/pikasTech/HWLAB/issues/1205) HarnessRL | HWPOD-L1-REQ-008/009/010 | PJ2026-010104 AI网关 | raw evidence、ioProbe、aggregate 链接 |
-| [#1206](https://github.com/pikasTech/HWLAB/issues/1206) 客户端 | HWPOD-L1-REQ-001/003 | HWPOD标准、HWPOD工具 | Web/CLI/API smoke |
-| [#1208](https://github.com/pikasTech/HWLAB/issues/1208) 平台运维 | HWPOD-L1-REQ-005/007 | HWPOD服务、AI网关 | status/logs/route diagnostics |
+| [L0 总规格](PJ2026-01-HWLAB.md) 硬件真实可用 | HWPOD-L1-REQ-001/002 | PJ2026-010101 HWPOD标准 | spec validate、registry |
+| [L0 总规格](PJ2026-01-HWLAB.md) 原入口可执行 | HWPOD-L1-REQ-003/004 | PJ2026-010102 HWPOD工具 | hwpod inspect/build/download/io-probe |
+| [Agent编排](PJ2026-0102-agent-orchestration.md) | HWPOD-L1-REQ-005/006 | PJ2026-010103 HWPOD服务 | runtime API、case run result、trace |
+| [HarnessRL](PJ2026-0103-harness-rl.md) | HWPOD-L1-REQ-008/009/010 | PJ2026-010104 AI网关 | raw evidence、ioProbe、aggregate 链接 |
+| [客户端](PJ2026-0104-client.md) | HWPOD-L1-REQ-001/003 | HWPOD标准、HWPOD工具 | Web/CLI/API smoke |
+| [平台运维](PJ2026-0106-platform-ops.md) | HWPOD-L1-REQ-005/007 | HWPOD服务、AI网关 | status/logs/route diagnostics |

 ## 11. 回写和变更规则

 - 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 runId、traceId、registry commit 或原入口命令。
- 新增长证据时写入 [#1216](https://github.com/pikasTech/HWLAB/issues/1216) 或对应 L2/L3 issue，本文档 只保留 L2 引用。
+- 新增长证据时写入硬件池证据 issue 或对应 L2/L3 issue，本文档只保留 L2 引用。
 - 稳定需求、原定 L2 分配、验收矩阵或边界变化时，更新本文档，并在必要时回写 L0 规格。
- 单次 CaseRun 日志、阶段报告、debug 过程和 PR 流水不得直接堆进本规格正文；应放在 [#1216](https://github.com/pikasTech/HWLAB/issues/1216)、对应 L2/L3 issue、case registry 或阶段报告中。
+- 单次 CaseRun 日志、阶段报告、debug 过程和 PR 流水不得直接堆进本规格正文；应放在硬件池证据 issue、对应 L2/L3 issue、case registry 或阶段报告中。
 - 若某项工作无法映射到本文档 的需求 ID 或原定 L2 编号，应先重新归类，不直接作为硬件池实现任务推进。
-
@@ -6,18 +6,7 @@
 | --- | --- | --- | --- |
 | v0.3 | b5d8cee438a3bd66ca440a25bf5a16d9081d9efa | 2026-06-14 | 将 issue/PR 引用显示改为短号 Markdown 链接，链接目标保留完整 URL。 |
 | v0.2 | b0cbe9b721b50e9fff4d350ee50ed2af03cf0405 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
-| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 [#1204](https://github.com/pikasTech/HWLAB/issues/1204) 迁移到 UniDesk 项目管理目录。 |
-
-## 迁移来源
-
-| 字段 | 内容 |
-| --- | --- |
-| 原 issue | [#1204](https://github.com/pikasTech/HWLAB/issues/1204) |
-| 原标题 | PJ2026-0102 Agent编排 |
-| 原 URL | [#1204](https://github.com/pikasTech/HWLAB/issues/1204) |
-| 原状态 | open |
-| 原更新时间 | 2026-06-14T13:44:34Z |
-| 原 body SHA | 36adff57afe181b8c0d8d4c666df11319922a2357d17de61075355bdea17f1d3 |
+| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从迁移来源 pikasTech/HWLAB#1204 迁移到 UniDesk 项目管理目录。 |

 ## 正文

@@ -30,16 +19,16 @@
 | 编号 | PJ2026-0102 |
 | 短名 | Agent编排 |
 | 层级 | L1 方向 |
-| 上级总项目 | [#1194](https://github.com/pikasTech/HWLAB/issues/1194) PJ2026-01 HWLAB 总规格 |
-| 关联方向 | [#1203](https://github.com/pikasTech/HWLAB/issues/1203) 硬件池、[#1205](https://github.com/pikasTech/HWLAB/issues/1205) HarnessRL、[#1206](https://github.com/pikasTech/HWLAB/issues/1206) 客户端、[#1207](https://github.com/pikasTech/HWLAB/issues/1207) 用户管理、[#1208](https://github.com/pikasTech/HWLAB/issues/1208) 平台运维 |
-| 证据索引 | [#1223](https://github.com/pikasTech/HWLAB/issues/1223) Agent编排证据索引：Code Agent 与 AgentRun 基线归档 |
-| 规格状态 | active / issue 规格锚点 |
+| 上级总项目 | [PJ2026-01 HWLAB 总规格](PJ2026-01-HWLAB.md) |
+| 关联方向 | [硬件池](PJ2026-0101-hardware-pool.md)、[HarnessRL](PJ2026-0103-harness-rl.md)、[客户端](PJ2026-0104-client.md)、[用户管理](PJ2026-0105-user-management.md)、[平台运维](PJ2026-0106-platform-ops.md) |
+| 证据索引 | 长证据保留在 Agent编排证据 issue；本文档只保留规格要求和证据归属 |
+| 规格状态 | 已生效 |
 | 核对时间 | 2026-06-14 北京时间 |
 | L2 调整口径 | 按用户最新要求收敛为任务生命周期、资源装配两个 active L2；不改变 HWLAB 六个 L1 方向 |
 | 主要运行面 | HWLAB v0.2/v0.3，AgentRun v0.1/v0.2，G14/D601 runtime lane |
 | 主要规格来源 | 迁移前 HWLabOA `SPEC-CLOUDE-M1.md`、AgentRun `docs/reference/spec-v01-*.md`、HWLAB/AgentRun issue 历史 |

-本文采用中文 L1 需求规格模板：正文只保留稳定目标、边界、L2 分配、原子需求、验证矩阵和追踪关系。AgentRun SPEC 摘要、历史 issue、单次 trace、PR/PipelineRun 和运行面长证据统一迁入 [#1223](https://github.com/pikasTech/HWLAB/issues/1223) 或对应下级 issue。
+本文采用中文 L1 需求规格模板：正文只保留稳定目标、边界、L2 分配、原子需求、验证矩阵和追踪关系。AgentRun SPEC 摘要、历史 issue、单次 trace、PR/PipelineRun 和运行面长证据统一迁入 Agent编排证据 issue 或对应下级 issue。

 ## 2. 目的和范围

@@ -58,11 +47,11 @@ Agent编排方向负责把用户、训练任务或系统任务从 HWLAB 入口

 ### 2.3 范围外

- 硬件 inventory、硬件资源状态、HWPOD 标准、HWPOD 服务端状态和 AI 网关能力定义归 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)。
- WebUI/CLI/API/SDK 的用户交互、页面布局、公开 API/SDK 兼容性、结果展示体验归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)。
- Harness pass/fail、CaseRun 评价、artifact 训练样本、RL 反馈和 evidence replay 归 [#1205](https://github.com/pikasTech/HWLAB/issues/1205)。
- 用户账户、权限、credit、usage、billing、admin 策略归 [#1207](https://github.com/pikasTech/HWLAB/issues/1207)。
- Git mirror、Secret sync、YAML/GitOps、rollout、namespace、平台数据库、日志/指标基础设施归 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
+- 硬件 inventory、硬件资源状态、HWPOD 标准、HWPOD 服务端状态和 AI 网关能力定义归 [硬件池](PJ2026-0101-hardware-pool.md)。
+- WebUI/CLI/API/SDK 的用户交互、页面布局、公开 API/SDK 兼容性、结果展示体验归 [客户端](PJ2026-0104-client.md)。
+- Harness pass/fail、CaseRun 评价、artifact 训练样本、RL 反馈和 evidence replay 归 [HarnessRL](PJ2026-0103-harness-rl.md)。
+- 用户账户、权限、credit、usage、billing、admin 策略归 [用户管理](PJ2026-0105-user-management.md)。
+- Git mirror、Secret sync、YAML/GitOps、rollout、namespace、平台数据库、日志/指标基础设施归 [平台运维](PJ2026-0106-platform-ops.md)。
 - 本方向不定义新的 AgentRun 产品路线；AgentRun 自身能力变更由 pikasTech/agentrun issue/PR 承载，本方向只定义 HWLAB 对 AgentRun 的使用合同和验收需求。

 ## 3. 运行概念
@@ -78,32 +67,32 @@ Agent编排方向负责把用户、训练任务或系统任务从 HWLAB 入口

 | 对象 | Authority | Agent编排职责 | 非主责交接 |
 | --- | --- | --- | --- |
-| 用户入口 | HWLAB 客户端/API | 接收并规范化 Agent 请求，返回 task/run/session/trace 指针 | UX、公开 API/SDK 体验归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206) |
-| 用户/账本 | HWLAB 用户管理 | 在提交前后消费 auth、quota、usage/billing 结果 | 策略、账本和 admin 归 [#1207](https://github.com/pikasTech/HWLAB/issues/1207) |
-| 硬件资源 | HWLAB 硬件池 | 引用 HWPOD hint/context 和分配结果 | inventory、租约、健康、状态归 [#1203](https://github.com/pikasTech/HWLAB/issues/1203) |
+| 用户入口 | HWLAB 客户端/API | 接收并规范化 Agent 请求，返回 task/run/session/trace 指针 | UX、公开 API/SDK 体验归 [客户端](PJ2026-0104-client.md) |
+| 用户/账本 | HWLAB 用户管理 | 在提交前后消费 auth、quota、usage/billing 结果 | 策略、账本和 admin 归 [用户管理](PJ2026-0105-user-management.md) |
+| 硬件资源 | HWLAB 硬件池 | 引用 HWPOD hint/context 和分配结果 | inventory、租约、健康、状态归 [硬件池](PJ2026-0101-hardware-pool.md) |
 | 执行事实 | AgentRun manager | 使用 run/command/runner-job/session/result/event 合同 | AgentRun 内部能力归 pikasTech/agentrun |
-| 资源装配 | HWLAB + AgentRun | 构造并证明 RuntimeAssembly、ResourceBundleRef、ProfileRef、SessionRef、workspace materialization | git mirror/Secret/GitOps 运维归 [#1208](https://github.com/pikasTech/HWLAB/issues/1208) |
-| 执行证据 | AgentRun events/result + HWLAB trace | 暴露生命周期状态、失败分类、结果指针和恢复建议 | Harness 评价归 [#1205](https://github.com/pikasTech/HWLAB/issues/1205)，展示归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206) |
+| 资源装配 | HWLAB + AgentRun | 构造并证明 RuntimeAssembly、ResourceBundleRef、ProfileRef、SessionRef、workspace materialization | git mirror/Secret/GitOps 运维归 [平台运维](PJ2026-0106-platform-ops.md) |
+| 执行证据 | AgentRun events/result + HWLAB trace | 暴露生命周期状态、失败分类、结果指针和恢复建议 | Harness 评价归 [HarnessRL](PJ2026-0103-harness-rl.md)，展示归 [客户端](PJ2026-0104-client.md) |

 ## 5. L2 课题分配

-本次按最新口径重划 [#1204](https://github.com/pikasTech/HWLAB/issues/1204) 的 L2：保留 HWLAB 六个 L1 方向不变；Agent编排下只保留两个 active L2，编号采用连续编号：PJ2026-010201 任务生命周期、PJ2026-010202 资源装配。
+本次按最新口径重划 Agent编排 的 L2：保留 HWLAB 六个 L1 方向不变；Agent编排下只保留两个 active L2，编号采用连续编号：PJ2026-010201 任务生命周期、PJ2026-010202 资源装配。

 ### 5.1 Active L2

 | 编号 | 短名 | 主责 | 关联 L1 | 边界 |
 | --- | --- | --- | --- | --- |
 | PJ2026-010201 | 任务生命周期 | 定义 submit、run、command、runner-job、queued/claimed/running/terminal、cancel、timeout、failureKind、liveness、recoveryActions、session continuation、session send、同 run 多 command 和结果指针。 | 客户端、HarnessRL、用户管理、平台运维 | 完成标准是 Agent 任务从提交到终态、恢复或安全失败的生命周期正确；不负责 Web 展示、Harness 评分、用户账本、硬件资源状态或平台发布。 |
-| PJ2026-010202 | 资源装配 | 定义 RuntimeAssembly、ResourceBundleRef/gitbundle、BackendImageRef、ProfileRef、SessionRef、promptRefs、requiredSkills、tools、workspaceFiles、provider profile、模型配置、SecretRef、source commit 和 workspace materialization。 | 硬件池、HarnessRL、客户端、用户管理、平台运维 | 完成标准是 runner 得到正确、可证明、可复现的执行输入；WebUI 工作区体验归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)，硬件资源状态归 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)，Secret/GitOps 运维归 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。 |
+| PJ2026-010202 | 资源装配 | 定义 RuntimeAssembly、ResourceBundleRef/gitbundle、BackendImageRef、ProfileRef、SessionRef、promptRefs、requiredSkills、tools、workspaceFiles、provider profile、模型配置、SecretRef、source commit 和 workspace materialization。 | 硬件池、HarnessRL、客户端、用户管理、平台运维 | 完成标准是 runner 得到正确、可证明、可复现的执行输入；WebUI 工作区体验归 [客户端](PJ2026-0104-client.md)，硬件资源状态归 [硬件池](PJ2026-0101-hardware-pool.md)，Secret/GitOps 运维归 [平台运维](PJ2026-0106-platform-ops.md)。 |

 ### 5.2 概念合并说明

 | 原切片 | 处理 | 理由 |
 | --- | --- | --- |
 | 会话恢复 | 并入 PJ2026-010201 任务生命周期 | 会话 continuation、resume、session send 和 runner replacement 是任务生命周期的一部分，不应单列。 |
-| 工作区 | 并入 PJ2026-010202 资源装配 | Agent workspace materialization 是资源装配输入证明；WebUI 工作区体验归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)，硬件/资源状态归 [#1203](https://github.com/pikasTech/HWLAB/issues/1203) 或 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。 |
+| 工作区 | 并入 PJ2026-010202 资源装配 | Agent workspace materialization 是资源装配输入证明；WebUI 工作区体验归 [客户端](PJ2026-0104-client.md)，硬件/资源状态归 [硬件池](PJ2026-0101-hardware-pool.md) 或 [平台运维](PJ2026-0106-platform-ops.md)。 |
 | 模型配置 | 并入 PJ2026-010202 资源装配 | provider profile、backendProfile、model、auth/config SecretRef 是 RuntimeAssembly/ProfileRef 装配项，不应单列。 |
-| 结果归档 | 删除 standalone L2 | Agent编排只负责生命周期内的 result/trace/artifact pointer；长期归档、评价和展示分别归 [#1205](https://github.com/pikasTech/HWLAB/issues/1205)、[#1206](https://github.com/pikasTech/HWLAB/issues/1206)、[#1208](https://github.com/pikasTech/HWLAB/issues/1208)。 |
+| 结果归档 | 删除 standalone L2 | Agent编排只负责生命周期内的 result/trace/artifact pointer；长期归档、评价和展示分别归 [HarnessRL](PJ2026-0103-harness-rl.md)、[客户端](PJ2026-0104-client.md)、[平台运维](PJ2026-0106-platform-ops.md)。 |

 ## 6. 原子需求

@@ -117,7 +106,7 @@ Agent编排方向负责把用户、训练任务或系统任务从 HWLAB 入口
 | AGENT-L1-REQ-006 | ResourceBundleRef 应能证明 repo/ref、requested commit、actual materialized commit、bundles、promptRefs、skills、tools 和 workspaceFiles 摘要。 | 功能/可追踪 | 资源装配 | 测试、检查 |
 | AGENT-L1-REQ-007 | Provider profile、模型选择和 backendProfile 应作为 ProfileRef/SecretRef 装配项管理，并能以 validate canary 证明可用；输出不得泄露 API key、auth.json、config.toml、token 或 DSN。 | 安全/功能 | 资源装配 | 测试、检查 |
 | AGENT-L1-REQ-008 | Agent 编排应输出可被 HWLAB 客户端和 HarnessRL 消费的生命周期证据指针，包括 runId、commandId、runnerJobId、sessionId、traceId、failureKind、lastSeq、result pointer 和 artifact/tool 摘要。 | 功能/证据 | 任务生命周期 | 测试、检查 |
-| AGENT-L1-REQ-009 | Agent 编排应保持与硬件池、HarnessRL、客户端、用户管理和平台运维的主责边界；跨方向证据必须引用对应 issue，不得在本方向重定义对方完成标准。 | 追踪/治理 | 全部 L2 | 检查 |
+| AGENT-L1-REQ-009 | Agent 编排应保持与硬件池、HarnessRL、客户端、用户管理和平台运维的主责边界；规格文件跨方向引用对应规格路径，执行 issue 跨方向引用对应 issue，不得在本方向重定义对方完成标准。 | 追踪/治理 | 全部 L2 | 检查 |
 | AGENT-L1-REQ-010 | Agent 编排相关运行面证据必须来自真实 HWLAB/AgentRun 原入口；mock、自测试、dry-run、source-only smoke 或只读日志解释不得作为用户可见能力关闭依据。 | 验收 | 全部 L2 | 检查、演示 |

 ## 7. 验证矩阵
@@ -139,33 +128,31 @@ Agent编排方向负责把用户、训练任务或系统任务从 HWLAB 入口

 | 来源 | 归属 | 风险 |
 | --- | --- | --- |
-| [#1173](https://github.com/pikasTech/HWLAB/issues/1173) | PJ2026-010202 资源装配 | v0.3 AgentRun v02 内建 provider profile 缺默认配置，需明确 YAML/SecretRef 预置或管理员首次写入策略。 |
-| [#1189](https://github.com/pikasTech/HWLAB/issues/1189) | PJ2026-010201 任务生命周期 | v0.3 trace 卡在 runner-job-created 且工具调用不可见，影响执行事实和生命周期证据可信度。 |
-| [#1146](https://github.com/pikasTech/HWLAB/issues/1146) | PJ2026-010201 / PJ2026-010202 | Code Agent 计费成功但 AgentRun FailedToOpenSocket，要求执行层失败与用户账本分离，并检查 provider/profile 装配。 |
-| [#1197](https://github.com/pikasTech/HWLAB/issues/1197) | PJ2026-010201 | CaseRun timeout 后 AgentRun claimed 与 trace raw/rendered 状态不一致，影响安全 cancel 和生命周期证据阅读。 |
-| [#1129](https://github.com/pikasTech/HWLAB/issues/1129) | PJ2026-010202 | Web v0.2 与 CaseRun 使用同类 gitbundle 但 live source commit 可能落后，需暴露 materialized commit 和刷新语义。 |
-| [#172](https://github.com/pikasTech/agentrun/issues/172) | PJ2026-010201 | runnerjob phase/pod identity 与 run events/liveness 可能不一致，需统一 describe run/session/runnerjob 语义。 |
-| [#179](https://github.com/pikasTech/agentrun/issues/179) | PJ2026-010202 / 平台运维 [#1208](https://github.com/pikasTech/HWLAB/issues/1208) | AgentRun v0.2 external DB/stateless 计划影响 D601 HWLAB v0.3 Agent 编排 durable state 和资源装配可复现性。 |
+| provider profile 默认配置 | PJ2026-010202 资源装配 | v0.3 AgentRun v02 内建 provider profile 缺默认配置，需明确 YAML/SecretRef 预置或管理员首次写入策略。 |
+| trace 卡在 runner-job-created | PJ2026-010201 任务生命周期 | v0.3 trace 卡在 runner-job-created 且工具调用不可见，影响执行事实和生命周期证据可信度。 |
+| 计费成功但执行失败 | PJ2026-010201 / PJ2026-010202 | Code Agent 计费成功但 AgentRun FailedToOpenSocket，要求执行层失败与用户账本分离，并检查 provider/profile 装配。 |
+| timeout 状态不一致 | PJ2026-010201 | CaseRun timeout 后 AgentRun claimed 与 trace raw/rendered 状态不一致，影响安全 cancel 和生命周期证据阅读。 |
+| source commit 漂移 | PJ2026-010202 | Web v0.2 与 CaseRun 使用同类 gitbundle 但 live source commit 可能落后，需暴露 materialized commit 和刷新语义。 |
+| AgentRun runnerjob 身份 | PJ2026-010201 | runnerjob phase/pod identity 与 run events/liveness 可能不一致，需统一 describe run/session/runnerjob 语义。 |
+| AgentRun external DB/stateless | PJ2026-010202 / [平台运维](PJ2026-0106-platform-ops.md) | AgentRun v0.2 external DB/stateless 计划影响 D601 HWLAB v0.3 Agent 编排 durable state 和资源装配可复现性。 |

 ## 9. 追踪关系

 | 上级 | 本层需求 | 下级/关联 | 验证入口 |
 | --- | --- | --- | --- |
-| [#1194](https://github.com/pikasTech/HWLAB/issues/1194) Agent 执行编排 | AGENT-L1-REQ-001/002/003/004/008 | PJ2026-010201 任务生命周期 | HWLAB agent chat、AgentRun run/command/runner-job、session send、trace/result |
-| [#1194](https://github.com/pikasTech/HWLAB/issues/1194) workspace/provider/runtime | AGENT-L1-REQ-005/006/007 | PJ2026-010202 资源装配 | RuntimeAssembly、resource materialization、provider validate |
-| [#1203](https://github.com/pikasTech/HWLAB/issues/1203) 硬件池 | AGENT-L1-REQ-006/009 | PJ2026-010202 资源装配 | HWPOD hint/context、硬件事实引用；硬件资源状态归 [#1203](https://github.com/pikasTech/HWLAB/issues/1203) |
-| [#1205](https://github.com/pikasTech/HWLAB/issues/1205) HarnessRL | AGENT-L1-REQ-008/009 | PJ2026-010201 任务生命周期 | trace/result/artifact pointer、toolCallSummary；pass/fail 归 [#1205](https://github.com/pikasTech/HWLAB/issues/1205) |
-| [#1206](https://github.com/pikasTech/HWLAB/issues/1206) 客户端 | AGENT-L1-REQ-001/004/008/009 | 任务生命周期、资源装配 | Web/CLI/API smoke、trace/result UI；WebUI 工作区体验归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206) |
-| [#1207](https://github.com/pikasTech/HWLAB/issues/1207) 用户管理 | AGENT-L1-REQ-003/007/009 | 任务生命周期、资源装配 | billing preflight/record、provider admin delegation |
-| [#1208](https://github.com/pikasTech/HWLAB/issues/1208) 平台运维 | AGENT-L1-REQ-005/006/007/010 | 资源装配 | lane/namespace/Secret/GitOps/runtime health |
-| [#1223](https://github.com/pikasTech/HWLAB/issues/1223) 证据索引 | 全部需求 | AgentRun SPEC 与历史 issue | 证据链接、开放风险、回写记录 |
+| [L0 总规格](PJ2026-01-HWLAB.md) Agent 执行编排 | AGENT-L1-REQ-001/002/003/004/008 | PJ2026-010201 任务生命周期 | HWLAB agent chat、AgentRun run/command/runner-job、session send、trace/result |
+| [L0 总规格](PJ2026-01-HWLAB.md) workspace/provider/runtime | AGENT-L1-REQ-005/006/007 | PJ2026-010202 资源装配 | RuntimeAssembly、resource materialization、provider validate |
+| [硬件池](PJ2026-0101-hardware-pool.md) | AGENT-L1-REQ-006/009 | PJ2026-010202 资源装配 | HWPOD hint/context、硬件事实引用；硬件资源状态归 [硬件池](PJ2026-0101-hardware-pool.md) |
+| [HarnessRL](PJ2026-0103-harness-rl.md) | AGENT-L1-REQ-008/009 | PJ2026-010201 任务生命周期 | trace/result/artifact pointer、toolCallSummary；pass/fail 归 [HarnessRL](PJ2026-0103-harness-rl.md) |
+| [客户端](PJ2026-0104-client.md) | AGENT-L1-REQ-001/004/008/009 | 任务生命周期、资源装配 | Web/CLI/API smoke、trace/result UI；WebUI 工作区体验归 [客户端](PJ2026-0104-client.md) |
+| [用户管理](PJ2026-0105-user-management.md) | AGENT-L1-REQ-003/007/009 | 任务生命周期、资源装配 | billing preflight/record、provider admin delegation |
+| [平台运维](PJ2026-0106-platform-ops.md) | AGENT-L1-REQ-005/006/007/010 | 资源装配 | lane/namespace/Secret/GitOps/runtime health |
+| Agent编排证据 issue | 全部需求 | AgentRun SPEC 与历史 issue | 证据链接、开放风险、回写记录 |

 ## 10. 回写和变更规则

 - 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 runId、commandId、runnerJobId、sessionId、traceId、result pointer、artifact pointer 或原入口命令。
- 新增长证据、AgentRun SPEC 摘要或历史 issue 证据时写入 [#1223](https://github.com/pikasTech/HWLAB/issues/1223)；本文档 只保留规格要求和证据索引引用。
+- 新增长证据、AgentRun SPEC 摘要或历史 issue 证据时写入 Agent编排证据 issue；本文档只保留规格要求和证据归属。
 - 稳定需求、L2 分配、验收矩阵或 authority 边界变化时，更新本文档，并在必要时回写 L0 规格。
- 单次 trace、PR 流水、PipelineRun、runtime debug、provider 事故和 CaseRun 日志不得直接堆入本规格正文；应放在 [#1223](https://github.com/pikasTech/HWLAB/issues/1223)、对应 L2/L3 issue、AgentRun issue 或阶段报告中。
+- 单次 trace、PR 流水、PipelineRun、runtime debug、provider 事故和 CaseRun 日志不得直接堆入本规格正文；应放在 Agent编排证据 issue、对应 L2/L3 issue、AgentRun issue 或阶段报告中。
 - 若某项工作无法映射到任务生命周期或资源装配，应先判断主责是否属于硬件池、HarnessRL、客户端、用户管理或平台运维，不直接作为 Agent编排实现任务推进。
-
-
@@ -6,25 +6,14 @@
 | --- | --- | --- | --- |
 | v0.3 | b5d8cee438a3bd66ca440a25bf5a16d9081d9efa | 2026-06-14 | 将 issue/PR 引用显示改为短号 Markdown 链接，链接目标保留完整 URL。 |
 | v0.2 | b0cbe9b721b50e9fff4d350ee50ed2af03cf0405 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
-| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 [#1205](https://github.com/pikasTech/HWLAB/issues/1205) 迁移到 UniDesk 项目管理目录。 |
-
-## 迁移来源
-
-| 字段 | 内容 |
-| --- | --- |
-| 原 issue | [#1205](https://github.com/pikasTech/HWLAB/issues/1205) |
-| 原标题 | PJ2026-0103 HarnessRL |
-| 原 URL | [#1205](https://github.com/pikasTech/HWLAB/issues/1205) |
-| 原状态 | open |
-| 原更新时间 | 2026-06-14T12:19:24Z |
-| 原 body SHA | 8b8fbe26aad2feb74691849b815cab49829877a16877e3c727e4cca7d0189efe |
+| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从迁移来源 pikasTech/HWLAB#1205 迁移到 UniDesk 项目管理目录。 |

 ## 正文

 编号: PJ2026-0103
 短名: HarnessRL
-上级总项目: [#1194](https://github.com/pikasTech/HWLAB/issues/1194)
-总规格 issue: [#1194](https://github.com/pikasTech/HWLAB/issues/1194)
+上级总项目: [PJ2026-01 HWLAB 总规格](PJ2026-01-HWLAB.md)
+总规格文件: [PJ2026-01-HWLAB.md](PJ2026-01-HWLAB.md)
 核对时间: 2026-06-14（北京时间）
 核对口径: 以 HWLAB v0.2 CaseRun、HWPOD evidence、PLC/ARM2D 已归档 registry、Harness RL 规划和开放 issue 为准；本文档 定义证据、评估、回放和训练反馈，不接管硬件资源、Agent 调度或客户端展示。

@@ -32,14 +21,14 @@

 - 主责对象: harness、CaseRun、case registry、ioProbe evidence、artifact/diff/final 证据、aggregate、评估、回放、训练反馈和 RL 闭环。
 - 不负责: 硬件容量与占用、Agent 执行生命周期、用户账号与计费、CI/CD 发布、Web/CLI 展示细节。
- 交接方向: 硬件池 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)、Agent编排 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)、客户端 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)、用户管理 [#1207](https://github.com/pikasTech/HWLAB/issues/1207)、平台运维 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
+- 交接方向: [硬件池](PJ2026-0101-hardware-pool.md)、[Agent编排](PJ2026-0102-agent-orchestration.md)、[客户端](PJ2026-0104-client.md)、[用户管理](PJ2026-0105-user-management.md)、[平台运维](PJ2026-0106-platform-ops.md)。

 ## 交叉引用

- 上游依赖: 硬件池 [#1203](https://github.com/pikasTech/HWLAB/issues/1203) 提供真实设备、probe 和原始硬件读数；Agent编排 [#1204](https://github.com/pikasTech/HWLAB/issues/1204) 提供任务生命周期、workspace 和 artifact 指针；平台运维 [#1208](https://github.com/pikasTech/HWLAB/issues/1208) 提供 runtime 与 registry/日志保留能力。
- 下游支撑: 客户端 [#1206](https://github.com/pikasTech/HWLAB/issues/1206) 展示 aggregate/evidence；用户管理 [#1207](https://github.com/pikasTech/HWLAB/issues/1207) 可消费 usage/evidence 统计；Agent编排 [#1204](https://github.com/pikasTech/HWLAB/issues/1204) 可消费评估反馈改善执行策略。
+- 上游依赖: [硬件池](PJ2026-0101-hardware-pool.md) 提供真实设备、probe 和原始硬件读数；[Agent编排](PJ2026-0102-agent-orchestration.md) 提供任务生命周期、workspace 和 artifact 指针；[平台运维](PJ2026-0106-platform-ops.md) 提供 runtime 与 registry/日志保留能力。
+- 下游支撑: [客户端](PJ2026-0104-client.md) 展示 aggregate/evidence；[用户管理](PJ2026-0105-user-management.md) 可消费 usage/evidence 统计；[Agent编排](PJ2026-0102-agent-orchestration.md) 可消费评估反馈改善执行策略。
 - 接口/证据边界: 本方向输出 CaseRun 状态、证据包、低噪声 aggregate、ioProbe evidence、评估/回放结果和训练反馈；不输出硬件可用性、Agent 调度状态、用户账本或前端布局。
- 需同步回写: evidence 标准、aggregate 口径、pass/fail 判定、回放格式或训练反馈格式变化时，回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194)、硬件池 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)、Agent编排 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)、客户端 [#1206](https://github.com/pikasTech/HWLAB/issues/1206) 和用户管理 [#1207](https://github.com/pikasTech/HWLAB/issues/1207)。
+- 需同步回写: evidence 标准、aggregate 口径、pass/fail 判定、回放格式或训练反馈格式变化时，回写 [L0 总规格](PJ2026-01-HWLAB.md)、[硬件池](PJ2026-0101-hardware-pool.md)、[Agent编排](PJ2026-0102-agent-orchestration.md)、[客户端](PJ2026-0104-client.md) 和 [用户管理](PJ2026-0105-user-management.md)。

 ## 方向目标

@@ -49,7 +38,7 @@

 | 编号 | 短名 | 主责 | 关联 L1 | 边界 |
 | --- | --- | --- | --- | --- |
-| PJ2026-010301 | CaseRun规格 | 定义 case definition、stage model、start/status/result/logs、case registry、postValidation 和 run-local workspace 约束。 | Agent编排、硬件池、平台运维 | 完成标准是 CaseRun 编排与 registry 语义正确；硬件实体绑定归 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)，Agent 生命周期归 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)。 |
+| PJ2026-010301 | CaseRun规格 | 定义 case definition、stage model、start/status/result/logs、case registry、postValidation 和 run-local workspace 约束。 | Agent编排、硬件池、平台运维 | 完成标准是 CaseRun 编排与 registry 语义正确；硬件实体绑定归 [硬件池](PJ2026-0101-hardware-pool.md)，Agent 生命周期归 [Agent编排](PJ2026-0102-agent-orchestration.md)。 |
 | PJ2026-010302 | 证据采集 | 定义 trace、diff、artifact、log、final response、HWPOD raw output、agent transcript 和 evidence 分层收集。 | Agent编排、客户端、平台运维 | 完成标准是证据不丢、不混、不伪造；低噪声摘要归 PJ2026-010304。 |
 | PJ2026-010303 | ioProbe建模 | 定义外部观测数据的 evidence 模型、采样、单位、stats、board-comm 关联和真实仪器/外部回采口径。 | 硬件池、客户端 | 硬件池负责 probe 能力和物理接入；本课题负责把观测转成 Harness 可评价证据。 |
 | PJ2026-010304 | Aggregate摘要 | 定义 aggregate.md、状态摘要、关键证据摘录、失败分类和 final-response 截断时的主阅读入口。 | 客户端、Agent编排 | 完成标准是人工和客户端能读懂结果；不替代 raw evidence 或 pass/fail 判定。 |
@@ -58,18 +47,18 @@

 ## 当前开放缺口映射

- [#921](https://github.com/pikasTech/HWLAB/issues/921): HWPOD 强化学习 Harness 总规划，主归 PJ2026-010306 训练反馈，并关联 PJ2026-010305 评估回放。
- [#1033](https://github.com/pikasTech/HWLAB/issues/1033): CaseRun + Web UI 统一 Agent Review 架构，主归 PJ2026-010305 评估回放，客户端展示归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)。
- [#1178](https://github.com/pikasTech/HWLAB/issues/1178) / [#1186](https://github.com/pikasTech/HWLAB/issues/1186): PLC 71-FREQ ioProbe 造模和真实频率源扩展，Harness 侧归 PJ2026-010303 ioProbe建模，硬件接入归 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)。
- [#1197](https://github.com/pikasTech/HWLAB/issues/1197): timeout 收口状态不一致，Harness 侧归 PJ2026-010301 CaseRun规格，Agent 生命周期归 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)。
- [#1200](https://github.com/pikasTech/HWLAB/issues/1200): final-response 截断但 present=true，主归 PJ2026-010304 Aggregate摘要，并关联 PJ2026-010302 证据采集。
+- HWPOD 强化学习 Harness 总规划：主归 PJ2026-010306 训练反馈，并关联 PJ2026-010305 评估回放。
+- CaseRun + Web UI 统一 Agent Review 架构：主归 PJ2026-010305 评估回放，客户端展示归 [客户端](PJ2026-0104-client.md)。
+- PLC 71-FREQ ioProbe 造模和真实频率源扩展：Harness 侧归 PJ2026-010303 ioProbe建模，硬件接入归 [硬件池](PJ2026-0101-hardware-pool.md)。
+- timeout 收口状态不一致：Harness 侧归 PJ2026-010301 CaseRun规格，Agent 生命周期归 [Agent编排](PJ2026-0102-agent-orchestration.md)。
+- final-response 截断但 present=true：主归 PJ2026-010304 Aggregate摘要，并关联 PJ2026-010302 证据采集。

 ## 验收标准

 - 原入口: `hwlab-cli case run start/status/result/logs`、case registry、aggregate.md、trace、artifact/diff/evidence 目录和 replay/评估入口。
 - Runtime/lane: HWLAB v0.2/v0.3；具体目标由下级 L2/L3 issue 指定。
 - Evidence: caseId、runId、traceId、registry commit、stage 状态、postValidation、ioProbe samples/stats、artifact 列表、diff、aggregate、评估/回放报告和训练反馈样本。
- 完成口径: HarnessRL 只确认“证据和评价闭环可审计、可复验、可回流”；硬件可用性由 [#1203](https://github.com/pikasTech/HWLAB/issues/1203) 验收，任务生命周期由 [#1204](https://github.com/pikasTech/HWLAB/issues/1204) 验收，用户入口由 [#1206](https://github.com/pikasTech/HWLAB/issues/1206) 验收，账本由 [#1207](https://github.com/pikasTech/HWLAB/issues/1207) 验收，运行面保留由 [#1208](https://github.com/pikasTech/HWLAB/issues/1208) 验收。
+- 完成口径: HarnessRL 只确认“证据和评价闭环可审计、可复验、可回流”；硬件可用性由 [硬件池](PJ2026-0101-hardware-pool.md) 验收，任务生命周期由 [Agent编排](PJ2026-0102-agent-orchestration.md) 验收，用户入口由 [客户端](PJ2026-0104-client.md) 验收，账本由 [用户管理](PJ2026-0105-user-management.md) 验收，运行面保留由 [平台运维](PJ2026-0106-platform-ops.md) 验收。

 ## 当前状态

@@ -79,6 +68,5 @@
 ## 回写规则

 - 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 caseId/runId/traceId/registry commit/evidence 路径。
- 影响 L0 中心、编号、职责边界或全局验收时回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194)。
- 涉及硬件资源或 probe 能力回写 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)；涉及 Agent 生命周期、workspace 或 artifact 指针回写 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)；涉及 Web/CLI/API 展示回写 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)；涉及 usage/credit/tenant 统计回写 [#1207](https://github.com/pikasTech/HWLAB/issues/1207)；涉及 registry/log/artifact 保留回写 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
-
+- 影响 L0 中心、编号、职责边界或全局验收时回写 [L0 总规格](PJ2026-01-HWLAB.md)。
+- 涉及硬件资源或 probe 能力回写 [硬件池](PJ2026-0101-hardware-pool.md)；涉及 Agent 生命周期、workspace 或 artifact 指针回写 [Agent编排](PJ2026-0102-agent-orchestration.md)；涉及 Web/CLI/API 展示回写 [客户端](PJ2026-0104-client.md)；涉及 usage/credit/tenant 统计回写 [用户管理](PJ2026-0105-user-management.md)；涉及 registry/log/artifact 保留回写 [平台运维](PJ2026-0106-platform-ops.md)。
@@ -6,25 +6,14 @@
 | --- | --- | --- | --- |
 | v0.3 | b5d8cee438a3bd66ca440a25bf5a16d9081d9efa | 2026-06-14 | 将 issue/PR 引用显示改为短号 Markdown 链接，链接目标保留完整 URL。 |
 | v0.2 | b0cbe9b721b50e9fff4d350ee50ed2af03cf0405 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
-| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 [#1206](https://github.com/pikasTech/HWLAB/issues/1206) 迁移到 UniDesk 项目管理目录。 |
-
-## 迁移来源
-
-| 字段 | 内容 |
-| --- | --- |
-| 原 issue | [#1206](https://github.com/pikasTech/HWLAB/issues/1206) |
-| 原标题 | PJ2026-0104 客户端 |
-| 原 URL | [#1206](https://github.com/pikasTech/HWLAB/issues/1206) |
-| 原状态 | open |
-| 原更新时间 | 2026-06-14T12:20:05Z |
-| 原 body SHA | a00a372c9b22c52ddfb52e38ff0dc9a85b6e7b1aadcb971ffb9e3b7462e49c58 |
+| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从迁移来源 pikasTech/HWLAB#1206 迁移到 UniDesk 项目管理目录。 |

 ## 正文

 编号: PJ2026-0104
 短名: 客户端
-上级总项目: [#1194](https://github.com/pikasTech/HWLAB/issues/1194)
-总规格 issue: [#1194](https://github.com/pikasTech/HWLAB/issues/1194)
+上级总项目: [PJ2026-01 HWLAB 总规格](PJ2026-01-HWLAB.md)
+总规格文件: [PJ2026-01-HWLAB.md](PJ2026-01-HWLAB.md)
 核对时间: 2026-06-14（北京时间）
 核对口径: 以 HWLAB Cloud Web、hwlab-cli、HTTP API、公开入口、v0.3 Vue parity 和用户可见退化 issue 为准；本文档 定义用户入口契约和展示行为，不接管用户账本、Agent 内部调度、硬件库存或发布机制。

@@ -32,14 +21,14 @@

 - 主责对象: Web、CLI、HTTP API、SDK/IDE 插件、webhook、公开文档、兼容性、用户任务入口、状态展示和结果获取。
 - 不负责: 用户/计费真相、Agent 调度内部、硬件库存与证据真实性、CI/CD 发布、Secret/配置下发。
- 交接方向: 用户管理 [#1207](https://github.com/pikasTech/HWLAB/issues/1207)、Agent编排 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)、硬件池 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)、HarnessRL [#1205](https://github.com/pikasTech/HWLAB/issues/1205)、平台运维 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
+- 交接方向: [用户管理](PJ2026-0105-user-management.md)、[Agent编排](PJ2026-0102-agent-orchestration.md)、[硬件池](PJ2026-0101-hardware-pool.md)、[HarnessRL](PJ2026-0103-harness-rl.md)、[平台运维](PJ2026-0106-platform-ops.md)。

 ## 交叉引用

- 上游依赖: 用户管理 [#1207](https://github.com/pikasTech/HWLAB/issues/1207) 提供身份、权限、API key、额度和 admin 能力；Agent编排 [#1204](https://github.com/pikasTech/HWLAB/issues/1204) 提供任务状态、session 和结果指针；硬件池 [#1203](https://github.com/pikasTech/HWLAB/issues/1203) 提供资源/设备状态；HarnessRL [#1205](https://github.com/pikasTech/HWLAB/issues/1205) 提供 evidence/aggregate；平台运维 [#1208](https://github.com/pikasTech/HWLAB/issues/1208) 提供公网入口和发布状态。
+- 上游依赖: [用户管理](PJ2026-0105-user-management.md) 提供身份、权限、API key、额度和 admin 能力；[Agent编排](PJ2026-0102-agent-orchestration.md) 提供任务状态、session 和结果指针；[硬件池](PJ2026-0101-hardware-pool.md) 提供资源/设备状态；[HarnessRL](PJ2026-0103-harness-rl.md) 提供 evidence/aggregate；[平台运维](PJ2026-0106-platform-ops.md) 提供公网入口和发布状态。
 - 下游支撑: 所有用户入口通过客户端暴露；用户管理、Agent编排、硬件池和 HarnessRL 的用户可见能力需要客户端承载。
 - 接口/证据边界: 本方向定义 Web/CLI/API/SDK/Webhook 的调用契约、展示行为、错误语义和兼容性；不定义账号账本、Agent 生命周期、HWPOD 语义或 Harness evidence 标准。
- 需同步回写: API/CLI/Web/SDK/Webhook 契约、兼容性、公开文档或用户入口变化时，回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194)、用户管理 [#1207](https://github.com/pikasTech/HWLAB/issues/1207)、Agent编排 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)、硬件池 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)、HarnessRL [#1205](https://github.com/pikasTech/HWLAB/issues/1205) 和平台运维 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
+- 需同步回写: API/CLI/Web/SDK/Webhook 契约、兼容性、公开文档或用户入口变化时，回写 [L0 总规格](PJ2026-01-HWLAB.md)、[用户管理](PJ2026-0105-user-management.md)、[Agent编排](PJ2026-0102-agent-orchestration.md)、[硬件池](PJ2026-0101-hardware-pool.md)、[HarnessRL](PJ2026-0103-harness-rl.md) 和 [平台运维](PJ2026-0106-platform-ops.md)。

 ## 方向目标

@@ -50,7 +39,7 @@
 | 编号 | 短名 | 主责 | 关联 L1 | 边界 |
 | --- | --- | --- | --- | --- |
 | PJ2026-010401 | Web工作台 | 定义 Cloud Web 的任务提交、session/history、trace/result、HWPOD/evidence、Access/Usage/Admin 和工作台交互。 | Agent编排、用户管理、硬件池、HarnessRL、平台运维 | 完成标准是 Web 原入口行为正确；身份真相、Agent 生命周期、HWPOD 语义和发布机制分别归对应 L1。 |
-| PJ2026-010402 | CLI入口 | 定义 hwlab-cli/hwpod/case 等用户命令的参数、输出、错误、profile、同路径 smoke 和脚本可用性。 | Agent编排、硬件池、HarnessRL、用户管理 | 完成标准是 CLI 用户入口一致可用；HWPOD 执行语义归 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)，CaseRun 评价归 [#1205](https://github.com/pikasTech/HWLAB/issues/1205)。 |
+| PJ2026-010402 | CLI入口 | 定义 hwlab-cli/hwpod/case 等用户命令的参数、输出、错误、profile、同路径 smoke 和脚本可用性。 | Agent编排、硬件池、HarnessRL、用户管理 | 完成标准是 CLI 用户入口一致可用；HWPOD 执行语义归 [硬件池](PJ2026-0101-hardware-pool.md)，CaseRun 评价归 [HarnessRL](PJ2026-0103-harness-rl.md)。 |
 | PJ2026-010403 | API契约 | 定义 HTTP API/WebSocket 的路径、schema、错误码、鉴权转发、兼容性和客户端消费契约。 | 用户管理、Agent编排、平台运维 | 完成标准是公开/内部 API 行为可依赖；后端业务真相由对应 L1 定义。 |
 | PJ2026-010404 | SDK插件 | 定义 SDK、IDE 插件、外部工具接入、任务创建/查询/结果读取封装和版本兼容。 | Agent编排、用户管理 | 完成标准是外部开发者可集成；不定义平台底层调度或账号账本。 |
 | PJ2026-010405 | Webhook集成 | 定义外部回调、事件订阅、任务状态通知、证据通知和失败重试语义。 | Agent编排、HarnessRL、用户管理 | 完成标准是外部系统能可靠消费事件；事件事实来源归对应业务 L1。 |
@@ -58,18 +47,18 @@

 ## 当前开放缺口映射

- [#1199](https://github.com/pikasTech/HWLAB/issues/1199): v0.3 Vue 工作台入口与会话发送退化，主归 PJ2026-010401 Web工作台，关联 Agent编排 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)。
- [#1172](https://github.com/pikasTech/HWLAB/issues/1172): v0.3 Cloud Web 直达 history 路由缺 SPA fallback，主归 PJ2026-010401，公开入口/发布归 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
- [#1192](https://github.com/pikasTech/HWLAB/issues/1192): v0.3 域名工作台登录后 API 间歇 502 且停留登录页，客户端侧归 PJ2026-010401/API契约，运行面归 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
- [#1166](https://github.com/pikasTech/HWLAB/issues/1166): v0.3 Cloud Web check 受测试运行器兼容性与 timing 抖动影响，客户端侧归 PJ2026-010401，验证工具链归 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
- [#1033](https://github.com/pikasTech/HWLAB/issues/1033): Agent Review 的 Web UI 承载部分归 PJ2026-010401，评估/审查语义归 HarnessRL [#1205](https://github.com/pikasTech/HWLAB/issues/1205)。
+- v0.3 Vue 工作台入口与会话发送退化：主归 PJ2026-010401 Web工作台，关联 [Agent编排](PJ2026-0102-agent-orchestration.md)。
+- v0.3 Cloud Web 直达 history 路由缺 SPA fallback：主归 PJ2026-010401，公开入口/发布归 [平台运维](PJ2026-0106-platform-ops.md)。
+- v0.3 域名工作台登录后 API 间歇 502 且停留登录页：客户端侧归 PJ2026-010401/API契约，运行面归 [平台运维](PJ2026-0106-platform-ops.md)。
+- v0.3 Cloud Web check 受测试运行器兼容性与 timing 抖动影响：客户端侧归 PJ2026-010401，验证工具链归 [平台运维](PJ2026-0106-platform-ops.md)。
+- Agent Review 的 Web UI 承载部分：归 PJ2026-010401，评估/审查语义归 [HarnessRL](PJ2026-0103-harness-rl.md)。

 ## 验收标准

 - 原入口: Cloud Web 公网/内网入口、`hwlab-cli`、HTTP API/WebSocket、SDK/插件样例和 Webhook 回调。
 - Runtime/lane: HWLAB v0.2/v0.3；具体目标由下级 L2/L3 issue 指定。
 - Evidence: Web smoke、CLI smoke、API 响应样例、SDK/plugin 示例、Webhook 投递记录、公开文档链接、兼容性记录和用户可见错误语义。
- 完成口径: 客户端只确认“用户入口一致、可用、可解释”；身份/账本由 [#1207](https://github.com/pikasTech/HWLAB/issues/1207) 验收，任务生命周期由 [#1204](https://github.com/pikasTech/HWLAB/issues/1204) 验收，硬件事实由 [#1203](https://github.com/pikasTech/HWLAB/issues/1203) 验收，evidence/aggregate 由 [#1205](https://github.com/pikasTech/HWLAB/issues/1205) 验收，发布/入口健康由 [#1208](https://github.com/pikasTech/HWLAB/issues/1208) 验收。
+- 完成口径: 客户端只确认“用户入口一致、可用、可解释”；身份/账本由 [用户管理](PJ2026-0105-user-management.md) 验收，任务生命周期由 [Agent编排](PJ2026-0102-agent-orchestration.md) 验收，硬件事实由 [硬件池](PJ2026-0101-hardware-pool.md) 验收，evidence/aggregate 由 [HarnessRL](PJ2026-0103-harness-rl.md) 验收，发布/入口健康由 [平台运维](PJ2026-0106-platform-ops.md) 验收。

 ## 当前状态

@@ -79,6 +68,5 @@
 ## 回写规则

 - 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 Web/CLI/API/SDK/Webhook 原入口证据。
- 影响 L0 中心、编号、职责边界或全局验收时回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194)。
- 涉及身份、权限、API key、usage 或 admin 回写 [#1207](https://github.com/pikasTech/HWLAB/issues/1207)；涉及任务/session/result 回写 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)；涉及 HWPOD 资源/状态回写 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)；涉及 evidence/aggregate 回写 [#1205](https://github.com/pikasTech/HWLAB/issues/1205)；涉及公网入口、CI/CD 或 runtime 发布回写 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
-
+- 影响 L0 中心、编号、职责边界或全局验收时回写 [L0 总规格](PJ2026-01-HWLAB.md)。
+- 涉及身份、权限、API key、usage 或 admin 回写 [用户管理](PJ2026-0105-user-management.md)；涉及任务/session/result 回写 [Agent编排](PJ2026-0102-agent-orchestration.md)；涉及 HWPOD 资源/状态回写 [硬件池](PJ2026-0101-hardware-pool.md)；涉及 evidence/aggregate 回写 [HarnessRL](PJ2026-0103-harness-rl.md)；涉及公网入口、CI/CD 或 runtime 发布回写 [平台运维](PJ2026-0106-platform-ops.md)。
@@ -6,25 +6,14 @@
 | --- | --- | --- | --- |
 | v0.3 | b5d8cee438a3bd66ca440a25bf5a16d9081d9efa | 2026-06-14 | 将 issue/PR 引用显示改为短号 Markdown 链接，链接目标保留完整 URL。 |
 | v0.2 | b0cbe9b721b50e9fff4d350ee50ed2af03cf0405 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
-| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 [#1207](https://github.com/pikasTech/HWLAB/issues/1207) 迁移到 UniDesk 项目管理目录。 |
-
-## 迁移来源
-
-| 字段 | 内容 |
-| --- | --- |
-| 原 issue | [#1207](https://github.com/pikasTech/HWLAB/issues/1207) |
-| 原标题 | PJ2026-0105 用户管理 |
-| 原 URL | [#1207](https://github.com/pikasTech/HWLAB/issues/1207) |
-| 原状态 | open |
-| 原更新时间 | 2026-06-14T12:20:54Z |
-| 原 body SHA | 8aac900d4eddbdcf7e6e3708e744a7eb7fd3c1065f346caa7734fa0fa7b2b9b1 |
+| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从迁移来源 pikasTech/HWLAB#1207 迁移到 UniDesk 项目管理目录。 |

 ## 正文

 编号: PJ2026-0105
 短名: 用户管理
-上级总项目: [#1194](https://github.com/pikasTech/HWLAB/issues/1194)
-总规格 issue: [#1194](https://github.com/pikasTech/HWLAB/issues/1194)
+上级总项目: [PJ2026-01 HWLAB 总规格](PJ2026-01-HWLAB.md)
+总规格文件: [PJ2026-01-HWLAB.md](PJ2026-01-HWLAB.md)
 核对时间: 2026-06-14（北京时间）
 核对口径: 以 HWLAB v0.3 user-billing、Sub2API 多用户/credit 架构吸收、API key、session、usage/credit、admin 和 quota/entitlement issue 为准；本文档 定义用户与账本真相，不接管客户端布局、Agent 执行语义或平台发布。

@@ -32,14 +21,14 @@

 - 主责对象: 用户、注册登录、session、权限、API key、credit、usage、billing、admin、plan/entitlement/quota、租户隔离和资源消费约束。
 - 不负责: 客户端交互细节、Agent 执行生命周期、硬件 evidence、Harness 评价、部署机制。
- 交接方向: 客户端 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)、Agent编排 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)、HarnessRL [#1205](https://github.com/pikasTech/HWLAB/issues/1205)、平台运维 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)、硬件池 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)。
+- 交接方向: [客户端](PJ2026-0104-client.md)、[Agent编排](PJ2026-0102-agent-orchestration.md)、[HarnessRL](PJ2026-0103-harness-rl.md)、[平台运维](PJ2026-0106-platform-ops.md)、[硬件池](PJ2026-0101-hardware-pool.md)。

 ## 交叉引用

- 上游依赖: 客户端 [#1206](https://github.com/pikasTech/HWLAB/issues/1206) 承载登录/API key/admin/usage 入口；Agent编排 [#1204](https://github.com/pikasTech/HWLAB/issues/1204) 和 HarnessRL [#1205](https://github.com/pikasTech/HWLAB/issues/1205) 提供 usage/evidence 来源；平台运维 [#1208](https://github.com/pikasTech/HWLAB/issues/1208) 提供数据库、Secret 和 runtime；硬件池 [#1203](https://github.com/pikasTech/HWLAB/issues/1203) 提供可授权的硬件资源事实。
+- 上游依赖: [客户端](PJ2026-0104-client.md) 承载登录/API key/admin/usage 入口；[Agent编排](PJ2026-0102-agent-orchestration.md) 和 [HarnessRL](PJ2026-0103-harness-rl.md) 提供 usage/evidence 来源；[平台运维](PJ2026-0106-platform-ops.md) 提供数据库、Secret 和 runtime；[硬件池](PJ2026-0101-hardware-pool.md) 提供可授权的硬件资源事实。
 - 下游支撑: 客户端、Agent编排、硬件池和 HarnessRL 都需要身份、权限、额度、租户隔离和资源消费约束。
 - 接口/证据边界: 本方向定义账户、session、权限、额度、计量账本、账单和 admin 真相；不定义客户端布局、Agent 调度、HWPOD 物理资源或 Harness evidence 标准。
- 需同步回写: 账户模型、API key、权限/配额、usage/credit、billing/admin 或租户隔离规则变化时，回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194)、客户端 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)、Agent编排 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)、HarnessRL [#1205](https://github.com/pikasTech/HWLAB/issues/1205) 和平台运维 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
+- 需同步回写: 账户模型、API key、权限/配额、usage/credit、billing/admin 或租户隔离规则变化时，回写 [L0 总规格](PJ2026-01-HWLAB.md)、[客户端](PJ2026-0104-client.md)、[Agent编排](PJ2026-0102-agent-orchestration.md)、[HarnessRL](PJ2026-0103-harness-rl.md) 和 [平台运维](PJ2026-0106-platform-ops.md)。

 ## 方向目标

@@ -49,27 +38,27 @@

 | 编号 | 短名 | 主责 | 关联 L1 | 边界 |
 | --- | --- | --- | --- | --- |
-| PJ2026-010501 | 账号会话 | 定义注册、登录、logout、session、introspect、cookie/token 生命周期和用户身份 source-of-truth。 | 客户端、平台运维 | 完成标准是身份可验证；登录页面和 UI 体验归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)，Secret/DB 发布归 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。 |
-| PJ2026-010502 | APIKey | 定义 API key 创建、撤销、scope、脱敏展示、轮换、服务侧校验和调用身份绑定。 | 客户端、Agent编排、平台运维 | 完成标准是 API key 可安全消费；CLI/Web 展示归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)，Secret 同步归 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。 |
-| PJ2026-010503 | 权限配额 | 定义 role/admin、plan、entitlement、quota、resource authorization、preflight 和资源使用许可。 | Agent编排、硬件池、客户端 | 完成标准是资源消费前授权正确；实际硬件可用性归 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)，任务执行归 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)。 |
+| PJ2026-010501 | 账号会话 | 定义注册、登录、logout、session、introspect、cookie/token 生命周期和用户身份 source-of-truth。 | 客户端、平台运维 | 完成标准是身份可验证；登录页面和 UI 体验归 [客户端](PJ2026-0104-client.md)，Secret/DB 发布归 [平台运维](PJ2026-0106-platform-ops.md)。 |
+| PJ2026-010502 | APIKey | 定义 API key 创建、撤销、scope、脱敏展示、轮换、服务侧校验和调用身份绑定。 | 客户端、Agent编排、平台运维 | 完成标准是 API key 可安全消费；CLI/Web 展示归 [客户端](PJ2026-0104-client.md)，Secret 同步归 [平台运维](PJ2026-0106-platform-ops.md)。 |
+| PJ2026-010503 | 权限配额 | 定义 role/admin、plan、entitlement、quota、resource authorization、preflight 和资源使用许可。 | Agent编排、硬件池、客户端 | 完成标准是资源消费前授权正确；实际硬件可用性归 [硬件池](PJ2026-0101-hardware-pool.md)，任务执行归 [Agent编排](PJ2026-0102-agent-orchestration.md)。 |
 | PJ2026-010504 | 计量账本 | 定义 credit ledger、reservation、usage record、idempotency、rollback/compensation 和 usage source 归因。 | Agent编排、HarnessRL、平台运维 | 完成标准是 usage/credit 真相可审计；Agent/Harness 只提供事件来源。 |
-| PJ2026-010505 | 账单后台 | 定义 billing、usage summary、admin credit adjust、报表、导出和运营后台能力。 | 客户端、平台运维 | 完成标准是管理员和用户能看到可信账单；页面承载归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)，DB/发布归 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。 |
+| PJ2026-010505 | 账单后台 | 定义 billing、usage summary、admin credit adjust、报表、导出和运营后台能力。 | 客户端、平台运维 | 完成标准是管理员和用户能看到可信账单；页面承载归 [客户端](PJ2026-0104-client.md)，DB/发布归 [平台运维](PJ2026-0106-platform-ops.md)。 |
 | PJ2026-010506 | 租户隔离 | 定义 tenant 边界、数据隔离、资源隔离、审计、跨用户共享和越权防护。 | 全部 L1 | 完成标准是多用户资源和数据不串租户；具体入口、执行、硬件和 evidence 仍由对应 L1 实现。 |

 ## 当前开放缺口映射

- [#1127](https://github.com/pikasTech/HWLAB/issues/1127): Go 用户与计费中台总计划，覆盖 PJ2026-010501 到 PJ2026-010505 的核心基线。
- [#1176](https://github.com/pikasTech/HWLAB/issues/1176): v0.3 user-billing 管理功能退化补齐，主归 PJ2026-010505 账单后台，并关联 PJ2026-010502 APIKey、PJ2026-010504 计量账本。
- [#1211](https://github.com/pikasTech/HWLAB/issues/1211): plan/entitlement/quota 资源授权闭环，主归 PJ2026-010503 权限配额。
- [#1146](https://github.com/pikasTech/HWLAB/issues/1146): Code Agent 计费成功但 AgentRun 执行失败，用户管理侧归 PJ2026-010504 计量账本与 PJ2026-010503 权限配额，Agent 执行归 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)。
- [#1192](https://github.com/pikasTech/HWLAB/issues/1192): 登录后 API 间歇 502 且停留登录页，身份/API 行为关联 PJ2026-010501，客户端入口归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)，运行面归 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
+- Go 用户与计费中台总计划：覆盖 PJ2026-010501 到 PJ2026-010505 的核心基线。
+- v0.3 user-billing 管理功能退化补齐：主归 PJ2026-010505 账单后台，并关联 PJ2026-010502 APIKey、PJ2026-010504 计量账本。
+- plan/entitlement/quota 资源授权闭环：主归 PJ2026-010503 权限配额。
+- Code Agent 计费成功但 AgentRun 执行失败：用户管理侧归 PJ2026-010504 计量账本与 PJ2026-010503 权限配额，Agent 执行归 [Agent编排](PJ2026-0102-agent-orchestration.md)。
+- 登录后 API 间歇 502 且停留登录页：身份/API 行为关联 PJ2026-010501，客户端入口归 [客户端](PJ2026-0104-client.md)，运行面归 [平台运维](PJ2026-0106-platform-ops.md)。

 ## 验收标准

 - 原入口: 注册/登录/API key/session introspect、Code Agent preflight、usage record、usage summary、credit ledger、admin 调整和 entitlement/quota API。
 - Runtime/lane: HWLAB v0.3 优先；涉及 v0.2 兼容时由下级 L2/L3 issue 指定。
 - Evidence: 用户/会话记录、API key 摘要、preflight 结果、reservation/usage record、credit ledger、usage summary、admin 操作记录、数据库 source-of-truth 记录和审计日志。
- 完成口径: 用户管理只确认“身份、权限、额度、计量、账单和租户隔离真相正确”；客户端入口由 [#1206](https://github.com/pikasTech/HWLAB/issues/1206) 验收，Agent 执行由 [#1204](https://github.com/pikasTech/HWLAB/issues/1204) 验收，硬件资源由 [#1203](https://github.com/pikasTech/HWLAB/issues/1203) 验收，Harness evidence 由 [#1205](https://github.com/pikasTech/HWLAB/issues/1205) 验收，DB/Secret/runtime 由 [#1208](https://github.com/pikasTech/HWLAB/issues/1208) 验收。
+- 完成口径: 用户管理只确认“身份、权限、额度、计量、账单和租户隔离真相正确”；客户端入口由 [客户端](PJ2026-0104-client.md) 验收，Agent 执行由 [Agent编排](PJ2026-0102-agent-orchestration.md) 验收，硬件资源由 [硬件池](PJ2026-0101-hardware-pool.md) 验收，Harness evidence 由 [HarnessRL](PJ2026-0103-harness-rl.md) 验收，DB/Secret/runtime 由 [平台运维](PJ2026-0106-platform-ops.md) 验收。

 ## 当前状态

@@ -79,6 +68,5 @@
 ## 回写规则

 - 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 API/Web/CLI、ledger、DB source-of-truth 和审计证据。
- 影响 L0 中心、编号、职责边界或全局验收时回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194)。
- 涉及 Web/CLI/API 展示回写 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)；涉及任务 preflight/usage source 回写 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)；涉及硬件资源授权回写 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)；涉及 evidence/usage 统计来源回写 [#1205](https://github.com/pikasTech/HWLAB/issues/1205)；涉及 DB、Secret、runtime 发布回写 [#1208](https://github.com/pikasTech/HWLAB/issues/1208)。
-
+- 影响 L0 中心、编号、职责边界或全局验收时回写 [L0 总规格](PJ2026-01-HWLAB.md)。
+- 涉及 Web/CLI/API 展示回写 [客户端](PJ2026-0104-client.md)；涉及任务 preflight/usage source 回写 [Agent编排](PJ2026-0102-agent-orchestration.md)；涉及硬件资源授权回写 [硬件池](PJ2026-0101-hardware-pool.md)；涉及 evidence/usage 统计来源回写 [HarnessRL](PJ2026-0103-harness-rl.md)；涉及 DB、Secret、runtime 发布回写 [平台运维](PJ2026-0106-platform-ops.md)。
@@ -6,25 +6,14 @@
 | --- | --- | --- | --- |
 | v0.3 | b5d8cee438a3bd66ca440a25bf5a16d9081d9efa | 2026-06-14 | 将 issue/PR 引用显示改为短号 Markdown 链接，链接目标保留完整 URL。 |
 | v0.2 | b0cbe9b721b50e9fff4d350ee50ed2af03cf0405 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
-| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 [#1208](https://github.com/pikasTech/HWLAB/issues/1208) 迁移到 UniDesk 项目管理目录。 |
-
-## 迁移来源
-
-| 字段 | 内容 |
-| --- | --- |
-| 原 issue | [#1208](https://github.com/pikasTech/HWLAB/issues/1208) |
-| 原标题 | PJ2026-0106 平台运维 |
-| 原 URL | [#1208](https://github.com/pikasTech/HWLAB/issues/1208) |
-| 原状态 | open |
-| 原更新时间 | 2026-06-14T12:21:38Z |
-| 原 body SHA | d9f55d319dcc1365eb35c1e76b507cc2132b7a64b2b34a859d8dc958537b03ef |
+| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从迁移来源 pikasTech/HWLAB#1208 迁移到 UniDesk 项目管理目录。 |

 ## 正文

 编号: PJ2026-0106
 短名: 平台运维
-上级总项目: [#1194](https://github.com/pikasTech/HWLAB/issues/1194)
-总规格 issue: [#1194](https://github.com/pikasTech/HWLAB/issues/1194)
+上级总项目: [PJ2026-01 HWLAB 总规格](PJ2026-01-HWLAB.md)
+总规格文件: [PJ2026-01-HWLAB.md](PJ2026-01-HWLAB.md)
 核对时间: 2026-06-14（北京时间）
 核对口径: 以 HWLAB v0.2/v0.3 runtime、G14/D601 lane、CI/CD、git mirror、YAML-first、Secret、FRP/Caddy、observability 和 GC/retention 问题为准；本文档 定义平台交付和运行面可见性，不接管产品行为、用户策略、Agent 语义或硬件验收标准。

@@ -32,14 +21,14 @@

 - 主责对象: CI/CD、git mirror、YAML-first、Secret 下发、rollout、公开入口、observability、GC/retention、平台发布和运行面诊断。
 - 不负责: 产品行为定义、用户策略、Agent 执行语义、硬件资源验收、Harness pass/fail、客户端 UX。
- 交接方向: 硬件池 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)、Agent编排 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)、HarnessRL [#1205](https://github.com/pikasTech/HWLAB/issues/1205)、客户端 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)、用户管理 [#1207](https://github.com/pikasTech/HWLAB/issues/1207)。
+- 交接方向: [硬件池](PJ2026-0101-hardware-pool.md)、[Agent编排](PJ2026-0102-agent-orchestration.md)、[HarnessRL](PJ2026-0103-harness-rl.md)、[客户端](PJ2026-0104-client.md)、[用户管理](PJ2026-0105-user-management.md)。

 ## 交叉引用

 - 上游依赖: 硬件池、Agent编排、HarnessRL、客户端和用户管理提供发布、配置、密钥、观测和运行面需求。
 - 下游支撑: 所有 L1 依赖平台运维完成镜像、配置、Secret、Git mirror/source commit、公开入口、运行状态、日志/trace 和清理保留。
 - 接口/证据边界: 本方向输出可复现发布、配置同步、Secret fingerprint、public exposure、健康状态、观测证据和运维动作记录；不定义任何业务 L1 的验收标准。
- 需同步回写: CI/CD、git mirror、YAML-first、Secret、公开入口、rollout、observability 或 GC/retention 规则变化时，回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194) 和全部受影响 L1。
+- 需同步回写: CI/CD、git mirror、YAML-first、Secret、公开入口、rollout、observability 或 GC/retention 规则变化时，回写 [L0 总规格](PJ2026-01-HWLAB.md) 和全部受影响 L1 规格。

 ## 方向目标

@@ -50,20 +39,20 @@
 | 编号 | 短名 | 主责 | 关联 L1 | 边界 |
 | --- | --- | --- | --- | --- |
 | PJ2026-010601 | 发布流水 | 定义 CI/CD、PipelineRun、image、rollout、trigger-current、post-merge deploy 和发布状态回写。 | 全部 L1 | 完成标准是变更可受控发布；业务功能是否正确由对应 L1 验收。 |
-| PJ2026-010602 | Git镜像 | 定义 git mirror sync/flush、source commit authority、bundle/mirror URL、lane source truth 和 Argo/GitOps 源同步。 | Agent编排、HarnessRL、平台运维 | 完成标准是运行面拿到正确源码；ResourceBundle 输入装配归 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)。 |
+| PJ2026-010602 | Git镜像 | 定义 git mirror sync/flush、source commit authority、bundle/mirror URL、lane source truth 和 Argo/GitOps 源同步。 | Agent编排、HarnessRL、平台运维 | 完成标准是运行面拿到正确源码；ResourceBundle 输入装配归 [Agent编排](PJ2026-0102-agent-orchestration.md)。 |
 | PJ2026-010603 | 配置治理 | 定义 YAML-first target/lane/node/service 配置、render、validate、schema 可见性和禁止硬编码策略。 | 全部 L1 | 完成标准是配置真相可控；具体业务数值和策略由对应 L1/配置 owning side 决定。 |
 | PJ2026-010604 | 密钥同步 | 定义 Secret sourceRef、targetKey、fingerprint、presence、下发、轮换和禁止泄漏输出。 | 用户管理、Agent编排、客户端 | 完成标准是凭据存在且可审计；凭据值和业务权限含义不在本 L1 反推。 |
-| PJ2026-010605 | 公开入口 | 定义 FRP/Caddy/domain/TLS、端口、health、public exposure 和入口漂移诊断。 | 客户端、用户管理、Agent编排 | 完成标准是公开入口指向正确 runtime；页面/接口业务行为归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206) / [#1207](https://github.com/pikasTech/HWLAB/issues/1207) / [#1204](https://github.com/pikasTech/HWLAB/issues/1204)。 |
+| PJ2026-010605 | 公开入口 | 定义 FRP/Caddy/domain/TLS、端口、health、public exposure 和入口漂移诊断。 | 客户端、用户管理、Agent编排 | 完成标准是公开入口指向正确 runtime；页面/接口业务行为归 [客户端](PJ2026-0104-client.md) / [用户管理](PJ2026-0105-user-management.md) / [Agent编排](PJ2026-0102-agent-orchestration.md)。 |
 | PJ2026-010606 | 运行观测 | 定义 health/status/logs/trace、failure reason、tail、diagnostic CLI、事件和可见性先修。 | 全部 L1 | 完成标准是失败位置和状态可见；观测信号不能替代能力实现。 |
-| PJ2026-010607 | 保留清理 | 定义 artifact、trace、case registry、workspace、session、log、cache、PVC 和 GC/retention 边界。 | HarnessRL、Agent编排、硬件池 | 完成标准是证据可保留且资源可回收；证据内容正确性归 [#1205](https://github.com/pikasTech/HWLAB/issues/1205)，workspace 语义归 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)。 |
+| PJ2026-010607 | 保留清理 | 定义 artifact、trace、case registry、workspace、session、log、cache、PVC 和 GC/retention 边界。 | HarnessRL、Agent编排、硬件池 | 完成标准是证据可保留且资源可回收；证据内容正确性归 [HarnessRL](PJ2026-0103-harness-rl.md)，workspace 语义归 [Agent编排](PJ2026-0102-agent-orchestration.md)。 |

 ## 当前开放缺口映射

- [#1209](https://github.com/pikasTech/HWLAB/issues/1209): v0.3 public exposure 端口/旧 web 指向问题，主归 PJ2026-010605 公开入口。
- [#1136](https://github.com/pikasTech/HWLAB/issues/1136): G14 v0.3 admin Secret 已收敛但 DB 连接阻塞登录，平台侧归 PJ2026-010604 密钥同步和 PJ2026-010606 运行观测。
- [#1192](https://github.com/pikasTech/HWLAB/issues/1192): 域名工作台登录后 API 间歇 502，入口/运行面归 PJ2026-010605 公开入口和 PJ2026-010606 运行观测，客户端归 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)。
- [#1166](https://github.com/pikasTech/HWLAB/issues/1166): Cloud Web check 受运行器兼容性和 timing 抖动影响，平台侧归 PJ2026-010601 发布流水与 PJ2026-010606 运行观测。
- [#1129](https://github.com/pikasTech/HWLAB/issues/1129): Web v0.2 与 CaseRun HWPOD 工具包同步差异，平台侧归 PJ2026-010602 Git镜像/源同步，Agent 装配归 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)。
+- v0.3 public exposure 端口/旧 web 指向问题：主归 PJ2026-010605 公开入口。
+- G14 v0.3 admin Secret 已收敛但 DB 连接阻塞登录：平台侧归 PJ2026-010604 密钥同步和 PJ2026-010606 运行观测。
+- 域名工作台登录后 API 间歇 502：入口/运行面归 PJ2026-010605 公开入口和 PJ2026-010606 运行观测，客户端归 [客户端](PJ2026-0104-client.md)。
+- Cloud Web check 受运行器兼容性和 timing 抖动影响：平台侧归 PJ2026-010601 发布流水与 PJ2026-010606 运行观测。
+- Web v0.2 与 CaseRun HWPOD 工具包同步差异：平台侧归 PJ2026-010602 Git镜像/源同步，Agent 装配归 [Agent编排](PJ2026-0102-agent-orchestration.md)。

 ## 验收标准

@@ -80,5 +69,5 @@
 ## 回写规则

 - 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 PipelineRun、source commit、render/Secret fingerprint、public health、status/log/trace 或 GC/retention 证据。
- 影响 L0 中心、编号、职责边界或全局验收时回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194)。
- 涉及硬件 runtime/node 回写 [#1203](https://github.com/pikasTech/HWLAB/issues/1203)；涉及 AgentRun/workspace/provider 回写 [#1204](https://github.com/pikasTech/HWLAB/issues/1204)；涉及 case registry/evidence 保留回写 [#1205](https://github.com/pikasTech/HWLAB/issues/1205)；涉及 Web/CLI/API/public entry 回写 [#1206](https://github.com/pikasTech/HWLAB/issues/1206)；涉及 DB/用户/Secret 语义回写 [#1207](https://github.com/pikasTech/HWLAB/issues/1207)。
+- 影响 L0 中心、编号、职责边界或全局验收时回写 [L0 总规格](PJ2026-01-HWLAB.md)。
+- 涉及硬件 runtime/node 回写 [硬件池](PJ2026-0101-hardware-pool.md)；涉及 AgentRun/workspace/provider 回写 [Agent编排](PJ2026-0102-agent-orchestration.md)；涉及 case registry/evidence 保留回写 [HarnessRL](PJ2026-0103-harness-rl.md)；涉及 Web/CLI/API/public entry 回写 [客户端](PJ2026-0104-client.md)；涉及 DB/用户/Secret 语义回写 [用户管理](PJ2026-0105-user-management.md)。
@@ -6,33 +6,22 @@
 | --- | --- | --- | --- |
 | v0.3 | b5d8cee438a3bd66ca440a25bf5a16d9081d9efa | 2026-06-14 | 将 issue/PR 引用显示改为短号 Markdown 链接，链接目标保留完整 URL。 |
 | v0.2 | b0cbe9b721b50e9fff4d350ee50ed2af03cf0405 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
-| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 [#1217](https://github.com/pikasTech/HWLAB/issues/1217) 迁移到 UniDesk 项目管理目录。 |
-
-## 迁移来源
-
-| 字段 | 内容 |
-| --- | --- |
-| 原 issue | [#1217](https://github.com/pikasTech/HWLAB/issues/1217) |
-| 原标题 | HWLAB 规格治理索引：编号、层级、回写与偏离规则 |
-| 原 URL | [#1217](https://github.com/pikasTech/HWLAB/issues/1217) |
-| 原状态 | open |
-| 原更新时间 | 2026-06-14T12:51:52Z |
-| 原 body SHA | 74b7a571bc045cf7d8a8c132e6de21d4bd56802f67eadab2fe89a62baf0e1d86 |
+| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从迁移来源 pikasTech/HWLAB#1217 迁移到 UniDesk 项目管理目录。 |

 ## 正文

-上级总项目: [#1194](https://github.com/pikasTech/HWLAB/issues/1194)
-关联面板: [#645](https://github.com/pikasTech/HWLAB/issues/645)
+上级总项目: [PJ2026-01 HWLAB 总规格](PJ2026-01-HWLAB.md)
+关联面板: HWLAB 长期总面板
 性质: 规格治理索引，不是 L1 方向，不是 L2 课题，不定义产品/系统需求。
-迁出来源: [#1194](https://github.com/pikasTech/HWLAB/issues/1194) 旧版“项目编号与命名规则 / L1 方向判定 / 层级职责边界 / 管理入口职责边界 / 交叉引用检查 / 偏离判定 / 回写规则”章节
+迁出来源: [L0 总规格](PJ2026-01-HWLAB.md) 旧版“项目编号与命名规则 / L1 方向判定 / 层级职责边界 / 管理入口职责边界 / 交叉引用检查 / 偏离判定 / 回写规则”章节
 迁出时间: 2026-06-14（北京时间）

 ## 使用规则

- 本文档 只保存项目管理和规格治理规则，供 [#1194](https://github.com/pikasTech/HWLAB/issues/1194)、L1/L2/L3/L4 issue 引用。
- 不在本文档 中新增、删除或重排 L1 方向；L1 方向树以 [#1194](https://github.com/pikasTech/HWLAB/issues/1194) 为准。
+- 本文档只保存项目管理和规格治理规则，供 [L0 总规格](PJ2026-01-HWLAB.md)、L1/L2/L3/L4 issue 引用。
+- 不在本文档中新增、删除或重排 L1 方向；L1 方向树以 [L0 总规格](PJ2026-01-HWLAB.md) 为准。
 - 不在本文档 中记录阶段进展、CaseRun 日志、PR 流水或具体实现方案。
- 治理规则变化需要回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194) 的引用关系，并同步更新 UniDesk `$unidesk-oa`。
+- 治理规则变化需要回写 [L0 总规格](PJ2026-01-HWLAB.md) 的引用关系，并同步更新 UniDesk `$unidesk-oa`。

 ## 编号与命名规则

@@ -52,10 +41,10 @@
 | 层级 | 负责定义 | 不负责 | 回写对象 |
 | --- | --- | --- | --- |
 | L0 / `PJ2026-01` | 项目使命、系统范围、L1 方向树、全局需求、全局验收 | PR 细节、CaseRun 日志、日报流水、具体实现设计 | `project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`、L1 issue |
-| L1 / 方向 | 能力域范围、成功标准、L2 课题清单、原入口验收类型、交叉引用边界 | 单个 PR、一次 smoke、仓库/工具/runtime 名称、项目管理动作 | [#1194](https://github.com/pikasTech/HWLAB/issues/1194)；方向范围变化时同步 `project-management/PJ2026-01` |
-| L2 / 课题 | 单个方向内的具体工作计划、交付物、阻塞、验收计划 | 总方向定义、跨方向路线图、实现细节流水 | 所属 L1；重大移动再回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194) |
+| L1 / 方向 | 能力域范围、成功标准、L2 课题清单、原入口验收类型、交叉引用边界 | 单个 PR、一次 smoke、仓库/工具/runtime 名称、项目管理动作 | [L0 总规格](PJ2026-01-HWLAB.md)；方向范围变化时同步 `project-management/PJ2026-01` |
+| L2 / 课题 | 单个方向内的具体工作计划、交付物、阻塞、验收计划 | 总方向定义、跨方向路线图、实现细节流水 | 所属 L1；重大移动再回写 [L0 总规格](PJ2026-01-HWLAB.md) |
 | L3 / 验收切片 | 一个有界验收切片和单一验收路径 | 多课题计划、父级范围变化、新能力域定义 | 所属 L2/L1，并附 evidence |
-| L4 / 执行任务 | PR、CaseRun、smoke、部署、文档收口等执行和 evidence | 新需求、新方向、验收规则变化 | 最近的 L3/L2/L1，必要时回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194) |
+| L4 / 执行任务 | PR、CaseRun、smoke、部署、文档收口等执行和 evidence | 新需求、新方向、验收规则变化 | 最近的 L3/L2/L1，必要时回写 [L0 总规格](PJ2026-01-HWLAB.md) |

 ## L1 主责判定

@@ -72,23 +61,23 @@ L1 方向必须是直接服务 L0 使命的一等产品/系统边界，并能定

 | 入口 | 定位 | 能定义 | 不能定义/承载 | 回写要求 |
 | --- | --- | --- | --- | --- |
-| [#1194](https://github.com/pikasTech/HWLAB/issues/1194) / `PJ2026-01` | L0 总项目需求规格 | 使命、范围、方向树、全局需求、全局验收 | 执行流水、PR 细节、CaseRun 原始日志、治理细则全文 | L1 范围变化和重大验收移动必须回写 |
-| [#645](https://github.com/pikasTech/HWLAB/issues/645) | 长期总面板和导航摘要 | L0/L1/L2 入口索引、阶段入口、历史专题导航 | 规格正文、验收标准、方向定义 | 指向 [#1194](https://github.com/pikasTech/HWLAB/issues/1194)，不替代 [#1194](https://github.com/pikasTech/HWLAB/issues/1194) |
-| [#644](https://github.com/pikasTech/HWLAB/issues/644) | Cloud M1 当前阶段规格 | 当前阶段目标、阶段口径、阶段验收重点 | L0 总规格、L1 方向本身、长期编号规则 | 阶段目标变化影响总规格时回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194) |
+| [PJ2026-01](PJ2026-01-HWLAB.md) | L0 总项目需求规格 | 使命、范围、方向树、全局需求、全局验收 | 执行流水、PR 细节、CaseRun 原始日志、治理细则全文 | L1 范围变化和重大验收移动必须回写 |
+| HWLAB 长期总面板 | 长期总面板和导航摘要 | L0/L1/L2 入口索引、阶段入口、历史专题导航 | 规格正文、验收标准、方向定义 | 指向 [L0 总规格](PJ2026-01-HWLAB.md)，不替代 L0 总规格 |
+| [HWLAB Cloud SPEC](stage-cloud-spec-20260601.md) | Cloud M1 当前阶段规格 | 当前阶段目标、阶段口径、阶段验收重点 | L0 总规格、L1 方向本身、长期编号规则 | 阶段目标变化影响总规格时回写 [L0 总规格](PJ2026-01-HWLAB.md) |
 | `project-management/PJ2026-01` | 长期文档和阶段报告沉淀 | 稳定规格、实施方案、测试规格、阶段报告 | 日常执行看板、未收敛讨论 | 从 issue 蒸馏稳定结论回文档 |
-| UniDesk `$unidesk-oa` | agent 侧项目治理操作规程 | agent 如何识别锚点、编号、职责、回写 | HWLAB 项目内容本身、L1 能力域 | 治理规则变化后更新 skill，并在 [#1194](https://github.com/pikasTech/HWLAB/issues/1194) 索引 commit |
+| UniDesk `$unidesk-oa` | agent 侧项目治理操作规程 | agent 如何识别锚点、编号、职责、回写 | HWLAB 项目内容本身、L1 能力域 | 治理规则变化后更新 skill，并在 [L0 总规格](PJ2026-01-HWLAB.md) 索引 commit |

 ## 交叉引用检查

 - L1/L2/L3 issue 只要涉及互相支撑，必须在正文写明“上游依赖、下游支撑、接口/证据边界、需同步回写”。
- 依赖其他 L1 的能力时，必须引用对应 L1 issue 编号；不能只写方向名。
- 如果一个变更影响多个 L1 的接口、证据或验收标准，主责 L1 必须回写受影响 L1，并在 [#1194](https://github.com/pikasTech/HWLAB/issues/1194) 留下重大移动摘要。
+- 依赖其他 L1 的能力时，规格文件必须用相对路径链接引用对应 L1 规格；执行 issue 必须引用对应 L1 issue 编号；不能只写方向名。
+- 如果一个变更影响多个 L1 的接口、证据或验收标准，主责 L1 必须回写受影响 L1，并在 [L0 总规格](PJ2026-01-HWLAB.md) 留下重大移动摘要。
 - 下级 issue 关闭前必须检查引用对象是否需要同步更新；引用未回写时不得直接关闭。
- [#645](https://github.com/pikasTech/HWLAB/issues/645) 只做导航索引，不替代上述交叉引用检查。
+- HWLAB 长期总面板只做导航索引，不替代上述交叉引用检查。

 ## 偏离判定

-出现以下情况时，任务必须先回到 [#1194](https://github.com/pikasTech/HWLAB/issues/1194) 或对应 L1 issue 重新归类：
+出现以下情况时，任务必须先回到 [L0 总规格](PJ2026-01-HWLAB.md) 或对应 L1 issue 重新归类：

 - 把文档整理、项目管理、skill 维护、看板维护或阶段报告当成 L1 方向。
 - 没有上级 L1 方向，却直接创建实现任务。
@@ -100,10 +89,10 @@ L1 方向必须是直接服务 L0 使命的一等产品/系统边界，并能定

 ## 回写规则

- `[#645](https://github.com/pikasTech/HWLAB/issues/645)` 只做长期总面板和导航，不承担规格正文。
- L1 方向变化必须回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194) 正文。
+- HWLAB 长期总面板只做长期总面板和导航，不承担规格正文。
+- L1 方向变化必须回写 [L0 总规格](PJ2026-01-HWLAB.md) 正文。
 - L1/L2/L3 持久管理 issue 标题必须以编号和短名开头。
- L1 issue 关闭或阶段完成时，必须评论回写 [#1194](https://github.com/pikasTech/HWLAB/issues/1194)，并说明验收证据、剩余 blocker 和是否需要更新项目管理规格。
+- L1 issue 关闭或阶段完成时，必须评论回写 L0 总项目 issue，并说明验收证据、剩余 blocker 和是否需要更新项目管理规格。
 - L2/L3/L4 执行 issue 必须写明编号、短名、上级总项目、主责方向、关联方向、目标 lane/branch、验收入口和完成后回写对象。
 - 稳定规则和长期规格最终应沉淀到 `project-management/PJ2026-01`；issue 保留执行状态、讨论、证据和交叉引用。
- agent 处理 HWLAB OA/总规格/项目漂移/issue 树任务时，应先加载 `$unidesk-oa`，并以 [#1194](https://github.com/pikasTech/HWLAB/issues/1194) 锚点为准。
+- agent 处理 HWLAB OA/总规格/项目漂移/issue 树任务时，应先加载 `$unidesk-oa`，并以 [L0 总规格](PJ2026-01-HWLAB.md) 和对应 L0 issue 锚点为准。
@@ -6,18 +6,7 @@
 | --- | --- | --- | --- |
 | v0.3 | b5d8cee438a3bd66ca440a25bf5a16d9081d9efa | 2026-06-14 | 将 issue/PR 引用显示改为短号 Markdown 链接，链接目标保留完整 URL。 |
 | v0.2 | b0cbe9b721b50e9fff4d350ee50ed2af03cf0405 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
-| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 [#644](https://github.com/pikasTech/HWLAB/issues/644) 迁移到 UniDesk 项目管理目录。 |
-
-## 迁移来源
-
-| 字段 | 内容 |
-| --- | --- |
-| 原 issue | [#644](https://github.com/pikasTech/HWLAB/issues/644) |
-| 原标题 | HWLAB Cloud SPEC / 云平台开发目标 20260601 |
-| 原 URL | [#644](https://github.com/pikasTech/HWLAB/issues/644) |
-| 原状态 | open |
-| 原更新时间 | 2026-06-05T03:14:18Z |
-| 原 body SHA | 69a4da1f218bff0c8c1a1247df513a77ccba22990c657fa681e3675484aa4fb5 |
+| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从迁移来源 pikasTech/HWLAB#644 迁移到 UniDesk 项目管理目录。 |

 ## 正文

@@ -25,7 +14,7 @@

 ## 背景

-HWLAB 2026-05 已经在 16666/16667 live 上跑通用户工作台、Code Agent 真实对话和 M3 虚拟硬件可信闭环（`7f38d17` live，`DC-DCSN-P0-2026-003` MVP 纠偏口径已收敛），下一阶段要把云平台从"单用户本地验证"扩张到"多人多端云端开箱即用"。本 SPEC 集中登记 2026-06-01 起的 5 个云平台开发目标，作为 v0.2 之后的下一段路线，并在 [#7](https://github.com/pikasTech/HWLAB/issues/7) 长期看板中取代旧的 MVP 单线叙述。
+HWLAB 2026-05 已经在 16666/16667 live 上跑通用户工作台、Code Agent 真实对话和 M3 虚拟硬件可信闭环（`7f38d17` live，`DC-DCSN-P0-2026-003` MVP 纠偏口径已收敛），下一阶段要把云平台从"单用户本地验证"扩张到"多人多端云端开箱即用"。本 SPEC 集中登记 2026-06-01 起的 5 个云平台开发目标，作为 v0.2 之后的下一段路线，并在 HWLAB 长期总面板中取代旧的 MVP 单线叙述。

 ## 目标

@@ -55,13 +44,13 @@ HWLAB 2026-05 已经在 16666/16667 live 上跑通用户工作台、Code Agent

 ## 关联

- 承接：HWLAB#7（HWLAB 长期总看板）当前阶段"Code Agent 真实可用 + M3 虚拟硬件可信闭环"已收敛
+- 承接：HWLAB 长期总看板当前阶段"Code Agent 真实可用 + M3 虚拟硬件可信闭环"已收敛
 - 取代：DC-DCSN-P0-2026-003 在 v0.2 / 16666-16667 范围的"MVP 优先"口径（云端协同 / HWPOD / 监管 AGENT 部分超出口径时回到本 SPEC）
- 关联 issue：
-  - [#621](https://github.com/pikasTech/HWLAB/issues/621) v0.2 Workbench 会话随用户账号持久化（多用户 / 跨设备恢复，目标 4）
-  - [#627](https://github.com/pikasTech/HWLAB/issues/627) Playwright/Chromium 运行环境与 Workbench browser smoke 防回归治理（云端开箱即用，关联目标 1）
-  - [#633](https://github.com/pikasTech/HWLAB/issues/633) PR 自动 CI / 自动 merge / deploy.json CD 分层（监管 AGENT 的工程护栏，关联目标 3）
-  - [#533](https://github.com/pikasTech/HWLAB/issues/533) v0.2 Device Pod 正式接入规格（被本 SPEC 目标 5 的"HWPOD 设备标准"包含并展开）
+- 关联历史主题：
+  - v0.2 Workbench 会话随用户账号持久化（多用户 / 跨设备恢复，目标 4）
+  - Playwright/Chromium 运行环境与 Workbench browser smoke 防回归治理（云端开箱即用，关联目标 1）
+  - PR 自动 CI / 自动 merge / deploy.json CD 分层（监管 AGENT 的工程护栏，关联目标 3）
+  - v0.2 Device Pod 正式接入规格（被本 SPEC 目标 5 的"HWPOD 设备标准"包含并展开）

 ## 阶段（2026-06-01 起）

@@ -76,7 +65,7 @@ HWLAB 2026-05 已经在 16666/16667 live 上跑通用户工作台、Code Agent
 - 签发日期：2026-06-01
 - 签发人：staff
 - 适用版本：HWLAB v0.2 之后
- 维护：[#7](https://github.com/pikasTech/HWLAB/issues/7) 长期看板"下一阶段路线"段落
+- 维护：HWLAB 长期总面板"下一阶段路线"段落

 ## 2026-06-05 设计补充：HWPOD Harness 单线程闭环与远景

@@ -149,21 +138,20 @@ HWLAB 2026-05 已经在 16666/16667 live 上跑通用户工作台、Code Agent

 ## 2026-06-05 关联补充：HWPOD Harness 概念体系

- 专门概念体系 issue：[#897](https://github.com/pikasTech/HWLAB/issues/897) `HWPOD Harness 概念体系与 v0.2 架构映射`。
- [#897](https://github.com/pikasTech/HWLAB/issues/897) 将 [#644](https://github.com/pikasTech/HWLAB/issues/644) 中的 HWPOD 方向从命名扩展为完整概念体系，详细定义 `hwpod`、`hwpodctl`、`hwpod-node`、Profile、Transport/Gateway、Harness Run、Evidence，以及它们和当前 v0.2 `device-pod-cli`、`cloud-api`、`hwlab-device-pod executor`、`hwlab-gateway`、`device-host-cli.mjs` 的对应关系。
+- 专门概念体系历史主题：`HWPOD Harness 概念体系与 v0.2 架构映射`。
+- 该历史主题将本阶段规格中的 HWPOD 方向从命名扩展为完整概念体系，详细定义 `hwpod`、`hwpodctl`、`hwpod-node`、Profile、Transport/Gateway、Harness Run、Evidence，以及它们和当前 v0.2 `device-pod-cli`、`cloud-api`、`hwlab-device-pod executor`、`hwlab-gateway`、`device-host-cli.mjs` 的对应关系。

-## 2026-06-05 修订：HWPOD Harness 以 [#897](https://github.com/pikasTech/HWLAB/issues/897) 最新四要素口径为准
+## 2026-06-05 修订：HWPOD Harness 以最新四要素口径为准

- [#897](https://github.com/pikasTech/HWLAB/issues/897) 已修订为核心业务概念体系：`hwpod` 是由 target device、workspace、debug probe、io probe 四个硬件研发要素组成的实体。
+- HWPOD Harness 概念体系已修订为核心业务概念体系：`hwpod` 是由 target device、workspace、debug probe、io probe 四个硬件研发要素组成的实体。
 - Profile 只作为记录/声明这四个要素的配置方式，不作为独立平级概念，也不是 hwpod 的四要素之一。
 - Code Agent / 用户运行时入口统一命名为 `hwpod-run`；管理入口统一命名为 `hwpod-ctl`；边缘执行节点统一命名为 `hwpod-node`。
- [#644](https://github.com/pikasTech/HWLAB/issues/644) 上方 2026-06-05 设计补充中的早期 `hwpod`/`hwpodctl`/Evidence 摘要只保留为讨论历史，后续实现和文档以 [#897](https://github.com/pikasTech/HWLAB/issues/897) 最新口径为准。
+- 本阶段规格上方 2026-06-05 设计补充中的早期 `hwpod`/`hwpodctl`/Evidence 摘要只保留为讨论历史，后续实现和文档以 HWPOD Harness 最新口径为准。

-## 2026-06-05 修订：HWPOD Harness 快速迭代阶段以 [#897](https://github.com/pikasTech/HWLAB/issues/897) 最新口径为准
+## 2026-06-05 修订：HWPOD Harness 快速迭代阶段以最新口径为准

- [#897](https://github.com/pikasTech/HWLAB/issues/897) 已更新为当前 HWPOD Harness 概念体系的权威 issue。
+- HWPOD Harness 概念体系已更新为当前快速迭代阶段的权威口径。
 - 快速迭代阶段先做 Code Agent workspace 内可完整自用、可随时自改进的 harness：`hwpod-spec`、`hwpod-cli`、`hwpod-ctl`、`hwpod-compiler-cli` 都放在 Code Agent workspace 内，以 skill/CLI 形态迭代。
 - `hwlab-api` 第一版只做 `hwpod-node-ops` 转发和结果返回，不承载 hwpod 业务翻译。
 - `hwpod-node` 只维护少量稳定 ops；原 `devicepod-gateway` / `hwlab-gateway` 迁移为 `hwpod-node` 内部 transport/gateway；原 `device-host-cli.mjs` 中的业务翻译迁移到 `hwpod-compiler-cli`，基础执行能力迁移到 `hwpod-node`。
- [#644](https://github.com/pikasTech/HWLAB/issues/644) 上方 2026-06-05 早期 `hwpod`/`hwpodctl`/`hwpod-run`/Profile/Evidence 摘要只保留为讨论历史，后续实现和文档以 [#897](https://github.com/pikasTech/HWLAB/issues/897) 最新口径为准。
-
+- 本阶段规格上方 2026-06-05 早期 `hwpod`/`hwpodctl`/`hwpod-run`/Profile/Evidence 摘要只保留为讨论历史，后续实现和文档以 HWPOD Harness 最新口径为准。
@@ -13,10 +13,10 @@

 使用原则：

- 业务需求规格用于使命和商业目标，利益相关方需求规格用于用户和运营方诉求，系统需求规格用于跨硬件、软件、人员和流程的系统级要求，软件需求规格用于软件能力要求，运行概念文档用于描述主要运行场景。
+- 业务需求规格用于使命和商业目标，利益相关方需求规格用于用户和运营方诉求，系统需求规格用于跨硬件、软件、人员和流程的系统级要求，软件需求规格用于软件能力要求。运行流程和一次性执行过程不进入需求规格正文，稳定概念优先沉淀为术语表。
 - HWLAB 的 L0、L1、L2 规格共用同一骨架，但粒度不同：L0 写使命、边界和全局需求；L1 写内部模块职责和验收边界；L2 写具体课题的交付物、阻塞项和验证计划。
- 规格正文只写稳定需求、边界、职责、验证和必要追踪关系；阶段报告、执行流水、长日志、拉取请求过程和一次性证据放到 GitHub 议题、阶段报告或证据索引中。
- 每条原子需求使用独立小节。信息表中必须包含主责、职责划分、验证入口、必需证据和接受标准；正文说明需求意图和边界。
+- 规格正文只写稳定需求、系统边界、外部输入输出、职责和必要追踪关系；内部治理、阶段报告、执行流水、长日志、拉取请求过程和一次性证据不进入需求规格正文。
+- 每条原子需求使用独立小节。信息表使用横向表格，必须包含编号、需求、主责模块和职责划分；正文只说明需求意图和边界，不重复需求句。

 ## 文档骨架

@@ -27,17 +27,9 @@

 | 版本 | 对应提交标识 | 更新日期 | 变更说明 |
 | --- | --- | --- | --- |
-| v0.1 | 待提交 | <年-月-日> | 创建需求规格。 |
+| v0.1 | 待提交 | <年-月-日> | 创建需求规格；如来自历史议题，只在这里写迁移来源 <组织>/<仓库>#<编号>。 |

-## 迁移来源
-
-| 字段 | 内容 |
-| --- | --- |
-| 原 GitHub 议题 | [#<编号>](https://github.com/<组织>/<仓库>/issues/<编号>) |
-| 原标题 | <标题> |
-| 原状态 | <打开或关闭> |
-| 原更新时间 | <时间戳> |
-| 原正文摘要标识 | <摘要标识> |
+未定稿前不新增版本号，不为单次编辑追加 `待提交` 版本；只有用户明确确认可以定稿时，才更新修改历史。

 ## 正文

@@ -50,14 +42,12 @@
 | 编号 | <项目编号> |
 | 短名 | <短名> |
 | 层级 | L0、L1 或 L2 |
-| 状态 | 有效、草案或归档 |
+| 状态 | 已生效、已废弃或未生效 |
 | 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](<相对路径>) |
 | 上级规格 | <相对路径链接；L0 可留空> |
-| 阶段规格 | <相对路径链接；不适用时留空> |
 | 规格治理索引 | <相对路径链接> |
-| 规格来源 | <项目管理路径、历史材料或 GitHub 议题> |

-本文采用 ISO/IEC/IEEE 29148 需求规格模板的项目裁剪版：正文只保留稳定使命、范围、运行概念、系统边界、内部模块或课题分工、原子需求和验证口径。编号、层级职责、回写、偏离判定和交叉引用治理由规格治理文档承载。
+本文采用 ISO/IEC/IEEE 29148 需求规格模板的项目裁剪版：正文只保留稳定使命、范围、术语、系统边界、内部模块或课题分工和原子需求。编号、层级职责、回写、偏离判定和交叉引用治理由规格治理文档承载。

 ## 2. 目的和范围

@@ -73,20 +63,24 @@

 - <非目标或转交范围>

-## 3. 运行概念
+## 3. 术语表

-1. <关键场景或运行步骤>
+| 术语 | 定义 |
+| --- | --- |
+| <术语> | <稳定定义> |

 ## 4. 系统边界和接口

-| 类别 | 内容 |
+本规格把目标对象作为一个完整系统看待；本章只描述外部输入、外部输出和系统边界，不描述内部治理流程。
+
+| 边界项 | 内容 |
 | --- | --- |
-| 用户入口 | <网页端、命令行、应用接口、开发工具包等> |
-| 上游系统 | <依赖来源> |
-| 下游系统 | <输出消费方> |
-| 验收入口 | <测试、演示、检查或分析入口> |
-| 长期文档 | <规格、计划、测试规格、阶段报告> |
-| 执行控制面 | <议题、拉取请求、跟踪记录、会话、任务、运行记录或案例登记> |
+| 外部使用者 | <用户、外部系统、管理员或自动化任务> |
+| 外部输入 | <用户请求、业务对象、资源约束、身份凭据、配置项或文件> |
+| 受控资源 | <系统管理的资源、数据、运行环境或外部设备> |
+| 外部输出 | <用户可获得的状态、结果、产物、通知、报告或记录> |
+| 用户接口 | <网页端、命令行、应用接口、开发工具包等> |
+| 系统边界 | <系统负责什么；明确不替代用户或外部系统负责什么> |

 ## 5. 内部分工与规格索引

@@ -98,19 +92,11 @@

 ### 6.1 <需求编号> <需求短名>

-| 字段 | 内容 |
-| --- | --- |
-| 编号 | <需求编号> |
-| 需求 | <系统或模块应当具备的能力或约束> |
-| 类型 | 功能、约束、支撑、接口或质量 |
-| 主责模块 | <相对路径链接或主责编号> |
-| 职责划分 | <主责负责什么；关联模块负责什么；哪些内容不属于本需求> |
-| 验证方法 | 测试、演示、检查或分析 |
-| 验证入口 | <命令行、网页端、应用接口、案例运行、跟踪记录等原入口> |
-| 必需证据 | <运行编号、跟踪编号、链接、日志摘要、报告链接等> |
-| 接受标准 | <可判定的完成标准> |
+| 编号 | 需求 | 主责模块 | 职责划分 |
+| --- | --- | --- | --- |
+| <需求编号> | <系统或模块应当具备的能力或约束> | <项目编号 短名，使用相对路径链接> | <主责负责什么；关联模块负责什么；哪些内容不属于本需求> |

-<正文说明该原子需求的意图、范围、边界和验收语义。正文不放执行流水和长证据。>
+<正文说明该原子需求的意图、范围和边界。正文不重复需求句，不放执行流水和长证据。>

 ## 7. 假设和风险