DeepSeek Harness白皮书

DeepSeek Harness 是 DeepSeek 官方开源的 Agent 运行时，采用“一切皆插件”架构，基于 Cordis 插件容器构建。它提供了 web 和 headless 两种运行模式，以及丰富的插件生态，允许用户自由拼装 Agent 能力，并进行深度定制。

核心特点：

• 一切皆插件：Agent 的所有能力都以插件形式存在，用户可以通过挂载插件来扩展 Agent 功能，例如添加工具、自定义界面等。
• 模型无关：官方适配 DeepSeek V4 系列模型，理论上可以接入其他 OpenAI 兼容模型。
• 可深度定制：用户可以通过修改 profile 和插件来改变 Agent 的行为和界面，满足个性化需求。
• 开源且 MI T 协议：用户可以自由使用和修改 DeepSeek Harness 的源码，并用于商业用途。

与主流 Agent 的对比：

• Claude Code：成熟的终端编码助手，开箱即用，但闭源、绑定 Claude 模型、定制空间有限。
• OpenAI Codex/OpenCode：工程能力强，但闭源绑定 OpenAI 模型。
• OpenCode：开源、终端、可配任意模型，但没有官方后端运行时，生态不如 DeepSeek Harness 丰富。
• Gemini CLI/Kimi CLI：分别擅长多模态和中文场景，但生态处于早期阶段。

学习路径：

• Day 1：理解 DeepSeek Harness 的概念，能够启动、对话和配置。
• Day 2：理解 profile 和插件机制，并编写第一个简单的插件。
• Day 3：评估插件质量、调优性能，并理解生态玩法。

应用场景：

• 日常编码：写函数、修 bug、补测试等。
• 数据处理与分析：数据清洗、统计分析、可视化等。
• 文档与知识工作：API 文档生成、笔记整理、总结、翻译等。
• 自动化与运维：批量处理、CI 任务、日志分析等。
• 代码理解与重构：代码审查、技术调研、代码重构等。

生态与资源：

• 官方入口：GitHub 仓库、官方文档站、API 文档、Discord、Discussions。
• 社区贡献模式：官方暂不接受外部 PR，但鼓励做 dsh-plugin 生态项目、写教程/博客。
• 插件生态：已出现 4000+ 插件，涵盖工具、上下文、会话、子代理、MCP、工作流、安全、模型、界面等方面。
• 新手参与路径：使用 -> 小改进 -> 发插件 -> 写内容。

未来展望：

• 技术演进：正式版发布、插件生态爆发、性能优化。
• 生态发展：插件数量增长、内容生态丰富、社区规模扩大。
• 竞争格局：成为“可编程 Agent 底座”的事实标准候选。
• 行业应用：金融、教育、销售、运营、研究等领域都有广泛应用。

风险与不确定性：

• rc 阶段的不稳定性：API 可能频繁变动，需要谨慎评估。
• 插件生态早期：第三方插件少，交互形态缺失，文档滞后于代码。
• 跨平台短板：Windows 上存在路径处理、编码问题、子进程终止等家族问题。
• 性能边界未充分验证：高并发、大型代码库场景缺少公开压测数据。

总结：

DeepSeek Harness 是一个功能强大、可深度定制的 Agent 运行时，拥有丰富的插件生态和广阔的应用前景。它适合想要深度定制 Agent、玩生态、跑 CI 的开发者，以及希望在服务器/CI 跑 Agent 的用户。目前生态处于早期阶段，用户入场可以获得先发优势，并参与到生态的建设中。