> ## Content Index > Fetch the complete content index at: https://www.hubwiz.com/blog/llms.txt > Use this file to discover other available public pages before exploring further. # DeepSeek Harness 解读 - URL: https://www.hubwiz.com/blog/deepseek-harness-aidai-li-de-wei-lai/ - Published: 2026-09-01T07:43:18.000Z - Updated: 2026-09-01T07:43:18.000Z - Description: 深入解析DeepSeek的开源、插件优先的代理运行时——以及它为何与Claude Code和Codex有根本性的不同。 - Author: admin - Tags: AGENT, #Import 2026-10-14 14:41 大多数AI编码代理从外表看起来都差不多。 你给它们一个提示。它们读取你的代码库。它们编辑文件、运行命令、搜索内容，并尝试完成任务。 但在底层，远不止一个LLM那么简单。 还有一个运行时。 还有工具、会话、权限、沙箱、模型适配器、代理循环、存储、调度。 这一层就是**harness（运行时框架）**。 而DeepSeek刚刚开源了一个。 ## 1、什么是DeepSeek Harness？ DeepSeek Harness（DSH）是DeepSeek AI开源的代理运行时框架。它目前以MIT许可证发布为开发者预览版。 DeepSeek的核心理念很简单： ***一切皆是插件。*** 不仅仅是外部工具。 模型、工具、技能、会话、沙箱、存储、循环、调度甚至UI都可以作为插件提供。DeepSeek表示这些组件可以通过配置选择、替换或扩展，无需修改Harness源代码本身。 这就是DSH有趣的地方。 它不仅仅是另一个编码代理。 它试图让**代理运行时本身变得可组合**。 ## 2、架构：模型 + Harness DeepSeek将代理描述为： **代理 = 模型 + Harness** 模型提供智能。 Harness提供该智能实际运行的环境。 DSH的简化视图如下： ``` │ Model │ └───────┬───────┘ │ ▼ ┌───────────────────┐ │ DeepSeek Harness │ │ Runtime │ └─────────┬─────────┘ │ ┌─────────────┼─────────────┐ ▼ ▼ ▼ ┌────────┐ ┌────────┐ ┌─────────┐ │ Tools │ │ Skills │ │Sessions │ └────────┘ └────────┘ └─────────┘ │ │ │ └─────────────┼─────────────┘ ▼ ┌──────────────┐ │ Environment │ │ Files / Shell│ │ Web / Runtime│ └──────────────┘ ``` 有趣的部分在于中间层。 DSH构建在**Cordis**之上，这是一个管理插件挂载、卸载、依赖、服务和事件的插件框架。官方架构文档更进一步：模型适配器、工具注册表、会话日志和代理循环本身就是插件。故意没有开发者必须修补才能扩展系统的特权核心。 这改变了你对自定义化的思考方式。 ## 3、一切皆是插件 这是我在DeepSeek Harness中发现最有趣的特性。 在传统的编码代理中，你通常只能在边缘进行自定义。 添加一个MCP服务器。 添加一个技能。 更改一些配置。 也许写一个扩展。 DSH采取了更激进的方法。 **架构本身就是模块化的。** 想改变模型层？ 它是一个插件。 想替换一个工具？ 插件。 想要不同的会话实现？ 插件。 想改变代理循环？ 插件。 想创建不同的运行时配置？ 组合插件。 DeepSeek明确地将模型、工具、技能、会话、沙箱、存储、循环、调度和UI作为插件能力暴露出来。 对开发者来说，这很重要，因为**这里的开源不仅仅意味着能够阅读源代码**。 你实际上可以更改机制。 你可以分叉它。 你可以编写自己的插件。 你可以替换组件。 你可以尝试完全不同的代理配置。 而且由于项目是MIT许可证，许可障碍比封闭的商业代理运行时低得多。 插件：[https://github.com/topics/dsh-plugin](https://github.com/topics/dsh-plugin?ref=hubwiz.com) ## 4、四种代理模式 ![None](https://www.hubwiz.com/blog/content/images/2026/08/1-nTju0yn9KHhWL9SCJpLkjg.png) DeepSeek不只提供一种运行Harness的方式。 它目前提供多种运行时模式。 #### 标准模式 这是完整的编码代理体验。 它包括文件编辑、Shell访问、文件和Web搜索、技能、规划、目标、子代理和工作流。 #### PTC模式 这个特别有趣。 DSH不将每个操作暴露为另一个顺序工具调用，而是可以通过**PTC Mode SDK**暴露其工具，允许模型生成一个组合多个操作的TypeScript程序。 概念上： ``` 传统代理： Model ↓ Tool call ↓ Result ↓ Model ↓ Tool call ↓ Result ↓ Model ``` 代码模式转向： ``` Model ↓ 生成TypeScript ↓ 执行多个操作 ↓ Result ``` 这是一种完全不同的工具编排思维方式。 #### 最小模式 最小模式将环境简化为一个持久化Bash工具和文件编辑器。 当你想用更小的工具集评估模型，而不是给它整个代理环境时，这很有用。 #### 创造者模式 创造者模式直接面向构建代理的开发者。 你可以检查运行时，在内存中试验Cordis插件，并组合自定义代理预设。 这就是DSH开始看起来不那么像编码助手，而更像**代理开发平台**的地方。 ## 5、你实际上可以自定义和添加自己的 ![None](https://www.hubwiz.com/blog/content/images/2026/08/1-jYaz5feLI7qG3i_3cp1oNw.png) 这就是开源部分变得重要的地方。 DSH界面为以下内容暴露了独立区域： **模型 → 插件 → 代理预设** 你可以检查已安装的插件及其状态、更改配置并创建自定义预设。 但更深层次的自定义发生在UI之下。 因为运行时是开源的且基于插件，你不受默认预设的限制。 你可以修改源代码。 编写你自己的插件。 替换现有功能。 创建不同的代理循环。 更改模型适配器。 构建你自己的工具。 创建自定义沙箱。 组合你自己的代理预设。 官方架构明确将**模型适配器、工具注册表、会话日志和代理循环**等核心组件视为插件。 这就是重要的区别。 **你不仅仅是在自定义代理的行为。** 你可以自定义使代理工作的机制。 ## 6、轨迹视图是另一个重大特性 ![None](https://www.hubwiz.com/blog/content/images/2026/08/1-4F2HoITezCJDdKsrH3iyBg.png) 代理调试很难。 普通应用程序给你日志。 代理给你对话、工具调用、上下文更改、子代理、模型输出和不断变化的状态。 DSH通过**仅追加的会话日志**来解决这个问题。 根据DeepSeek的说法，该日志记录模型看到的内容，包括系统提示、推理、工具调用和结果、子代理调度和上下文注入。然后轨迹视图可以检查这些记录，而恢复、分叉、搜索和重放在同一事件流上操作。 对于代理开发者来说，这不仅仅是一个漂亮的UI特性。 它是一个可观测性原语。 如果代理做出了错误的决定，你想知道： ``` 模型看到了什么？ ↓ 它选择了哪个工具？ ↓ 工具返回了什么？ ↓ 注入了什么上下文？ ↓ 运行了哪个子代理？ ↓ 接下来发生了什么？ ``` 可追溯的事件流使调查变得容易得多。 ## 7、DSH vs Claude Code vs Codex 这就是DSH变得更容易理解的地方。 **Claude Code**和**Codex**主要是面向开发者的编码代理产品。 Claude Code在终端中运行，可以探索代码库、编辑文件、执行命令、使用MCP并自动化开发工作流。Anthropic还提供可配置的权限和CLI控制。 **Codex**是OpenAI的编码代理，具有本地CLI以及IDE、桌面和云端界面。其CLI在Apache-2.0下开源。 但DeepSeek Harness从不同的架构角度来看待这个问题。 ![None](https://www.hubwiz.com/blog/content/images/2026/08/1-d2MzrqG8KcL83XuEcRW2lQ.png) 重要的区别**不仅仅是开源与闭源**。 Codex也是开源的。 区别在于**被开放的内容以及系统的结构方式**。 使用DSH，插件架构延伸到核心运行时本身。DeepSeek的架构文档明确将代理循环、模型适配器、工具注册表和会话日志描述为可替换的插件。 这是一个更宏大的自定义化面。 ## 8、为什么开源在这里很重要 这可能是DSH最有力的论点。 使用闭源编码代理，你使用供应商提供的运行时。 你可以配置它。 你可以连接外部工具。 但你通常无法重新设计底层的代理架构。 使用DeepSeek Harness，源代码就在那里。 你可以检查实现。 更改它。 分叉它。 构建插件。 替换组件。 创建你自己的运行时配置文件。 构建一个行为不同于默认DSH体验的代理。 该项目是MIT许可证，并明确鼓励插件生态系统。 对于研究者和代理框架开发者来说，这很重要。 你不仅仅是在测试一个代理。 你可以测试**你自己对代理应该是什么样子的想法**。 ## 9、但有一个问题 DeepSeek Harness仍然是**开发者预览版**。 DeepSeek明确警告该项目正在快速演变，兼容性破坏性更改将会发生。 这意味着我不会把DSH视为Claude Code或Codex的成熟替代品。 架构是有趣的部分。 生态系统仍需围绕它成熟。 还有一个安全考量。 DSH可以在本地机器上执行操作，因此DeepSeek建议使用具有有限权限的专用虚拟机或容器，尤其是在与不受信任的互联网内容交互时。 这是\*\*"代理可以做任何事"**和**"应该允许代理做任何事"\*\*之间的重要区别。 ## 10、我的看法 我认为DeepSeek Harness最有趣的地方不在于它是另一个AI编码代理。 有趣的是DeepSeek正在暴露**代理背后的机制**。 模型是可替换的。 工具是可替换的。 会话层是可替换的。 代理循环是可替换的。 运行时可以重新组合。 而整个东西都建立在开源插件架构之上。 这使得DSH感觉不那么像\*\*"另一个Claude Code竞争者"**，而更像**一种构建你自己的编码代理基础设施的尝试\*\*。 这是一个更有趣的问题。 AI编码代理的下一步可能不仅仅是更好的模型。 可能是更好的**harness**。 而DeepSeek刚刚开源了一个更有趣的架构供实验。 ## 11、本地运行DeepSeek Harness DeepSeek Harness最棒的事情之一是你不必通过托管服务来交互。 你可以本地运行整个Web UI。 #### 选项1：直接运行 如果你已经安装了Node.js： ``` npx @deepseek-ai/dsh web ``` 就这样。 默认情况下，DSH在以下地址启动其Web UI： ``` http://127.0.0.1:3080 ``` 官方CLI还会在你的默认浏览器中打开本地UI。如果你不想自动打开，使用： ``` npx @deepseek-ai/dsh web --no-open ``` 这是无需克隆仓库即可**本地试用DeepSeek Harness**的最快方式。 #### 选项2：克隆并运行源代码 如果你有兴趣实际修改Harness，这是我推荐的路径。 ``` git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web ``` 重要的区别是，你现在运行的是**你自己签出的Harness源代码**。 --- 原文链接：[DeepSeek Harness: The Future of AI Agents?](https://medium.com/@nilaymallik/deepseek-harness-the-future-of-ai-agents-b61898e21ea0?ref=hubwiz.com) 汇智网翻译整理，转载请标明出处