mirrors/pikasTech-unidesk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: normalize HWLAB issue links

Browse Source
This commit is contained in:
Codex
2026-06-14 14:47:36 +00:00
parent 8671406c82
commit b0cbe9b721
14 changed files with 277 additions and 266 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.agents/skills/unidesk-gh/SKILL.md
+1
View File
@@ -14,6 +14,7 @@ UniDesk 受控 GitHub 操作入口，所有 issue/PR 读写走 `bun scripts/cli.
- Issue/PR 的正式写入一律使用中文，包括标题、正文、评论、关闭/重开说明、PR 描述、PR 评论和 merge closeout 说明。
- 命令、路径、trace/session/job id、API path、代码标识符、英文专有名词、原始日志摘录和外部错误原文可以保留原样；解释性文字、结论、风险、计划和验收说明必须中文。
- 除非用户明确要求外文，不要用英文撰写 issue/PR closeout、进展评论或阻塞说明。
- Markdown 正文、issue/PR 正文和评论里的 issue/PR 引用必须写完整 HTTPS URL，例如 `https://github.com/pikasTech/HWLAB/issues/1194` 或 `https://github.com/pikasTech/HWLAB/pull/1234`；不要把裸井号编号或 `owner/repo` 加井号编号当成正文引用。`owner/repo#number` 只允许作为 CLI 命令参数 shorthand。
---
.agents/skills/unidesk-oa/SKILL.md
+5 -4
View File
@@ -18,6 +18,7 @@ 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 引用必须使用完整 `https://github.com/<owner>/<repo>/issues/<number>` 或 `https://github.com/<owner>/<repo>/pull/<number>` URL；不要写裸井号编号或 `owner/repo` 加井号编号。CLI 参数中的 `owner/repo#number` shorthand 只作为命令输入例外。
- 不要让日报或阶段报告成为总规划。阶段报告只总结相对总规格的移动，不能替代中心规划。
- 当任务缺少上级方向、验收标准或原始验证入口时，先归类为规划/调查，不要直接变成实现任务。
- L1 方向必须是直接服务 L0 使命的能力域。文档整理、阶段报告、项目管理机制、看板维护、技能维护、仓库名、工具名和临时执行路径都不能作为 L1 方向。
@@ -25,10 +26,10 @@ description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管
## HWLAB 标准 issue 锚点
- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`，历史 issue `pikasTech/HWLAB#1194`。
- 长期导航面板：`pikasTech/HWLAB#645`（`HWLAB 长期总面板`）。这是面板，不是规格书。
- 当前 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` 只作为导航索引。
- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`，历史 issue `https://github.com/pikasTech/HWLAB/issues/1194`。
- 长期导航面板：`https://github.com/pikasTech/HWLAB/issues/645`（`HWLAB 长期总面板`）。这是面板，不是规格书。
- 当前 Cloud M1 阶段规格：`project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md`，历史 issue `https://github.com/pikasTech/HWLAB/issues/644`。
- 创建或更新 HWLAB 项目管理 issue 时，非平凡 L1/L2/L3/L4 工作都要链接回 `project-management/PJ2026-01` 中的对应规格文件，并保持 `https://github.com/pikasTech/HWLAB/issues/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 个中文汉字以内，解释写在正文，不写进名称。
## 工作流
.agents/skills/unidesk-oa/references/project-planning.md
+7 -6
View File
@@ -32,20 +32,21 @@ HWLAB Cloud M1 需要一个项目控制结构，避免局部 issue/PR 工作偏
不要把稳定需求的唯一副本放在 issue 评论里。长期有效的需求必须蒸馏到 `project-management/PJ2026-01`，再从 issue 链接过去。
不要把长证据正文放进项目管理目录。项目管理目录只承载规格、治理和阶段中心；长证据保留在 GitHub issue。
所有 Markdown 正文、issue/PR 正文和评论中的 issue/PR 引用都必须写成完整 HTTPS URL，例如 `https://github.com/pikasTech/HWLAB/issues/1194` 或 `https://github.com/pikasTech/HWLAB/pull/1234`；不要使用裸井号编号或 `owner/repo` 加井号编号。`owner/repo#number` 只允许作为 CLI 命令参数 shorthand。
## 当前 HWLAB issue 锚点
- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`。该规格文档本身承担索引职责；历史 issue 为 `pikasTech/HWLAB#1194`。
- 长期面板/导航：`pikasTech/HWLAB#645`（`HWLAB 长期总面板`）。不要把它当成规格书。
- Cloud M1 阶段规格：`project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md`。这是阶段规格，不是 L1 方向；历史 issue 为 `pikasTech/HWLAB#644`。
- 新建或更新方向/课题/执行 issue 时，除非用户明确限定在 HWLAB Cloud M1 之外，否则正文应包含 `上级总项目: #1194`。
- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`。该规格文档本身承担索引职责；历史 issue 为 `https://github.com/pikasTech/HWLAB/issues/1194`。
- 长期面板/导航：`https://github.com/pikasTech/HWLAB/issues/645`（`HWLAB 长期总面板`）。不要把它当成规格书。
- Cloud M1 阶段规格：`project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md`。这是阶段规格，不是 L1 方向；历史 issue 为 `https://github.com/pikasTech/HWLAB/issues/644`。
- 新建或更新方向/课题/执行 issue 时，除非用户明确限定在 HWLAB Cloud M1 之外，否则正文应包含 `上级总项目: https://github.com/pikasTech/HWLAB/issues/1194`。
## 编号规则
- HWLAB L0 项目编号是 `PJ2026-01`：`PJ` 表示项目，`2026` 是立项年份，`01` 是 HWLAB L0 序号。
- L1 方向编号为 `PJ2026-0101`、`PJ2026-0102`、`PJ2026-0103` 等。
- L2 课题编号在 L1 编号后继续追加两位，例如 `PJ2026-010101`、`PJ2026-010102`、`PJ2026-010201`。
- L3/L4 长期管理编号继续每级追加两位，例如 `PJ2026-01010203` 表示 HWLAB L1 #01 / L2 #02 / L3 #03。
- L3/L4 长期管理编号继续每级追加两位，例如 `PJ2026-01010203` 表示 HWLAB L1 第 01 个 / L2 第 02 个 / L3 第 03 个。
- 不要因为优先级变化而重编号。新稳定节点追加新后缀；执行型 PR 或一次性 smoke 可以引用最近的稳定编号，不一定单独编号。
- 稳定节点短名通常不超过 8 个中文汉字。issue 标题应以编号和短名开头，例如 `PJ2026-010102 频源造模`；详细解释写在正文。
@@ -112,7 +113,7 @@ L0 定义：
- issue 层级索引。
- 偏离指标。
通常应该有一个 L0 GitHub issue 和一个 L0 总规格文档。对 HWLAB 来说，标准 L0 编号是 `PJ2026-01`，标准 L0 issue 是 `pikasTech/HWLAB#1194`；`#645` 只作为长期面板/导航入口。
通常应该有一个 L0 GitHub issue 和一个 L0 总规格文档。对 HWLAB 来说，标准 L0 编号是 `PJ2026-01`，标准 L0 issue 是 `https://github.com/pikasTech/HWLAB/issues/1194`；`https://github.com/pikasTech/HWLAB/issues/645` 只作为长期面板/导航入口。
### L1 方向
.agents/skills/unidesk-oa/references/templates.md
+13 -13
View File
@@ -78,8 +78,8 @@
编号: PJ2026-01
短名: HWLAB
上级面板: #645
当前 L0 总规格: #1194
上级面板: https://github.com/pikasTech/HWLAB/issues/645
当前 L0 总规格: https://github.com/pikasTech/HWLAB/issues/1194
总规格文档: project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md
## 项目中心
@@ -90,12 +90,12 @@
## L1 方向
- [ ] PJ2026-0101 #... 硬件池:
- [ ] PJ2026-0102 #... Agent编排:
- [ ] PJ2026-0103 #... HarnessRL:
- [ ] PJ2026-0104 #... 客户端:
- [ ] PJ2026-0105 #... 用户管理:
- [ ] PJ2026-0106 #... 平台运维:
- [ ] PJ2026-0101 https://github.com/pikasTech/HWLAB/issues/<issue-number> 硬件池:
- [ ] PJ2026-0102 https://github.com/pikasTech/HWLAB/issues/<issue-number> Agent编排:
- [ ] PJ2026-0103 https://github.com/pikasTech/HWLAB/issues/<issue-number> HarnessRL:
- [ ] PJ2026-0104 https://github.com/pikasTech/HWLAB/issues/<issue-number> 客户端:
- [ ] PJ2026-0105 https://github.com/pikasTech/HWLAB/issues/<issue-number> 用户管理:
- [ ] PJ2026-0106 https://github.com/pikasTech/HWLAB/issues/<issue-number> 平台运维:
方向判定: L1 必须是直接服务 L0 的能力域；文档整理、项目管理、看板维护、技能维护、仓库名、工具名和临时执行路径不得作为 L1。
@@ -135,7 +135,7 @@
编号: PJ2026-010N
短名: <8字以内>
上级总项目: #1194
上级总项目: https://github.com/pikasTech/HWLAB/issues/1194
总规格文档: project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md
## 主责边界
@@ -162,7 +162,7 @@
## L2 课题
- [ ] #...
- [ ] https://github.com/pikasTech/HWLAB/issues/<issue-number>
## 验收标准
@@ -187,11 +187,11 @@
编号: PJ2026-010N0M
短名: <8字以内>
上级总项目: #1194
上级总项目: https://github.com/pikasTech/HWLAB/issues/1194
主责方向: PJ2026-010N <短名>
关联方向: <可空；只列交接方向，不替代主责>
所属方向: #...
所属课题: #...
所属方向: https://github.com/pikasTech/HWLAB/issues/<issue-number>
所属课题: https://github.com/pikasTech/HWLAB/issues/<issue-number>
规格文档: project-management/PJ2026-01/specs/<对应规格文件>.md
## 目标
project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md
+46 -45
View File
@@ -4,14 +4,15 @@
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.3 | 待提交 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
| v0.2 | b40a37ce771811cc97d74ef0909a7ce441161c6b | 2026-06-14 | 移除项目管理目录中的 evidence 文件，长证据保留在 GitHub issue。 |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#1194 迁移到 UniDesk 项目管理目录。 |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 https://github.com/pikasTech/HWLAB/issues/1194 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
| 字段 | 内容 |
| --- | --- |
| 原 issue | pikasTech/HWLAB#1194 |
| 原 issue | https://github.com/pikasTech/HWLAB/issues/1194 |
| 原标题 | PJ2026-01 HWLAB 总规格 |
| 原 URL | https://github.com/pikasTech/HWLAB/issues/1194 |
| 原状态 | open |
@@ -22,18 +23,18 @@
| 层级 | 文件 | 历史 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 |
| 阶段规格 | [stage-cloud-spec-20260601.md](stage-cloud-spec-20260601.md) | https://github.com/pikasTech/HWLAB/issues/644 |
| L0 总规格 | [PJ2026-01-HWLAB.md](PJ2026-01-HWLAB.md) | https://github.com/pikasTech/HWLAB/issues/1194 |
| L1 硬件池 | [PJ2026-0101-hardware-pool.md](PJ2026-0101-hardware-pool.md) | https://github.com/pikasTech/HWLAB/issues/1203 |
| L1 Agent编排 | [PJ2026-0102-agent-orchestration.md](PJ2026-0102-agent-orchestration.md) | https://github.com/pikasTech/HWLAB/issues/1204 |
| L1 HarnessRL | [PJ2026-0103-harness-rl.md](PJ2026-0103-harness-rl.md) | https://github.com/pikasTech/HWLAB/issues/1205 |
| L1 客户端 | [PJ2026-0104-client.md](PJ2026-0104-client.md) | https://github.com/pikasTech/HWLAB/issues/1206 |
| L1 用户管理 | [PJ2026-0105-user-management.md](PJ2026-0105-user-management.md) | https://github.com/pikasTech/HWLAB/issues/1207 |
| L1 平台运维 | [PJ2026-0106-platform-ops.md](PJ2026-0106-platform-ops.md) | https://github.com/pikasTech/HWLAB/issues/1208 |
| 治理规则 | [spec-governance.md](spec-governance.md) | https://github.com/pikasTech/HWLAB/issues/1217 |
| 当前中心 | [current-center.md](current-center.md) | https://github.com/pikasTech/HWLAB/issues/1218 |
长证据不进入项目管理目录。硬件池证据保留在 pikasTech/HWLAB#1216，Agent编排证据保留在 pikasTech/HWLAB#1223；规格文件只引用证据 issue，不复制证据正文。
长证据不进入项目管理目录。硬件池证据保留在 https://github.com/pikasTech/HWLAB/issues/1216，Agent编排证据保留在 https://github.com/pikasTech/HWLAB/issues/1223；规格文件只引用证据 issue，不复制证据正文。
## 正文
@@ -47,14 +48,14 @@
| 短名 | HWLAB |
| 层级 | L0 总项目 |
| 状态 | active / L0 需求规格锚点 |
| 长期面板 | #645 HWLAB 长期总面板 |
| 阶段规格 | #644 HWLAB Cloud SPEC / 云平台开发目标 20260601 |
| 阶段中心索引 | #1218 HWLAB 当前中心索引：阶段主线与非中心边界 |
| 规格治理索引 | #1217 HWLAB 规格治理索引：编号、层级、回写与偏离规则 |
| L1 划分 | 保持现有六方向：#1203、#1204、#1205、#1206、#1207、#1208 |
| 长期面板 | https://github.com/pikasTech/HWLAB/issues/645 HWLAB 长期总面板 |
| 阶段规格 | https://github.com/pikasTech/HWLAB/issues/644 HWLAB Cloud SPEC / 云平台开发目标 20260601 |
| 阶段中心索引 | https://github.com/pikasTech/HWLAB/issues/1218 HWLAB 当前中心索引：阶段主线与非中心边界 |
| 规格治理索引 | https://github.com/pikasTech/HWLAB/issues/1217 HWLAB 规格治理索引：编号、层级、回写与偏离规则 |
| L1 划分 | 保持现有六方向：https://github.com/pikasTech/HWLAB/issues/1203、https://github.com/pikasTech/HWLAB/issues/1204、https://github.com/pikasTech/HWLAB/issues/1205、https://github.com/pikasTech/HWLAB/issues/1206、https://github.com/pikasTech/HWLAB/issues/1207、https://github.com/pikasTech/HWLAB/issues/1208 |
| 规格来源 | `project-management/PJ2026-01` 与迁移前 HWLabOA 阶段材料 |
本文采用中文 L0 需求规格模板：正文只保留稳定使命、范围、运行概念、系统边界、L1 分配、全局原子需求、验证矩阵和追踪关系。编号规则、层级职责、回写、偏离判定和交叉引用治理迁入 #1217；阶段主线和非中心边界迁入 #1218。
本文采用中文 L0 需求规格模板：正文只保留稳定使命、范围、运行概念、系统边界、L1 分配、全局原子需求、验证矩阵和追踪关系。编号规则、层级职责、回写、偏离判定和交叉引用治理迁入 https://github.com/pikasTech/HWLAB/issues/1217；阶段主线和非中心边界迁入 https://github.com/pikasTech/HWLAB/issues/1218。
## 2. 目的和范围
@@ -76,8 +77,8 @@ HWLAB 的中心目标是把真实硬件资源、Agent 执行、Harness/RL 验收
- 无 L1 主责归属的孤立工具美化、旧门禁修补或无原入口验收的观测增强。
- 单个 PR、一次 CaseRun、一次 smoke、一次部署或阶段报告流水；这些属于 L3/L4 或报告，不属于 L0 需求规格正文。
- 具体实现设计、代码结构、临时运行面调试路径、原始日志堆叠和每日进展统计。
- 编号、回写、偏离和管理流程全文；这些由 #1217 承载。
- 当前阶段优先级和阶段主线全文；这些由 #1218 和 #644 承载。
- 编号、回写、偏离和管理流程全文；这些由 https://github.com/pikasTech/HWLAB/issues/1217 承载。
- 当前阶段优先级和阶段主线全文；这些由 https://github.com/pikasTech/HWLAB/issues/1218 和 https://github.com/pikasTech/HWLAB/issues/644 承载。
## 3. 运行概念
@@ -108,23 +109,23 @@ 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 用户管理 |
| PJ2026-0101 | 硬件池 | https://github.com/pikasTech/HWLAB/issues/1203 | 板卡、探针、HWPOD node、设备注册、资源占用、设备健康、可用性 | https://github.com/pikasTech/HWLAB/issues/1208 平台运维 | https://github.com/pikasTech/HWLAB/issues/1204 Agent编排、https://github.com/pikasTech/HWLAB/issues/1205 HarnessRL、https://github.com/pikasTech/HWLAB/issues/1206 客户端 |
| PJ2026-0102 | Agent编排 | https://github.com/pikasTech/HWLAB/issues/1204 | Code Agent、AgentRun、workspace、session、provider profile、任务生命周期、任务恢复 | https://github.com/pikasTech/HWLAB/issues/1203 硬件池、https://github.com/pikasTech/HWLAB/issues/1208 平台运维、https://github.com/pikasTech/HWLAB/issues/1207 用户管理 | https://github.com/pikasTech/HWLAB/issues/1205 HarnessRL、https://github.com/pikasTech/HWLAB/issues/1206 客户端 |
| PJ2026-0103 | HarnessRL | https://github.com/pikasTech/HWLAB/issues/1205 | harness、CaseRun、ioProbe、evidence、评估、回放、训练反馈、RL 闭环 | https://github.com/pikasTech/HWLAB/issues/1203 硬件池、https://github.com/pikasTech/HWLAB/issues/1204 Agent编排、https://github.com/pikasTech/HWLAB/issues/1208 平台运维 | https://github.com/pikasTech/HWLAB/issues/1206 客户端、https://github.com/pikasTech/HWLAB/issues/1207 用户管理 |
| PJ2026-0104 | 客户端 | https://github.com/pikasTech/HWLAB/issues/1206 | Web、CLI、HTTP API、SDK/IDE 插件、webhook、公开文档、兼容性、用户任务入口与结果获取 | https://github.com/pikasTech/HWLAB/issues/1207 用户管理、https://github.com/pikasTech/HWLAB/issues/1204 Agent编排、https://github.com/pikasTech/HWLAB/issues/1203 硬件池、https://github.com/pikasTech/HWLAB/issues/1205 HarnessRL、https://github.com/pikasTech/HWLAB/issues/1208 平台运维 | 用户入口和集成调用 |
| PJ2026-0105 | 用户管理 | https://github.com/pikasTech/HWLAB/issues/1207 | 用户、注册登录、权限、API key、credit、usage、billing、admin、租户隔离 | https://github.com/pikasTech/HWLAB/issues/1206 客户端、https://github.com/pikasTech/HWLAB/issues/1204 Agent编排、https://github.com/pikasTech/HWLAB/issues/1205 HarnessRL、https://github.com/pikasTech/HWLAB/issues/1208 平台运维 | https://github.com/pikasTech/HWLAB/issues/1206 客户端、https://github.com/pikasTech/HWLAB/issues/1204 Agent编排、https://github.com/pikasTech/HWLAB/issues/1203 硬件池、https://github.com/pikasTech/HWLAB/issues/1205 HarnessRL |
| PJ2026-0106 | 平台运维 | https://github.com/pikasTech/HWLAB/issues/1208 | CI/CD、git mirror、YAML-first、Secret 下发、rollout、observability、GC、平台发布 | 全部 L1 的发布/配置/观测需求 | https://github.com/pikasTech/HWLAB/issues/1203 硬件池、https://github.com/pikasTech/HWLAB/issues/1204 Agent编排、https://github.com/pikasTech/HWLAB/issues/1205 HarnessRL、https://github.com/pikasTech/HWLAB/issues/1206 客户端、https://github.com/pikasTech/HWLAB/issues/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-001 | HWLAB 应提供真实硬件资源池，使任务能发现、分配、占用、释放并验证真实设备、probe、HWPOD node 和健康状态。 | 功能 | https://github.com/pikasTech/HWLAB/issues/1203 硬件池 | 测试、演示 |
| HWLAB-L0-REQ-002 | HWLAB 应提供 Agent 执行编排，使用户任务能进入受控 workspace/session/provider/runtime，并能跟踪、恢复、取消和归档结果。 | 功能 | https://github.com/pikasTech/HWLAB/issues/1204 Agent编排 | 测试、演示 |
| HWLAB-L0-REQ-003 | HWLAB 应提供 Harness/RL 验收闭环，使真实硬件任务产出可审计 evidence、aggregate、评估、回放和训练反馈。 | 功能 | https://github.com/pikasTech/HWLAB/issues/1205 HarnessRL | 测试、检查 |
| HWLAB-L0-REQ-004 | HWLAB 应提供统一客户端入口，使 Web、CLI、API、SDK/IDE plugin 和 Webhook 围绕同一任务模型、权限模型和结果模型协同演进。 | 功能 | https://github.com/pikasTech/HWLAB/issues/1206 客户端 | 测试、演示 |
| HWLAB-L0-REQ-005 | HWLAB 应提供多用户与运营管理，使身份、权限、API key、credit、usage、billing、admin 和租户隔离具有统一真相。 | 功能 | https://github.com/pikasTech/HWLAB/issues/1207 用户管理 | 测试、检查 |
| HWLAB-L0-REQ-006 | HWLAB 应提供平台交付与运维能力，使代码、配置、密钥、发布、入口、观测和清理通过受控入口维护。 | 支撑 | https://github.com/pikasTech/HWLAB/issues/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 | 检查 |
@@ -147,21 +148,21 @@ L1 划分保持现有六方向；本次整理不新增、不删除、不重命
| 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 |
| HWLAB-L0-REQ-001 | PJ2026-0101 硬件池 | Agent编排、HarnessRL、客户端、平台运维 | https://github.com/pikasTech/HWLAB/issues/1203 |
| HWLAB-L0-REQ-002 | PJ2026-0102 Agent编排 | 硬件池、HarnessRL、客户端、用户管理、平台运维 | https://github.com/pikasTech/HWLAB/issues/1204 |
| HWLAB-L0-REQ-003 | PJ2026-0103 HarnessRL | 硬件池、Agent编排、客户端、用户管理、平台运维 | https://github.com/pikasTech/HWLAB/issues/1205 |
| HWLAB-L0-REQ-004 | PJ2026-0104 客户端 | 用户管理、Agent编排、硬件池、HarnessRL、平台运维 | https://github.com/pikasTech/HWLAB/issues/1206 |
| HWLAB-L0-REQ-005 | PJ2026-0105 用户管理 | 客户端、Agent编排、HarnessRL、硬件池、平台运维 | https://github.com/pikasTech/HWLAB/issues/1207 |
| HWLAB-L0-REQ-006 | PJ2026-0106 平台运维 | 全部 L1 | https://github.com/pikasTech/HWLAB/issues/1208 |
| HWLAB-L0-REQ-007 | 全部 L1 | https://github.com/pikasTech/HWLAB/issues/1217 治理索引 | https://github.com/pikasTech/HWLAB/issues/1203 - https://github.com/pikasTech/HWLAB/issues/1208 |
| HWLAB-L0-REQ-008 | 全部 L1 | https://github.com/pikasTech/HWLAB/issues/1217 治理索引 | https://github.com/pikasTech/HWLAB/issues/1203 - https://github.com/pikasTech/HWLAB/issues/1208 |
| HWLAB-L0-REQ-009 | 全部 L1 | 项目管理规格文件、https://github.com/pikasTech/HWLAB/issues/1217、https://github.com/pikasTech/HWLAB/issues/1218、https://github.com/pikasTech/HWLAB/issues/644、https://github.com/pikasTech/HWLAB/issues/645 | https://github.com/pikasTech/HWLAB/issues/1194、https://github.com/pikasTech/HWLAB/issues/1203 - https://github.com/pikasTech/HWLAB/issues/1208 |
## 9. 引用和变更规则
- L1 划分变化必须更新本文档；本次整理未改变 L1 划分。
- 编号、层级、主责、回写、偏离和交叉引用治理规则见 #1217。
- 当前阶段主线、非中心边界和阶段计划见 #1218 与 #644。
- 长期导航见 #645；#645 不替代本规格。
- 编号、层级、主责、回写、偏离和交叉引用治理规则见 https://github.com/pikasTech/HWLAB/issues/1217。
- 当前阶段主线、非中心边界和阶段计划见 https://github.com/pikasTech/HWLAB/issues/1218 与 https://github.com/pikasTech/HWLAB/issues/644。
- 长期导航见 https://github.com/pikasTech/HWLAB/issues/645；https://github.com/pikasTech/HWLAB/issues/645 不替代本规格。
- 单次执行证据、CaseRun 日志、PR 流水和阶段报告不得堆入本规格正文，应写入对应 L1/L2/L3/L4 issue、证据索引或项目管理阶段报告。
- 稳定规格最终应沉淀到 `project-management/PJ2026-01`；issue 保留执行状态、讨论、证据链接和交叉引用。
project-management/PJ2026-01/specs/PJ2026-0101-hardware-pool.md
+43 -42
View File
@@ -4,13 +4,14 @@
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#1203 迁移到 UniDesk 项目管理目录。 |
| v0.2 | 待提交 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 https://github.com/pikasTech/HWLAB/issues/1203 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
| 字段 | 内容 |
| --- | --- |
| 原 issue | pikasTech/HWLAB#1203 |
| 原 issue | https://github.com/pikasTech/HWLAB/issues/1203 |
| 原标题 | PJ2026-0101 硬件池 |
| 原 URL | https://github.com/pikasTech/HWLAB/issues/1203 |
| 原状态 | open |
@@ -28,14 +29,14 @@
| 编号 | PJ2026-0101 |
| 短名 | 硬件池 |
| 层级 | L1 方向 |
| 上级总项目 | #1194 PJ2026-01 HWLAB 总规格 |
| 关联方向 | #1204 Agent编排、#1205 HarnessRL、#1206 客户端、#1208 平台运维 |
| 证据索引 | #1216 硬件池证据索引：HWPOD 与 CaseRun 基线归档 |
| 上级总项目 | https://github.com/pikasTech/HWLAB/issues/1194 PJ2026-01 HWLAB 总规格 |
| 关联方向 | https://github.com/pikasTech/HWLAB/issues/1204 Agent编排、https://github.com/pikasTech/HWLAB/issues/1205 HarnessRL、https://github.com/pikasTech/HWLAB/issues/1206 客户端、https://github.com/pikasTech/HWLAB/issues/1208 平台运维 |
| 证据索引 | https://github.com/pikasTech/HWLAB/issues/1216 硬件池证据索引：HWPOD 与 CaseRun 基线归档 |
| 规格状态 | active / issue 规格锚点 |
| 核对时间 | 2026-06-14 北京时间 |
| 主要运行面 | HWLAB v0.2，G14 runtime，D601/外部硬件节点 |
本文采用中文 L1 需求规格模板：正文只保留稳定需求、边界、原定 L2 分配、验证矩阵和追踪关系；CaseRun 流水、阶段报告、具体 bug 排查和单次证据不在本文展开，长证据统一迁入 #1216 或下级 L2/L3 issue。
本文采用中文 L1 需求规格模板：正文只保留稳定需求、边界、原定 L2 分配、验证矩阵和追踪关系；CaseRun 流水、阶段报告、具体 bug 排查和单次证据不在本文展开，长证据统一迁入 https://github.com/pikasTech/HWLAB/issues/1216 或下级 L2/L3 issue。
## 2. 目的和范围
@@ -52,11 +53,11 @@
### 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。
- Agent 任务生命周期、session/resume、provider profile 和调度策略，归 https://github.com/pikasTech/HWLAB/issues/1204。
- CaseRun pass/fail、aggregate、评估、回放和训练反馈，归 https://github.com/pikasTech/HWLAB/issues/1205。
- Web/CLI/API/SDK 的通用用户入口体验和展示契约，归 https://github.com/pikasTech/HWLAB/issues/1206。
- 用户账号、API key、credit、usage、billing 和租户策略，归 https://github.com/pikasTech/HWLAB/issues/1207。
- CI/CD、GitOps、Secret、public exposure 和 runtime 运维发布，归 https://github.com/pikasTech/HWLAB/issues/1208。
## 3. 运行概念
@@ -75,31 +76,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 |
| 原始证据 | HWPOD spec、nodeId、probe UID、job id、return code、ioProbe samples/stats、traceId、runId、registry commit；长证据索引见 https://github.com/pikasTech/HWLAB/issues/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 | 检查 |
| HWPOD-L1-REQ-001 | 硬件池应定义 HWPOD-SPEC，用于描述硬件资源身份、能力模型、AI 网关接入、操作能力和状态/错误语义。 | 功能 | https://github.com/pikasTech/HWLAB/issues/1194 / https://github.com/pikasTech/HWLAB/issues/1203 | PJ2026-010101 HWPOD标准 | 检查 |
| HWPOD-L1-REQ-002 | 硬件池应为每个可用硬件资源维护稳定的 `hwpod-id`、HWPOD spec 和 source-of-truth 路径。 | 功能 | 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 等操作入口。 | 功能 | https://github.com/pikasTech/HWLAB/issues/1203 | PJ2026-010102 HWPOD工具 | 测试 |
| HWPOD-L1-REQ-004 | HWPOD 工具应优先使用 HWLAB runtime API authority，并在存在 override 时暴露来源，避免遗留环境变量误路由。 | 约束 | https://github.com/pikasTech/HWLAB/issues/1091 | PJ2026-010102 HWPOD工具 | 测试、检查 |
| HWPOD-L1-REQ-005 | HWPOD 服务应支持服务端资源注册、管理、状态查询、必要权限/租约、请求接收、路由和结果归档。 | 功能 | https://github.com/pikasTech/HWLAB/issues/1203 | PJ2026-010103 HWPOD服务 | 测试、检查 |
| HWPOD-L1-REQ-006 | 当存在并发或多用户使用时，HWPOD 服务应在执行前完成占用、冲突检测、租约释放和超时安全收口。 | 功能/安全 | https://github.com/pikasTech/HWLAB/issues/1194 | PJ2026-010103 HWPOD服务 | 测试、演示 |
| HWPOD-L1-REQ-007 | AI 网关应暴露节点心跳、健康、inventory、命令执行、日志/artifact/IO 回传和适配器执行能力。 | 功能 | https://github.com/pikasTech/HWLAB/issues/1203 | PJ2026-010104 AI网关 | 演示、检查 |
| HWPOD-L1-REQ-008 | 当 download/debug 请求包含 probe 约束时，AI 网关或其适配器应验证请求 probe 与项目绑定一致；不一致时不得返回成功。 | 功能/约束 | https://github.com/pikasTech/HWLAB/issues/1092 | PJ2026-010104 AI网关 | 测试 |
| HWPOD-L1-REQ-009 | 当采集板外状态时，AI 网关应区分板内 echo 和外部 ioProbe 读数，并记录单位、samples、stats 和 raw evidence。 | 功能 | https://github.com/pikasTech/HWLAB/issues/1178 | PJ2026-010104 AI网关 | 测试 |
| HWPOD-L1-REQ-010 | 硬件池应输出原始硬件事实和错误语义，但不得定义 HarnessRL pass/fail、训练奖励或业务评分。 | 边界 | https://github.com/pikasTech/HWLAB/issues/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。 |
| PJ2026-010101 | HWPOD标准 | 定义 HWPOD-SPEC、硬件资源身份、能力模型、AI 网关接入标准、操作能力标准、状态/错误语义和验收基线。 | 客户端、HarnessRL、Agent编排 | 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 等操作入口。 | 客户端 | https://github.com/pikasTech/HWLAB/issues/1216 中 HWPOD build/download/UART/ioProbe 原入口证据；https://github.com/pikasTech/HWLAB/issues/1091 | 这不是通用客户端 L1。只要完成标准由 HWPOD 语义或真实硬件执行定义，就主归属硬件池。 |
| PJ2026-010103 | HWPOD服务 | 实现服务端 HWPOD 注册、管理、状态、必要权限/租约、请求接收、路由、结果归档，并把工具侧请求转发到 AI 网关节点。 | 用户管理、Agent编排、平台运维 | https://github.com/pikasTech/HWLAB/issues/1216 全部 CaseRun registry 证据；https://github.com/pikasTech/HWLAB/issues/1129、https://github.com/pikasTech/HWLAB/issues/1197 | 它负责 HWPOD 服务端语义，不负责全局部署机制、用户策略或 Agent 任务调度。 |
| PJ2026-010104 | AI网关 | 实现连接真实硬件到服务端的节点侧能力，包括 PC 客户端形态、硬件网关盒子形态、心跳、命令执行、日志/artifact/IO 结果回传和适配器执行。 | HarnessRL、Agent编排、平台运维 | https://github.com/pikasTech/HWLAB/issues/1216 中 probe、UART、board-comm、ioProbe、电流回采、频率源扩展证据；https://github.com/pikasTech/HWLAB/issues/1092、https://github.com/pikasTech/HWLAB/issues/1097、https://github.com/pikasTech/HWLAB/issues/1186 | debug probe、UART、board-comm、ioProbe、电压/电流/频率/CANopen 等适配器是网关侧能力切片，通常作为本 L2 下的 L3。 |
## 7. 吸收概念和归属规则
@@ -130,31 +131,31 @@
| 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 截断问题不改变硬件事实，但影响结果阅读。 |
| https://github.com/pikasTech/HWLAB/issues/1091 | PJ2026-010102 HWPOD工具 | 遗留 node ops URL 可能导致误路由。 |
| https://github.com/pikasTech/HWLAB/issues/1092 | PJ2026-010104 AI网关 | probe mismatch 可能被顶层误报成功。 |
| https://github.com/pikasTech/HWLAB/issues/1097 | PJ2026-010104 AI网关 | D601 hwpod-node 不稳定影响长任务。 |
| https://github.com/pikasTech/HWLAB/issues/1129 | PJ2026-010103 HWPOD服务 | CaseRun 与 Web runner 工具包可能不同步，涉及服务端/运行面工具分发。 |
| https://github.com/pikasTech/HWLAB/issues/1186 | PJ2026-010104 AI网关 | PLC 真实频率源端到端扩展未完成。 |
| https://github.com/pikasTech/HWLAB/issues/1196 | PJ2026-010103 HWPOD服务 | commandExecution trace 主阅读区仍有 wrapper JSON 噪声。 |
| https://github.com/pikasTech/HWLAB/issues/1197 | PJ2026-010103 HWPOD服务 | timeout 后 AgentRun/trace/rendered 状态不一致，影响服务端安全收口。 |
| https://github.com/pikasTech/HWLAB/issues/1200 | 关联 https://github.com/pikasTech/HWLAB/issues/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 |
| https://github.com/pikasTech/HWLAB/issues/1194 硬件真实可用 | HWPOD-L1-REQ-001/002 | PJ2026-010101 HWPOD标准 | spec validate、registry |
| https://github.com/pikasTech/HWLAB/issues/1194 原入口可执行 | HWPOD-L1-REQ-003/004 | PJ2026-010102 HWPOD工具 | hwpod inspect/build/download/io-probe |
| https://github.com/pikasTech/HWLAB/issues/1204 Agent编排 | HWPOD-L1-REQ-005/006 | PJ2026-010103 HWPOD服务 | runtime API、case run result、trace |
| https://github.com/pikasTech/HWLAB/issues/1205 HarnessRL | HWPOD-L1-REQ-008/009/010 | PJ2026-010104 AI网关 | raw evidence、ioProbe、aggregate 链接 |
| https://github.com/pikasTech/HWLAB/issues/1206 客户端 | HWPOD-L1-REQ-001/003 | HWPOD标准、HWPOD工具 | Web/CLI/API smoke |
| https://github.com/pikasTech/HWLAB/issues/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 引用。
- 新增长证据时写入 https://github.com/pikasTech/HWLAB/issues/1216 或对应 L2/L3 issue，本文档 只保留 L2 引用。
- 稳定需求、原定 L2 分配、验收矩阵或边界变化时，更新本文档，并在必要时回写 L0 规格。
- 单次 CaseRun 日志、阶段报告、debug 过程和 PR 流水不得直接堆进本规格正文；应放在 #1216、对应 L2/L3 issue、case registry 或阶段报告中。
- 单次 CaseRun 日志、阶段报告、debug 过程和 PR 流水不得直接堆进本规格正文；应放在 https://github.com/pikasTech/HWLAB/issues/1216、对应 L2/L3 issue、case registry 或阶段报告中。
- 若某项工作无法映射到本文档 的需求 ID 或原定 L2 编号，应先重新归类，不直接作为硬件池实现任务推进。
project-management/PJ2026-01/specs/PJ2026-0102-agent-orchestration.md
+38 -37
View File
@@ -4,13 +4,14 @@
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#1204 迁移到 UniDesk 项目管理目录。 |
| v0.2 | 待提交 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 https://github.com/pikasTech/HWLAB/issues/1204 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
| 字段 | 内容 |
| --- | --- |
| 原 issue | pikasTech/HWLAB#1204 |
| 原 issue | https://github.com/pikasTech/HWLAB/issues/1204 |
| 原标题 | PJ2026-0102 Agent编排 |
| 原 URL | https://github.com/pikasTech/HWLAB/issues/1204 |
| 原状态 | open |
@@ -28,16 +29,16 @@
| 编号 | PJ2026-0102 |
| 短名 | Agent编排 |
| 层级 | L1 方向 |
| 上级总项目 | #1194 PJ2026-01 HWLAB 总规格 |
| 关联方向 | #1203 硬件池、#1205 HarnessRL、#1206 客户端、#1207 用户管理、#1208 平台运维 |
| 证据索引 | #1223 Agent编排证据索引：Code Agent 与 AgentRun 基线归档 |
| 上级总项目 | https://github.com/pikasTech/HWLAB/issues/1194 PJ2026-01 HWLAB 总规格 |
| 关联方向 | https://github.com/pikasTech/HWLAB/issues/1203 硬件池、https://github.com/pikasTech/HWLAB/issues/1205 HarnessRL、https://github.com/pikasTech/HWLAB/issues/1206 客户端、https://github.com/pikasTech/HWLAB/issues/1207 用户管理、https://github.com/pikasTech/HWLAB/issues/1208 平台运维 |
| 证据索引 | https://github.com/pikasTech/HWLAB/issues/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。
本文采用中文 L1 需求规格模板：正文只保留稳定目标、边界、L2 分配、原子需求、验证矩阵和追踪关系。AgentRun SPEC 摘要、历史 issue、单次 trace、PR/PipelineRun 和运行面长证据统一迁入 https://github.com/pikasTech/HWLAB/issues/1223 或对应下级 issue。
## 2. 目的和范围
@@ -56,11 +57,11 @@ Agent编排方向负责把用户、训练任务或系统任务从 HWLAB 入口
### 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。
- 硬件 inventory、硬件资源状态、HWPOD 标准、HWPOD 服务端状态和 AI 网关能力定义归 https://github.com/pikasTech/HWLAB/issues/1203。
- WebUI/CLI/API/SDK 的用户交互、页面布局、公开 API/SDK 兼容性、结果展示体验归 https://github.com/pikasTech/HWLAB/issues/1206。
- Harness pass/fail、CaseRun 评价、artifact 训练样本、RL 反馈和 evidence replay 归 https://github.com/pikasTech/HWLAB/issues/1205。
- 用户账户、权限、credit、usage、billing、admin 策略归 https://github.com/pikasTech/HWLAB/issues/1207。
- Git mirror、Secret sync、YAML/GitOps、rollout、namespace、平台数据库、日志/指标基础设施归 https://github.com/pikasTech/HWLAB/issues/1208。
- 本方向不定义新的 AgentRun 产品路线；AgentRun 自身能力变更由 pikasTech/agentrun issue/PR 承载，本方向只定义 HWLAB 对 AgentRun 的使用合同和验收需求。
## 3. 运行概念
@@ -76,32 +77,32 @@ Agent编排方向负责把用户、训练任务或系统任务从 HWLAB 入口
| 对象 | 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 |
| 用户入口 | HWLAB 客户端/API | 接收并规范化 Agent 请求，返回 task/run/session/trace 指针 | UX、公开 API/SDK 体验归 https://github.com/pikasTech/HWLAB/issues/1206 |
| 用户/账本 | HWLAB 用户管理 | 在提交前后消费 auth、quota、usage/billing 结果 | 策略、账本和 admin 归 https://github.com/pikasTech/HWLAB/issues/1207 |
| 硬件资源 | HWLAB 硬件池 | 引用 HWPOD hint/context 和分配结果 | inventory、租约、健康、状态归 https://github.com/pikasTech/HWLAB/issues/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 |
| 资源装配 | HWLAB + AgentRun | 构造并证明 RuntimeAssembly、ResourceBundleRef、ProfileRef、SessionRef、workspace materialization | git mirror/Secret/GitOps 运维归 https://github.com/pikasTech/HWLAB/issues/1208 |
| 执行证据 | AgentRun events/result + HWLAB trace | 暴露生命周期状态、失败分类、结果指针和恢复建议 | Harness 评价归 https://github.com/pikasTech/HWLAB/issues/1205，展示归 https://github.com/pikasTech/HWLAB/issues/1206 |
## 5. L2 课题分配
本次按最新口径重划 #1204 的 L2：保留 HWLAB 六个 L1 方向不变；Agent编排下只保留两个 active L2，编号采用连续编号：PJ2026-010201 任务生命周期、PJ2026-010202 资源装配。
本次按最新口径重划 https://github.com/pikasTech/HWLAB/issues/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。 |
| PJ2026-010202 | 资源装配 | 定义 RuntimeAssembly、ResourceBundleRef/gitbundle、BackendImageRef、ProfileRef、SessionRef、promptRefs、requiredSkills、tools、workspaceFiles、provider profile、模型配置、SecretRef、source commit 和 workspace materialization。 | 硬件池、HarnessRL、客户端、用户管理、平台运维 | 完成标准是 runner 得到正确、可证明、可复现的执行输入；WebUI 工作区体验归 https://github.com/pikasTech/HWLAB/issues/1206，硬件资源状态归 https://github.com/pikasTech/HWLAB/issues/1203，Secret/GitOps 运维归 https://github.com/pikasTech/HWLAB/issues/1208。 |
### 5.2 概念合并说明
| 原切片 | 处理 | 理由 |
| --- | --- | --- |
| 会话恢复 | 并入 PJ2026-010201 任务生命周期 | 会话 continuation、resume、session send 和 runner replacement 是任务生命周期的一部分，不应单列。 |
| 工作区 | 并入 PJ2026-010202 资源装配 | Agent workspace materialization 是资源装配输入证明；WebUI 工作区体验归 #1206，硬件/资源状态归 #1203 或 #1208。 |
| 工作区 | 并入 PJ2026-010202 资源装配 | Agent workspace materialization 是资源装配输入证明；WebUI 工作区体验归 https://github.com/pikasTech/HWLAB/issues/1206，硬件/资源状态归 https://github.com/pikasTech/HWLAB/issues/1203 或 https://github.com/pikasTech/HWLAB/issues/1208。 |
| 模型配置 | 并入 PJ2026-010202 资源装配 | provider profile、backendProfile、model、auth/config SecretRef 是 RuntimeAssembly/ProfileRef 装配项，不应单列。 |
| 结果归档 | 删除 standalone L2 | Agent编排只负责生命周期内的 result/trace/artifact pointer；长期归档、评价和展示分别归 #1205、#1206、#1208。 |
| 结果归档 | 删除 standalone L2 | Agent编排只负责生命周期内的 result/trace/artifact pointer；长期归档、评价和展示分别归 https://github.com/pikasTech/HWLAB/issues/1205、https://github.com/pikasTech/HWLAB/issues/1206、https://github.com/pikasTech/HWLAB/issues/1208。 |
## 6. 原子需求
@@ -137,33 +138,33 @@ Agent编排方向负责把用户、训练任务或系统任务从 HWLAB 入口
| 来源 | 归属 | 风险 |
| --- | --- | --- |
| #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 和资源装配可复现性。 |
| https://github.com/pikasTech/HWLAB/issues/1173 | PJ2026-010202 资源装配 | v0.3 AgentRun v02 内建 provider profile 缺默认配置，需明确 YAML/SecretRef 预置或管理员首次写入策略。 |
| https://github.com/pikasTech/HWLAB/issues/1189 | PJ2026-010201 任务生命周期 | v0.3 trace 卡在 runner-job-created 且工具调用不可见，影响执行事实和生命周期证据可信度。 |
| https://github.com/pikasTech/HWLAB/issues/1146 | PJ2026-010201 / PJ2026-010202 | Code Agent 计费成功但 AgentRun FailedToOpenSocket，要求执行层失败与用户账本分离，并检查 provider/profile 装配。 |
| https://github.com/pikasTech/HWLAB/issues/1197 | PJ2026-010201 | CaseRun timeout 后 AgentRun claimed 与 trace raw/rendered 状态不一致，影响安全 cancel 和生命周期证据阅读。 |
| https://github.com/pikasTech/HWLAB/issues/1129 | PJ2026-010202 | Web v0.2 与 CaseRun 使用同类 gitbundle 但 live source commit 可能落后，需暴露 materialized commit 和刷新语义。 |
| https://github.com/pikasTech/agentrun/issues/172 | PJ2026-010201 | runnerjob phase/pod identity 与 run events/liveness 可能不一致，需统一 describe run/session/runnerjob 语义。 |
| https://github.com/pikasTech/agentrun/issues/179 | PJ2026-010202 / 平台运维 https://github.com/pikasTech/HWLAB/issues/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 | 证据链接、开放风险、回写记录 |
| 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 |
| https://github.com/pikasTech/HWLAB/issues/1194 workspace/provider/runtime | AGENT-L1-REQ-005/006/007 | PJ2026-010202 资源装配 | RuntimeAssembly、resource materialization、provider validate |
| https://github.com/pikasTech/HWLAB/issues/1203 硬件池 | AGENT-L1-REQ-006/009 | PJ2026-010202 资源装配 | HWPOD hint/context、硬件事实引用；硬件资源状态归 https://github.com/pikasTech/HWLAB/issues/1203 |
| https://github.com/pikasTech/HWLAB/issues/1205 HarnessRL | AGENT-L1-REQ-008/009 | PJ2026-010201 任务生命周期 | trace/result/artifact pointer、toolCallSummary；pass/fail 归 https://github.com/pikasTech/HWLAB/issues/1205 |
| https://github.com/pikasTech/HWLAB/issues/1206 客户端 | AGENT-L1-REQ-001/004/008/009 | 任务生命周期、资源装配 | Web/CLI/API smoke、trace/result UI；WebUI 工作区体验归 https://github.com/pikasTech/HWLAB/issues/1206 |
| https://github.com/pikasTech/HWLAB/issues/1207 用户管理 | AGENT-L1-REQ-003/007/009 | 任务生命周期、资源装配 | billing preflight/record、provider admin delegation |
| https://github.com/pikasTech/HWLAB/issues/1208 平台运维 | AGENT-L1-REQ-005/006/007/010 | 资源装配 | lane/namespace/Secret/GitOps/runtime health |
| https://github.com/pikasTech/HWLAB/issues/1223 证据索引 | 全部需求 | AgentRun SPEC 与历史 issue | 证据链接、开放风险、回写记录 |
## 10. 回写和变更规则
- 下级 L2/L3 完成后回写对应历史 issue，并在需要时更新本文档，并引用 runId、commandId、runnerJobId、sessionId、traceId、result pointer、artifact pointer 或原入口命令。
- 新增长证据、AgentRun SPEC 摘要或历史 issue 证据时写入 #1223；本文档 只保留规格要求和证据索引引用。
- 新增长证据、AgentRun SPEC 摘要或历史 issue 证据时写入 https://github.com/pikasTech/HWLAB/issues/1223；本文档 只保留规格要求和证据索引引用。
- 稳定需求、L2 分配、验收矩阵或 authority 边界变化时，更新本文档，并在必要时回写 L0 规格。
- 单次 trace、PR 流水、PipelineRun、runtime debug、provider 事故和 CaseRun 日志不得直接堆入本规格正文；应放在 #1223、对应 L2/L3 issue、AgentRun issue 或阶段报告中。
- 单次 trace、PR 流水、PipelineRun、runtime debug、provider 事故和 CaseRun 日志不得直接堆入本规格正文；应放在 https://github.com/pikasTech/HWLAB/issues/1223、对应 L2/L3 issue、AgentRun issue 或阶段报告中。
- 若某项工作无法映射到任务生命周期或资源装配，应先判断主责是否属于硬件池、HarnessRL、客户端、用户管理或平台运维，不直接作为 Agent编排实现任务推进。
project-management/PJ2026-01/specs/PJ2026-0103-harness-rl.md
+18 -17
View File
@@ -4,13 +4,14 @@
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#1205 迁移到 UniDesk 项目管理目录。 |
| v0.2 | 待提交 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 https://github.com/pikasTech/HWLAB/issues/1205 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
| 字段 | 内容 |
| --- | --- |
| 原 issue | pikasTech/HWLAB#1205 |
| 原 issue | https://github.com/pikasTech/HWLAB/issues/1205 |
| 原标题 | PJ2026-0103 HarnessRL |
| 原 URL | https://github.com/pikasTech/HWLAB/issues/1205 |
| 原状态 | open |
@@ -21,8 +22,8 @@
编号: PJ2026-0103
短名: HarnessRL
上级总项目: #1194
总规格 issue: #1194
上级总项目: https://github.com/pikasTech/HWLAB/issues/1194
总规格 issue: https://github.com/pikasTech/HWLAB/issues/1194
核对时间: 2026-06-14（北京时间）
核对口径: 以 HWLAB v0.2 CaseRun、HWPOD evidence、PLC/ARM2D 已归档 registry、Harness RL 规划和开放 issue 为准；本文档 定义证据、评估、回放和训练反馈，不接管硬件资源、Agent 调度或客户端展示。
@@ -30,14 +31,14 @@
- 主责对象: harness、CaseRun、case registry、ioProbe evidence、artifact/diff/final 证据、aggregate、评估、回放、训练反馈和 RL 闭环。
- 不负责: 硬件容量与占用、Agent 执行生命周期、用户账号与计费、CI/CD 发布、Web/CLI 展示细节。
- 交接方向: 硬件池 #1203、Agent编排 #1204、客户端 #1206、用户管理 #1207、平台运维 #1208。
- 交接方向: 硬件池 https://github.com/pikasTech/HWLAB/issues/1203、Agent编排 https://github.com/pikasTech/HWLAB/issues/1204、客户端 https://github.com/pikasTech/HWLAB/issues/1206、用户管理 https://github.com/pikasTech/HWLAB/issues/1207、平台运维 https://github.com/pikasTech/HWLAB/issues/1208。
## 交叉引用
- 上游依赖: 硬件池 #1203 提供真实设备、probe 和原始硬件读数；Agent编排 #1204 提供任务生命周期、workspace 和 artifact 指针；平台运维 #1208 提供 runtime 与 registry/日志保留能力。
- 下游支撑: 客户端 #1206 展示 aggregate/evidence；用户管理 #1207 可消费 usage/evidence 统计；Agent编排 #1204 可消费评估反馈改善执行策略。
- 上游依赖: 硬件池 https://github.com/pikasTech/HWLAB/issues/1203 提供真实设备、probe 和原始硬件读数；Agent编排 https://github.com/pikasTech/HWLAB/issues/1204 提供任务生命周期、workspace 和 artifact 指针；平台运维 https://github.com/pikasTech/HWLAB/issues/1208 提供 runtime 与 registry/日志保留能力。
- 下游支撑: 客户端 https://github.com/pikasTech/HWLAB/issues/1206 展示 aggregate/evidence；用户管理 https://github.com/pikasTech/HWLAB/issues/1207 可消费 usage/evidence 统计；Agent编排 https://github.com/pikasTech/HWLAB/issues/1204 可消费评估反馈改善执行策略。
- 接口/证据边界: 本方向输出 CaseRun 状态、证据包、低噪声 aggregate、ioProbe evidence、评估/回放结果和训练反馈；不输出硬件可用性、Agent 调度状态、用户账本或前端布局。
- 需同步回写: evidence 标准、aggregate 口径、pass/fail 判定、回放格式或训练反馈格式变化时，回写 #1194、硬件池 #1203、Agent编排 #1204、客户端 #1206 和用户管理 #1207。
- 需同步回写: evidence 标准、aggregate 口径、pass/fail 判定、回放格式或训练反馈格式变化时，回写 https://github.com/pikasTech/HWLAB/issues/1194、硬件池 https://github.com/pikasTech/HWLAB/issues/1203、Agent编排 https://github.com/pikasTech/HWLAB/issues/1204、客户端 https://github.com/pikasTech/HWLAB/issues/1206 和用户管理 https://github.com/pikasTech/HWLAB/issues/1207。
## 方向目标
@@ -47,7 +48,7 @@
| 编号 | 短名 | 主责 | 关联 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-010301 | CaseRun规格 | 定义 case definition、stage model、start/status/result/logs、case registry、postValidation 和 run-local workspace 约束。 | Agent编排、硬件池、平台运维 | 完成标准是 CaseRun 编排与 registry 语义正确；硬件实体绑定归 https://github.com/pikasTech/HWLAB/issues/1203，Agent 生命周期归 https://github.com/pikasTech/HWLAB/issues/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 判定。 |
@@ -56,18 +57,18 @@
## 当前开放缺口映射
- #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 证据采集。
- https://github.com/pikasTech/HWLAB/issues/921: HWPOD 强化学习 Harness 总规划，主归 PJ2026-010306 训练反馈，并关联 PJ2026-010305 评估回放。
- https://github.com/pikasTech/HWLAB/issues/1033: CaseRun + Web UI 统一 Agent Review 架构，主归 PJ2026-010305 评估回放，客户端展示归 https://github.com/pikasTech/HWLAB/issues/1206。
- https://github.com/pikasTech/HWLAB/issues/1178 / https://github.com/pikasTech/HWLAB/issues/1186: PLC 71-FREQ ioProbe 造模和真实频率源扩展，Harness 侧归 PJ2026-010303 ioProbe建模，硬件接入归 https://github.com/pikasTech/HWLAB/issues/1203。
- https://github.com/pikasTech/HWLAB/issues/1197: timeout 收口状态不一致，Harness 侧归 PJ2026-010301 CaseRun规格，Agent 生命周期归 https://github.com/pikasTech/HWLAB/issues/1204。
- https://github.com/pikasTech/HWLAB/issues/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 验收。
- 完成口径: HarnessRL 只确认“证据和评价闭环可审计、可复验、可回流”；硬件可用性由 https://github.com/pikasTech/HWLAB/issues/1203 验收，任务生命周期由 https://github.com/pikasTech/HWLAB/issues/1204 验收，用户入口由 https://github.com/pikasTech/HWLAB/issues/1206 验收，账本由 https://github.com/pikasTech/HWLAB/issues/1207 验收，运行面保留由 https://github.com/pikasTech/HWLAB/issues/1208 验收。
## 当前状态
@@ -77,6 +78,6 @@
## 回写规则
- 下级 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。
- 影响 L0 中心、编号、职责边界或全局验收时回写 https://github.com/pikasTech/HWLAB/issues/1194。
- 涉及硬件资源或 probe 能力回写 https://github.com/pikasTech/HWLAB/issues/1203；涉及 Agent 生命周期、workspace 或 artifact 指针回写 https://github.com/pikasTech/HWLAB/issues/1204；涉及 Web/CLI/API 展示回写 https://github.com/pikasTech/HWLAB/issues/1206；涉及 usage/credit/tenant 统计回写 https://github.com/pikasTech/HWLAB/issues/1207；涉及 registry/log/artifact 保留回写 https://github.com/pikasTech/HWLAB/issues/1208。
project-management/PJ2026-01/specs/PJ2026-0104-client.md
+17 -16
View File
@@ -4,13 +4,14 @@
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#1206 迁移到 UniDesk 项目管理目录。 |
| v0.2 | 待提交 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 https://github.com/pikasTech/HWLAB/issues/1206 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
| 字段 | 内容 |
| --- | --- |
| 原 issue | pikasTech/HWLAB#1206 |
| 原 issue | https://github.com/pikasTech/HWLAB/issues/1206 |
| 原标题 | PJ2026-0104 客户端 |
| 原 URL | https://github.com/pikasTech/HWLAB/issues/1206 |
| 原状态 | open |
@@ -21,8 +22,8 @@
编号: PJ2026-0104
短名: 客户端
上级总项目: #1194
总规格 issue: #1194
上级总项目: https://github.com/pikasTech/HWLAB/issues/1194
总规格 issue: https://github.com/pikasTech/HWLAB/issues/1194
核对时间: 2026-06-14（北京时间）
核对口径: 以 HWLAB Cloud Web、hwlab-cli、HTTP API、公开入口、v0.3 Vue parity 和用户可见退化 issue 为准；本文档 定义用户入口契约和展示行为，不接管用户账本、Agent 内部调度、硬件库存或发布机制。
@@ -30,14 +31,14 @@
- 主责对象: Web、CLI、HTTP API、SDK/IDE 插件、webhook、公开文档、兼容性、用户任务入口、状态展示和结果获取。
- 不负责: 用户/计费真相、Agent 调度内部、硬件库存与证据真实性、CI/CD 发布、Secret/配置下发。
- 交接方向: 用户管理 #1207、Agent编排 #1204、硬件池 #1203、HarnessRL #1205、平台运维 #1208。
- 交接方向: 用户管理 https://github.com/pikasTech/HWLAB/issues/1207、Agent编排 https://github.com/pikasTech/HWLAB/issues/1204、硬件池 https://github.com/pikasTech/HWLAB/issues/1203、HarnessRL https://github.com/pikasTech/HWLAB/issues/1205、平台运维 https://github.com/pikasTech/HWLAB/issues/1208。
## 交叉引用
- 上游依赖: 用户管理 #1207 提供身份、权限、API key、额度和 admin 能力；Agent编排 #1204 提供任务状态、session 和结果指针；硬件池 #1203 提供资源/设备状态；HarnessRL #1205 提供 evidence/aggregate；平台运维 #1208 提供公网入口和发布状态。
- 上游依赖: 用户管理 https://github.com/pikasTech/HWLAB/issues/1207 提供身份、权限、API key、额度和 admin 能力；Agent编排 https://github.com/pikasTech/HWLAB/issues/1204 提供任务状态、session 和结果指针；硬件池 https://github.com/pikasTech/HWLAB/issues/1203 提供资源/设备状态；HarnessRL https://github.com/pikasTech/HWLAB/issues/1205 提供 evidence/aggregate；平台运维 https://github.com/pikasTech/HWLAB/issues/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。
- 需同步回写: API/CLI/Web/SDK/Webhook 契约、兼容性、公开文档或用户入口变化时，回写 https://github.com/pikasTech/HWLAB/issues/1194、用户管理 https://github.com/pikasTech/HWLAB/issues/1207、Agent编排 https://github.com/pikasTech/HWLAB/issues/1204、硬件池 https://github.com/pikasTech/HWLAB/issues/1203、HarnessRL https://github.com/pikasTech/HWLAB/issues/1205 和平台运维 https://github.com/pikasTech/HWLAB/issues/1208。
## 方向目标
@@ -48,7 +49,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，CaseRun 评价归 #1205。 |
| PJ2026-010402 | CLI入口 | 定义 hwlab-cli/hwpod/case 等用户命令的参数、输出、错误、profile、同路径 smoke 和脚本可用性。 | Agent编排、硬件池、HarnessRL、用户管理 | 完成标准是 CLI 用户入口一致可用；HWPOD 执行语义归 https://github.com/pikasTech/HWLAB/issues/1203，CaseRun 评价归 https://github.com/pikasTech/HWLAB/issues/1205。 |
| PJ2026-010403 | API契约 | 定义 HTTP API/WebSocket 的路径、schema、错误码、鉴权转发、兼容性和客户端消费契约。 | 用户管理、Agent编排、平台运维 | 完成标准是公开/内部 API 行为可依赖；后端业务真相由对应 L1 定义。 |
| PJ2026-010404 | SDK插件 | 定义 SDK、IDE 插件、外部工具接入、任务创建/查询/结果读取封装和版本兼容。 | Agent编排、用户管理 | 完成标准是外部开发者可集成；不定义平台底层调度或账号账本。 |
| PJ2026-010405 | Webhook集成 | 定义外部回调、事件订阅、任务状态通知、证据通知和失败重试语义。 | Agent编排、HarnessRL、用户管理 | 完成标准是外部系统能可靠消费事件；事件事实来源归对应业务 L1。 |
@@ -56,18 +57,18 @@
## 当前开放缺口映射
- #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。
- https://github.com/pikasTech/HWLAB/issues/1199: v0.3 Vue 工作台入口与会话发送退化，主归 PJ2026-010401 Web工作台，关联 Agent编排 https://github.com/pikasTech/HWLAB/issues/1204。
- https://github.com/pikasTech/HWLAB/issues/1172: v0.3 Cloud Web 直达 history 路由缺 SPA fallback，主归 PJ2026-010401，公开入口/发布归 https://github.com/pikasTech/HWLAB/issues/1208。
- https://github.com/pikasTech/HWLAB/issues/1192: v0.3 域名工作台登录后 API 间歇 502 且停留登录页，客户端侧归 PJ2026-010401/API契约，运行面归 https://github.com/pikasTech/HWLAB/issues/1208。
- https://github.com/pikasTech/HWLAB/issues/1166: v0.3 Cloud Web check 受测试运行器兼容性与 timing 抖动影响，客户端侧归 PJ2026-010401，验证工具链归 https://github.com/pikasTech/HWLAB/issues/1208。
- https://github.com/pikasTech/HWLAB/issues/1033: Agent Review 的 Web UI 承载部分归 PJ2026-010401，评估/审查语义归 HarnessRL https://github.com/pikasTech/HWLAB/issues/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 验收。
- 完成口径: 客户端只确认“用户入口一致、可用、可解释”；身份/账本由 https://github.com/pikasTech/HWLAB/issues/1207 验收，任务生命周期由 https://github.com/pikasTech/HWLAB/issues/1204 验收，硬件事实由 https://github.com/pikasTech/HWLAB/issues/1203 验收，evidence/aggregate 由 https://github.com/pikasTech/HWLAB/issues/1205 验收，发布/入口健康由 https://github.com/pikasTech/HWLAB/issues/1208 验收。
## 当前状态
@@ -77,6 +78,6 @@
## 回写规则
- 下级 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。
- 影响 L0 中心、编号、职责边界或全局验收时回写 https://github.com/pikasTech/HWLAB/issues/1194。
- 涉及身份、权限、API key、usage 或 admin 回写 https://github.com/pikasTech/HWLAB/issues/1207；涉及任务/session/result 回写 https://github.com/pikasTech/HWLAB/issues/1204；涉及 HWPOD 资源/状态回写 https://github.com/pikasTech/HWLAB/issues/1203；涉及 evidence/aggregate 回写 https://github.com/pikasTech/HWLAB/issues/1205；涉及公网入口、CI/CD 或 runtime 发布回写 https://github.com/pikasTech/HWLAB/issues/1208。
project-management/PJ2026-01/specs/PJ2026-0105-user-management.md
+20 -19
View File
@@ -4,13 +4,14 @@
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#1207 迁移到 UniDesk 项目管理目录。 |
| v0.2 | 待提交 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 https://github.com/pikasTech/HWLAB/issues/1207 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
| 字段 | 内容 |
| --- | --- |
| 原 issue | pikasTech/HWLAB#1207 |
| 原 issue | https://github.com/pikasTech/HWLAB/issues/1207 |
| 原标题 | PJ2026-0105 用户管理 |
| 原 URL | https://github.com/pikasTech/HWLAB/issues/1207 |
| 原状态 | open |
@@ -21,8 +22,8 @@
编号: PJ2026-0105
短名: 用户管理
上级总项目: #1194
总规格 issue: #1194
上级总项目: https://github.com/pikasTech/HWLAB/issues/1194
总规格 issue: https://github.com/pikasTech/HWLAB/issues/1194
核对时间: 2026-06-14（北京时间）
核对口径: 以 HWLAB v0.3 user-billing、Sub2API 多用户/credit 架构吸收、API key、session、usage/credit、admin 和 quota/entitlement issue 为准；本文档 定义用户与账本真相，不接管客户端布局、Agent 执行语义或平台发布。
@@ -30,14 +31,14 @@
- 主责对象: 用户、注册登录、session、权限、API key、credit、usage、billing、admin、plan/entitlement/quota、租户隔离和资源消费约束。
- 不负责: 客户端交互细节、Agent 执行生命周期、硬件 evidence、Harness 评价、部署机制。
- 交接方向: 客户端 #1206、Agent编排 #1204、HarnessRL #1205、平台运维 #1208、硬件池 #1203。
- 交接方向: 客户端 https://github.com/pikasTech/HWLAB/issues/1206、Agent编排 https://github.com/pikasTech/HWLAB/issues/1204、HarnessRL https://github.com/pikasTech/HWLAB/issues/1205、平台运维 https://github.com/pikasTech/HWLAB/issues/1208、硬件池 https://github.com/pikasTech/HWLAB/issues/1203。
## 交叉引用
- 上游依赖: 客户端 #1206 承载登录/API key/admin/usage 入口；Agent编排 #1204 和 HarnessRL #1205 提供 usage/evidence 来源；平台运维 #1208 提供数据库、Secret 和 runtime；硬件池 #1203 提供可授权的硬件资源事实。
- 上游依赖: 客户端 https://github.com/pikasTech/HWLAB/issues/1206 承载登录/API key/admin/usage 入口；Agent编排 https://github.com/pikasTech/HWLAB/issues/1204 和 HarnessRL https://github.com/pikasTech/HWLAB/issues/1205 提供 usage/evidence 来源；平台运维 https://github.com/pikasTech/HWLAB/issues/1208 提供数据库、Secret 和 runtime；硬件池 https://github.com/pikasTech/HWLAB/issues/1203 提供可授权的硬件资源事实。
- 下游支撑: 客户端、Agent编排、硬件池和 HarnessRL 都需要身份、权限、额度、租户隔离和资源消费约束。
- 接口/证据边界: 本方向定义账户、session、权限、额度、计量账本、账单和 admin 真相；不定义客户端布局、Agent 调度、HWPOD 物理资源或 Harness evidence 标准。
- 需同步回写: 账户模型、API key、权限/配额、usage/credit、billing/admin 或租户隔离规则变化时，回写 #1194、客户端 #1206、Agent编排 #1204、HarnessRL #1205 和平台运维 #1208。
- 需同步回写: 账户模型、API key、权限/配额、usage/credit、billing/admin 或租户隔离规则变化时，回写 https://github.com/pikasTech/HWLAB/issues/1194、客户端 https://github.com/pikasTech/HWLAB/issues/1206、Agent编排 https://github.com/pikasTech/HWLAB/issues/1204、HarnessRL https://github.com/pikasTech/HWLAB/issues/1205 和平台运维 https://github.com/pikasTech/HWLAB/issues/1208。
## 方向目标
@@ -47,27 +48,27 @@
| 编号 | 短名 | 主责 | 关联 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-010501 | 账号会话 | 定义注册、登录、logout、session、introspect、cookie/token 生命周期和用户身份 source-of-truth。 | 客户端、平台运维 | 完成标准是身份可验证；登录页面和 UI 体验归 https://github.com/pikasTech/HWLAB/issues/1206，Secret/DB 发布归 https://github.com/pikasTech/HWLAB/issues/1208。 |
| PJ2026-010502 | APIKey | 定义 API key 创建、撤销、scope、脱敏展示、轮换、服务侧校验和调用身份绑定。 | 客户端、Agent编排、平台运维 | 完成标准是 API key 可安全消费；CLI/Web 展示归 https://github.com/pikasTech/HWLAB/issues/1206，Secret 同步归 https://github.com/pikasTech/HWLAB/issues/1208。 |
| PJ2026-010503 | 权限配额 | 定义 role/admin、plan、entitlement、quota、resource authorization、preflight 和资源使用许可。 | Agent编排、硬件池、客户端 | 完成标准是资源消费前授权正确；实际硬件可用性归 https://github.com/pikasTech/HWLAB/issues/1203，任务执行归 https://github.com/pikasTech/HWLAB/issues/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-010505 | 账单后台 | 定义 billing、usage summary、admin credit adjust、报表、导出和运营后台能力。 | 客户端、平台运维 | 完成标准是管理员和用户能看到可信账单；页面承载归 https://github.com/pikasTech/HWLAB/issues/1206，DB/发布归 https://github.com/pikasTech/HWLAB/issues/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。
- https://github.com/pikasTech/HWLAB/issues/1127: Go 用户与计费中台总计划，覆盖 PJ2026-010501 到 PJ2026-010505 的核心基线。
- https://github.com/pikasTech/HWLAB/issues/1176: v0.3 user-billing 管理功能退化补齐，主归 PJ2026-010505 账单后台，并关联 PJ2026-010502 APIKey、PJ2026-010504 计量账本。
- https://github.com/pikasTech/HWLAB/issues/1211: plan/entitlement/quota 资源授权闭环，主归 PJ2026-010503 权限配额。
- https://github.com/pikasTech/HWLAB/issues/1146: Code Agent 计费成功但 AgentRun 执行失败，用户管理侧归 PJ2026-010504 计量账本与 PJ2026-010503 权限配额，Agent 执行归 https://github.com/pikasTech/HWLAB/issues/1204。
- https://github.com/pikasTech/HWLAB/issues/1192: 登录后 API 间歇 502 且停留登录页，身份/API 行为关联 PJ2026-010501，客户端入口归 https://github.com/pikasTech/HWLAB/issues/1206，运行面归 https://github.com/pikasTech/HWLAB/issues/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 验收。
- 完成口径: 用户管理只确认“身份、权限、额度、计量、账单和租户隔离真相正确”；客户端入口由 https://github.com/pikasTech/HWLAB/issues/1206 验收，Agent 执行由 https://github.com/pikasTech/HWLAB/issues/1204 验收，硬件资源由 https://github.com/pikasTech/HWLAB/issues/1203 验收，Harness evidence 由 https://github.com/pikasTech/HWLAB/issues/1205 验收，DB/Secret/runtime 由 https://github.com/pikasTech/HWLAB/issues/1208 验收。
## 当前状态
@@ -77,6 +78,6 @@
## 回写规则
- 下级 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。
- 影响 L0 中心、编号、职责边界或全局验收时回写 https://github.com/pikasTech/HWLAB/issues/1194。
- 涉及 Web/CLI/API 展示回写 https://github.com/pikasTech/HWLAB/issues/1206；涉及任务 preflight/usage source 回写 https://github.com/pikasTech/HWLAB/issues/1204；涉及硬件资源授权回写 https://github.com/pikasTech/HWLAB/issues/1203；涉及 evidence/usage 统计来源回写 https://github.com/pikasTech/HWLAB/issues/1205；涉及 DB、Secret、runtime 发布回写 https://github.com/pikasTech/HWLAB/issues/1208。
project-management/PJ2026-01/specs/PJ2026-0106-platform-ops.md
+17 -17
View File
@@ -4,13 +4,14 @@
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#1208 迁移到 UniDesk 项目管理目录。 |
| v0.2 | 待提交 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 https://github.com/pikasTech/HWLAB/issues/1208 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
| 字段 | 内容 |
| --- | --- |
| 原 issue | pikasTech/HWLAB#1208 |
| 原 issue | https://github.com/pikasTech/HWLAB/issues/1208 |
| 原标题 | PJ2026-0106 平台运维 |
| 原 URL | https://github.com/pikasTech/HWLAB/issues/1208 |
| 原状态 | open |
@@ -21,8 +22,8 @@
编号: PJ2026-0106
短名: 平台运维
上级总项目: #1194
总规格 issue: #1194
上级总项目: https://github.com/pikasTech/HWLAB/issues/1194
总规格 issue: https://github.com/pikasTech/HWLAB/issues/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 语义或硬件验收标准。
@@ -30,14 +31,14 @@
- 主责对象: CI/CD、git mirror、YAML-first、Secret 下发、rollout、公开入口、observability、GC/retention、平台发布和运行面诊断。
- 不负责: 产品行为定义、用户策略、Agent 执行语义、硬件资源验收、Harness pass/fail、客户端 UX。
- 交接方向: 硬件池 #1203、Agent编排 #1204、HarnessRL #1205、客户端 #1206、用户管理 #1207。
- 交接方向: 硬件池 https://github.com/pikasTech/HWLAB/issues/1203、Agent编排 https://github.com/pikasTech/HWLAB/issues/1204、HarnessRL https://github.com/pikasTech/HWLAB/issues/1205、客户端 https://github.com/pikasTech/HWLAB/issues/1206、用户管理 https://github.com/pikasTech/HWLAB/issues/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。
- 需同步回写: CI/CD、git mirror、YAML-first、Secret、公开入口、rollout、observability 或 GC/retention 规则变化时，回写 https://github.com/pikasTech/HWLAB/issues/1194 和全部受影响 L1。
## 方向目标
@@ -48,20 +49,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。 |
| PJ2026-010602 | Git镜像 | 定义 git mirror sync/flush、source commit authority、bundle/mirror URL、lane source truth 和 Argo/GitOps 源同步。 | Agent编排、HarnessRL、平台运维 | 完成标准是运行面拿到正确源码；ResourceBundle 输入装配归 https://github.com/pikasTech/HWLAB/issues/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-010605 | 公开入口 | 定义 FRP/Caddy/domain/TLS、端口、health、public exposure 和入口漂移诊断。 | 客户端、用户管理、Agent编排 | 完成标准是公开入口指向正确 runtime；页面/接口业务行为归 https://github.com/pikasTech/HWLAB/issues/1206 / https://github.com/pikasTech/HWLAB/issues/1207 / https://github.com/pikasTech/HWLAB/issues/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。 |
| PJ2026-010607 | 保留清理 | 定义 artifact、trace、case registry、workspace、session、log、cache、PVC 和 GC/retention 边界。 | HarnessRL、Agent编排、硬件池 | 完成标准是证据可保留且资源可回收；证据内容正确性归 https://github.com/pikasTech/HWLAB/issues/1205，workspace 语义归 https://github.com/pikasTech/HWLAB/issues/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。
- https://github.com/pikasTech/HWLAB/issues/1209: v0.3 public exposure 端口/旧 web 指向问题，主归 PJ2026-010605 公开入口。
- https://github.com/pikasTech/HWLAB/issues/1136: G14 v0.3 admin Secret 已收敛但 DB 连接阻塞登录，平台侧归 PJ2026-010604 密钥同步和 PJ2026-010606 运行观测。
- https://github.com/pikasTech/HWLAB/issues/1192: 域名工作台登录后 API 间歇 502，入口/运行面归 PJ2026-010605 公开入口和 PJ2026-010606 运行观测，客户端归 https://github.com/pikasTech/HWLAB/issues/1206。
- https://github.com/pikasTech/HWLAB/issues/1166: Cloud Web check 受运行器兼容性和 timing 抖动影响，平台侧归 PJ2026-010601 发布流水与 PJ2026-010606 运行观测。
- https://github.com/pikasTech/HWLAB/issues/1129: Web v0.2 与 CaseRun HWPOD 工具包同步差异，平台侧归 PJ2026-010602 Git镜像/源同步，Agent 装配归 https://github.com/pikasTech/HWLAB/issues/1204。
## 验收标准
@@ -78,6 +79,5 @@
## 回写规则
- 下级 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。
- 影响 L0 中心、编号、职责边界或全局验收时回写 https://github.com/pikasTech/HWLAB/issues/1194。
- 涉及硬件 runtime/node 回写 https://github.com/pikasTech/HWLAB/issues/1203；涉及 AgentRun/workspace/provider 回写 https://github.com/pikasTech/HWLAB/issues/1204；涉及 case registry/evidence 保留回写 https://github.com/pikasTech/HWLAB/issues/1205；涉及 Web/CLI/API/public entry 回写 https://github.com/pikasTech/HWLAB/issues/1206；涉及 DB/用户/Secret 语义回写 https://github.com/pikasTech/HWLAB/issues/1207。
project-management/PJ2026-01/specs/current-center.md
+11 -10
View File
@@ -4,13 +4,14 @@
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#1218 迁移到 UniDesk 项目管理目录。 |
| v0.2 | 待提交 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 https://github.com/pikasTech/HWLAB/issues/1218 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
| 字段 | 内容 |
| --- | --- |
| 原 issue | pikasTech/HWLAB#1218 |
| 原 issue | https://github.com/pikasTech/HWLAB/issues/1218 |
| 原标题 | HWLAB 当前中心索引：阶段主线与非中心边界 |
| 原 URL | https://github.com/pikasTech/HWLAB/issues/1218 |
| 原状态 | open |
@@ -19,19 +20,19 @@
## 正文
上级总项目: #1194
关联阶段规格: #644
关联面板: #645
上级总项目: https://github.com/pikasTech/HWLAB/issues/1194
关联阶段规格: https://github.com/pikasTech/HWLAB/issues/644
关联面板: https://github.com/pikasTech/HWLAB/issues/645
性质: 阶段中心索引，不是 L1 方向，不是 L2 课题，不重新定义 L1 划分。
迁出来源: #1194 旧版“当前中心”章节
迁出来源: https://github.com/pikasTech/HWLAB/issues/1194 旧版“当前中心”章节
迁出时间: 2026-06-14（北京时间）
## 使用规则
- 本文档 保存阶段性主线、非中心边界和计划口径。
- L0 规格只引用本文档，不在规格正文中展开阶段计划。
- 阶段中心变化不等于 L1 划分变化；如确需改变 L1 方向树，必须先回到 #1194 按规格变更处理。
- 阶段报告和当天进展不得写入 #1194 正文，应写到本文档 评论、#644 或阶段报告中。
- 阶段中心变化不等于 L1 划分变化；如确需改变 L1 方向树，必须先回到 https://github.com/pikasTech/HWLAB/issues/1194 按规格变更处理。
- 阶段报告和当天进展不得写入 https://github.com/pikasTech/HWLAB/issues/1194 正文，应写到本文档 评论、https://github.com/pikasTech/HWLAB/issues/644 或阶段报告中。
## 当前中心
@@ -50,7 +51,7 @@
## 回写规则
- 阶段中心变化时更新本文档，并在 #1194 保持引用。
- 如果阶段中心变化影响 L0 使命、范围、L1 方向树或全局需求，必须同步更新 #1194。
- 阶段中心变化时更新本文档，并在 https://github.com/pikasTech/HWLAB/issues/1194 保持引用。
- 如果阶段中心变化影响 L0 使命、范围、L1 方向树或全局需求，必须同步更新 https://github.com/pikasTech/HWLAB/issues/1194。
- 具体执行进展只写入对应 L1/L2/L3/L4 issue 或本文档 评论，不写入 L0 规格正文。
project-management/PJ2026-01/specs/spec-governance.md
+24 -24
View File
@@ -4,13 +4,14 @@
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#1217 迁移到 UniDesk 项目管理目录。 |
| v0.2 | 待提交 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 https://github.com/pikasTech/HWLAB/issues/1217 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
| 字段 | 内容 |
| --- | --- |
| 原 issue | pikasTech/HWLAB#1217 |
| 原 issue | https://github.com/pikasTech/HWLAB/issues/1217 |
| 原标题 | HWLAB 规格治理索引：编号、层级、回写与偏离规则 |
| 原 URL | https://github.com/pikasTech/HWLAB/issues/1217 |
| 原状态 | open |
@@ -19,18 +20,18 @@
## 正文
上级总项目: #1194
关联面板: #645
上级总项目: https://github.com/pikasTech/HWLAB/issues/1194
关联面板: https://github.com/pikasTech/HWLAB/issues/645
性质: 规格治理索引，不是 L1 方向，不是 L2 课题，不定义产品/系统需求。
迁出来源: #1194 旧版“项目编号与命名规则 / L1 方向判定 / 层级职责边界 / 管理入口职责边界 / 交叉引用检查 / 偏离判定 / 回写规则”章节
迁出来源: https://github.com/pikasTech/HWLAB/issues/1194 旧版“项目编号与命名规则 / L1 方向判定 / 层级职责边界 / 管理入口职责边界 / 交叉引用检查 / 偏离判定 / 回写规则”章节
迁出时间: 2026-06-14（北京时间）
## 使用规则
- 本文档 只保存项目管理和规格治理规则，供 #1194、L1/L2/L3/L4 issue 引用。
- 不在本文档 中新增、删除或重排 L1 方向；L1 方向树以 #1194 为准。
- 本文档 只保存项目管理和规格治理规则，供 https://github.com/pikasTech/HWLAB/issues/1194、L1/L2/L3/L4 issue 引用。
- 不在本文档 中新增、删除或重排 L1 方向；L1 方向树以 https://github.com/pikasTech/HWLAB/issues/1194 为准。
- 不在本文档 中记录阶段进展、CaseRun 日志、PR 流水或具体实现方案。
- 治理规则变化需要回写 #1194 的引用关系，并同步更新 UniDesk `$unidesk-oa`。
- 治理规则变化需要回写 https://github.com/pikasTech/HWLAB/issues/1194 的引用关系，并同步更新 UniDesk `$unidesk-oa`。
## 编号与命名规则
@@ -39,7 +40,7 @@
- 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。
- L3/L4 持久管理节点继续每级追加两位，例如 `PJ2026-01010203` 表示 L1 第 01 个 / L2 第 02 个 / L3 第 03 个。
- 已分配的持久编号不因优先级、阶段或主线变化而重排；新增持久节点只追加新后缀。
- 单个 PR、一次 smoke、一次 CaseRun 等纯执行项可以只引用最近的持久编号，不强制独立编号。
- 持久节点必须有短名，一般控制在 8 个中文汉字以内；必要解释写在说明列或正文里，不塞进名称。
@@ -50,10 +51,10 @@
| 层级 | 负责定义 | 不负责 | 回写对象 |
| --- | --- | --- | --- |
| 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 |
| L1 / 方向 | 能力域范围、成功标准、L2 课题清单、原入口验收类型、交叉引用边界 | 单个 PR、一次 smoke、仓库/工具/runtime 名称、项目管理动作 | https://github.com/pikasTech/HWLAB/issues/1194；方向范围变化时同步 `project-management/PJ2026-01` |
| L2 / 课题 | 单个方向内的具体工作计划、交付物、阻塞、验收计划 | 总方向定义、跨方向路线图、实现细节流水 | 所属 L1；重大移动再回写 https://github.com/pikasTech/HWLAB/issues/1194 |
| L3 / 验收切片 | 一个有界验收切片和单一验收路径 | 多课题计划、父级范围变化、新能力域定义 | 所属 L2/L1，并附 evidence |
| L4 / 执行任务 | PR、CaseRun、smoke、部署、文档收口等执行和 evidence | 新需求、新方向、验收规则变化 | 最近的 L3/L2/L1，必要时回写 #1194 |
| L4 / 执行任务 | PR、CaseRun、smoke、部署、文档收口等执行和 evidence | 新需求、新方向、验收规则变化 | 最近的 L3/L2/L1，必要时回写 https://github.com/pikasTech/HWLAB/issues/1194 |
## L1 主责判定
@@ -70,23 +71,23 @@ L1 方向必须是直接服务 L0 使命的一等产品/系统边界，并能定
| 入口 | 定位 | 能定义 | 不能定义/承载 | 回写要求 |
| --- | --- | --- | --- | --- |
| #1194 / `PJ2026-01` | L0 总项目需求规格 | 使命、范围、方向树、全局需求、全局验收 | 执行流水、PR 细节、CaseRun 原始日志、治理细则全文 | L1 范围变化和重大验收移动必须回写 |
| #645 | 长期总面板和导航摘要 | L0/L1/L2 入口索引、阶段入口、历史专题导航 | 规格正文、验收标准、方向定义 | 指向 #1194，不替代 #1194 |
| #644 | Cloud M1 当前阶段规格 | 当前阶段目标、阶段口径、阶段验收重点 | L0 总规格、L1 方向本身、长期编号规则 | 阶段目标变化影响总规格时回写 #1194 |
| https://github.com/pikasTech/HWLAB/issues/1194 / `PJ2026-01` | L0 总项目需求规格 | 使命、范围、方向树、全局需求、全局验收 | 执行流水、PR 细节、CaseRun 原始日志、治理细则全文 | L1 范围变化和重大验收移动必须回写 |
| https://github.com/pikasTech/HWLAB/issues/645 | 长期总面板和导航摘要 | L0/L1/L2 入口索引、阶段入口、历史专题导航 | 规格正文、验收标准、方向定义 | 指向 https://github.com/pikasTech/HWLAB/issues/1194，不替代 https://github.com/pikasTech/HWLAB/issues/1194 |
| https://github.com/pikasTech/HWLAB/issues/644 | Cloud M1 当前阶段规格 | 当前阶段目标、阶段口径、阶段验收重点 | L0 总规格、L1 方向本身、长期编号规则 | 阶段目标变化影响总规格时回写 https://github.com/pikasTech/HWLAB/issues/1194 |
| `project-management/PJ2026-01` | 长期文档和阶段报告沉淀 | 稳定规格、实施方案、测试规格、阶段报告 | 日常执行看板、未收敛讨论 | 从 issue 蒸馏稳定结论回文档 |
| UniDesk `$unidesk-oa` | agent 侧项目治理操作规程 | agent 如何识别锚点、编号、职责、回写 | HWLAB 项目内容本身、L1 能力域 | 治理规则变化后更新 skill，并在 #1194 索引 commit |
| UniDesk `$unidesk-oa` | agent 侧项目治理操作规程 | agent 如何识别锚点、编号、职责、回写 | HWLAB 项目内容本身、L1 能力域 | 治理规则变化后更新 skill，并在 https://github.com/pikasTech/HWLAB/issues/1194 索引 commit |
## 交叉引用检查
- L1/L2/L3 issue 只要涉及互相支撑，必须在正文写明“上游依赖、下游支撑、接口/证据边界、需同步回写”。
- 依赖其他 L1 的能力时，必须引用对应 L1 issue 编号；不能只写方向名。
- 如果一个变更影响多个 L1 的接口、证据或验收标准，主责 L1 必须回写受影响 L1，并在 #1194 留下重大移动摘要。
- 如果一个变更影响多个 L1 的接口、证据或验收标准，主责 L1 必须回写受影响 L1，并在 https://github.com/pikasTech/HWLAB/issues/1194 留下重大移动摘要。
- 下级 issue 关闭前必须检查引用对象是否需要同步更新；引用未回写时不得直接关闭。
- #645 只做导航索引，不替代上述交叉引用检查。
- https://github.com/pikasTech/HWLAB/issues/645 只做导航索引，不替代上述交叉引用检查。
## 偏离判定
出现以下情况时，任务必须先回到 #1194 或对应 L1 issue 重新归类：
出现以下情况时，任务必须先回到 https://github.com/pikasTech/HWLAB/issues/1194 或对应 L1 issue 重新归类：
- 把文档整理、项目管理、skill 维护、看板维护或阶段报告当成 L1 方向。
- 没有上级 L1 方向，却直接创建实现任务。
@@ -98,11 +99,10 @@ L1 方向必须是直接服务 L0 使命的一等产品/系统边界，并能定
## 回写规则
- `#645` 只做长期总面板和导航，不承担规格正文。
- L1 方向变化必须回写 #1194 正文。
- `https://github.com/pikasTech/HWLAB/issues/645` 只做长期总面板和导航，不承担规格正文。
- L1 方向变化必须回写 https://github.com/pikasTech/HWLAB/issues/1194 正文。
- L1/L2/L3 持久管理 issue 标题必须以编号和短名开头。
- L1 issue 关闭或阶段完成时，必须评论回写 #1194，并说明验收证据、剩余 blocker 和是否需要更新项目管理规格。
- L1 issue 关闭或阶段完成时，必须评论回写 https://github.com/pikasTech/HWLAB/issues/1194，并说明验收证据、剩余 blocker 和是否需要更新项目管理规格。
- L2/L3/L4 执行 issue 必须写明编号、短名、上级总项目、主责方向、关联方向、目标 lane/branch、验收入口和完成后回写对象。
- 稳定规则和长期规格最终应沉淀到 `project-management/PJ2026-01`；issue 保留执行状态、讨论、证据和交叉引用。
- agent 处理 HWLAB OA/总规格/项目漂移/issue 树任务时，应先加载 `$unidesk-oa`，并以 #1194 锚点为准。
- agent 处理 HWLAB OA/总规格/项目漂移/issue 树任务时，应先加载 `$unidesk-oa`，并以 https://github.com/pikasTech/HWLAB/issues/1194 锚点为准。
project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md
+17 -16
View File
@@ -4,13 +4,14 @@
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#644 迁移到 UniDesk 项目管理目录。 |
| v0.2 | 待提交 | 2026-06-14 | 将 issue/PR 引用改为完整 GitHub URL，避免 Markdown 渲染时裸 # 编号失效。 |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 https://github.com/pikasTech/HWLAB/issues/644 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
| 字段 | 内容 |
| --- | --- |
| 原 issue | pikasTech/HWLAB#644 |
| 原 issue | https://github.com/pikasTech/HWLAB/issues/644 |
| 原标题 | HWLAB Cloud SPEC / 云平台开发目标 20260601 |
| 原 URL | https://github.com/pikasTech/HWLAB/issues/644 |
| 原状态 | open |
@@ -23,7 +24,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 长期看板中取代旧的 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 之后的下一段路线，并在 https://github.com/pikasTech/HWLAB/issues/7 长期看板中取代旧的 MVP 单线叙述。
## 目标
@@ -56,10 +57,10 @@ HWLAB 2026-05 已经在 16666/16667 live 上跑通用户工作台、Code Agent
- 承接：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 设备标准"包含并展开）
- https://github.com/pikasTech/HWLAB/issues/621 v0.2 Workbench 会话随用户账号持久化（多用户 / 跨设备恢复，目标 4）
- https://github.com/pikasTech/HWLAB/issues/627 Playwright/Chromium 运行环境与 Workbench browser smoke 防回归治理（云端开箱即用，关联目标 1）
- https://github.com/pikasTech/HWLAB/issues/633 PR 自动 CI / 自动 merge / deploy.json CD 分层（监管 AGENT 的工程护栏，关联目标 3）
- https://github.com/pikasTech/HWLAB/issues/533 v0.2 Device Pod 正式接入规格（被本 SPEC 目标 5 的"HWPOD 设备标准"包含并展开）
## 阶段（2026-06-01 起）
@@ -74,7 +75,7 @@ HWLAB 2026-05 已经在 16666/16667 live 上跑通用户工作台、Code Agent
- 签发日期：2026-06-01
- 签发人：staff
- 适用版本：HWLAB v0.2 之后
- 维护：#7 长期看板"下一阶段路线"段落
- 维护：https://github.com/pikasTech/HWLAB/issues/7 长期看板"下一阶段路线"段落
## 2026-06-05 设计补充：HWPOD Harness 单线程闭环与远景
@@ -147,21 +148,21 @@ HWLAB 2026-05 已经在 16666/16667 live 上跑通用户工作台、Code Agent
## 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` 的对应关系。
- 专门概念体系 issue：https://github.com/pikasTech/HWLAB/issues/897 `HWPOD Harness 概念体系与 v0.2 架构映射`。
- https://github.com/pikasTech/HWLAB/issues/897 将 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` 的对应关系。
## 2026-06-05 修订：HWPOD Harness 以 #897 最新四要素口径为准
## 2026-06-05 修订：HWPOD Harness 以 https://github.com/pikasTech/HWLAB/issues/897 最新四要素口径为准
- #897 已修订为核心业务概念体系：`hwpod` 是由 target device、workspace、debug probe、io probe 四个硬件研发要素组成的实体。
- https://github.com/pikasTech/HWLAB/issues/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 最新口径为准。
- https://github.com/pikasTech/HWLAB/issues/644 上方 2026-06-05 设计补充中的早期 `hwpod`/`hwpodctl`/Evidence 摘要只保留为讨论历史，后续实现和文档以 https://github.com/pikasTech/HWLAB/issues/897 最新口径为准。
## 2026-06-05 修订：HWPOD Harness 快速迭代阶段以 #897 最新口径为准
## 2026-06-05 修订：HWPOD Harness 快速迭代阶段以 https://github.com/pikasTech/HWLAB/issues/897 最新口径为准
- #897 已更新为当前 HWPOD Harness 概念体系的权威 issue。
- https://github.com/pikasTech/HWLAB/issues/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 最新口径为准。
- https://github.com/pikasTech/HWLAB/issues/644 上方 2026-06-05 早期 `hwpod`/`hwpodctl`/`hwpod-run`/Profile/Evidence 摘要只保留为讨论历史，后续实现和文档以 https://github.com/pikasTech/HWLAB/issues/897 最新口径为准。