pikasTech-unidesk/project-management/PJ2026-01/evidence/agent-orchestration-evidence.md

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 事故，不直接写入规格正文。