pikasTech-unidesk/docs/MDTODO/artificer-runtime-capabilities.md

# Artificer 运行能力

本文件跟踪 Artificer 的 AipodSpec、provider/model 选择、credential 投影、任务级覆盖、Session 续跑和真实派单验收。单次配置、协议或运行故障作为 ITEM 进入本长期问题域。


## R1 [in_progress]

落实 [UniDesk #1846](https://github.com/pikasTech/unidesk/issues/1846) 与 [AgentRun #325](https://github.com/pikasTech/agentrun/issues/325)：Artificer 的 API credential 唯一来自 ~/.codex/*.pika，AgentRun effective backend profile 固定为 gpt-pika，默认模型改为 gpt-5.6-sol、reasoning effort 改为 medium，并支持任务级模型与 reasoning 选择，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R1_Task_Report.md)。

### R1.1 [in_progress]

在 [UniDesk #1846](https://github.com/pikasTech/unidesk/issues/1846) 将 gpt.pika 的 auth.json/config.toml 唯一 sourceRef 改为 /root/.codex/*.pika；plan/sync 默认视图显示精确 sourceRef 与 source/effective profile，config.toml 同步前验证显式 provider/base URL 且不输出值，activation fence blocked 时不提示 --confirm，缺失或不安全配置 fail closed，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R1.1_Task_Report.md)。

### R1.2 [completed]

在 [AgentRun #325](https://github.com/pikasTech/agentrun/issues/325) 让 AipodSpec 默认 backendProfile/credential.profile=gpt-pika、默认模型 gpt-5.6-sol、默认 reasoning effort=medium，并支持显式 model/reasoning override；provider/SecretRef 不随模型切换，带点的 gpt.pika 在 AgentRun admission 中 fail closed，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R1.2_Task_Report.md)。

### R1.3 [in_progress]

修复 UniDesk Aipod create/render/send：只有显式参数才覆盖服务端 AipodSpec，增加 --model 与 --reasoning-effort 同构 dry-run，禁止 client sessionPolicy 默改 provider/executionPolicy，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R1.3_Task_Report.md)。

### R1.4

两个 PR 合并后只观察自动链；先跑 .pika 默认与显式模型最短 Artificer canary，再为 [UniDesk #1844](https://github.com/pikasTech/unidesk/issues/1844) 创建唯一替代 task 并记录 supersedes，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R1.4_Task_Report.md)。

## R2 [completed]

解决 [AgentRun #335](https://github.com/pikasTech/agentrun/issues/335)：修复 Artificer 同 session follow-up 的 AipodSpec primary workspace、resource bundle、GitHub tool credential 继承退化，以及终态收敛窗口复用旧 run 产生 provider-less 空 command 的竞态；只修既有 session admission/继承路径，不新增合同、租约、围栏、fallback 或第二 authority，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R2_Task_Report.md)。

## R3 [completed]

解决 [AgentRun #337](https://github.com/pikasTech/agentrun/issues/337)：由 Artificer owning YAML 的既有 Aipod/runner 启动装配统一提供 Git author/committer identity，使全新 task 与同 session resume/new-turn 均无需任务内 git config 即可提交；只做最小必要修复，不新增第二 authority、合同、租约、安全机制、围栏或 monitor 支线，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R3_Task_Report.md)。

### R3.1 [completed]

调查 config/aipods/artificer.yaml、Aipod render 与 runner 启动路径，确认单一 identity owner，并用两个既有失败 task 和 #335 resume canary 建立初始/续跑复现证据，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R3.1_Task_Report.md)。

### R3.2 [completed]

由原生子代理在独立 AgentRun v0.2 worktree 实现最小 YAML-first identity 装配与定向测试，覆盖初始 runner 和同 session 新 turn；Artificer 不递归修自己，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R3.2_Task_Report.md)。

### R3.3 [completed]

主代理 review/合并后只观察自动 CI/CD；以新 task 直接 commit、同 session send 直接 commit 两个 canary 验收，不使用 task-local git config 或人工发布，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R3.3_Task_Report.md)。

## R4 [completed]

解决 [AgentRun #340](https://github.com/pikasTech/agentrun/issues/340)：修复 Artificer active turn 在 durable steer 已确认后发生 backend retry/thread resume 时丢失 steer 增量、错误回退初始 prompt 的问题；只修既有 command/event/thread 恢复路径，不新增客户端重发、第二 prompt authority、合同、租约、安全机制或围栏，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R4_Task_Report.md)。

### R4.1 [completed]

只读复现 [AgentRun #340](https://github.com/pikasTech/agentrun/issues/340) 的 durable steer ack → backend hard-timeout/retry → thread resume 指令回退，定位 effective prompt/turn state 在哪一层遗漏 steer，并冻结最小修复边界，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R4.1_Task_Report.md)。

### R4.2 [completed]

由原生子代理在独立 AgentRun v0.2 worktree 实现 active steer 的顺序、幂等恢复与定向测试；Artificer 不递归修自己，不触碰 Monitor 业务、provider/model/workspace/credential 装配，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R4.2_Task_Report.md)。

### R4.3 [completed]

主代理 review/合并后只观察自动 CI/CD；用新 Artificer canary 验证 active steer 后 backend retry 无需重发仍继续最新指令，并确认 workspace/resource bundle/tool credential 保持正确，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R4.3_Task_Report.md)。

## R5 [completed]

解决 [AgentRun #346](https://github.com/pikasTech/agentrun/issues/346)：由 owning Aipod YAML 提示词明确当前 Artificer 是执行者并禁止递归创建或派发 Artificer；由原生子代理做最小修复，不改变模型、provider、SecretRef、workspace、credential 或 resume 语义，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R5_Task_Report.md)。

### R5.1 [completed]

由原生子代理按 [AgentRun #346](https://github.com/pikasTech/agentrun/issues/346) 修改 config/aipods/artificer.yaml 的单一 prompt authority 并补 render 定向测试，禁止 Artificer 递归修自己，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R5.1_Task_Report.md)。

### R5.2 [completed]

主代理 review/合并 [AgentRun #346](https://github.com/pikasTech/agentrun/issues/346) 的最小 PR，只观察自动 CI/CD，不新增代码默认值或第二 prompt authority，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R5.2_Task_Report.md)。

### R5.3 [completed]

自动上线后执行最短 Artificer canary，确认直接处理业务任务且没有创建第二 task，并记录 task/run/session 证据，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R5.3_Task_Report.md)。

## R6 [in_progress]

让 Artificer 派单成为 Target-aware 的单命令流程：主代理先用 MDTODO 跟踪，再通过 trans 在 YAML 选择的 Target 上执行 create/dispatch；CLI 只需 repo、ref 与 prompt 即自动渲染合法 workspaceRef、resourceBundleRef、session、projectId、bundle 继承和 SecretRef，提交前 dry-run 阻止必然失败任务；Artificer owning YAML prompt 与 unidesk-subagent skill 固化 Target/trans 及所有子代理先建 MDTODO 的规则，并以私有 pikainc/selfmedia 在 NC01 真实验收，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R6_Task_Report.md)。

### R6.1 [in_progress]

由原生子代理在最新远端基线的独立 worktree 调查并实现易用派单入口，覆盖 repo/ref/Target/trans、合法资源投影、提交前校验、私有仓库 YAML SecretRef 与 Artificer owning prompt、unidesk-subagent 固定规则；对应原生任务 artificer_dispatch_ux，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R6.1_Task_Report.md)。

### R6.2

主代理审查跨仓改动并按依赖顺序合并 PR，只观察自动 CI/CD 收敛；不得人工触发 mirror、PipelineRun、apply 或 rollout，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R6.2_Task_Report.md)。

### R6.3

上线后通过 trans 在 NC01 使用新单命令入口派发 pikainc/selfmedia 的 feat/r6-ocr-visual-planner，确认 task 直接 running、session 可续跑且不出现 schema-invalid 或 repository-not-found，完成任务后将详细报告写入[任务报告](./details/artificer-runtime-capabilities/R6.3_Task_Report.md)。