docs: migrate HWLAB specs to project management

2026-06-14 13:57:38 +00:00
parent 85bbc3cd3a
commit 37de91c653
16 changed files with 1367 additions and 35 deletions
@@ -1,23 +1,22 @@
 ---
 name: unidesk-oa
-description: UniDesk/HWLabOA 项目管理运行技能。用户提到 HWLabOA、OA 文档、总项目规格、总规划、重大项目/方向/课题/子课题层级、任务书、实施方案、测试规格、阶段报告、项目偏离，或通过 GitHub issue 层级树管理 HWLAB Cloud M1 / UniDesk / AgentRun 跨仓项目治理时使用。
+description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管理目录、HWLAB OA、总项目规格、总规划、重大项目/方向/课题/子课题层级、任务书、实施方案、测试规格、阶段报告、项目偏离，或通过 project-management 与 GitHub issue 管理 HWLAB Cloud M1 / UniDesk / AgentRun 跨仓项目治理时使用。
 ---

 # UniDesk OA

-使用本技能时，把 HWLAB Cloud M1 的项目管理稳定地锚定在总规格和相互链接的 GitHub issue 层级上。
+使用本技能时，把 HWLAB Cloud M1 的项目管理稳定地锚定在 UniDesk 仓库内的项目编号目录和相互链接的 GitHub issue 执行记录上。

 ## 仓库

- HWLabOA 真相源：`/root/HWLabOA`（从 `/root/unidesk` 看是 `../HWLabOA`），远端为 `git@github.com:notLabyet/HWLabOA.git`，分支为 `main`。
- UniDesk 控制/工具仓库：`/root/unidesk`，远端为 `git@github.com:pikasTech/unidesk.git`，分支为 `master`。
- 修改 HWLabOA 文档前，必须在 `/root/HWLabOA` 执行 `git status --short --branch` 和 `git pull --ff-only origin main`。
- 使用 UniDesk GitHub CLI 或修改本技能前，必须在 `/root/unidesk` 执行 `git status --short --branch` 和 `git pull --ff-only origin master`。
+- UniDesk 项目管理真相源：`/root/unidesk/project-management/PJ2026-01`，其中 `specs/PJ2026-01-HWLAB.md` 是 L0 总规格和项目索引，随 `pikasTech/unidesk` 的 `master` 分支版本化。
+- 迁移前 HWLabOA 仓库：`/root/HWLabOA` 只作为历史材料和对照来源，不再作为 HWLAB Cloud M1 规格真相源。
+- 使用 UniDesk GitHub CLI、修改本技能或修改项目管理文档前，必须在 `/root/unidesk` 执行 `git status --short --branch` 和 `git pull --ff-only origin master`。

 ## 运行模型

- 将 HWLabOA Markdown 视为长期规格真相源。
- 将 GitHub issue 视为执行控制面：层级、状态、讨论、跨仓引用、PR 链接和收口证据都在 issue 中流转。
+- 将 `project-management/PJ2026-01` 下的 Markdown 视为长期规格真相源。
+- 将 GitHub issue 视为执行控制面和历史讨论入口：状态、讨论、跨仓引用、PR 链接和收口证据可以在 issue 中流转，但规格正文不得只写在 issue 中。
 - 不要让日报或阶段报告成为总规划。阶段报告只总结相对总规格的移动，不能替代中心规划。
 - 当任务缺少上级方向、验收标准或原始验证入口时，先归类为规划/调查，不要直接变成实现任务。
 - L1 方向必须是直接服务 L0 使命的能力域。文档整理、阶段报告、项目管理机制、看板维护、技能维护、仓库名、工具名和临时执行路径都不能作为 L1 方向。
@@ -25,10 +24,10 @@ description: UniDesk/HWLabOA 项目管理运行技能。用户提到 HWLabOA、O

 ## HWLAB 标准 issue 锚点

- L0 总规格：`PJ2026-01`，`pikasTech/HWLAB#1194`（`HWLAB 总规格`）。
+- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`，历史 issue `pikasTech/HWLAB#1194`。
 - 长期导航面板：`pikasTech/HWLAB#645`（`HWLAB 长期总面板`）。这是面板，不是规格书。
- 当前 Cloud M1 阶段规格：`pikasTech/HWLAB#644`（`HWLAB Cloud SPEC / 云平台开发目标 20260601`）。这是阶段规格，不是 L1 方向。
- 创建或更新 HWLAB 项目管理 issue 时，非平凡 L1/L2/L3/L4 工作都要链接回 `#1194`，并保持 `#645` 只作为导航索引。
+- 当前 Cloud M1 阶段规格：`project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md`，历史 issue `pikasTech/HWLAB#644`。
+- 创建或更新 HWLAB 项目管理 issue 时，非平凡 L1/L2/L3/L4 工作都要链接回 `project-management/PJ2026-01` 中的对应规格文件，并保持 `#645` 只作为导航索引。
 - 所有管理 issue 和规格都使用 HWLAB 层级编号：项目编号格式为 `PJ<YYYY>-<path>`；`PJ` 表示项目，`2026` 是立项年份，HWLAB L0 是 `PJ2026-01`；L1 编号是 `PJ2026-0101`、`PJ2026-0102` 等；L2 继续追加两位，例如 `PJ2026-010102` 表示 HWLAB L1 第 1 个方向下的第 2 个 L2 课题。稳定节点短名通常控制在 8 个中文汉字以内，解释写在正文，不写进名称。

 ## 工作流
@@ -36,7 +35,7 @@ description: UniDesk/HWLabOA 项目管理运行技能。用户提到 HWLabOA、O
 1. 做规划类问题时，读取 `references/project-planning.md`。
 2. 创建或更新总规格、issue 正文时，读取 `references/templates.md`。
 3. 写入 GitHub issue/PR 评论时，同时使用 `unidesk-gh`；所有写入必须从 `/root/unidesk` 通过 `bun scripts/cli.ts gh ...` 完成。
-4. 修改长期 HWLabOA 项目文档时，把稳定规划内容放到总规格/规格文件，阶段报告只保留带日期的总结。
+4. 修改长期项目管理文档时，把稳定规划内容放到 `project-management/PJ2026-01` 的总规格/规格文件，阶段报告只保留带日期的总结。
 5. 修订 L1/L2 层级时，先按完成标准判断主责，再看实现表面。工具、CLI、Web、API 形态可以形成关联 L1，但主责 L1 必须是定义完成标准的能力域。

 ## 必需层级和职责
@@ -1,4 +1,4 @@
 interface:
  display_name: "UniDesk OA"
-  short_description: "管理 HWLabOA 总规格和 issue 层级。"
-  default_prompt: "使用本技能规划 HWLabOA 项目结构、总规格和相互链接的 GitHub issue 层级树。"
+  short_description: "管理 UniDesk 项目规格目录和 issue 层级。"
+  default_prompt: "使用本技能规划 project-management/PJ2026-01 项目结构、总规格和相互链接的 GitHub issue 执行记录。"
@@ -29,13 +29,13 @@ HWLAB Cloud M1 需要一个项目控制结构，避免局部 issue/PR 工作偏
 - 运行 trace、session、job ID。
 - 收口评论。

-不要把稳定需求的唯一副本放在 issue 评论里。长期有效的需求必须蒸馏到 HWLabOA，再从 issue 链接过去。
+不要把稳定需求的唯一副本放在 issue 评论里。长期有效的需求必须蒸馏到 `project-management/PJ2026-01`，再从 issue 链接过去。

 ## 当前 HWLAB issue 锚点

- L0 总规格：`PJ2026-01`，`pikasTech/HWLAB#1194`（`HWLAB 总规格`）。
+- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`。该规格文档本身承担索引职责；历史 issue 为 `pikasTech/HWLAB#1194`。
 - 长期面板/导航：`pikasTech/HWLAB#645`（`HWLAB 长期总面板`）。不要把它当成规格书。
- Cloud M1 阶段规格：`pikasTech/HWLAB#644`（`HWLAB Cloud SPEC / 云平台开发目标 20260601`）。这是阶段规格，不是 L1 方向。
+- Cloud M1 阶段规格：`project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md`。这是阶段规格，不是 L1 方向；历史 issue 为 `pikasTech/HWLAB#644`。
 - 新建或更新方向/课题/执行 issue 时，除非用户明确限定在 HWLAB Cloud M1 之外，否则正文应包含 `上级总项目: #1194`。

 ## 编号规则
@@ -47,24 +47,33 @@ HWLAB Cloud M1 需要一个项目控制结构，避免局部 issue/PR 工作偏
 - 不要因为优先级变化而重编号。新稳定节点追加新后缀；执行型 PR 或一次性 smoke 可以引用最近的稳定编号，不一定单独编号。
 - 稳定节点短名通常不超过 8 个中文汉字。issue 标题应以编号和短名开头，例如 `PJ2026-010102 频源造模`；详细解释写在正文。

-## 建议的 HWLabOA 结构
+## 建议的 UniDesk 项目管理结构

-HWLAB Cloud M1 的长期文档放在：
+HWLAB Cloud M1 的长期文档放在 UniDesk 仓库内，并使用项目编号命名目录：

 ```text
-/root/HWLabOA/Project Management/[EPIC001][HWLab][PRJ002][CLOUD-M1]/
+/root/unidesk/project-management/PJ2026-01/
 ```

 推荐文件：

 ```text
-SPEC-CLOUD-M1-MASTER.md          # L0 总规格和 issue 层级树索引
-SPEC-CLOUD-M1.md                 # 既有阶段材料，可以链接到 master 文件
-PLAN-CLOUD-M1-DIRECTIONS.md      # L1 方向实施方案，可选
-TEST-CLOUD-M1-VALIDATION.md      # 跨方向验收矩阵，可选
+specs/PJ2026-01-HWLAB.md                 # L0 总规格，同时作为项目索引
+specs/stage-cloud-spec-20260601.md       # 既有阶段材料
+specs/PJ2026-010N-*.md                   # L1 方向规格
+specs/spec-governance.md                 # 编号、层级、回写与偏离规则
+specs/current-center.md                  # 当前中心和非中心边界
+evidence/*.md                            # 迁出的长证据索引
 ```

-优先维护一个 master 文件。只有当 master 文件过大，或某个部分具有独立生命周期和评审需要时才拆分。
+优先维护 L0 总规格作为入口索引。只有当某个部分具有独立生命周期和评审需要时才拆分到 L1、治理、阶段或证据文件。
+
+每个长期规格文件最前面必须有修改历史表格，字段固定为：
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+
+版本号随稳定规格变更递增；对应 commit id 写入承载该版本内容的 Git commit；变更说明用一句话概括。

 ## L0-L4 规则

@@ -74,8 +83,8 @@ TEST-CLOUD-M1-VALIDATION.md      # 跨方向验收矩阵，可选

 | 层级 | 负责 | 不负责 | 回写到 |
 | --- | --- | --- | --- |
-| L0 | 使命、非目标、当前中心、L1 方向树、全局验收、偏离规则 | PR 细节、CaseRun 日志、日报流水、实现设计 | HWLabOA 总规格和 L1 issue |
-| L1 | 能力域范围、成功标准、L2 课题清单、原始验收类型 | 单个 PR、一次性 smoke、仓库/工具/运行面名称、项目管理动作 | L0 issue 和 HWLabOA |
+| L0 | 使命、非目标、当前中心、L1 方向树、全局验收、偏离规则 | PR 细节、CaseRun 日志、日报流水、实现设计 | `project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md` 和 L1 issue |
+| L1 | 能力域范围、成功标准、L2 课题清单、原始验收类型 | 单个 PR、一次性 smoke、仓库/工具/运行面名称、项目管理动作 | L0 规格和对应 L1 规格文件 |
 | L2 | 一个 L1 内的具体课题、交付物、阻塞项、验证计划 | 宽泛能力域或实现细节流水 | L1 issue，重大移动再回写 L0 |
 | L3 | 一个有界验收切片和单一验收路径 | 路线图、多课题计划、父级范围变化 | L2/L1 issue 并带证据 |
 | L4 | 具体执行：PR、CaseRun、smoke、部署、文档收口 | 新需求、新方向、验收规则变化 | 最近的 L3/L2/L1，并带原入口证据 |
@@ -5,6 +5,12 @@
 ```markdown
 # HWLAB 总规格

+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | <commit> | <YYYY-MM-DD> | <一句话变更说明> |
+
 编号: PJ2026-01
 短名: HWLAB

@@ -74,7 +80,7 @@
 短名: HWLAB
 上级面板: #645
 当前 L0 总规格: #1194
-总规格文档: <HWLabOA 路径或 GitHub URL>
+总规格文档: project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md

 ## 项目中心

@@ -99,8 +105,8 @@

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

 - 下级 issue 关闭时必须评论回写到对应 L1。
- L1 阶段完成时必须回写本 issue，并更新 HWLabOA 总规格。
+- L1 阶段完成时必须回写本 issue，并更新 `project-management/PJ2026-01` 中的对应规格文件。
 ```

 ## L1 方向 issue 正文
@@ -130,7 +136,7 @@
 编号: PJ2026-010N
 短名: <8字以内>
 上级总项目: #1194
-总规格文档: <HWLabOA 路径或 GitHub URL>
+总规格文档: project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md

 ## 主责边界

@@ -171,7 +177,7 @@
 ## 回写规则

 - 下级 L2/L3 完成后评论回写本 issue。
- 方向状态变化后更新 L0 issue 和 HWLabOA 总规格。
+- 方向状态变化后更新 L0 规格和对应 L1 规格文件。
 ```

 ## L2/L3 执行 issue 头部
@@ -186,7 +192,7 @@
 关联方向: <可空；只列交接方向，不替代主责>
 所属方向: #...
 所属课题: #...
-规格文档: <HWLabOA 路径或 URL>
+规格文档: project-management/PJ2026-01/specs/<对应规格文件>.md

 ## 目标

@@ -202,7 +208,7 @@

 - [ ] 评论回写所属课题
 - [ ] 评论回写所属方向
- [ ] 如稳定规则变化，更新 HWLabOA 总规格
+- [ ] 如稳定规则变化，更新 `project-management/PJ2026-01` 中的对应规格文件
 ```

 ## 阶段报告章节
@@ -0,0 +1,102 @@
+# Agent编排证据索引：Code Agent 与 AgentRun 基线归档
+
+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | 待提交 | 2026-06-14 | 从 pikasTech/HWLAB#1223 迁移到 UniDesk 项目管理目录。 |
+
+## 迁移来源
+
+| 字段 | 内容 |
+| --- | --- |
+| 原 issue | pikasTech/HWLAB#1223 |
+| 原标题 | Agent编排证据索引：Code Agent 与 AgentRun 基线归档 |
+| 原 URL | https://github.com/pikasTech/HWLAB/issues/1223 |
+| 原状态 | open |
+| 原更新时间 | 2026-06-14T13:22:33Z |
+| 原 body SHA | 7fd86b09fb503174cd14651eeb5af9dc5bfb38c9bbe734cd0245342f02d44192 |
+
+## 正文
+
+上级总项目: #1194
+所属方向: #1204 PJ2026-0102 Agent编排
+性质: 证据索引，不是 L1 方向，不是 L2 课题，不定义新的产品需求。
+迁出/整理时间: 2026-06-14（北京时间）
+
+## 使用规则
+
+- 本文档只保存 Agent编排相关的规格来源、AgentRun SPEC、历史 issue 和开放风险索引。
+- #1204 已迁移到 `project-management/PJ2026-01/specs/PJ2026-0102-agent-orchestration.md`，正文只保留稳定需求、边界、L2 分配、验证矩阵和追踪关系。
+- 当前 #1204 只保留两个 active L2：PJ2026-010201 任务生命周期、PJ2026-010202 资源装配。
+- 证据新增时更新本文档或对应 L2/L3 issue；只有稳定需求变化才回写规格文档。
+
+## 规格来源
+
+- L0 总规格: #1194，要求 Agent编排提供 Code Agent、AgentRun、workspace、session、provider profile、任务生命周期和任务恢复能力。
+- 阶段规格: #644，提出云端协同、多用户同时访问 Code Agent、远程协作 AI Coding、Code Agent 长程稳定性和 session resume。
+- HWLabOA: 迁移前 HWLabOA `SPEC-CLOUDE-M1.md`，作为迁移前来源材料。
+- AgentRun source truth: `G14:/root/agentrun-v01`，分支 `v0.1`，AGENTS.md 定义 AgentRun 是 UniDesk 与 HWLAB 的共享 Agent 执行基础设施。
+
+## AgentRun 长期 SPEC 来源
+
+- `docs/reference/spec-v01-hwlab-manual-dispatch.md`: HWLAB 作为业务 dispatcher，AgentRun 作为执行事实 authority；定义 `run + command + runner-job`、SessionRef、ResourceBundleRef、trace/result、cancel 和 HWLAB canary。
+- `docs/reference/spec-v01-runtime-assembly.md`: 定义 `BackendImageRef`、`ProfileRef`、`SessionRef`、`ResourceBundleRef` 四要素，禁止 credential、host path、prompt、skill 和 workspace 文件绕过装配模型。
+- `docs/reference/spec-v01-agentrun-mgr.md`: 定义 manager REST API、durable facts、command/run terminal 分离、result envelope、failureKind、session send 和 runner job 查询。
+- `docs/reference/spec-v01-agentrun-runner.md`: 定义 runner Job、claim/lease、同 run 多 command loop、SessionRef/PVC、ResourceBundle materialization、event normalization 和 redaction。
+- `docs/reference/spec-v01-backend-adapter.md`: 定义 Codex stdio adapter、profile 隔离、assistant/tool/output 事件归一、completed 判定和 failure mapping。
+- `docs/reference/spec-v01-provider-profile-management.md`: 定义 provider profile 管理、动态 slug、Secret/config 写入、validate canary 和 HWLAB 委托边界。
+- `docs/reference/spec-v01-queue.md`: 定义 AgentRun Queue 直接吸收旧 Code Queue，Queue 与 Session 分层，用户级 follow-up 走 Session。
+- `docs/reference/spec-v01-validation.md`: 定义真实运行面验收、短返回 JSON、terminal completed + 非空 reply、event pagination、cancel、SessionRef、ResourceBundleRef 和 bounded output。
+
+## HWLAB issue 历史索引
+
+| Issue | 状态 | 归属切片 | 结论 |
+| --- | --- | --- | --- |
+| #643 | closed | 任务生命周期 / 资源装配 | HWLAB v0.2 通过 adapter 接入 AgentRun v0.1，HWLAB 对外 API 不变，AgentRun 承接执行事实和运行装配。 |
+| #792 | closed | 任务生命周期 | 固化 HWLAB session 与 AgentRun run/job、providerProfile/backendProfile、project/workspace、runner lease 的 authority 边界；session/resume 属于生命周期。 |
+| #770 | closed | 任务生命周期 | per-session RWO PVC 直接挂载验证同 session/thread/PVC 跨 runner pod 删除后可继续。 |
+| #716/#723/#761/#812 | closed | 任务生命周期 | stale continuation、总超时、继续会话、sessionReuse 元数据等历史问题并入生命周期恢复语义。 |
+| #679/#1034/#1038/#1144/#1173 | mixed | 资源装配 | provider profile 从 MiniMax-M3/dfcx-go 到动态配置、权限、默认 Secret 缺口，归入 RuntimeAssembly/ProfileRef 装配。 |
+| #1045/#1129/#1130/#933 | mixed | 资源装配 | gitbundle source commit、Web/CaseRun 工具包同步、手动刷新和 CI/GitOps source 对齐形成 ResourceBundle/source truth 需求。 |
+| #1189 | open | 任务生命周期 | v0.3 trace 卡在 runner-job-created、真实 tool/stdout 不可见，要求生命周期状态、result pointer 与 runnerjob/liveness 一致。 |
+| #1146 | open | 任务生命周期 / 资源装配 | 计费链路成功后 AgentRun 执行 FailedToOpenSocket，说明执行层失败必须与用户账本分离，并检查 provider/profile 装配。 |
+| #1197 | open | 任务生命周期 | CaseRun timeout 后 AgentRun claimed、trace raw error/rendered running 不一致，要求 timeout/cancel/terminal 语义统一。 |
+| #1129 | open | 资源装配 | CaseRun 与 Web v0.2 使用同类 gitbundle，但 live Web source commit 可能落后，需要暴露 materialized commit。 |
+
+## AgentRun issue 历史索引
+
+| Issue | 状态 | 归属切片 | 结论 |
+| --- | --- | --- | --- |
+| pikasTech/agentrun#28 | open | 资源装配 | backend image、profile、session、初始资源统一装配调研，后续沉淀到 RuntimeAssembly 和 provider profile 管理 SPEC。 |
+| pikasTech/agentrun#31/#36 | mixed | 任务生命周期 / 资源装配 | 按 HWLAB v0.2 基线补齐 AgentRun 自身能力，确认 run/command/runner-job、result、cancel、SessionRef、ResourceBundleRef 和 failureKind。 |
+| pikasTech/agentrun#79 | closed | 资源装配 | ResourceBundleRef `promptRefs` 与 gitbundle skill registry 已在 live AgentRun v0.1 验证，resume 后不重复注入 initial prompt。 |
+| pikasTech/agentrun#84 | closed | 任务生命周期 | 异步 subagent Session 控制面与 CLI 跑通，session 默认视图、trace/output/read/cancel 建立，归入生命周期。 |
+| pikasTech/agentrun#97 | closed | 资源装配 | `workspaceFiles` 支持 bounded UTF-8 seed file，CaseRun 可在 Agent 启动前放置 run-local spec。 |
+| pikasTech/agentrun#118 | closed | 资源装配 / 平台交接 | runner 支持 G14 egress proxy 与真实 upstream source 获取，保留 NO_PROXY 和 Secret redaction 边界。 |
+| pikasTech/agentrun#166 | closed | 任务生命周期 | timeout 改为空闲超时，持续输出时不按 wall-clock hard timeout 切断；恢复建议走同 session 续跑。 |
+| pikasTech/agentrun#172 | open | 任务生命周期 | runnerjob phase/pod identity 可能与 run events/liveness 不一致，要求 describe run/session/runnerjob 语义统一。 |
+| pikasTech/agentrun#179 | open | 资源装配 / 平台交接 | AgentRun v0.2 计划用 PK01 PostgreSQL 作为唯一 durable state，验证无状态服务和 HWLAB v0.3 内网接入。 |
+
+## 证据到 #1204 L2 的映射
+
+| #1204 active L2 | 主要证据 |
+| --- | --- |
+| PJ2026-010201 任务生命周期 | #643、#792、#770、#716、#723、#761、#812、#1146、#1189、#1197、agentrun#31/#36/#84/#166/#172、`spec-v01-hwlab-manual-dispatch.md`、`spec-v01-agentrun-mgr.md`、`spec-v01-agentrun-runner.md`、`spec-v01-validation.md` |
+| PJ2026-010202 资源装配 | #643、#679、#917、#1034、#1038、#1045、#1129、#1130、#1144、#1173、agentrun#28/#31/#36/#79/#97/#118/#179、`spec-v01-runtime-assembly.md`、`spec-v01-provider-profile-management.md`、`spec-v01-backend-adapter.md`、`spec-v01-agentrun-runner.md` |
+
+## 概念合并去向
+
+| 原概念 | 当前归属 | 说明 |
+| --- | --- | --- |
+| 会话恢复 | PJ2026-010201 任务生命周期 | continuation、resume、session send、runner replacement 是任务生命周期恢复语义。 |
+| 结果归档 | PJ2026-010201 任务生命周期；评价/展示/长期存储分别交接 #1205/#1206/#1208 | Agent编排只保留 result/trace/artifact pointer、failureKind、lastSeq 等生命周期证据。 |
+| 工作区 | PJ2026-010202 资源装配；WebUI 工作区体验交接 #1206；硬件/资源状态交接 #1203/#1208 | workspace materialization、workspaceFiles、seed file 和 source commit 是资源装配输入证明。 |
+| 模型配置 | PJ2026-010202 资源装配 | provider profile、backendProfile、model、auth/config SecretRef 是 RuntimeAssembly/ProfileRef 装配项。 |
+
+## 回写规则
+
+- 新增 AgentRun SPEC、HWLAB issue 或 AgentRun issue 证据时，优先更新本文档。
+- 如果证据改变 Agent编排需求、L2 划分、验收标准或 authority 边界，再回写 #1204 对应规格文件。
+- 如果证据只说明单次失败、PR、PipelineRun、runtime 验证或 provider 事故，不直接写入规格正文。
+
@@ -0,0 +1,61 @@
+# 硬件池证据索引：HWPOD 与 CaseRun 基线归档
+
+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | 待提交 | 2026-06-14 | 从 pikasTech/HWLAB#1216 迁移到 UniDesk 项目管理目录。 |
+
+## 迁移来源
+
+| 字段 | 内容 |
+| --- | --- |
+| 原 issue | pikasTech/HWLAB#1216 |
+| 原标题 | 硬件池证据索引：HWPOD 与 CaseRun 基线归档 |
+| 原 URL | https://github.com/pikasTech/HWLAB/issues/1216 |
+| 原状态 | open |
+| 原更新时间 | 2026-06-14T13:09:08Z |
+| 原 body SHA | fb361115887931afe355c87ddcfd34ab166f9e9cd1aeef66296e37c7f1e7d2a2 |
+
+## 正文
+
+上级总项目: #1194
+主责方向: #1203 PJ2026-0101 硬件池
+性质: 证据索引，不是 L2 课题，不重新定义硬件池范围。
+迁出来源: #1203 旧版“CaseRun 验证证据 / 当前基线证据”正文
+迁出时间: 2026-06-14（北京时间）
+
+## 使用规则
+
+- 本文档 只保存长证据索引、CaseRun registry 路径、trace、runId、jobId 和关键读数摘要。
+- L1/L2 规格正文只引用本文档，不展开长证据。
+- 新增证据时优先追加评论，避免反复整篇替换。
+- 证据可以支撑验收，但不能替代 #1203 的需求、边界和验证矩阵。
+- 业务 pass/fail、aggregate、训练反馈归 #1205 HarnessRL；本文档 只记录硬件事实和原始证据入口。
+- 支撑 L2 必须使用 #1203 原定 4 个 L2：PJ2026-010101 HWPOD标准、PJ2026-010102 HWPOD工具、PJ2026-010103 HWPOD服务、PJ2026-010104 AI网关。
+
+## HWPOD / CaseRun 基线证据
+
+| 能力 | 证据入口 | 关键证据 | 支撑 L2 |
+| --- | --- | --- | --- |
+| D601-F103 compile-only 基线 | case registry `d601-f103-v2-compile/issue968-postmerge-v02-20260606022031`；`d601-f103-v2-compile/issue992-summary-20260606-082818` | `status=succeeded`、`compileOnly=true`、Keil job `20260606_102030_0ddb720f`、`downloadSkipped=true`；隔离 subject worktree、trace `trc_case_d601-f103-v2-compile_e781775c67fd4a09bf29eae76a790ec7`、HWPOD build command 和 post-agent compile check | PJ2026-010101 HWPOD标准、PJ2026-010102 HWPOD工具 |
+| D601-F103 build/download/UART 链路 | case registry `d601-f103-v2-main-marker-download-uart/issue1020-case2-r7-20260606-172930`；`d601-f103-v2-main-marker-download-uart-20260607052350-41954c34` | stage kinds `spec-validate, inspect, workspace-edit, build, download, uart-read`；trace `trc_case_d601-f103-v2-main-marker-download-uart_34ab5dff913a4eb09a8cdd4bd131d9a9`；后续 run 继续记录 build/download/uart-read 原入口 | PJ2026-010102 HWPOD工具、PJ2026-010104 AI网关 |
+| D601-F103 Arm2D 运行态 | case registry `d601-f103-v2-arm2d-stage-d/issue1077-stage-d-nosteer-20260609-131740` | HWPOD spec/inspect、workspace 读写、Keil build job `20260609_212320_42aa804f` rc=0/warnings=0、download job `20260609_212343_b81a7a86` completed/Verify OK/Application running、UART read；同时暴露 probe mismatch 风险，跟踪 #1092 | PJ2026-010102 HWPOD工具、PJ2026-010104 AI网关 |
+| ConStart 71-FREQ build | case registry `constart-71freq-build/constart-71freq-build-20260613150339-9bd9a5ef` | `caseRun=completed; agent=completed; command=completed; postValidation=completed rc=0 warnings=0`；trace `trc_case_constart-71freq-build_17bf45bec2aa4a7cb1aa1215b5ae6551`；验证 mono repo workspace、submodule `5ef2fc874782713d1e4752636a8db05cc4a18cd2`、`hwpod-ctl spec validate`、`hwpod inspect`、`hwpod build` 和 post-agent compile check | PJ2026-010101 HWPOD标准、PJ2026-010102 HWPOD工具、PJ2026-010103 HWPOD服务 |
+| PLC AO/ioProbe 硬件闭环 | #1178、#1181、#1182、#1183、#1184、#1185；case registry `constart-71freq-ao-ioprobe-repair/constart-71freq-ao-ioprobe-repair-20260614052517-641c9492` | `caseRun=completed; agent=completed; command=completed; postValidation=completed rc=0 warnings=0`；trace `trc_case_constart-71freq-ao-ioprobe-repair_9f25ef24dfd6410ab64396cf1195d51b`；registry commit `82b04f1`；外部 41 AI0 读数：4000uA -> 3.998754mA，8000uA -> 7.998794mA，12000uA -> 11.995110mA，20000uA -> 19.964974mA，恢复 4000uA 后约 3.998mA | PJ2026-010102 HWPOD工具、PJ2026-010104 AI网关 |
+| PLC 真实频率源扩展 | #1186 | 真实频率源端到端扩展仍 open，作为 ioProbe 与 HarnessRL 的交叉下一步 | PJ2026-010104 AI网关，关联 #1205 |
+
+## 已知证据阅读限制
+
+| Issue | 说明 | 支撑 L2 |
+| --- | --- | --- |
+| #1196 | HWPOD commandExecution trace 主阅读区仍有 wrapper JSON 噪声，影响阅读但不改变硬件事实。 | PJ2026-010103 HWPOD服务 |
+| #1197 | CaseRun timeout 后 AgentRun claimed / trace raw error / rendered running 状态不一致，影响超时收口判断。 | PJ2026-010103 HWPOD服务 |
+| #1200 | `641c9492` run 的 `final-response.md` 截断但 `present=true`；该 run 的硬件闭环证据以 `aggregate.md`、`agent-transcript.md`、trace 和 registry commit 为准。 | 关联 #1205 HarnessRL，不改变硬件池 L2 划分 |
+
+## 回写规则
+
+- 新证据追加到本文档 评论，或在对应 L2/L3 issue 收口评论中引用本文档。
+- 需求、边界或验收口径变化回写 #1203；业务评价变化回写 #1205。
+- 不得在本证据索引中新增或重命名硬件池 L2；L2 划分以 #1203 的 4 个原定 L2 为准。
+
@@ -0,0 +1,166 @@
+# PJ2026-01 HWLAB 总规格
+
+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | 待提交 | 2026-06-14 | 从 pikasTech/HWLAB#1194 迁移到 UniDesk 项目管理目录。 |
+
+## 迁移来源
+
+| 字段 | 内容 |
+| --- | --- |
+| 原 issue | pikasTech/HWLAB#1194 |
+| 原标题 | PJ2026-01 HWLAB 总规格 |
+| 原 URL | https://github.com/pikasTech/HWLAB/issues/1194 |
+| 原状态 | open |
+| 原更新时间 | 2026-06-14T12:53:55Z |
+| 原 body SHA | 4868729f6e33eec813713e810700b510847164d799373edf01c8ff50126a04b6 |
+
+## 项目规格索引
+
+| 层级 | 文件 | 历史 issue |
+| --- | --- | --- |
+| 阶段规格 | [stage-cloud-spec-20260601.md](stage-cloud-spec-20260601.md) | pikasTech/HWLAB#644 |
+| L0 总规格 | [PJ2026-01-HWLAB.md](PJ2026-01-HWLAB.md) | pikasTech/HWLAB#1194 |
+| L1 硬件池 | [PJ2026-0101-hardware-pool.md](PJ2026-0101-hardware-pool.md) | pikasTech/HWLAB#1203 |
+| L1 Agent编排 | [PJ2026-0102-agent-orchestration.md](PJ2026-0102-agent-orchestration.md) | pikasTech/HWLAB#1204 |
+| L1 HarnessRL | [PJ2026-0103-harness-rl.md](PJ2026-0103-harness-rl.md) | pikasTech/HWLAB#1205 |
+| L1 客户端 | [PJ2026-0104-client.md](PJ2026-0104-client.md) | pikasTech/HWLAB#1206 |
+| L1 用户管理 | [PJ2026-0105-user-management.md](PJ2026-0105-user-management.md) | pikasTech/HWLAB#1207 |
+| L1 平台运维 | [PJ2026-0106-platform-ops.md](PJ2026-0106-platform-ops.md) | pikasTech/HWLAB#1208 |
+| 治理规则 | [spec-governance.md](spec-governance.md) | pikasTech/HWLAB#1217 |
+| 当前中心 | [current-center.md](current-center.md) | pikasTech/HWLAB#1218 |
+| 硬件池证据 | [../evidence/hardware-pool-evidence.md](../evidence/hardware-pool-evidence.md) | pikasTech/HWLAB#1216 |
+| Agent编排证据 | [../evidence/agent-orchestration-evidence.md](../evidence/agent-orchestration-evidence.md) | pikasTech/HWLAB#1223 |
+
+## 正文
+
+## PJ2026-01 HWLAB 总项目需求规格
+
+## 1. 文档控制
+
+| 字段 | 内容 |
+| --- | --- |
+| 编号 | PJ2026-01 |
+| 短名 | HWLAB |
+| 层级 | L0 总项目 |
+| 状态 | active / L0 需求规格锚点 |
+| 长期面板 | #645 HWLAB 长期总面板 |
+| 阶段规格 | #644 HWLAB Cloud SPEC / 云平台开发目标 20260601 |
+| 阶段中心索引 | #1218 HWLAB 当前中心索引：阶段主线与非中心边界 |
+| 规格治理索引 | #1217 HWLAB 规格治理索引：编号、层级、回写与偏离规则 |
+| L1 划分 | 保持现有六方向：#1203、#1204、#1205、#1206、#1207、#1208 |
+| 规格来源 | `project-management/PJ2026-01` 与迁移前 HWLabOA 阶段材料 |
+
+本文采用中文 L0 需求规格模板：正文只保留稳定使命、范围、运行概念、系统边界、L1 分配、全局原子需求、验证矩阵和追踪关系。编号规则、层级职责、回写、偏离判定和交叉引用治理迁入 #1217；阶段主线和非中心边界迁入 #1218。
+
+## 2. 目的和范围
+
+### 2.1 项目使命
+
+HWLAB 的中心目标是把真实硬件资源、Agent 执行、Harness/RL 验收反馈、多客户端入口、多用户运营和平台自动化运维收敛为一个云端硬件研发平台。平台必须服务真实硬件研发闭环：用户或训练任务通过客户端/API 提出需求，Agent 在受控 workspace 中执行，通过硬件池触达真实设备，由 HarnessRL 收集可审计 evidence，并把成功路径、失败分类和训练反馈回流为可复用能力。
+
+### 2.2 范围内
+
+- 真实硬件资源池：板卡、probe、HWPOD 节点、设备注册、占用、健康、可用性和原始硬件事实。
+- Agent 执行编排：Code Agent、AgentRun、workspace、session、provider profile、任务生命周期和任务恢复。
+- 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 范围外
+
+- 无 L1 主责归属的孤立工具美化、旧门禁修补或无原入口验收的观测增强。
+- 单个 PR、一次 CaseRun、一次 smoke、一次部署或阶段报告流水；这些属于 L3/L4 或报告，不属于 L0 需求规格正文。
+- 具体实现设计、代码结构、临时运行面调试路径、原始日志堆叠和每日进展统计。
+- 编号、回写、偏离和管理流程全文；这些由 #1217 承载。
+- 当前阶段优先级和阶段主线全文；这些由 #1218 和 #644 承载。
+
+## 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. 平台运维保证代码、配置、密钥、发布、运行观测和资源清理可控、可追踪、可恢复。
+
+## 4. 系统边界和接口
+
+| 类别 | 内容 |
+| --- | --- |
+| 用户入口 | 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 证据 |
+
+## 5. L1 方向树
+
+L1 划分保持现有六方向；本次整理不新增、不删除、不重命名 L1。
+
+| 编号 | 短名 | L1 规格 issue | 主责 | 上游依赖 | 下游支撑 |
+| --- | --- | --- | --- | --- | --- |
+| PJ2026-0101 | 硬件池 | #1203 | 板卡、探针、HWPOD node、设备注册、资源占用、设备健康、可用性 | #1208 平台运维 | #1204 Agent编排、#1205 HarnessRL、#1206 客户端 |
+| PJ2026-0102 | Agent编排 | #1204 | Code Agent、AgentRun、workspace、session、provider profile、任务生命周期、任务恢复 | #1203 硬件池、#1208 平台运维、#1207 用户管理 | #1205 HarnessRL、#1206 客户端 |
+| PJ2026-0103 | HarnessRL | #1205 | harness、CaseRun、ioProbe、evidence、评估、回放、训练反馈、RL 闭环 | #1203 硬件池、#1204 Agent编排、#1208 平台运维 | #1206 客户端、#1207 用户管理 |
+| PJ2026-0104 | 客户端 | #1206 | Web、CLI、HTTP API、SDK/IDE 插件、webhook、公开文档、兼容性、用户任务入口与结果获取 | #1207 用户管理、#1204 Agent编排、#1203 硬件池、#1205 HarnessRL、#1208 平台运维 | 用户入口和集成调用 |
+| PJ2026-0105 | 用户管理 | #1207 | 用户、注册登录、权限、API key、credit、usage、billing、admin、租户隔离 | #1206 客户端、#1204 Agent编排、#1205 HarnessRL、#1208 平台运维 | #1206 客户端、#1204 Agent编排、#1203 硬件池、#1205 HarnessRL |
+| PJ2026-0106 | 平台运维 | #1208 | CI/CD、git mirror、YAML-first、Secret 下发、rollout、observability、GC、平台发布 | 全部 L1 的发布/配置/观测需求 | #1203 硬件池、#1204 Agent编排、#1205 HarnessRL、#1206 客户端、#1207 用户管理 |
+
+## 6. 全局原子需求
+
+| ID | 需求 | 类型 | 主责 L1 | 验证方法 |
+| --- | --- | --- | --- | --- |
+| HWLAB-L0-REQ-001 | HWLAB 应提供真实硬件资源池，使任务能发现、分配、占用、释放并验证真实设备、probe、HWPOD node 和健康状态。 | 功能 | #1203 硬件池 | 测试、演示 |
+| HWLAB-L0-REQ-002 | HWLAB 应提供 Agent 执行编排，使用户任务能进入受控 workspace/session/provider/runtime，并能跟踪、恢复、取消和归档结果。 | 功能 | #1204 Agent编排 | 测试、演示 |
+| HWLAB-L0-REQ-003 | HWLAB 应提供 Harness/RL 验收闭环，使真实硬件任务产出可审计 evidence、aggregate、评估、回放和训练反馈。 | 功能 | #1205 HarnessRL | 测试、检查 |
+| HWLAB-L0-REQ-004 | HWLAB 应提供统一客户端入口，使 Web、CLI、API、SDK/IDE plugin 和 Webhook 围绕同一任务模型、权限模型和结果模型协同演进。 | 功能 | #1206 客户端 | 测试、演示 |
+| HWLAB-L0-REQ-005 | HWLAB 应提供多用户与运营管理，使身份、权限、API key、credit、usage、billing、admin 和租户隔离具有统一真相。 | 功能 | #1207 用户管理 | 测试、检查 |
+| HWLAB-L0-REQ-006 | HWLAB 应提供平台交付与运维能力，使代码、配置、密钥、发布、入口、观测和清理通过受控入口维护。 | 支撑 | #1208 平台运维 | 检查、演示 |
+| HWLAB-L0-REQ-007 | HWLAB 的用户可见能力关闭前必须经过真实入口验收；源码检查、PR 合并或构建通过不能单独作为关闭依据。 | 约束 | 全部 L1 | 检查 |
+| HWLAB-L0-REQ-008 | HWLAB 的下级工作必须且只能有一个主责 L1；跨方向支撑通过关联方向和回写表达，不重复建树。 | 约束 | 全部 L1 | 检查 |
+| HWLAB-L0-REQ-009 | HWLAB 的稳定需求、验证标准和长期结论应沉淀到 `project-management/PJ2026-01` 的对应规格文件；阶段报告和执行流水不得替代规格。 | 约束 | 全部 L1 | 检查 |
+
+## 7. 全局验证矩阵
+
+| 需求 ID | 方法 | 原入口 | 必需证据 | 接受标准 |
+| --- | --- | --- | --- | --- |
+| HWLAB-L0-REQ-001 | 测试/演示 | HWPOD 工具、HWPOD 服务、AI 网关、CaseRun | hwpod-id、spec、node health、probe、lease、raw hardware evidence | 真实设备可被发现、绑定、执行、释放和审计。 |
+| HWLAB-L0-REQ-002 | 测试/演示 | Web/CLI/API 提交 Agent 任务、AgentRun trace/result | runId、sessionId、workspace、provider profile、trace、artifact/result pointer | 任务生命周期可跟踪，异常可恢复或明确失败。 |
+| HWLAB-L0-REQ-003 | 测试/检查 | CaseRun/Harness/ioProbe/replay | caseId、runId、traceId、aggregate、ioProbe samples/stats、evaluation/replay 输出 | evidence 可审计、可复验、可用于训练反馈。 |
+| HWLAB-L0-REQ-004 | 测试/演示 | Cloud Web、hwlab-cli、HTTP API、SDK/Webhook sample | Web smoke、CLI smoke、API response、SDK/Webhook 示例 | 多客户端行为和错误语义一致。 |
+| HWLAB-L0-REQ-005 | 测试/检查 | user-billing / auth / API key / usage / admin API | session、API key 摘要、preflight、usage record、credit ledger、admin 操作记录 | 用户和运营真相统一且可审计。 |
+| HWLAB-L0-REQ-006 | 检查/演示 | 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-007 | 检查 | L1/L2/L3/L4 收口评论 | 原入口命令、lane/node、trace/session/job/run/URL、结果摘要 | 关闭证据来自真实入口。 |
+| HWLAB-L0-REQ-008 | 检查 | issue 正文和回写评论 | 主责方向、关联方向、回写对象 | 每个非平凡工作只有一个主责 L1。 |
+| HWLAB-L0-REQ-009 | 检查 | 项目管理规格文件、历史 issue、阶段报告链接 | 长期规格链接、报告链接、issue 引用 | 稳定需求不只存在于评论或日报中。 |
+
+## 8. 追踪关系
+
+| L0 需求 | 主责 L1 | 关联 L1 | 规格 issue |
+| --- | --- | --- | --- |
+| HWLAB-L0-REQ-001 | PJ2026-0101 硬件池 | Agent编排、HarnessRL、客户端、平台运维 | #1203 |
+| HWLAB-L0-REQ-002 | PJ2026-0102 Agent编排 | 硬件池、HarnessRL、客户端、用户管理、平台运维 | #1204 |
+| HWLAB-L0-REQ-003 | PJ2026-0103 HarnessRL | 硬件池、Agent编排、客户端、用户管理、平台运维 | #1205 |
+| HWLAB-L0-REQ-004 | PJ2026-0104 客户端 | 用户管理、Agent编排、硬件池、HarnessRL、平台运维 | #1206 |
+| HWLAB-L0-REQ-005 | PJ2026-0105 用户管理 | 客户端、Agent编排、HarnessRL、硬件池、平台运维 | #1207 |
+| HWLAB-L0-REQ-006 | PJ2026-0106 平台运维 | 全部 L1 | #1208 |
+| HWLAB-L0-REQ-007 | 全部 L1 | #1217 治理索引 | #1203-#1208 |
+| HWLAB-L0-REQ-008 | 全部 L1 | #1217 治理索引 | #1203-#1208 |
+| HWLAB-L0-REQ-009 | 全部 L1 | 项目管理规格文件、#1217、#1218、#644、#645 | #1194、#1203-#1208 |
+
+## 9. 引用和变更规则
+
+- L1 划分变化必须更新本文档；本次整理未改变 L1 划分。
+- 编号、层级、主责、回写、偏离和交叉引用治理规则见 #1217。
+- 当前阶段主线、非中心边界和阶段计划见 #1218 与 #644。
+- 长期导航见 #645；#645 不替代本规格。
+- 单次执行证据、CaseRun 日志、PR 流水和阶段报告不得堆入本规格正文，应写入对应 L1/L2/L3/L4 issue、证据索引或项目管理阶段报告。
+- 稳定规格最终应沉淀到 `project-management/PJ2026-01`；issue 保留执行状态、讨论、证据链接和交叉引用。
@@ -0,0 +1,160 @@
+# PJ2026-0101 硬件池
+
+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | 待提交 | 2026-06-14 | 从 pikasTech/HWLAB#1203 迁移到 UniDesk 项目管理目录。 |
+
+## 迁移来源
+
+| 字段 | 内容 |
+| --- | --- |
+| 原 issue | pikasTech/HWLAB#1203 |
+| 原标题 | PJ2026-0101 硬件池 |
+| 原 URL | https://github.com/pikasTech/HWLAB/issues/1203 |
+| 原状态 | open |
+| 原更新时间 | 2026-06-14T12:46:46Z |
+| 原 body SHA | dd5222a909f7259076124d89fcc532fb8a00c0014e9120a65d023cb768857cf4 |
+
+## 正文
+
+## PJ2026-0101 硬件池需求规格
+
+## 1. 文档控制
+
+| 字段 | 内容 |
+| --- | --- |
+| 编号 | PJ2026-0101 |
+| 短名 | 硬件池 |
+| 层级 | L1 方向 |
+| 上级总项目 | #1194 PJ2026-01 HWLAB 总规格 |
+| 关联方向 | #1204 Agent编排、#1205 HarnessRL、#1206 客户端、#1208 平台运维 |
+| 证据索引 | #1216 硬件池证据索引：HWPOD 与 CaseRun 基线归档 |
+| 规格状态 | active / issue 规格锚点 |
+| 核对时间 | 2026-06-14 北京时间 |
+| 主要运行面 | HWLAB v0.2，G14 runtime，D601/外部硬件节点 |
+
+本文采用中文 L1 需求规格模板：正文只保留稳定需求、边界、原定 L2 分配、验证矩阵和追踪关系；CaseRun 流水、阶段报告、具体 bug 排查和单次证据不在本文展开，长证据统一迁入 #1216 或下级 L2/L3 issue。
+
+## 2. 目的和范围
+
+### 2.1 目的
+
+硬件池方向负责把真实硬件资源抽象成可被 Agent、CaseRun、Harness 和客户端稳定引用的资源池。它必须保证 HWPOD 标准、工具入口、服务端资源管理和 AI 网关真实硬件执行链路可审计、可分配、可验证。
+
+### 2.2 范围内
+
+- HWPOD-SPEC、硬件资源身份、能力模型、AI 网关接入标准、操作能力标准、状态/错误语义和验收基线。
+- `hwpod-ctl`、HWPOD-SPEC 新建/修改/校验，以及 compile、download、filesystem、UART、board-comm、ioProbe 等工具侧操作入口。
+- 服务端 HWPOD 注册、管理、状态、权限/租约、请求接收、路由、结果归档和工具请求转发。
+- AI 网关节点侧能力：PC 客户端形态、硬件网关盒子形态、心跳、命令执行、日志/artifact/IO 回传和适配器执行。
+
+### 2.3 范围外
+
+- Agent 任务生命周期、session/resume、provider profile 和调度策略，归 #1204。
+- CaseRun pass/fail、aggregate、评估、回放和训练反馈，归 #1205。
+- Web/CLI/API/SDK 的通用用户入口体验和展示契约，归 #1206。
+- 用户账号、API key、credit、usage、billing 和租户策略，归 #1207。
+- CI/CD、GitOps、Secret、public exposure 和 runtime 运维发布，归 #1208。
+
+## 3. 运行概念
+
+1. 用户、Agent 或 CaseRun 以 `hwpod-id` 请求硬件能力。
+2. `HWPOD标准` 定义资源身份、能力声明、网关接入和状态/错误语义。
+3. `HWPOD工具` 在用户/Agent workspace 内提供 spec validate、inspect、build、download、filesystem、UART、board-comm 和 ioProbe 等操作入口。
+4. `HWPOD服务` 接收工具侧请求，完成注册状态、权限/租约、路由、请求转发和结果归档。
+5. `AI网关` 靠近真实硬件执行命令，回传日志、artifact、probe、UART、board-comm 和 ioProbe 原始证据。
+6. HarnessRL 消费这些原始硬件证据形成 aggregate、pass/fail、回放和训练反馈；硬件池不替代 HarnessRL 做评分。
+
+## 4. 系统边界和接口
+
+| 类别 | 内容 |
+| --- | --- |
+| 输入 | HWPOD spec、workspace、node registry、probe UID、ioProbe endpoint、操作请求、可选资源租约 |
+| 输出 | 设备可用性、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 |
+
+## 5. 原子需求
+
+| ID | 需求 | 类型 | 来源 | 分配 L2 | 验证方法 |
+| --- | --- | --- | --- | --- | --- |
+| HWPOD-L1-REQ-001 | 硬件池应定义 HWPOD-SPEC，用于描述硬件资源身份、能力模型、AI 网关接入、操作能力和状态/错误语义。 | 功能 | #1194 / #1203 | PJ2026-010101 HWPOD标准 | 检查 |
+| HWPOD-L1-REQ-002 | 硬件池应为每个可用硬件资源维护稳定的 `hwpod-id`、HWPOD spec 和 source-of-truth 路径。 | 功能 | #1203 | PJ2026-010101 HWPOD标准 | 检查、测试 |
+| HWPOD-L1-REQ-003 | HWPOD 工具应支持 HWPOD-SPEC 新建、修改、校验、inspect，以及 compile、download、filesystem、UART、board-comm、ioProbe 等操作入口。 | 功能 | #1203 | PJ2026-010102 HWPOD工具 | 测试 |
+| HWPOD-L1-REQ-004 | HWPOD 工具应优先使用 HWLAB runtime API authority，并在存在 override 时暴露来源，避免遗留环境变量误路由。 | 约束 | #1091 | PJ2026-010102 HWPOD工具 | 测试、检查 |
+| HWPOD-L1-REQ-005 | HWPOD 服务应支持服务端资源注册、管理、状态查询、必要权限/租约、请求接收、路由和结果归档。 | 功能 | #1203 | PJ2026-010103 HWPOD服务 | 测试、检查 |
+| HWPOD-L1-REQ-006 | 当存在并发或多用户使用时，HWPOD 服务应在执行前完成占用、冲突检测、租约释放和超时安全收口。 | 功能/安全 | #1194 | PJ2026-010103 HWPOD服务 | 测试、演示 |
+| HWPOD-L1-REQ-007 | AI 网关应暴露节点心跳、健康、inventory、命令执行、日志/artifact/IO 回传和适配器执行能力。 | 功能 | #1203 | PJ2026-010104 AI网关 | 演示、检查 |
+| HWPOD-L1-REQ-008 | 当 download/debug 请求包含 probe 约束时，AI 网关或其适配器应验证请求 probe 与项目绑定一致；不一致时不得返回成功。 | 功能/约束 | #1092 | PJ2026-010104 AI网关 | 测试 |
+| HWPOD-L1-REQ-009 | 当采集板外状态时，AI 网关应区分板内 echo 和外部 ioProbe 读数，并记录单位、samples、stats 和 raw evidence。 | 功能 | #1178 | PJ2026-010104 AI网关 | 测试 |
+| HWPOD-L1-REQ-010 | 硬件池应输出原始硬件事实和错误语义，但不得定义 HarnessRL pass/fail、训练奖励或业务评分。 | 边界 | #1205 | 全部 L2 | 检查 |
+
+## 6. L2 分配
+
+| 编号 | 短名 | 主责 | 关联 L1 | 证据引用 | 边界 |
+| --- | --- | --- | --- | --- | --- |
+| PJ2026-010101 | HWPOD标准 | 定义 HWPOD-SPEC、硬件资源身份、能力模型、AI 网关接入标准、操作能力标准、状态/错误语义和验收基线。 | 客户端、HarnessRL、Agent编排 | #1216 中 D601-F103 compile-only、ConStart 71-FREQ build | 这是标准/协议型交付，不是单纯文档。它定义 HWPOD 资源和 AI 网关能力声明的正确性规则。 |
+| PJ2026-010102 | HWPOD工具 | 实现硬件池领域工具侧，包括 `hwpod-ctl`、HWPOD-SPEC 新建/修改/校验，以及 compile、download、filesystem、IO 等操作入口。 | 客户端 | #1216 中 HWPOD build/download/UART/ioProbe 原入口证据；#1091 | 这不是通用客户端 L1。只要完成标准由 HWPOD 语义或真实硬件执行定义，就主归属硬件池。 |
+| PJ2026-010103 | HWPOD服务 | 实现服务端 HWPOD 注册、管理、状态、必要权限/租约、请求接收、路由、结果归档，并把工具侧请求转发到 AI 网关节点。 | 用户管理、Agent编排、平台运维 | #1216 全部 CaseRun registry 证据；#1129、#1197 | 它负责 HWPOD 服务端语义，不负责全局部署机制、用户策略或 Agent 任务调度。 |
+| PJ2026-010104 | AI网关 | 实现连接真实硬件到服务端的节点侧能力，包括 PC 客户端形态、硬件网关盒子形态、心跳、命令执行、日志/artifact/IO 结果回传和适配器执行。 | HarnessRL、Agent编排、平台运维 | #1216 中 probe、UART、board-comm、ioProbe、电流回采、频率源扩展证据；#1092、#1097、#1186 | debug probe、UART、board-comm、ioProbe、电压/电流/频率/CANopen 等适配器是网关侧能力切片，通常作为本 L2 下的 L3。 |
+
+## 7. 吸收概念和归属规则
+
+| 概念 | 归属 |
+| --- | --- |
+| 资源模型 | 并入 PJ2026-010101 HWPOD标准；标准同时定义资源模型和网关能力模型。 |
+| 资源占用 | 通常并入 PJ2026-010103 HWPOD服务；涉及用户可见操作请求时也关联 PJ2026-010102 HWPOD工具。 |
+| 安全状态 | 是 PJ2026-010103 HWPOD服务 和 PJ2026-010104 AI网关 的横向验收要求；除非安全态恢复本身成为中心课题，否则不单列 L2。 |
+| 运行诊断 | 规格不一致归 HWPOD标准；命令/API 诊断归 HWPOD工具；路由/状态诊断归 HWPOD服务；node/probe/IO 执行诊断归 AI网关。 |
+| debug/download/IO/观测通道 | 默认不单列 L2，作为 AI网关 下的能力切片，以及 HWPOD工具 侧的操作入口。 |
+
+## 8. 验证矩阵
+
+| 需求 ID | 方法 | 原入口 | 必需证据 | 接受标准 |
+| --- | --- | --- | --- | --- |
+| HWPOD-L1-REQ-001 | 检查 | HWPOD-SPEC / spec reference | spec 字段、能力模型、错误语义 | 资源、工具、服务和网关能力能被同一标准解释。 |
+| HWPOD-L1-REQ-002 | 检查/测试 | `hwpod-ctl spec validate`、HWPOD registry | spec 文件、registry 路径、`hwpod-id` | 每个资源能追溯到唯一 spec 和 registry 来源。 |
+| HWPOD-L1-REQ-003 | 测试 | `hwpod inspect`、`hwpod build/download/uart/io-probe` | 命令输出、return code、raw evidence | 工具入口能按 HWPOD 语义执行或明确失败。 |
+| HWPOD-L1-REQ-004 | 测试/检查 | HWPOD 工具 route 输出 | runtime API authority、override source | 不再因遗留 `HWLAB_HWPOD_NODE_OPS_URL` 静默误路由。 |
+| HWPOD-L1-REQ-005 | 测试/检查 | HWLAB runtime API / case registry | registered resource、route、result/archive | 服务端可注册、路由、归档硬件操作结果。 |
+| HWPOD-L1-REQ-006 | 测试/演示 | 后续并发资源请求 | lease、holder、release、timeout 记录 | 冲突请求被阻止或排队，异常后能释放或安全收口。 |
+| HWPOD-L1-REQ-007 | 演示/检查 | node health/inventory、node logs | nodeId、连接状态、inventory、artifact/log | 网关节点能力和健康可被服务端与下游追踪。 |
+| HWPOD-L1-REQ-008 | 测试 | Keil download/debug 场景 | probe UID、uvoptx 绑定、return code | probe mismatch 不得被报告为成功。 |
+| HWPOD-L1-REQ-009 | 测试 | `hwpod io-probe read` | samples、stats、unit、raw evidence | 外部读数可独立于板内 echo 被审计。 |
+| HWPOD-L1-REQ-010 | 检查 | raw evidence / HarnessRL aggregate 对照 | raw evidence、HarnessRL 输出链接 | 硬件池只给事实，不写业务 pass/fail。 |
+
+## 9. 开放风险和跟踪项
+
+| Issue | 归属 L2 | 风险 |
+| --- | --- | --- |
+| #1091 | PJ2026-010102 HWPOD工具 | 遗留 node ops URL 可能导致误路由。 |
+| #1092 | PJ2026-010104 AI网关 | probe mismatch 可能被顶层误报成功。 |
+| #1097 | PJ2026-010104 AI网关 | D601 hwpod-node 不稳定影响长任务。 |
+| #1129 | PJ2026-010103 HWPOD服务 | CaseRun 与 Web runner 工具包可能不同步，涉及服务端/运行面工具分发。 |
+| #1186 | PJ2026-010104 AI网关 | PLC 真实频率源端到端扩展未完成。 |
+| #1196 | PJ2026-010103 HWPOD服务 | commandExecution trace 主阅读区仍有 wrapper JSON 噪声。 |
+| #1197 | PJ2026-010103 HWPOD服务 | timeout 后 AgentRun/trace/rendered 状态不一致，影响服务端安全收口。 |
+| #1200 | 关联 #1205 HarnessRL | final response 截断问题不改变硬件事实，但影响结果阅读。 |
+
+## 10. 追踪关系
+
+| 上级 | 本层需求 | 下级/关联 | 验证入口 |
+| --- | --- | --- | --- |
+| #1194 硬件真实可用 | HWPOD-L1-REQ-001/002 | PJ2026-010101 HWPOD标准 | spec validate、registry |
+| #1194 原入口可执行 | HWPOD-L1-REQ-003/004 | PJ2026-010102 HWPOD工具 | hwpod inspect/build/download/io-probe |
+| #1204 Agent编排 | HWPOD-L1-REQ-005/006 | PJ2026-010103 HWPOD服务 | runtime API、case run result、trace |
+| #1205 HarnessRL | HWPOD-L1-REQ-008/009/010 | PJ2026-010104 AI网关 | raw evidence、ioProbe、aggregate 链接 |
+| #1206 客户端 | HWPOD-L1-REQ-001/003 | HWPOD标准、HWPOD工具 | Web/CLI/API smoke |
+| #1208 平台运维 | HWPOD-L1-REQ-005/007 | HWPOD服务、AI网关 | status/logs/route diagnostics |
+
+## 11. 回写和变更规则
+
+- 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 runId、traceId、registry commit 或原入口命令。
+- 新增长证据时写入 #1216 或对应 L2/L3 issue，本文档 只保留 L2 引用。
+- 稳定需求、原定 L2 分配、验收矩阵或边界变化时，更新本文档，并在必要时回写 L0 规格。
+- 单次 CaseRun 日志、阶段报告、debug 过程和 PR 流水不得直接堆进本规格正文；应放在 #1216、对应 L2/L3 issue、case registry 或阶段报告中。
+- 若某项工作无法映射到本文档 的需求 ID 或原定 L2 编号，应先重新归类，不直接作为硬件池实现任务推进。
+
@@ -0,0 +1,169 @@
+# PJ2026-0102 Agent编排
+
+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | 待提交 | 2026-06-14 | 从 pikasTech/HWLAB#1204 迁移到 UniDesk 项目管理目录。 |
+
+## 迁移来源
+
+| 字段 | 内容 |
+| --- | --- |
+| 原 issue | pikasTech/HWLAB#1204 |
+| 原标题 | PJ2026-0102 Agent编排 |
+| 原 URL | https://github.com/pikasTech/HWLAB/issues/1204 |
+| 原状态 | open |
+| 原更新时间 | 2026-06-14T13:44:34Z |
+| 原 body SHA | 36adff57afe181b8c0d8d4c666df11319922a2357d17de61075355bdea17f1d3 |
+
+## 正文
+
+## PJ2026-0102 Agent编排需求规格
+
+## 1. 文档控制
+
+| 字段 | 内容 |
+| --- | --- |
+| 编号 | PJ2026-0102 |
+| 短名 | Agent编排 |
+| 层级 | L1 方向 |
+| 上级总项目 | #1194 PJ2026-01 HWLAB 总规格 |
+| 关联方向 | #1203 硬件池、#1205 HarnessRL、#1206 客户端、#1207 用户管理、#1208 平台运维 |
+| 证据索引 | #1223 Agent编排证据索引：Code Agent 与 AgentRun 基线归档 |
+| 规格状态 | active / 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 或对应下级 issue。
+
+## 2. 目的和范围
+
+### 2.1 目的
+
+Agent编排方向负责把用户、训练任务或系统任务从 HWLAB 入口稳定送入受控 Agent 执行生命周期，并把执行状态、会话续跑、资源装配、运行证据指针和失败分类交给客户端、HarnessRL、用户管理和平台运维。它必须保证 Code Agent/HWLAB adapter 与 AgentRun 的边界清晰：HWLAB 负责业务入口、用户/HWPOD 授权和对外 result/trace 合同；AgentRun 负责 run、command、runner job、session、backend profile、event、terminal status 和 failureKind 的执行事实。
+
+### 2.2 范围内
+
+- 从 HWLAB `/v1/agent/chat`、CLI/Web/API 等入口到 AgentRun `run + command + runner-job` 的短返回、幂等、可轮询执行生命周期。
+- SessionRef、thread、conversation、continuation、session send、同 run 多 command、runner replacement、timeout/cancel 和恢复动作；这些全部归入任务生命周期，不单列会话恢复 L2。
+- RuntimeAssembly 装配：BackendImageRef、ProfileRef、SessionRef、ResourceBundleRef、gitbundle、promptRefs、requiredSkills、tools、workspaceFiles、SecretRef、provider profile 和模型配置；这些全部归入资源装配，不单列模型配置 L2。
+- Agent 执行面 workspace 的 prepare/materialize、source commit、seed file、env/Secret 投影和 runner 可复现输入；这些作为资源装配的一部分管理，不单列工作区 L2。
+- result/trace/artifact pointer、tool call summary、liveness、failureKind 和 recoveryActions；这些作为任务生命周期的输出证据，不单列结果归档 L2。
+- 与硬件池、HarnessRL、客户端、用户管理、平台运维的证据和主责交接。
+
+### 2.3 范围外
+
+- 硬件 inventory、硬件资源状态、HWPOD 标准、HWPOD 服务端状态和 AI 网关能力定义归 #1203。
+- WebUI/CLI/API/SDK 的用户交互、页面布局、公开 API/SDK 兼容性、结果展示体验归 #1206。
+- Harness pass/fail、CaseRun 评价、artifact 训练样本、RL 反馈和 evidence replay 归 #1205。
+- 用户账户、权限、credit、usage、billing、admin 策略归 #1207。
+- Git mirror、Secret sync、YAML/GitOps、rollout、namespace、平台数据库、日志/指标基础设施归 #1208。
+- 本方向不定义新的 AgentRun 产品路线；AgentRun 自身能力变更由 pikasTech/agentrun issue/PR 承载，本方向只定义 HWLAB 对 AgentRun 的使用合同和验收需求。
+
+## 3. 运行概念
+
+1. 用户、训练任务或系统任务通过 HWLAB 客户端/API 提交 Agent 请求。
+2. HWLAB 做用户、项目、HWPOD 和业务策略校验，并构造 AgentRun RuntimeAssembly。
+3. AgentRun manager 创建 run、command 和 runner job，短返回可轮询 ID。
+4. runner 按资源装配结果物化 workspace、profile、session、bundle、prompt、skill、tool 和 env，执行后持续上报 events。
+5. HWLAB 通过 result/trace/status 入口暴露执行生命周期事实，客户端、HarnessRL 和用户管理只消费指针和摘要，不反向定义 AgentRun 执行事实。
+6. cancel、timeout、provider failure、runner replacement、session continuation 等恢复语义由任务生命周期统一管理。
+
+## 4. 系统边界和权威
+
+| 对象 | Authority | Agent编排职责 | 非主责交接 |
+| --- | --- | --- | --- |
+| 用户入口 | HWLAB 客户端/API | 接收并规范化 Agent 请求，返回 task/run/session/trace 指针 | UX、公开 API/SDK 体验归 #1206 |
+| 用户/账本 | HWLAB 用户管理 | 在提交前后消费 auth、quota、usage/billing 结果 | 策略、账本和 admin 归 #1207 |
+| 硬件资源 | HWLAB 硬件池 | 引用 HWPOD hint/context 和分配结果 | inventory、租约、健康、状态归 #1203 |
+| 执行事实 | 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 |
+| 执行证据 | AgentRun events/result + HWLAB trace | 暴露生命周期状态、失败分类、结果指针和恢复建议 | Harness 评价归 #1205，展示归 #1206 |
+
+## 5. L2 课题分配
+
+本次按最新口径重划 #1204 的 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，硬件资源状态归 #1203，Secret/GitOps 运维归 #1208。 |
+
+### 5.2 概念合并说明
+
+| 原切片 | 处理 | 理由 |
+| --- | --- | --- |
+| 会话恢复 | 并入 PJ2026-010201 任务生命周期 | 会话 continuation、resume、session send 和 runner replacement 是任务生命周期的一部分，不应单列。 |
+| 工作区 | 并入 PJ2026-010202 资源装配 | Agent workspace materialization 是资源装配输入证明；WebUI 工作区体验归 #1206，硬件/资源状态归 #1203 或 #1208。 |
+| 模型配置 | 并入 PJ2026-010202 资源装配 | provider profile、backendProfile、model、auth/config SecretRef 是 RuntimeAssembly/ProfileRef 装配项，不应单列。 |
+| 结果归档 | 删除 standalone L2 | Agent编排只负责生命周期内的 result/trace/artifact pointer；长期归档、评价和展示分别归 #1205、#1206、#1208。 |
+
+## 6. 原子需求
+
+| ID | 需求 | 类型 | 主责 L2 | 验证类型 |
+| --- | --- | --- | --- | --- |
+| AGENT-L1-REQ-001 | HWLAB 应通过 AgentRun durable resource 模型创建和跟踪 Agent 执行；run、command、runner job 创建必须短返回 JSON，并提供后续轮询入口。 | 功能 | 任务生命周期 | 测试、演示 |
+| AGENT-L1-REQ-002 | Agent 执行生命周期应区分 command terminal 与 run terminal；只有 terminal completed 且具备可用 reply/final evidence 时才可判定完成。 | 功能/正确性 | 任务生命周期 | 测试、检查 |
+| AGENT-L1-REQ-003 | Agent 编排应提供幂等 cancel、timeout、provider unavailable、runner lease conflict、FailedToOpenSocket 等失败分类和可操作恢复动作。 | 功能/诊断 | 任务生命周期 | 测试、检查 |
+| AGENT-L1-REQ-004 | Agent 编排应支持 SessionRef/thread 恢复、同 session 续跑、同 run 多 command 和 runner replacement；恢复失败必须显式分类，不得拼接历史或 fake resume。 | 功能 | 任务生命周期 | 测试、演示 |
+| AGENT-L1-REQ-005 | Agent 编排应按 RuntimeAssembly 装配 BackendImageRef、ProfileRef、SessionRef、ResourceBundleRef；缺失或非法要素必须结构化失败，不得静默 fallback。 | 约束/功能 | 资源装配 | 检查、测试 |
+| 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-010 | Agent 编排相关运行面证据必须来自真实 HWLAB/AgentRun 原入口；mock、自测试、dry-run、source-only smoke 或只读日志解释不得作为用户可见能力关闭依据。 | 验收 | 全部 L2 | 检查、演示 |
+
+## 7. 验证矩阵
+
+| 需求 | 验证类型 | 原入口 | 必需证据 | 通过标准 |
+| --- | --- | --- | --- | --- |
+| AGENT-L1-REQ-001 | 测试 | HWLAB `/v1/agent/chat`、`hwlab-cli client agent ...`、AgentRun run/command/runner-job API | traceId、runId、commandId、runnerJobId、jobName、namespace、短返回 JSON | 创建和轮询不依赖长同步请求。 |
+| AGENT-L1-REQ-002 | 测试/检查 | AgentRun result envelope、HWLAB result/trace | terminalStatus、completed、terminalSource、finalResponseAuthority、scoped event cursor | 不把 partial/stdout/idle timeout 误判为 completed。 |
+| AGENT-L1-REQ-003 | 测试/检查 | cancel、timeout、provider failure、runner lease、socket failure 场景 | failureKind、liveness、recoveryActions、cancel result、redacted error | 失败可分类、可恢复或可安全收口。 |
+| AGENT-L1-REQ-004 | 测试 | session send、thread resume、runner pod 删除后续跑 | sessionId、threadId、PVC/storage 摘要、same-session evidence、initialPromptInjected=false | 同 session 可继续；不可继续时显式 evicted/failed。 |
+| AGENT-L1-REQ-005 | 检查/测试 | RuntimeAssembly render、runner job response、events | image/profile/session/resource 四要素摘要、SecretRef 名称/key、valuesPrinted=false | 所有运行时输入可追踪且不绕过装配模型。 |
+| AGENT-L1-REQ-006 | 测试/检查 | resource-bundle-materialized event、workspace summary | repoUrl、fetchRepoUrl、mirrorUsed、actual commit、bundles、tools、skills、workspaceFiles 摘要 | runner 使用正确版本资源，Web/CaseRun 不漂移。 |
+| AGENT-L1-REQ-007 | 测试/检查 | provider-profiles list/show/config/validate、HWLAB admin 委托 API | configured、SecretRef、hash suffix、validationId、runId、commandId、jobName | profile 可配置、可验证、输出脱敏。 |
+| AGENT-L1-REQ-008 | 测试/检查 | HWLAB trace/result、AgentRun events/result | lastSeq、eventCount、eventsCapped、artifactSummary、toolCallSummary、final assistant seq | 下游可审计执行事实和 artifact 指针。 |
+| AGENT-L1-REQ-009 | 检查 | L2/L3 issue 和收口评论 | 主责 L1、关联 L1、回写对象、证据索引链接 | 不抢硬件池/Harness/客户端/用户/运维主责。 |
+| AGENT-L1-REQ-010 | 检查/演示 | 真实 HWLAB/AgentRun runtime | 原入口命令、lane/node、trace/session/job/run、结果摘要 | 关闭证据来自真实入口。 |
+
+## 8. 当前开放风险
+
+| 来源 | 归属 | 风险 |
+| --- | --- | --- |
+| #1173 | PJ2026-010202 资源装配 | v0.3 AgentRun v02 内建 provider profile 缺默认配置，需明确 YAML/SecretRef 预置或管理员首次写入策略。 |
+| #1189 | PJ2026-010201 任务生命周期 | v0.3 trace 卡在 runner-job-created 且工具调用不可见，影响执行事实和生命周期证据可信度。 |
+| #1146 | PJ2026-010201 / PJ2026-010202 | Code Agent 计费成功但 AgentRun FailedToOpenSocket，要求执行层失败与用户账本分离，并检查 provider/profile 装配。 |
+| #1197 | PJ2026-010201 | CaseRun timeout 后 AgentRun claimed 与 trace raw/rendered 状态不一致，影响安全 cancel 和生命周期证据阅读。 |
+| #1129 | PJ2026-010202 | Web v0.2 与 CaseRun 使用同类 gitbundle 但 live source commit 可能落后，需暴露 materialized commit 和刷新语义。 |
+| pikasTech/agentrun#172 | PJ2026-010201 | runnerjob phase/pod identity 与 run events/liveness 可能不一致，需统一 describe run/session/runnerjob 语义。 |
+| pikasTech/agentrun#179 | PJ2026-010202 / 平台运维 #1208 | AgentRun v0.2 external DB/stateless 计划影响 D601 HWLAB v0.3 Agent 编排 durable state 和资源装配可复现性。 |
+
+## 9. 追踪关系
+
+| 上级 | 本层需求 | 下级/关联 | 验证入口 |
+| --- | --- | --- | --- |
+| #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 workspace/provider/runtime | AGENT-L1-REQ-005/006/007 | PJ2026-010202 资源装配 | RuntimeAssembly、resource materialization、provider validate |
+| #1203 硬件池 | AGENT-L1-REQ-006/009 | PJ2026-010202 资源装配 | HWPOD hint/context、硬件事实引用；硬件资源状态归 #1203 |
+| #1205 HarnessRL | AGENT-L1-REQ-008/009 | PJ2026-010201 任务生命周期 | trace/result/artifact pointer、toolCallSummary；pass/fail 归 #1205 |
+| #1206 客户端 | AGENT-L1-REQ-001/004/008/009 | 任务生命周期、资源装配 | Web/CLI/API smoke、trace/result UI；WebUI 工作区体验归 #1206 |
+| #1207 用户管理 | AGENT-L1-REQ-003/007/009 | 任务生命周期、资源装配 | billing preflight/record、provider admin delegation |
+| #1208 平台运维 | AGENT-L1-REQ-005/006/007/010 | 资源装配 | lane/namespace/Secret/GitOps/runtime health |
+| #1223 证据索引 | 全部需求 | AgentRun SPEC 与历史 issue | 证据链接、开放风险、回写记录 |
+
+## 10. 回写和变更规则
+
+- 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 runId、commandId、runnerJobId、sessionId、traceId、result pointer、artifact pointer 或原入口命令。
+- 新增长证据、AgentRun SPEC 摘要或历史 issue 证据时写入 #1223；本文档 只保留规格要求和证据索引引用。
+- 稳定需求、L2 分配、验收矩阵或 authority 边界变化时，更新本文档，并在必要时回写 L0 规格。
+- 单次 trace、PR 流水、PipelineRun、runtime debug、provider 事故和 CaseRun 日志不得直接堆入本规格正文；应放在 #1223、对应 L2/L3 issue、AgentRun issue 或阶段报告中。
+- 若某项工作无法映射到任务生命周期或资源装配，应先判断主责是否属于硬件池、HarnessRL、客户端、用户管理或平台运维，不直接作为 Agent编排实现任务推进。
+
+
@@ -0,0 +1,82 @@
+# PJ2026-0103 HarnessRL
+
+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | 待提交 | 2026-06-14 | 从 pikasTech/HWLAB#1205 迁移到 UniDesk 项目管理目录。 |
+
+## 迁移来源
+
+| 字段 | 内容 |
+| --- | --- |
+| 原 issue | pikasTech/HWLAB#1205 |
+| 原标题 | PJ2026-0103 HarnessRL |
+| 原 URL | https://github.com/pikasTech/HWLAB/issues/1205 |
+| 原状态 | open |
+| 原更新时间 | 2026-06-14T12:19:24Z |
+| 原 body SHA | 8b8fbe26aad2feb74691849b815cab49829877a16877e3c727e4cca7d0189efe |
+
+## 正文
+
+编号: PJ2026-0103
+短名: HarnessRL
+上级总项目: #1194
+总规格 issue: #1194
+核对时间: 2026-06-14（北京时间）
+核对口径: 以 HWLAB v0.2 CaseRun、HWPOD evidence、PLC/ARM2D 已归档 registry、Harness RL 规划和开放 issue 为准；本文档 定义证据、评估、回放和训练反馈，不接管硬件资源、Agent 调度或客户端展示。
+
+## 主责边界
+
+- 主责对象: harness、CaseRun、case registry、ioProbe evidence、artifact/diff/final 证据、aggregate、评估、回放、训练反馈和 RL 闭环。
+- 不负责: 硬件容量与占用、Agent 执行生命周期、用户账号与计费、CI/CD 发布、Web/CLI 展示细节。
+- 交接方向: 硬件池 #1203、Agent编排 #1204、客户端 #1206、用户管理 #1207、平台运维 #1208。
+
+## 交叉引用
+
+- 上游依赖: 硬件池 #1203 提供真实设备、probe 和原始硬件读数；Agent编排 #1204 提供任务生命周期、workspace 和 artifact 指针；平台运维 #1208 提供 runtime 与 registry/日志保留能力。
+- 下游支撑: 客户端 #1206 展示 aggregate/evidence；用户管理 #1207 可消费 usage/evidence 统计；Agent编排 #1204 可消费评估反馈改善执行策略。
+- 接口/证据边界: 本方向输出 CaseRun 状态、证据包、低噪声 aggregate、ioProbe evidence、评估/回放结果和训练反馈；不输出硬件可用性、Agent 调度状态、用户账本或前端布局。
+- 需同步回写: evidence 标准、aggregate 口径、pass/fail 判定、回放格式或训练反馈格式变化时，回写 #1194、硬件池 #1203、Agent编排 #1204、客户端 #1206 和用户管理 #1207。
+
+## 方向目标
+
+把真实硬件运行过程转化为可审计、可回放、可训练的 Harness/RL 证据闭环，支撑 HWLAB 的研发验收和能力提升。当前重点是让 CaseRun 从“跑过一次”升级为“证据结构稳定、人工可读、失败可分类、后续可训练”。
+
+## L2 课题
+
+| 编号 | 短名 | 主责 | 关联 L1 | 边界 |
+| --- | --- | --- | --- | --- |
+| PJ2026-010301 | CaseRun规格 | 定义 case definition、stage model、start/status/result/logs、case registry、postValidation 和 run-local workspace 约束。 | Agent编排、硬件池、平台运维 | 完成标准是 CaseRun 编排与 registry 语义正确；硬件实体绑定归 #1203，Agent 生命周期归 #1204。 |
+| 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 判定。 |
+| PJ2026-010305 | 评估回放 | 定义 pass/fail、judge、baseline、replay、regression 和对抗审查入口。 | Agent编排、客户端、用户管理 | 完成标准是同一证据可被复验和比较；不定义硬件资源或用户权限。 |
+| PJ2026-010306 | 训练反馈 | 定义 RL/reward、训练样本、失败标签、prompt/skill 反馈和可复用改进数据。 | Agent编排、用户管理 | 完成标准是评估结果能回流为训练/改进材料；不承诺具体模型训练发布。 |
+
+## 当前开放缺口映射
+
+- #921: HWPOD 强化学习 Harness 总规划，主归 PJ2026-010306 训练反馈，并关联 PJ2026-010305 评估回放。
+- #1033: CaseRun + Web UI 统一 Agent Review 架构，主归 PJ2026-010305 评估回放，客户端展示归 #1206。
+- #1178/#1186: PLC 71-FREQ ioProbe 造模和真实频率源扩展，Harness 侧归 PJ2026-010303 ioProbe建模，硬件接入归 #1203。
+- #1197: timeout 收口状态不一致，Harness 侧归 PJ2026-010301 CaseRun规格，Agent 生命周期归 #1204。
+- #1200: 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 验收，任务生命周期由 #1204 验收，用户入口由 #1206 验收，账本由 #1207 验收，运行面保留由 #1208 验收。
+
+## 当前状态
+
+- L2 编号和主责边界已固定；下级执行时按本表创建 L2/L3 issue，不再把单个 case、一次 smoke 或某个 artifact bug 升级成 L2。
+- 当前优先收口 CaseRun 状态语义、ioProbe 外部证据、aggregate 主阅读入口和评估/训练反馈的最小闭环。
+
+## 回写规则
+
+- 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 caseId/runId/traceId/registry commit/evidence 路径。
+- 影响 L0 中心、编号、职责边界或全局验收时回写 #1194。
+- 涉及硬件资源或 probe 能力回写 #1203；涉及 Agent 生命周期、workspace 或 artifact 指针回写 #1204；涉及 Web/CLI/API 展示回写 #1206；涉及 usage/credit/tenant 统计回写 #1207；涉及 registry/log/artifact 保留回写 #1208。
+
@@ -0,0 +1,82 @@
+# PJ2026-0104 客户端
+
+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | 待提交 | 2026-06-14 | 从 pikasTech/HWLAB#1206 迁移到 UniDesk 项目管理目录。 |
+
+## 迁移来源
+
+| 字段 | 内容 |
+| --- | --- |
+| 原 issue | pikasTech/HWLAB#1206 |
+| 原标题 | PJ2026-0104 客户端 |
+| 原 URL | https://github.com/pikasTech/HWLAB/issues/1206 |
+| 原状态 | open |
+| 原更新时间 | 2026-06-14T12:20:05Z |
+| 原 body SHA | a00a372c9b22c52ddfb52e38ff0dc9a85b6e7b1aadcb971ffb9e3b7462e49c58 |
+
+## 正文
+
+编号: PJ2026-0104
+短名: 客户端
+上级总项目: #1194
+总规格 issue: #1194
+核对时间: 2026-06-14（北京时间）
+核对口径: 以 HWLAB Cloud Web、hwlab-cli、HTTP API、公开入口、v0.3 Vue parity 和用户可见退化 issue 为准；本文档 定义用户入口契约和展示行为，不接管用户账本、Agent 内部调度、硬件库存或发布机制。
+
+## 主责边界
+
+- 主责对象: Web、CLI、HTTP API、SDK/IDE 插件、webhook、公开文档、兼容性、用户任务入口、状态展示和结果获取。
+- 不负责: 用户/计费真相、Agent 调度内部、硬件库存与证据真实性、CI/CD 发布、Secret/配置下发。
+- 交接方向: 用户管理 #1207、Agent编排 #1204、硬件池 #1203、HarnessRL #1205、平台运维 #1208。
+
+## 交叉引用
+
+- 上游依赖: 用户管理 #1207 提供身份、权限、API key、额度和 admin 能力；Agent编排 #1204 提供任务状态、session 和结果指针；硬件池 #1203 提供资源/设备状态；HarnessRL #1205 提供 evidence/aggregate；平台运维 #1208 提供公网入口和发布状态。
+- 下游支撑: 所有用户入口通过客户端暴露；用户管理、Agent编排、硬件池和 HarnessRL 的用户可见能力需要客户端承载。
+- 接口/证据边界: 本方向定义 Web/CLI/API/SDK/Webhook 的调用契约、展示行为、错误语义和兼容性；不定义账号账本、Agent 生命周期、HWPOD 语义或 Harness evidence 标准。
+- 需同步回写: API/CLI/Web/SDK/Webhook 契约、兼容性、公开文档或用户入口变化时，回写 #1194、用户管理 #1207、Agent编排 #1204、硬件池 #1203、HarnessRL #1205 和平台运维 #1208。
+
+## 方向目标
+
+形成统一的多客户端用户入口，让 Web、CLI、API、SDK/IDE 插件和 Webhook 围绕同一任务模型、权限模型、资源模型和结果模型协同演进。当前重点是把 v0.3 Vue 工作台退化、公开入口、API/CLI 一致性和用户管理页面补齐归到稳定 L2 下。
+
+## L2 课题
+
+| 编号 | 短名 | 主责 | 关联 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，CaseRun 评价归 #1205。 |
+| PJ2026-010403 | API契约 | 定义 HTTP API/WebSocket 的路径、schema、错误码、鉴权转发、兼容性和客户端消费契约。 | 用户管理、Agent编排、平台运维 | 完成标准是公开/内部 API 行为可依赖；后端业务真相由对应 L1 定义。 |
+| PJ2026-010404 | SDK插件 | 定义 SDK、IDE 插件、外部工具接入、任务创建/查询/结果读取封装和版本兼容。 | Agent编排、用户管理 | 完成标准是外部开发者可集成；不定义平台底层调度或账号账本。 |
+| PJ2026-010405 | Webhook集成 | 定义外部回调、事件订阅、任务状态通知、证据通知和失败重试语义。 | Agent编排、HarnessRL、用户管理 | 完成标准是外部系统能可靠消费事件；事件事实来源归对应业务 L1。 |
+| PJ2026-010406 | 文档兼容 | 定义公开文档、示例、迁移说明、兼容性矩阵、错误排查和多客户端一致性说明。 | 全部 L1 | 完成标准是用户入口可解释、可迁移；不把内部长期规格或阶段报告当作客户端交付。 |
+
+## 当前开放缺口映射
+
+- #1199: v0.3 Vue 工作台入口与会话发送退化，主归 PJ2026-010401 Web工作台，关联 Agent编排 #1204。
+- #1172: v0.3 Cloud Web 直达 history 路由缺 SPA fallback，主归 PJ2026-010401，公开入口/发布归 #1208。
+- #1192: v0.3 域名工作台登录后 API 间歇 502 且停留登录页，客户端侧归 PJ2026-010401/API契约，运行面归 #1208。
+- #1166: v0.3 Cloud Web check 受测试运行器兼容性与 timing 抖动影响，客户端侧归 PJ2026-010401，验证工具链归 #1208。
+- #1033: Agent Review 的 Web UI 承载部分归 PJ2026-010401，评估/审查语义归 HarnessRL #1205。
+
+## 验收标准
+
+- 原入口: 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 验收，任务生命周期由 #1204 验收，硬件事实由 #1203 验收，evidence/aggregate 由 #1205 验收，发布/入口健康由 #1208 验收。
+
+## 当前状态
+
+- L2 编号和主责边界已固定；下级执行时按本表创建 L2/L3 issue，不再以单个页面、组件、测试脚本或框架迁移作为替代 L2。
+- 当前优先收口 Web工作台、CLI/API 一致性、公开入口可用性和公开文档/兼容性，确保 v0.3 多用户与硬件工作流不会继续在客户端层分叉。
+
+## 回写规则
+
+- 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 Web/CLI/API/SDK/Webhook 原入口证据。
+- 影响 L0 中心、编号、职责边界或全局验收时回写 #1194。
+- 涉及身份、权限、API key、usage 或 admin 回写 #1207；涉及任务/session/result 回写 #1204；涉及 HWPOD 资源/状态回写 #1203；涉及 evidence/aggregate 回写 #1205；涉及公网入口、CI/CD 或 runtime 发布回写 #1208。
+
@@ -0,0 +1,82 @@
+# PJ2026-0105 用户管理
+
+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | 待提交 | 2026-06-14 | 从 pikasTech/HWLAB#1207 迁移到 UniDesk 项目管理目录。 |
+
+## 迁移来源
+
+| 字段 | 内容 |
+| --- | --- |
+| 原 issue | pikasTech/HWLAB#1207 |
+| 原标题 | PJ2026-0105 用户管理 |
+| 原 URL | https://github.com/pikasTech/HWLAB/issues/1207 |
+| 原状态 | open |
+| 原更新时间 | 2026-06-14T12:20:54Z |
+| 原 body SHA | 8aac900d4eddbdcf7e6e3708e744a7eb7fd3c1065f346caa7734fa0fa7b2b9b1 |
+
+## 正文
+
+编号: PJ2026-0105
+短名: 用户管理
+上级总项目: #1194
+总规格 issue: #1194
+核对时间: 2026-06-14（北京时间）
+核对口径: 以 HWLAB v0.3 user-billing、Sub2API 多用户/credit 架构吸收、API key、session、usage/credit、admin 和 quota/entitlement issue 为准；本文档 定义用户与账本真相，不接管客户端布局、Agent 执行语义或平台发布。
+
+## 主责边界
+
+- 主责对象: 用户、注册登录、session、权限、API key、credit、usage、billing、admin、plan/entitlement/quota、租户隔离和资源消费约束。
+- 不负责: 客户端交互细节、Agent 执行生命周期、硬件 evidence、Harness 评价、部署机制。
+- 交接方向: 客户端 #1206、Agent编排 #1204、HarnessRL #1205、平台运维 #1208、硬件池 #1203。
+
+## 交叉引用
+
+- 上游依赖: 客户端 #1206 承载登录/API key/admin/usage 入口；Agent编排 #1204 和 HarnessRL #1205 提供 usage/evidence 来源；平台运维 #1208 提供数据库、Secret 和 runtime；硬件池 #1203 提供可授权的硬件资源事实。
+- 下游支撑: 客户端、Agent编排、硬件池和 HarnessRL 都需要身份、权限、额度、租户隔离和资源消费约束。
+- 接口/证据边界: 本方向定义账户、session、权限、额度、计量账本、账单和 admin 真相；不定义客户端布局、Agent 调度、HWPOD 物理资源或 Harness evidence 标准。
+- 需同步回写: 账户模型、API key、权限/配额、usage/credit、billing/admin 或租户隔离规则变化时，回写 #1194、客户端 #1206、Agent编排 #1204、HarnessRL #1205 和平台运维 #1208。
+
+## 方向目标
+
+建立可运营的多用户管理体系，让 HWLAB 能支持用户注册、鉴权、API key、额度预检、资源授权、计量、账单和管理员操作，并用同一用户真相约束 Code Agent、HWPOD 和 Harness 资源消费。
+
+## L2 课题
+
+| 编号 | 短名 | 主责 | 关联 L1 | 边界 |
+| --- | --- | --- | --- | --- |
+| PJ2026-010501 | 账号会话 | 定义注册、登录、logout、session、introspect、cookie/token 生命周期和用户身份 source-of-truth。 | 客户端、平台运维 | 完成标准是身份可验证；登录页面和 UI 体验归 #1206，Secret/DB 发布归 #1208。 |
+| PJ2026-010502 | APIKey | 定义 API key 创建、撤销、scope、脱敏展示、轮换、服务侧校验和调用身份绑定。 | 客户端、Agent编排、平台运维 | 完成标准是 API key 可安全消费；CLI/Web 展示归 #1206，Secret 同步归 #1208。 |
+| PJ2026-010503 | 权限配额 | 定义 role/admin、plan、entitlement、quota、resource authorization、preflight 和资源使用许可。 | Agent编排、硬件池、客户端 | 完成标准是资源消费前授权正确；实际硬件可用性归 #1203，任务执行归 #1204。 |
+| 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，DB/发布归 #1208。 |
+| PJ2026-010506 | 租户隔离 | 定义 tenant 边界、数据隔离、资源隔离、审计、跨用户共享和越权防护。 | 全部 L1 | 完成标准是多用户资源和数据不串租户；具体入口、执行、硬件和 evidence 仍由对应 L1 实现。 |
+
+## 当前开放缺口映射
+
+- #1127: Go 用户与计费中台总计划，覆盖 PJ2026-010501 到 PJ2026-010505 的核心基线。
+- #1176: v0.3 user-billing 管理功能退化补齐，主归 PJ2026-010505 账单后台，并关联 PJ2026-010502 APIKey、PJ2026-010504 计量账本。
+- #1211: plan/entitlement/quota 资源授权闭环，主归 PJ2026-010503 权限配额。
+- #1146: Code Agent 计费成功但 AgentRun 执行失败，用户管理侧归 PJ2026-010504 计量账本与 PJ2026-010503 权限配额，Agent 执行归 #1204。
+- #1192: 登录后 API 间歇 502 且停留登录页，身份/API 行为关联 PJ2026-010501，客户端入口归 #1206，运行面归 #1208。
+
+## 验收标准
+
+- 原入口: 注册/登录/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 验收，Agent 执行由 #1204 验收，硬件资源由 #1203 验收，Harness evidence 由 #1205 验收，DB/Secret/runtime 由 #1208 验收。
+
+## 当前状态
+
+- L2 编号和主责边界已固定；下级执行时按本表创建 L2/L3 issue，不再把 UI 页面、单个 API 或数据库表名当作替代 L2。
+- 当前优先收口 v0.3 user-billing 的账号/API key/usage/admin/entitlement/quota 链路，并让 Code Agent、HWPOD 和 Harness 都只消费同一用户管理真相。
+
+## 回写规则
+
+- 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 API/Web/CLI、ledger、DB source-of-truth 和审计证据。
+- 影响 L0 中心、编号、职责边界或全局验收时回写 #1194。
+- 涉及 Web/CLI/API 展示回写 #1206；涉及任务 preflight/usage source 回写 #1204；涉及硬件资源授权回写 #1203；涉及 evidence/usage 统计来源回写 #1205；涉及 DB、Secret、runtime 发布回写 #1208。
+
@@ -0,0 +1,83 @@
+# PJ2026-0106 平台运维
+
+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | 待提交 | 2026-06-14 | 从 pikasTech/HWLAB#1208 迁移到 UniDesk 项目管理目录。 |
+
+## 迁移来源
+
+| 字段 | 内容 |
+| --- | --- |
+| 原 issue | pikasTech/HWLAB#1208 |
+| 原标题 | PJ2026-0106 平台运维 |
+| 原 URL | https://github.com/pikasTech/HWLAB/issues/1208 |
+| 原状态 | open |
+| 原更新时间 | 2026-06-14T12:21:38Z |
+| 原 body SHA | d9f55d319dcc1365eb35c1e76b507cc2132b7a64b2b34a859d8dc958537b03ef |
+
+## 正文
+
+编号: PJ2026-0106
+短名: 平台运维
+上级总项目: #1194
+总规格 issue: #1194
+核对时间: 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 语义或硬件验收标准。
+
+## 主责边界
+
+- 主责对象: CI/CD、git mirror、YAML-first、Secret 下发、rollout、公开入口、observability、GC/retention、平台发布和运行面诊断。
+- 不负责: 产品行为定义、用户策略、Agent 执行语义、硬件资源验收、Harness pass/fail、客户端 UX。
+- 交接方向: 硬件池 #1203、Agent编排 #1204、HarnessRL #1205、客户端 #1206、用户管理 #1207。
+
+## 交叉引用
+
+- 上游依赖: 硬件池、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 和全部受影响 L1。
+
+## 方向目标
+
+建立可持续交付和可观测的平台运维体系，让 HWLAB 各业务方向可以通过受控 CI/CD、Git mirror、YAML-first 配置、Secret/rollout、公开入口和保留清理机制稳定发布与排障。当前重点是消除 v0.3 公开入口、DB/Secret、AgentRun/provider、git mirror 和可见性缺口对业务 L1 的遮蔽。
+
+## L2 课题
+
+| 编号 | 短名 | 主责 | 关联 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。 |
+| 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/#1207/#1204。 |
+| 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，workspace 语义归 #1204。 |
+
+## 当前开放缺口映射
+
+- #1209: v0.3 public exposure 端口/旧 web 指向问题，主归 PJ2026-010605 公开入口。
+- #1136: G14 v0.3 admin Secret 已收敛但 DB 连接阻塞登录，平台侧归 PJ2026-010604 密钥同步和 PJ2026-010606 运行观测。
+- #1192: 域名工作台登录后 API 间歇 502，入口/运行面归 PJ2026-010605 公开入口和 PJ2026-010606 运行观测，客户端归 #1206。
+- #1166: Cloud Web check 受运行器兼容性和 timing 抖动影响，平台侧归 PJ2026-010601 发布流水与 PJ2026-010606 运行观测。
+- #1129: Web v0.2 与 CaseRun HWPOD 工具包同步差异，平台侧归 PJ2026-010602 Git镜像/源同步，Agent 装配归 #1204。
+
+## 验收标准
+
+- 原入口: UniDesk/HWLAB 受控 CI/CD、git mirror、YAML render/validate、Secret sync、FRP/Caddy/public health、runtime status/logs/trace、GC/retention 命令。
+- Runtime/lane: HWLAB v0.2/v0.3、G14/D601 相关 lane；具体目标由下级 L2/L3 issue 指定。
+- Evidence: PipelineRun/rollout 状态、source commit、mirror sync/flush 记录、YAML render 结果、Secret fingerprint、public URL health、pod/service 状态、logs/trace、GC/retention 摘要和失败原因。
+- 完成口径: 平台运维只确认“交付、配置、密钥、入口、观测和清理可控”；硬件、Agent、Harness、客户端和用户管理的业务成功由对应 L1 定义。
+
+## 当前状态
+
+- L2 编号和主责边界已固定；下级执行时按本表创建 L2/L3 issue，不再以单个 namespace、pod、脚本或临时运维动作作为替代 L2。
+- 当前优先收口 v0.3 public exposure、DB/Secret、git mirror/source commit、AgentRun/provider 可观测性和运行面保留清理，避免平台缺口遮蔽业务验收。
+
+## 回写规则
+
+- 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 PipelineRun、source commit、render/Secret fingerprint、public health、status/log/trace 或 GC/retention 证据。
+- 影响 L0 中心、编号、职责边界或全局验收时回写 #1194。
+- 涉及硬件 runtime/node 回写 #1203；涉及 AgentRun/workspace/provider 回写 #1204；涉及 case registry/evidence 保留回写 #1205；涉及 Web/CLI/API/public entry 回写 #1206；涉及 DB/用户/Secret 语义回写 #1207。
+
@@ -0,0 +1,56 @@
+# HWLAB 当前中心索引：阶段主线与非中心边界
+
+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | 待提交 | 2026-06-14 | 从 pikasTech/HWLAB#1218 迁移到 UniDesk 项目管理目录。 |
+
+## 迁移来源
+
+| 字段 | 内容 |
+| --- | --- |
+| 原 issue | pikasTech/HWLAB#1218 |
+| 原标题 | HWLAB 当前中心索引：阶段主线与非中心边界 |
+| 原 URL | https://github.com/pikasTech/HWLAB/issues/1218 |
+| 原状态 | open |
+| 原更新时间 | 2026-06-14T12:52:18Z |
+| 原 body SHA | 1818977dd433ec0ae8390773aed02967f61d1bb90ab30810af2c1337fc3ce5a8 |
+
+## 正文
+
+上级总项目: #1194
+关联阶段规格: #644
+关联面板: #645
+性质: 阶段中心索引，不是 L1 方向，不是 L2 课题，不重新定义 L1 划分。
+迁出来源: #1194 旧版“当前中心”章节
+迁出时间: 2026-06-14（北京时间）
+
+## 使用规则
+
+- 本文档 保存阶段性主线、非中心边界和计划口径。
+- L0 规格只引用本文档，不在规格正文中展开阶段计划。
+- 阶段中心变化不等于 L1 划分变化；如确需改变 L1 方向树，必须先回到 #1194 按规格变更处理。
+- 阶段报告和当天进展不得写入 #1194 正文，应写到本文档 评论、#644 或阶段报告中。
+
+## 当前中心
+
+- 当前主线一：硬件池优先，先保证真实板卡、探针、HWPOD node、设备注册、占用、健康和可用性可被下游稳定引用。
+- 当前主线二：Agent编排连接用户任务、workspace、session、provider profile、任务恢复和硬件池资源。
+- 当前主线三：HarnessRL 在真实硬件和 Agent 编排之上形成 CaseRun、ioProbe、evidence、评估、回放、训练反馈闭环。
+- 当前主线四：客户端和用户管理把平台能力对外开放为 Web/CLI/API/SDK、身份、权限、额度、计量和 admin 能力。
+- 当前支撑主线：平台运维通过 CI/CD、git mirror、YAML-first、Secret、rollout、observability 和 GC 保证各方向可持续交付。
+
+## 当前非中心
+
+- 无硬件池、Agent编排、HarnessRL、客户端、用户管理或平台运维归属的孤立工具美化。
+- 不解除明确 blocker 的旧门禁修补。
+- 无原入口验收的观测增强。
+- 只统计 issue/PR 数量、但不能说明对 L1 验收移动的阶段报告。
+
+## 回写规则
+
+- 阶段中心变化时更新本文档，并在 #1194 保持引用。
+- 如果阶段中心变化影响 L0 使命、范围、L1 方向树或全局需求，必须同步更新 #1194。
+- 具体执行进展只写入对应 L1/L2/L3/L4 issue 或本文档 评论，不写入 L0 规格正文。
+
@@ -0,0 +1,108 @@
+# HWLAB 规格治理索引：编号、层级、回写与偏离规则
+
+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | 待提交 | 2026-06-14 | 从 pikasTech/HWLAB#1217 迁移到 UniDesk 项目管理目录。 |
+
+## 迁移来源
+
+| 字段 | 内容 |
+| --- | --- |
+| 原 issue | pikasTech/HWLAB#1217 |
+| 原标题 | HWLAB 规格治理索引：编号、层级、回写与偏离规则 |
+| 原 URL | https://github.com/pikasTech/HWLAB/issues/1217 |
+| 原状态 | open |
+| 原更新时间 | 2026-06-14T12:51:52Z |
+| 原 body SHA | 74b7a571bc045cf7d8a8c132e6de21d4bd56802f67eadab2fe89a62baf0e1d86 |
+
+## 正文
+
+上级总项目: #1194
+关联面板: #645
+性质: 规格治理索引，不是 L1 方向，不是 L2 课题，不定义产品/系统需求。
+迁出来源: #1194 旧版“项目编号与命名规则 / L1 方向判定 / 层级职责边界 / 管理入口职责边界 / 交叉引用检查 / 偏离判定 / 回写规则”章节
+迁出时间: 2026-06-14（北京时间）
+
+## 使用规则
+
+- 本文档 只保存项目管理和规格治理规则，供 #1194、L1/L2/L3/L4 issue 引用。
+- 不在本文档 中新增、删除或重排 L1 方向；L1 方向树以 #1194 为准。
+- 不在本文档 中记录阶段进展、CaseRun 日志、PR 流水或具体实现方案。
+- 治理规则变化需要回写 #1194 的引用关系，并同步更新 UniDesk `$unidesk-oa`。
+
+## 编号与命名规则
+
+- 编号格式：`PJ<立项年份>-<层级路径>`。
+- `PJ` 表示项目，`2026` 表示立项年份。
+- HWLAB L0 总项目编号固定为 `PJ2026-01`。
+- L1 方向编号在 L0 路径后追加两位，例如 `PJ2026-0101` 表示 HWLAB 第 1 个 L1 方向。
+- L2 课题编号继续追加两位，例如 `PJ2026-010102` 表示 HWLAB 第 1 个 L1 方向下的第 2 个 L2 课题。
+- L3/L4 持久管理节点继续每级追加两位，例如 `PJ2026-01010203` 表示 L1 #01 / L2 #02 / L3 #03。
+- 已分配的持久编号不因优先级、阶段或主线变化而重排；新增持久节点只追加新后缀。
+- 单个 PR、一次 smoke、一次 CaseRun 等纯执行项可以只引用最近的持久编号，不强制独立编号。
+- 持久节点必须有短名，一般控制在 8 个中文汉字以内；必要解释写在说明列或正文里，不塞进名称。
+- issue 标题建议格式：`<编号> <短名>`；执行 issue 可在短名后追加冒号和具体任务描述。
+
+## 层级职责边界
+
+| 层级 | 负责定义 | 不负责 | 回写对象 |
+| --- | --- | --- | --- |
+| L0 / `PJ2026-01` | 项目使命、系统范围、L1 方向树、全局需求、全局验收 | PR 细节、CaseRun 日志、日报流水、具体实现设计 | `project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`、L1 issue |
+| L1 / 方向 | 能力域范围、成功标准、L2 课题清单、原入口验收类型、交叉引用边界 | 单个 PR、一次 smoke、仓库/工具/runtime 名称、项目管理动作 | #1194；方向范围变化时同步 `project-management/PJ2026-01` |
+| L2 / 课题 | 单个方向内的具体工作计划、交付物、阻塞、验收计划 | 总方向定义、跨方向路线图、实现细节流水 | 所属 L1；重大移动再回写 #1194 |
+| L3 / 验收切片 | 一个有界验收切片和单一验收路径 | 多课题计划、父级范围变化、新能力域定义 | 所属 L2/L1，并附 evidence |
+| L4 / 执行任务 | PR、CaseRun、smoke、部署、文档收口等执行和 evidence | 新需求、新方向、验收规则变化 | 最近的 L3/L2/L1，必要时回写 #1194 |
+
+## L1 主责判定
+
+L1 方向必须是直接服务 L0 使命的一等产品/系统边界，并能定义下级工作的完成标准。L1 不是松散标签；跨方向任务可以列关联方向，但必须有且只有一个主责 L1。主责 L1 按“谁定义完成标准、谁接收回写 evidence”判定。
+
+合格的 L1 方向应同时满足：
+
+- 直接支撑云端硬件研发平台的产品、技术或运营能力。
+- 可以承载多个 L2 课题和验证切片，而不是单个 PR 或单次文档更新。
+- 有明确的用户价值、平台能力或真实运行面验收方式。
+- 能说明上游依赖、下游支撑、接口/证据边界和需同步回写对象。
+
+## 管理入口职责边界
+
+| 入口 | 定位 | 能定义 | 不能定义/承载 | 回写要求 |
+| --- | --- | --- | --- | --- |
+| #1194 / `PJ2026-01` | L0 总项目需求规格 | 使命、范围、方向树、全局需求、全局验收 | 执行流水、PR 细节、CaseRun 原始日志、治理细则全文 | L1 范围变化和重大验收移动必须回写 |
+| #645 | 长期总面板和导航摘要 | L0/L1/L2 入口索引、阶段入口、历史专题导航 | 规格正文、验收标准、方向定义 | 指向 #1194，不替代 #1194 |
+| #644 | Cloud M1 当前阶段规格 | 当前阶段目标、阶段口径、阶段验收重点 | L0 总规格、L1 方向本身、长期编号规则 | 阶段目标变化影响总规格时回写 #1194 |
+| `project-management/PJ2026-01` | 长期文档和阶段报告沉淀 | 稳定规格、实施方案、测试规格、阶段报告 | 日常执行看板、未收敛讨论 | 从 issue 蒸馏稳定结论回文档 |
+| UniDesk `$unidesk-oa` | agent 侧项目治理操作规程 | agent 如何识别锚点、编号、职责、回写 | HWLAB 项目内容本身、L1 能力域 | 治理规则变化后更新 skill，并在 #1194 索引 commit |
+
+## 交叉引用检查
+
+- L1/L2/L3 issue 只要涉及互相支撑，必须在正文写明“上游依赖、下游支撑、接口/证据边界、需同步回写”。
+- 依赖其他 L1 的能力时，必须引用对应 L1 issue 编号；不能只写方向名。
+- 如果一个变更影响多个 L1 的接口、证据或验收标准，主责 L1 必须回写受影响 L1，并在 #1194 留下重大移动摘要。
+- 下级 issue 关闭前必须检查引用对象是否需要同步更新；引用未回写时不得直接关闭。
+- #645 只做导航索引，不替代上述交叉引用检查。
+
+## 偏离判定
+
+出现以下情况时，任务必须先回到 #1194 或对应 L1 issue 重新归类：
+
+- 把文档整理、项目管理、skill 维护、看板维护或阶段报告当成 L1 方向。
+- 没有上级 L1 方向，却直接创建实现任务。
+- 涉及互相支撑但未引用对应 L1 issue。
+- 没有明确原入口验收，却计划关闭用户可见能力 issue。
+- 工具、CI、Web parity、观测增强没有解除某个 L1 的明确 blocker。
+- 阶段报告只统计 issue/PR 数量，没有说明对 L1 验收的移动。
+- 硬件池、Agent编排、HarnessRL、客户端、用户管理、平台运维互相抢主责，但没有说明 primary L1 和交叉引用。
+
+## 回写规则
+
+- `#645` 只做长期总面板和导航，不承担规格正文。
+- L1 方向变化必须回写 #1194 正文。
+- L1/L2/L3 持久管理 issue 标题必须以编号和短名开头。
+- L1 issue 关闭或阶段完成时，必须评论回写 #1194，并说明验收证据、剩余 blocker 和是否需要更新项目管理规格。
+- L2/L3/L4 执行 issue 必须写明编号、短名、上级总项目、主责方向、关联方向、目标 lane/branch、验收入口和完成后回写对象。
+- 稳定规则和长期规格最终应沉淀到 `project-management/PJ2026-01`；issue 保留执行状态、讨论、证据和交叉引用。
+- agent 处理 HWLAB OA/总规格/项目漂移/issue 树任务时，应先加载 `$unidesk-oa`，并以 #1194 锚点为准。
+
@@ -0,0 +1,167 @@
+# HWLAB Cloud SPEC / 云平台开发目标 20260601
+
+## 修改历史
+
+| 版本 | 对应 commit id | 更新日期 | 变更说明 |
+| --- | --- | --- | --- |
+| v0.1 | 待提交 | 2026-06-14 | 从 pikasTech/HWLAB#644 迁移到 UniDesk 项目管理目录。 |
+
+## 迁移来源
+
+| 字段 | 内容 |
+| --- | --- |
+| 原 issue | pikasTech/HWLAB#644 |
+| 原标题 | HWLAB Cloud SPEC / 云平台开发目标 20260601 |
+| 原 URL | https://github.com/pikasTech/HWLAB/issues/644 |
+| 原状态 | open |
+| 原更新时间 | 2026-06-05T03:14:18Z |
+| 原 body SHA | 69a4da1f218bff0c8c1a1247df513a77ccba22990c657fa681e3675484aa4fb5 |
+
+## 正文
+
+## HWLAB Cloud SPEC / 云平台开发目标 20260601
+
+## 背景
+
+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 长期看板中取代旧的 MVP 单线叙述。
+
+## 目标
+
+### 1. 吸收本地嵌入式 AI Coding 的最佳实践
+
+吸收本地嵌入式 AI Coding 的最佳实践，包括 SKILL/Pipeline/docs/TODO 管理等，做到云端开箱即用。做到用户免本地配置开箱即用。
+
+### 2. 增强对 ARM2D 的开发能力
+
+增强对 ARM2D 的开发能力，包括吸收已有的 SKILL。
+
+### 3. 增强监管 AGENT
+
+增强监管 AGENT，专门负责对抗监督，降低 AI 不按预定的技术路线写的问题，在 ARM2D 的移植任务上做优化和验证。
+
+### 4. 提高云平台的云端协同能力
+
+提高云平台的云端协同能力，支持多用户同时访问同一个 Code Agent。提供远程协作 AI Coding。
+
+### 5. 提高对硬件的接入能力
+
+提高对硬件的接入能力，包括：
+
+- **定义可接入硬件设备的标准和接口**：即 HWPOD 设备应该具备哪些能力，提供哪些接口
+- **接入调试盒子**：调试盒子先用开发板代替进行固件和云开发
+- **接入接线盘**：接线盘暂时不接入，等接线盘硬件搭建后再接入
+
+## 关联
+
+- 承接：HWLAB#7（HWLAB 长期总看板）当前阶段"Code Agent 真实可用 + M3 虚拟硬件可信闭环"已收敛
+- 取代：DC-DCSN-P0-2026-003 在 v0.2 / 16666-16667 范围的"MVP 优先"口径（云端协同 / HWPOD / 监管 AGENT 部分超出口径时回到本 SPEC）
+- 关联 issue：
+  - #621 v0.2 Workbench 会话随用户账号持久化（多用户 / 跨设备恢复，目标 4）
+  - #627 Playwright/Chromium 运行环境与 Workbench browser smoke 防回归治理（云端开箱即用，关联目标 1）
+  - #633 PR 自动 CI / 自动 merge / deploy.json CD 分层（监管 AGENT 的工程护栏，关联目标 3）
+  - #533 v0.2 Device Pod 正式接入规格（被本 SPEC 目标 5 的"HWPOD 设备标准"包含并展开）
+
+## 阶段（2026-06-01 起）
+
+| 阶段 | 焦点 | 验收 |
+| --- | --- | --- |
+| Phase A 2026-06 | HWPOD 设备能力 / 接口标准 v1 起草 + 监管 AGENT 边界稿 | HWPOD v1 SPEC issue 发布；监管 AGENT 边界定义 v1 |
+| Phase B 2026-07 | 调试盒子用开发板替代接入 v0 + 多用户同 Code Agent 最小可用 | 公开 demo 多人会话；HWPOD v1 在调试盒子上跑通最小 IO |
+| Phase C 2026-08 | ARM2D 移植任务优化与监管 AGENT 闭环 + SKILL/Pipeline/docs/TODO 统一收口 | ARM2D 一次完整移植成功由监管 AGENT 留痕；本地 SKILL 全部上云 |
+
+## 签发
+
+- 签发日期：2026-06-01
+- 签发人：staff
+- 适用版本：HWLAB v0.2 之后
+- 维护：#7 长期看板"下一阶段路线"段落
+
+## 2026-06-05 设计补充：HWPOD Harness 单线程闭环与远景
+
+### 当前定稿：先打通单线程 Harness 闭环
+
+本阶段不先做批量训练、分级调度、虚拟/真实硬件分层治理或完整 eval registry。优先打通一个 profile、一类硬件执行节点、一次 Code Agent harness run、一组 evidence 的单线程闭环。
+
+当前三层命名与职责定稿如下：
+
+| 名称 | 职责 | 边界 |
+| --- | --- | --- |
+| `hwpod` | Code Agent / 用户运行时 Harness 入口，用于 workspace、patch、build、download、UART/JSON-RPC、evidence 和 closeout | 不管理 profile，不更新执行节点，不绕过工具协议直接做临时 shell/cmd 维护 |
+| `hwpodctl` | 管理入口，用于 profile 管理、node 绑定、临时 cmd 透传维护、更新 `hwpod-node`、readiness/smoke 和 selector 生成 | 是管理员/平台侧能力，不作为 Code Agent 常规运行时入口 |
+| `hwpod-node` | 靠近硬件的边缘执行节点，承接 build/download/uart/evidence 等真实动作 | 不等同于用户 PC host，也不是 USB/内核 driver；只执行受控命令并返回结构化 JSON |
+
+`hwpod-node` 可以运行在用户 PC、实验室控制盒、AI 网关、调试器边缘设备或其他靠近硬件的计算端点上；因此不使用 `hwpod-host` 作为主名。`hwlab-gateway` / tunnel / outbound poll 连接属于 `hwpod-node` 的 transport 或连接组件，不作为用户侧主抽象。
+
+与现有 v0.2 名称的映射：
+
+- `device-pod-cli` / 当前 `hwpod` alias -> `hwpod`
+- profile SOP、gateway 启动、host 文件同步、临时维护脚本 -> `hwpodctl`
+- D601 Windows `device-host-cli.mjs` 及后续 AI 网关/调试器边缘执行器 -> `hwpod-node`
+- `hwlab-device-pod` cloud service / executor -> 云端执行适配层，负责把 Cloud API 请求路由到对应 `hwpod-node`
+
+### Kubernetes 语义对齐
+
+本命名借用 Kubernetes 调度词汇，但不把 `hwpod` 等同于 Kubernetes Pod：
+
+| Kubernetes | HWPOD Harness |
+| --- | --- |
+| `kubectl` | `hwpodctl` |
+| Pod | `hwpod`，硬件研发执行上下文 |
+| Node | `hwpod-node`，靠近硬件的执行节点 |
+| kubelet | `hwpod-node` runtime/agent |
+| manifest / CRD | profile / harness spec |
+| Job | 一次 harness run |
+| Namespace | project / tenant / lab lane |
+
+`hwpod` 表示可被 Agent 或用户调用的硬件研发执行上下文，绑定 profile、workspace、toolchain、node capability 和 evidence 流。它可以由 Kubernetes Pod 承载，但产品语义不是 Kubernetes workload object。
+
+### 单线程 MVP 验收闭环
+
+第一版闭环建议固定为：
+
+1. `hwpodctl apply -f <profile.yaml>`：注册或更新一个 HWPOD profile。
+2. `hwpodctl get nodes` / `hwpodctl node status <node>`：确认 `hwpod-node` 在线、版本、能力和 gateway/transport 状态。
+3. `hwpodctl update node <node>`：把节点执行器更新到期望版本，解决当前 v0.2 中 cloud rollout 成功但 D601 host-side CLI 未同步的断点。
+4. `hwpodctl smoke <profile>`：用只读或 echo 级动作证明 cloud-api -> executor -> hwpod-node -> hardware-adjacent runtime 可达。
+5. Code Agent 使用 `hwpod` 执行一次真实任务：workspace inspect / apply-patch / build / download / UART 或 JSON-RPC smoke。
+6. `hwpod evidence` 或等价 closeout 输出 build log、download log、UART tail、node version、profile id、run id 和失败分类。
+
+本阶段最重要的产品约束：
+
+- `hwpod` 只做运行时 harness 操作，不做运维维护。
+- `hwpodctl` 可以做临时 cmd 透传和节点更新，但必须留下版本、命令、smoke 和 evidence 记录。
+- `hwpod-node` 只执行受控动作并输出结构化 JSON，不拥有云端用户、项目、Agent 策略或 CI/CD 决策。
+- 云端 runtime version、profile version、`hwpod-node` version 和 smoke result 必须能被同一条状态命令看见，避免“云端成功、边缘执行器仍旧”的假绿。
+
+### 远景：云 Harness 训练与用户开发平台
+
+单线程闭环跑通后，HWPOD Harness 的远景不是单纯远程调试硬件，而是云端硬件研发训练与用户开发平台：
+
+- 云端批量起 sandbox，对同一个硬件研发任务并行运行不同模型、prompt、tool schema 和 Agent 策略。
+- 真实 `hwpod-node` / 设备池作为稀缺资源，由云端统一排队、锁定、审计和计量。
+- 每次 run 留下统一 trace/evidence，包括代码 diff、build/download/UART、tool call、node/profile 版本和失败分类。
+- 内部先用 HWLAB 自身 issue dogfood：每个修复任务都沉淀为 harness case，成功路径进入回归/eval，失败路径进入训练样本和产品缺口。
+- 对外用户看到的是“导入项目 -> 选择 profile -> 运行 harness -> 查看成功率/失败原因/evidence -> 复用为 CI/HIL gate”的开发平台，而不是裸容器日志或远程 shell。
+
+因此云端的核心价值不是替代本地调试手感，而是把硬件研发过程变成可重复、可审计、可训练、可协作、可计量的平台能力。本地 PC、AI 网关和调试器边缘设备都作为 `hwpod-node` 接入云端控制面；用户开发体验先由单线程闭环打磨，再演进到批量 harness 和训练平台。
+
+## 2026-06-05 关联补充：HWPOD Harness 概念体系
+
+- 专门概念体系 issue：#897 `HWPOD Harness 概念体系与 v0.2 架构映射`。
+- #897 将 #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` 的对应关系。
+
+## 2026-06-05 修订：HWPOD Harness 以 #897 最新四要素口径为准
+
+- #897 已修订为核心业务概念体系：`hwpod` 是由 target device、workspace、debug probe、io probe 四个硬件研发要素组成的实体。
+- Profile 只作为记录/声明这四个要素的配置方式，不作为独立平级概念，也不是 hwpod 的四要素之一。
+- Code Agent / 用户运行时入口统一命名为 `hwpod-run`；管理入口统一命名为 `hwpod-ctl`；边缘执行节点统一命名为 `hwpod-node`。
+- #644 上方 2026-06-05 设计补充中的早期 `hwpod`/`hwpodctl`/Evidence 摘要只保留为讨论历史，后续实现和文档以 #897 最新口径为准。
+
+## 2026-06-05 修订：HWPOD Harness 快速迭代阶段以 #897 最新口径为准
+
+- #897 已更新为当前 HWPOD Harness 概念体系的权威 issue。
+- 快速迭代阶段先做 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 上方 2026-06-05 早期 `hwpod`/`hwpodctl`/`hwpod-run`/Profile/Evidence 摘要只保留为讨论历史，后续实现和文档以 #897 最新口径为准。
+