插件与自动化
KsADK 0.8.5 提供本地优先的插件生命周期、生态宿主桥接、平台资源插件、Scheduler Lite 和统一会话表面。已发布 Agent 和精确识别的历史 Bundle 继续使用原路径，不要求重建或升级 Runtime。
Studio 与 Hosted UI 固定使用 @kingsoftcloud/ksadk-web@0.3.12 的版本化
Conversation v1 headless 模块。发布制品从公开 npm 包重建，并通过源码、浏览器和制品审计；
具体云环境仍需按下方边界验证控制面、资源授权与 Runtime 镜像。
支持边界
云端通用 PluginHost、云端 24×7 调度、P2-06 DSH Codex Bundle/child Provider、Claude Code 和游戏插件执行均不在 0.8.5 支持声明中。一个参考 DSH AgentProvider 的 E2E 通过不等于任意第三方 Provider 自动受支持。
0.8.5 交付与安装边界
Studio 使用受管理的完整 DSH Core/Profile，并在自身界面中展示插件设置。Codex 插件仍归原生 App Server 管理。安装使插件进入工作区；在 Agent 中绑定所需 Skill/MCP 后才参与执行。有 UI 的插件各自保留入口，打开设置不会自动替用户选中 IM 机器人。
Codex 云端交付把插件字节与准入引用冻结为 Agent 版本关联的不可变制品，需要控制面制品接口与存储支持。接口不可用时会阻断部署，不会静默丢弃插件。桌面 OAuth 凭证不会随制品复制；云端 MCP OAuth 和凭证管理在后续版本完善。发现 Skill 不等于其 MCP 已连接或已授权。
知识库、长期记忆和 Skill Center 通过官方平台资源插件接入同一 Build/Activation 链路。Studio 只保存资源连接标识，不把 AK/SK 或运行时 token 写入 Agent spec；Build 固化连接引用、资源类型与插件摘要，Runtime 再按账号、区域和平台注入的凭证解析连接。知识库以只读检索工具提供，记忆库按 Agent 策略启用召回和写入，Skill Center 提供技能发现与加载。界面显示“已绑定”只说明配置已经进入 Agent Revision，不表示调用方已经获得服务端权限，也不表示目标网络当前可达。
通用 Python wheel 包含 Web 0.3.12 与编译后的 Studio 页面；安装器会按 pyproject.toml 解析声明的 Python 依赖，但 wheel 本身不包含 Node/Codex/DSH 二进制、社区插件或凭证。额外能力按需安装 extra；完全断网安装还需准备依赖 wheelhouse 及原生工具链。既有云端 Agent 只有显式重新构建、更新部署后才变化。
DSH 插件管理的受管工具链固定为 Node.js 22、DSH 0.1.7-rc.1 和 pnpm@11.7.0。Studio 桌面打包会使用随工具链提供的 Node/npm 安装该版本；开发者如覆盖 AGENTENGINE_PNPM_BIN，必须提供经过验证的同一版本。
选择接入方式
| 方式 | 所有者 | 当前用途 |
|---|---|---|
dsh | DeepSeek Harness / Cordis | 默认插件格式；Bundle 可贡献 AgentProvider、Tool、Renderer 和 Studio slot |
codex | Codex App Server | 兼容 Codex 官方插件，并保留 Codex 的原生宿主与权限语义 |
linked | 外部宿主 | 只发现或跳转，不能显示为已安装可执行 |
KsADK 不定义第三种私有插件包、manifest 或 ABI。插件不会修改 Kernel 合同；新增 Runtime 由标准 DSH Bundle 贡献粗粒度 AgentProvider，Codex 插件继续由 App Server 管理。
复用 Codex 与 DSH 数据面
这两个生态保留各自的原生宿主，不会被转换成 KsADK 私有插件：
| 数据面 | 装配与执行 | 不可变边界 |
|---|---|---|
Codex skills / mcpServers / hooks / apps | Codex App Server 负责 marketplace 与安装生命周期；KsADK 只在显式准入后为 Agent Build 生成选择性 marketplace | plugin.json、组件和可执行位进入 SHA-256 快照与 plugin.lock；每个 Build 使用独立 CODEX_HOME |
DSH ctx.tools | 固定版本 DSH CLI 启动完整 Profile；wheel 内的普通 Cordis Bundle 将 ctx.tools.schemas() / ctx.tools.execute() 投影为真正的 Streamable HTTP MCP | Profile 摘要、工具清单摘要、sidecar 版本和 MCP lease 逐层校验，任何漂移均 fail closed |
Codex manifest 同时接受官方 camelCase 和兼容的 snake_case 拼写，但同一字段出现两种拼写会被拒绝。local、git、npm 来源都必须解析为不可变坐标：Git 需要完整 commit SHA，npm 需要精确 semver；宿主报告的 integrity 会一并进入来源快照。Agent 只得到用户选择的组件。由于 Codex 当前没有可验证的 hook trust API，选择 hook 的 Build 会安全阻断，而不会绕过宿主信任提示。
DSH capability sidecar 只监听随机 loopback 端口，使用进程内 bearer lease，并限制请求、参数、结果、并发、deadline 和 Node heap。取消会传到 Cordis AbortSignal；Profile 修改、插件停用/卸载、Studio 退出都会撤销 UI lease、取消在途调用并清理整个 sidecar 进程组。现有 dsh-agent-provider-host/v1 的 10 方法 ABI 保持不变，Tool 数据面使用独立且标准的 mcp.connector/v1，避免破坏已经发运的 Bundle。
能力接口同时发布一个内存中的 provider MCP Resource，可直接加入 Harness/Plugin Agent 的 MCP bindings。Build 只锁定 Profile、descriptor、inventory 和工具过滤摘要；PluginHost 在每次新 Agent activation 时重新取得并核对 endpoint/bearer 租约，地址与凭证不会进入 Catalog 文件、Agent spec、Bundle 或 plugin lock。Profile 变化会先撤下旧 Resource，旧 Build 因摘要不匹配而 fail closed。
本地 capability host 要求 Node.js >= 22.19，并使用 KsADK 固定的 DSH 版本；不会回退到 PATH 中任意版本的 CLI。
DSH 客户端 UI 与 Channel 页面
Studio 使用受管理的完整 DSH Core/Profile。官方 @kingsoftcloud/dsh-channels-client 是 wheel 自带的 web client bundle，通过 dsh.client.inject 接入 @deepseek-ai/dsh-app-studio，再把 Channels workspace slot 挂载到 Studio。它只提供 UI 挂载，不启动 Channel API/worker，也不把 Channel 服务打进 Python wheel。
默认 Studio 启动会在 HTTP 服务可用后后台安装并启用该 bundle；KSADK_STUDIO_CHANNEL_DEFAULT=0 可关闭默认激活。首次激活失败不会阻塞 Studio 主页面，用户可以重新启动 Studio 或在插件设置中显式启用；显式停用不会被下一次启动的默认逻辑覆盖。Channels 页面再通过本地 Studio API 访问独立 Channel 服务，Studio 和高代码 Agent 共用 ksadk.connector 的出站 WSS 协议。
Channel UI 页面和协议客户端由 ksadk-python 维护并随 wheel 分发；DSH Core/Profile 仍由受管工具链维护。Studio 可见导航、workspace slot 和页面挂载依赖 DSH 的正式 extension point，不需要修改 minified 静态文件。
开发 DSH Bundle
开发者不需要检出或编译 DeepSeek Harness 源码。先从公网 npm 安装 KsADK 固定版本的受管理 DSH CLI，再创建、校验、测试和打包标准 DSH Bundle：
agentengine plugin toolchain status
agentengine plugin toolchain install
agentengine plugin create ./my-provider --name @example/my-provider
agentengine plugin validate ./my-provider
agentengine plugin test ./my-provider
agentengine plugin pack ./my-provider --output-dir ./artifacts生成目录是普通 npm 包，使用 DSH 的 dsh.bundle.patch / Cordis 组合格式，不包含 ksadk-plugin.yaml。validate 和 test 会在临时 Profile 中验证安装、投射、停用、启用和卸载；pack 使用固定 pnpm 按 npm files 语义生成 .tgz。
把 Bundle 安装到隔离 Profile 后，可以通过同一套 DSH 生命周期命令管理：
agentengine plugin install ./artifacts/example-my-provider-0.1.0.tgz \
--accept-host-permissions
agentengine plugin disable @example/my-provider
agentengine plugin enable @example/my-provider
agentengine plugin uninstall @example/my-provider发布门禁会从公网 npm 安装固定 DSH 工具链，并验证生成 Bundle、.tgz，以及官方 Codex subagent 包的格式和安装边界：
KSADK_DSH_TOOLCHAIN_E2E=1 \
uv run --extra all pytest -q tests/e2e/test_dsh_managed_toolchain_e2e.py这项校验不代表 P2-06 的 DSH Codex Bundle/child Provider 执行链已经完成。另一个真实仓外 Node AgentProvider 会在受管 Profile 中完成安装、连续两轮、停用、损坏升级失败回滚、重新启用旧包继续执行和卸载。
本地 DSH 源码若包含尚未发布的改动，编译结果可能与 npm 包不同。普通插件开发、CI 与发布始终以固定 npm 版本为兼容基线；只有 DSH 核心开发者验证下一版时才显式设置 KSADK_DSH_BIN，且版本不匹配会 fail closed。KsADK 只是包装官方命令，不复制 DSH 编译器。
管理 Codex 插件
Codex 插件的目录、安装状态和卸载由 Codex App Server 管理。KsADK 只调用宿主协议，不解释执行插件代码，也不会把 .codex-plugin/plugin.json 转换成 ksadk-plugin.yaml：
agentengine plugin codex list
agentengine plugin codex info <plugin-id>
agentengine plugin codex install <plugin-id> --accept-host-permissions
agentengine plugin codex uninstall <plugin-id>缺少 Codex App Server 时返回明确的 unavailable 错误。安装确认表示插件按当前系统用户的宿主权限运行；插件自己的认证仍在 Codex 中完成。
管理 DSH Profile
DSH 插件由隔离的 DeepSeek Harness Profile 管理。安装、启停、升级和卸载均调用受管理的原生 dsh plugin，修改后通过宿主配置预检。目录或 .tgz 会按 SHA-256 固化为不可变安装源；启用、更新或投影前发现摘要漂移会 fail closed，失败升级会恢复旧 manifest、lock、状态与可执行旧包：
export KSADK_DSH_HOME=/path/to/isolated/dsh-home
export KSADK_DSH_PROFILE=web
agentengine plugin list
agentengine plugin install <bundle> --accept-host-permissions
agentengine plugin disable <bundle-name>
agentengine plugin enable <bundle-name>
agentengine plugin profile
agentengine plugin uninstall <bundle-name>agentengine plugin dsh ... 只保留为早期脚本兼容别名。
DSH bundle 可能运行安装脚本，必须显式确认宿主权限。只有通过握手、权限、会话投影与执行 conformance 的 AgentProvider 才能出现在 Runtime 选择器中。
DSH capability sidecar 当前要求 POSIX 进程组隔离；Windows 与云部署在具备可验证的进程树回收和 Node Profile 物化能力前会明确拒绝，不会退化为只终止父进程的弱隔离。
创建本地定时任务
Studio 的 自动化 页面支持 once、interval 和 cron，并使用 IANA 时区。任务可以启停、编辑、删除、立即运行；详情页显示下次运行时间和 occurrence 状态历史。Agent 详情页的 自动化 Tab 只展示并创建当前 Agent 的任务。
| 能力 | 当前行为 |
|---|---|
| 存储 | 工作区本地 SQLite |
| 触发 | Studio 本地进程中的 Scheduler Lite |
| 连续性 | 新会话，或显式绑定已有 session 后续接 |
| 并发 | 同一任务禁止重叠执行 |
| 误点补偿 | skip 或 run_once |
| 历史 | 保留 accepted、run identity、terminal 状态和错误信息 |
本地调度边界
Studio 进程停止后不会提供 24×7 唤醒。云端持久 ScheduleStore、独立 scheduler worker 和跨 Pod claim 属于后续端云阶段。
接入会话表面
ConversationSurface 声明输入能力，ConversationInput 只提交已允许的字段，ConversationItem 表示文本、reasoning、工具、审批、A2UI 和未知输出。Studio、Hosted UI 和自定义前端使用相同的 item identity 进行增量归并与重放。
核心 Renderer 提供通用降级；Provider 特有的 UI 应通过受控 Renderer 或 A2UI surface 扩展。未知 item 必须保持可见和不可执行，不能丢弃，也不能把未经识别的数据变成可点击操作。审批 item 只有在携带持久 revision 时才允许提交；缺少 revision 的客户端保持只读。
共享 Web 包、Studio、Hosted UI 与独立前端的浏览器 E2E 全部通过后，才会把这一表面标记为稳定可写。
兼容与发布门禁
| 项目 | 当前边界 |
|---|---|
| 历史 Agent | 真实 0.8.2 LangGraph Bundle v2 和更早 framework Bundle 继续走旧 Runtime；历史 Harness 只有命中显式登记的精确来源摘要才进入 legacy adapter，未知 v1 fail closed |
| 新 Harness v2 | 必须解析到就绪的 DSH registration；缺失时 fail closed，不回退 legacy adapter |
| 本地存储 | 无 PostgreSQL 时继续使用 SQLite 或 memory；高可用能力不被伪造 |
| 第三方生态 | Claude Code、游戏和任意能力必须由标准 DSH Bundle 承载，或由 Codex App Server 原生管理，并通过 conformance |
| 稳定发布 | make phase2-release-preflight 中的 DSH、会话浏览器、历史 Agent、clean provenance 和公开制品审计必须全部通过 |
游戏类扩展可以由一个 DSH Bundle 组合 Tool、Store、Renderer/A2UI 和 Studio slot；完整游戏循环可以贡献独立 AgentProvider。它们都不需要修改 Kernel 协议，但在通过权限、生命周期、会话投影和回滚测试前，不会显示为已支持插件。