DeepSeek Harness（也称 dsh）是面向开发者的开源 AI 智能体运行时，用于构建和运行自定义智能体。它采用 MIT 许可证，目前仍处于开发者预览阶段。需要先厘清一点：它不是新的基础模型，也不是开箱即用的固定智能体产品；它提供的是一个让开发者选择、拼装智能体各部分能力的运行环境。现有资料显示，v0.1 于 2026 年 8 月 13 日发布，而非 9 月。12

核心思路：没有需要打补丁的“特权内核”

Harness 把“万物皆插件”落实到了运行时设计中：模型适配器、工具、技能、会话、沙箱、存储、调度、智能体循环，甚至 UI，都可以通过配置替换或重新组合。221

这意味着，团队若要切换模型提供商、收紧工具权限、加入人工审批策略，或使用不同的执行环境，原则上不必长期维护一套改过核心代码的分支；只需把新插件与已有组件共同挂载到运行时中。

Cordis：插件如何协作

Harness 底层使用 Cordis 插件框架。插件会向共享上下文贡献服务、类型化事件和可撤销的副作用；当插件卸载时，相应注册也可以随之撤销。2122

Cordis 还具备依赖感知能力：针对所需服务注册的回调，在依赖服务发生变化时会被卸载并重新运行；ctx.plugin 则会依据插件声明的 schema 校验配置后再加载插件。19

对扩展开发者而言，这些机制提供了清晰的接入点。例如，工具插件可注册到 ctx.tools；工具执行前的策略钩子可以返回类型化的“允许”或“拒绝”决定。权限控制、沙箱限制以及计划模式策略，都可以利用这一类扩展点实现。17

四种内置运行模式

Harness 提供四套起步预设，分别面向不同开发任务：2

• Standard：提供较完整的编程智能体工作流与工具集。
• Code：通过 Code Mode SDK 暴露工具，让模型生成的 TypeScript 协调多步骤任务。
• Minimal：提供持久化 shell 与 str_replace_editor，适合受限环境或基准测试。
• Creator：增加运行时检查和内存内插件试验能力，面向创建新预设的开发者。

这些模式是可用的起点，而不是能力边界。随着需求变化，团队可以通过插件替换或补充模型、工具、策略与执行环境。221

安装与首次使用

Harness 以 npm 包和 CLI 的形式发布，包名为 @deepseek-ai/dsh。文档给出的快速启动命令是：

npx @deepseek-ai/dsh web

如果需要从源码运行或直接参与代码开发，也可以克隆源代码仓库。130

启动 Web UI 后，可在 Settings → Models 中配置模型凭据，再选择工作区并组织任务。dsh 进程默认把启动命令所在目录作为文件系统位置；但全新的 Web UI 不会自动选定工作区，仍需手动添加。25

可观测性不是事后附加，而是会话模型的一部分

Harness 以追加式会话日志记录模型所见内容，包括系统提示词、推理、工具调用及结果、子智能体调度和上下文注入。Trajectory 视图可按来源检查这些记录；恢复（resume）、分叉（fork）、搜索和回放（replay）也都基于同一条事件流。2

因此，这份日志不只是排错材料。它也是复盘一次运行、回到先前分支，以及重现影响智能体行为的运行时事件序列的依据。

开发者预览版：兼容性管理要更谨慎

Harness 明确仍处于开发者预览阶段，团队不宜假设插件与 API 已提供长期稳定的兼容性承诺。26

较稳妥的实践是：固定当前使用版本，阅读发布变更，在隔离的 profile 或工作区中测试升级，并对代表性会话执行回放后，再扩大部署范围。这是基于预览版状态提出的风险控制建议，并不代表官方承诺每次升级都会破坏兼容性。

插件验证建议分为两层：

1. 先验证插件本身：检查配置 schema、所需服务、失败行为，以及工具策略逻辑。
2. 再验证完整组合：让插件与实际使用的模型适配器、工具、沙箱、权限、会话存储及其他插件一起运行测试。

配置机制可为此提供基础保障。cordis.yml 条目可包含 config 块，插件会暴露 schema，并在 apply 函数运行前校验配置；配置不合法时，加载会直接失败，而不是让插件以“半配置”状态启动。2728 生成的配置目录可通过 pnpm run verify-config-catalog 进行校验。18

在分发方面，文档支持将扩展打包为可安装 bundle，再通过 dsh plugin add 加入 profile。将 bundle 与配置显式化，有助于复现、审计、测试和升级一套由多个组件组成的运行时。24

结论

把 DeepSeek Harness 看作智能体开发基础设施更为准确：模型连接、工具、策略、执行环境、循环、状态和界面，都是可以组合的选择。Cordis 负责插件生命周期与协作，四种运行模式提供开箱可用的起点，追加式会话日志则留下细粒度的运行记录。

它的吸引力在于灵活性；而正因为仍是开发者预览版，版本固定、隔离测试、会话回放以及对插件组合的系统验证，都会是实际落地时不可省略的工程环节。221

DeepSeek Harness（也称 dsh）是面向开发者的开源 AI 智能体运行时，用于构建和运行自定义智能体。它采用 MIT 许可证，目前仍处于开发者预览阶段。需要先厘清一点：它不是新的基础模型，也不是开箱即用的固定智能体产品；它提供的是一个让开发者选择、拼装智能体各部分能力的运行环境。现有资料显示，v0.1 于 2026 年 8 月 13 日发布，而非 9 月。12

核心思路：没有需要打补丁的“特权内核”

Harness 把“万物皆插件”落实到了运行时设计中：模型适配器、工具、技能、会话、沙箱、存储、调度、智能体循环，甚至 UI，都可以通过配置替换或重新组合。221

这意味着，团队若要切换模型提供商、收紧工具权限、加入人工审批策略，或使用不同的执行环境，原则上不必长期维护一套改过核心代码的分支；只需把新插件与已有组件共同挂载到运行时中。

Cordis：插件如何协作

Harness 底层使用 Cordis 插件框架。插件会向共享上下文贡献服务、类型化事件和可撤销的副作用；当插件卸载时，相应注册也可以随之撤销。2122

Cordis 还具备依赖感知能力：针对所需服务注册的回调，在依赖服务发生变化时会被卸载并重新运行；ctx.plugin 则会依据插件声明的 schema 校验配置后再加载插件。19

对扩展开发者而言，这些机制提供了清晰的接入点。例如，工具插件可注册到 ctx.tools；工具执行前的策略钩子可以返回类型化的“允许”或“拒绝”决定。权限控制、沙箱限制以及计划模式策略，都可以利用这一类扩展点实现。17

四种内置运行模式

Harness 提供四套起步预设，分别面向不同开发任务：2

• Standard：提供较完整的编程智能体工作流与工具集。
• Code：通过 Code Mode SDK 暴露工具，让模型生成的 TypeScript 协调多步骤任务。
• Minimal：提供持久化 shell 与 str_replace_editor，适合受限环境或基准测试。
• Creator：增加运行时检查和内存内插件试验能力，面向创建新预设的开发者。

这些模式是可用的起点，而不是能力边界。随着需求变化，团队可以通过插件替换或补充模型、工具、策略与执行环境。221

安装与首次使用

Harness 以 npm 包和 CLI 的形式发布，包名为 @deepseek-ai/dsh。文档给出的快速启动命令是：

npx @deepseek-ai/dsh web

如果需要从源码运行或直接参与代码开发，也可以克隆源代码仓库。130

启动 Web UI 后，可在 Settings → Models 中配置模型凭据，再选择工作区并组织任务。dsh 进程默认把启动命令所在目录作为文件系统位置；但全新的 Web UI 不会自动选定工作区，仍需手动添加。25

可观测性不是事后附加，而是会话模型的一部分

Harness 以追加式会话日志记录模型所见内容，包括系统提示词、推理、工具调用及结果、子智能体调度和上下文注入。Trajectory 视图可按来源检查这些记录；恢复（resume）、分叉（fork）、搜索和回放（replay）也都基于同一条事件流。2

因此，这份日志不只是排错材料。它也是复盘一次运行、回到先前分支，以及重现影响智能体行为的运行时事件序列的依据。

开发者预览版：兼容性管理要更谨慎

Harness 明确仍处于开发者预览阶段，团队不宜假设插件与 API 已提供长期稳定的兼容性承诺。26

较稳妥的实践是：固定当前使用版本，阅读发布变更，在隔离的 profile 或工作区中测试升级，并对代表性会话执行回放后，再扩大部署范围。这是基于预览版状态提出的风险控制建议，并不代表官方承诺每次升级都会破坏兼容性。

插件验证建议分为两层：

1. 先验证插件本身：检查配置 schema、所需服务、失败行为，以及工具策略逻辑。
2. 再验证完整组合：让插件与实际使用的模型适配器、工具、沙箱、权限、会话存储及其他插件一起运行测试。

配置机制可为此提供基础保障。cordis.yml 条目可包含 config 块，插件会暴露 schema，并在 apply 函数运行前校验配置；配置不合法时，加载会直接失败，而不是让插件以“半配置”状态启动。2728 生成的配置目录可通过 pnpm run verify-config-catalog 进行校验。18

在分发方面，文档支持将扩展打包为可安装 bundle，再通过 dsh plugin add 加入 profile。将 bundle 与配置显式化，有助于复现、审计、测试和升级一套由多个组件组成的运行时。24

结论

把 DeepSeek Harness 看作智能体开发基础设施更为准确：模型连接、工具、策略、执行环境、循环、状态和界面，都是可以组合的选择。Cordis 负责插件生命周期与协作，四种运行模式提供开箱可用的起点，追加式会话日志则留下细粒度的运行记录。

它的吸引力在于灵活性；而正因为仍是开发者预览版，版本固定、隔离测试、会话回放以及对插件组合的系统验证，都会是实际落地时不可省略的工程环节。221