DeepSeek Harness (dsh)

什么是 DeepSeek Harness (dsh)？

DeepSeek Harness (dsh) 是深度求索（DeepSeek AI）开发的开源智能体运行时与框架。它基于 Cordis 插件内核构建，其中每个组件——从 AI 模型、工具，到会话、沙箱乃至智能体循环本身——都是可替换的插件。dsh 并非一个新的 AI 模型，而是一个为模型配备工作空间、工具、权限、内存和结构化执行环境以完成任务的“框架”。

DeepSeek Harness 的核心特性

DeepSeek Harness 以其模块化、插件优先的架构脱颖而出，旨在提供灵活性和自主控制权。

• 万物皆插件：这是 dsh 的核心原则。模型适配器、工具注册表、会话日志记录、沙箱化，甚至用户界面等功能都作为插件实现。这使得智能体系统的任何层级都可以在不修改单体核心的情况下进行替换或扩展。

• 可组合的运行时：用户可以通过堆叠插件“包”并应用配置“补丁”来组装自己的智能体运行时。dsh 附带多个预定义的智能体“预设”（标准、代码、极简、创作者），它们共享相同的插件核心，但暴露不同的能力。

• 完全本地执行：dsh 在您的本地机器上运行（默认地址为 http://127.0.0.1:3080），而非远程服务器。这使用户能够完全控制自己的数据和执行环境。

• 仅追加会话日志：每个操作——模型提示、推理、工具调用、结果——都会被记录在不可变的会话日志中。这支持了强大的功能，如逐步检查（“轨迹”视图）、重放、从任意点分叉运行以及恢复工作。

• 丰富的插件生态系统：活跃的社区已迅速开发了数百个插件（在 GitHub 上归类于 dsh-plugin），这些插件增加了新工具、用户界面、浏览器控制、替代的智能体循环和沙箱解决方案。

• 面向开发者且采用 MIT 许可证：作为一个采用 MIT 许可证的开发者预览项目，dsh 面向那些希望拥有、定制并构建自己的智能体基础设施，而非使用封闭托管服务的团队和开发者。

如何使用 DeepSeek Harness

使用 DeepSeek Harness 涉及本地设置、配置，并利用其插件系统来定制智能体以满足您的需求。

1. 快速安装与启动

• 前提条件：确保已安装 Node.js（v22.19+ 或 v24+）。

• 启动 Web UI：在终端中运行 npx @deepseek-ai/dsh web。此命令将下载并启动 dsh Web UI，可通过 http://127.0.0.1:3080 访问。

• 初始配置：

  • 打开 Web UI 并导航至 ### 设置 > 模型。
  • 添加一个 DeepSeek API 密钥（或其他支持的提供商如 Anthropic 或 OpenAI 的凭证）。
  • 选择一个 ### 工作空间目录（供智能体操作的本地文件夹）。在选择工作空间之前，会话编辑器将不可用。

2. 从源代码运行（用于开发）

• 克隆仓库：git clone https://github.com/deepseek-ai/deepseek-harness
• 安装依赖：pnpm install
• 构建项目：pnpm run build
• 运行本地构建：pnpm dsh web

3. 使用插件进行扩展

• dsh 的强大之处在于其可扩展性。您可以直接将社区插件安装到配置文件中。
• 示例：要安装终端 UI 插件，请运行 dsh plugin add dsh-cc-tui。
• 可以通过 Web UI 的插件设置面板管理和检查插件。

4. 理解运行时模式

• 标准模式：功能齐全的编码智能体，具备文件编辑、Shell、搜索、技能和子智能体功能。

• 代码模式：通过 TypeScript SDK 暴露工具，允许模型在单个程序中编排复杂的多步骤操作。

• 极简模式：仅包含持久化 bash 和文件编辑器的精简环境，非常适合对 AI 模型进行基准测试。

• 创作者模式：标准模式加上运行时检查工具，专为创作新的智能体预设和测试插件组合而设计。

DeepSeek Harness 的价格

DeepSeek Harness 本身在 MIT 许可证下 ### 完全免费且开源。该软件没有订阅费或许可证费用。

• 需要考虑的成本：

  • 模型 API 成本：您必须为 AI 模型（例如 DeepSeek、OpenAI 的 GPT-4、Anthropic 的 Claude）提供自己的 API 密钥。您将根据所选模型提供商的使用量和定价产生费用。

  • 基础设施：由于它在本地运行，您的“基础设施”就是您自己的计算机。没有服务器托管费用。

  • 开发时间：作为一个开发者预览框架，将 dsh 定制为特定生产需求需要技术投入。

使用 DeepSeek Harness 的有用提示

• 从 Web UI 预设开始：web 配置文件是最简单的启动方式。它会自动初始化一个合理的默认配置。

• 检查您的配置：使用 dsh web --dump-config 打印您的实例启动时使用的确切插件树。这对于调试和理解如何修补它非常有价值。

• 利用轨迹视图：运行后，使用轨迹选项卡检查智能体工作的每一步。这种透明度是理解失败和优化提示词的关键。

• 谨慎管理工作空间：智能体在您选择的目录内操作。确保它具有必要的权限并包含任务所需的上下文（代码、文件）。

• 注意插件来源：社区插件未经深度求索（DeepSeek AI）审核。在安装任何插件之前，请检查其源代码，特别是当它请求文件系统或网络访问权限时。

• 预期会有变化：该项目处于“开发者预览”阶段。虽然对于实验来说是稳定的，但在 1.0 版本发布之前，核心 API 和插件可能会出现破坏性变更。

常见问题解答 (FAQ)

DeepSeek Harness 是深度求索的新 AI 模型吗？

不是。DeepSeek Harness (dsh) 不是一个模型。它是一个框架——一个“框架”——为现有的 AI 模型（如深度求索自己的模型，或 Claude，或 GPT-4）提供使用工具和完成任务的环境。

官方的“DeepSeek Harness”与 Python 的“deepseek-harness”有什么区别？

它们是两个完全无关的项目，只是名字巧合地相似。官方的 dsh（本文主题）是深度求索（DeepSeek AI）开发的 TypeScript/Node.js 智能体运行时。Python 的 deepseek-harness 是一个独立的社区构建的 DeepSeek V4 API 客户端库。

我可以在 dsh 中使用深度求索以外的模型吗？

可以。dsh 通过插件支持多个“模型适配器”。它支持深度求索、OpenAI、Anthropic 以及其他提供 OpenAI 兼容 API 端点的提供商。

运行 dsh 安全吗？它会访问我的文件吗？

dsh 在本地运行，并且只访问您明确选择的工作空间目录内的文件。沙箱化插件可以进一步限制权限。然而，与任何执行代码的软件一样，您应该只在包含可信内容的工作空间中运行它，并对来自未经审查来源的插件保持谨慎。

我为什么要选择 dsh 而不是像 Claude Code 这样的托管智能体？

如果您优先考虑数据隐私（所有内容都保留在本地）、需要对智能体能力进行深度定制、希望拥有和修改运行时，或者正在构建内部平台，请选择 dsh。如果您希望获得更即用、稳定、托管的体验，并且设置开销更少，请选择托管智能体。

如何贡献一个插件？

按照 Cordis/dsh 约定开发您的插件，将其发布到 npm 或 GitHub，并在 GitHub 上为其添加 dsh-plugin 主题标签，以便社区能够发现它。

“开发者预览”是什么意思？

这意味着该软件已公开发布供开发和测试，但其 API 尚未稳定。未来的版本中可能会出现破坏性变更。不建议用于无法容忍此类变更的关键生产部署。