AgentKit Studio
运行时与部署

三运行时对照

用 loop 归属、会话归属、Run 持久状态、Studio 接缝、能力集五个维度,横向比较 DSH Native、Star Harness 与 Codex。

三个运行时的差别不在「谁更聪明」,而在哪一侧拥有状态。下面的对照全部来自 src/runtime-contract.mjs 的能力矩阵,没有一条来自产品文案。

五个维度横向对照

维度DSH Native HarnessStar HarnessCodex Agent
model/tool loop 归属DSH 原生循环(owner: 'dsh')Harness 原生内核(owner: 'ksadk-harness',execution: 'native-kernel')Codex App Server(owner: 'studio',execution: 'codex-app-server')
会话 / transcript 归属DSH Session,事件源 dsh-session原生 Run 存储,事件源 native-run-storeDSH Session,事件源 studio-codex-adapter
流式归属dsh-agent/assistant-streamnative-model-portcodex-turn/item
Run 持久状态DSH 原生持久化 + replay持久回执(durable-receipts)+ resumeDSH 原生持久化 + replay
Studio 接缝原生执行直通,Studio 只做资源与模型投影npm 插件 + 整轮端口契约 agentkit.native-dsh-turn/v1进程内适配器 + 临时 Codex thread
能力集session、session-events、stream、cancel、replay、persistence、build-bindingnative-run、durable-receipts、tool-approval、cancel、resume、child-taskssession、stream、cancel、replay、build-binding
契约版本agentkit.studio.runtime/v1agentkit.native-dsh-turn/v1studio.codex.adapter/v1

依据:src/runtime-contract.mjs:19-35。

从能力集能直接读出的差异

能力DSH NativeStar HarnessCodex含义
session有有(native-run)有三者都产出可见会话
cancel有有有都能中断当前轮
replay有无有只有 DSH 侧能按原生请求重放
persistence / durable-receiptspersistencedurable-receipts无独立项落盘保证的形态不同
resume无有无只有 Star Harness 支持跨进程续跑
child-tasks无有无只有 Star Harness 有子任务模型

「无」不是缺陷,是边界

resume 与 child-tasks 缺失意味着 DSH Native 与 Codex 的 Run 由 DSH 会话生命周期托管;Star Harness 自己拥有 Run 账本,所以它必须自带恢复语义。选型时看你要的是「会话连续」还是「Run 可恢复」。

可创建性矩阵

运行时ALLOWED_RUNTIME_TYPES新建表单编辑既有 Agent进入便携包 / 部署
dsh-native是是(默认)是是
codex是是是是
harness是装好并启用后可选是是

依据:src/client/theme.mjs:26、src/client/pages/agent-form.mjs:61-79。

Star Harness 是可配置的,不是恒不可选

creatableRuntime 对 harness 还要求 starHarnessReady,它取自 star-harness/status 的 canCreate——已安装 + 已启用 + 至少一个可用工作区(src/client/pages/agent-form.mjs:61-79、src/host/services/star-harness.mjs:150)。没装好之前按钮渲染为 disabled 并带「未开放」徽章;装好并绑定工作区后即可新建。安装与绑定流程见 Star Harness。

runtime.type 字段

Prop

Type

默认值来自 STUDIO_DEFAULT_AUTHORING_RUNTIME = 'dsh-native'(src/authoring-defaults.mjs:4)。

Run 身份的四个必填项

无论选哪条路径,一次 Run 都必须能解析出同一组标识,否则在路由前就被拒绝:

字段必填校验
agentId是非空字符串
sessionId是非空字符串
runId是非空字符串
revision是匹配 ^\d+$ 且 ≥ 1
buildId是非空字符串

缺失任一项抛 RUN_IDENTITY_INVALID;与路由绑定的 agentId / sessionId 不一致抛 RUN_IDENTITY_MISMATCH(src/runtime-contract.mjs:43-64)。

切换运行时

操作行为依据
编辑既有 Agent保留原运行时,不自动切换src/client/pages/agent-form.mjs:48
新建时选 DSH Native清空已选工具,避免残留绑定进入全新原生循环:83
新建时想选 Star Harness需先安装、启用并绑定工作区;否则不可选src/client/pages/agent-form.mjs:61-79

切换运行时不会迁移已有的 Run 历史:旧会话仍按原运行时打开。

运行目标是否就绪

「启动检查」里的运行目标目录一行只统计 ALLOWED_RUNTIME_TYPES 内的类型,并用界面名展示:

检查结果含义依据
confirmedHost 返回了至少一个受支持的运行目标src/client/state/start-checks.mjs:21-24
missingHost 尚未登记任何受支持的运行目标同上
unknown目录读取失败,或旧 RPC 只给了默认原生条目:20、:23

旧连接的回退不算目录

旧版 RPC 载体只返回一个 source: 'dsh' 的默认原生条目,那不是真实的运行目标目录。Studio 把它判为 unknown 而不是 confirmed,以免把「连接降级」显示成「运行时就绪」(src/client/state/start-checks.mjs:20)。

相关页面

本页导航