DeepSeek Harness v0.1：官方插件化 Agent 框架的启动与配置

一句话结论

DeepSeek 官方开源的 Agent 框架：一切皆插件（模型、工具、技能、会话、沙箱、文件系统、循环、编排、UI 均可替换），一条 npx @deepseek-ai/dsh web 即可本地启动 Web UI，当前为开发者预览版、会破坏性变更。

适用场景

• 适合的任务：想用 DeepSeek 官方框架搭建/定制 Agent harness；需要把模型、工具、技能按插件组合的实验；研究官方对 V4 系列 Agent 工作流的默认配置。

• 不适合的任务：生产环境直接依赖未锁定版本的预览框架；需要开箱即用的成熟 Agent 产品（预览版迭代快、兼容性会破）。

• 适用的模型版本：框架面向 DeepSeek 模型（V4 系列），README 以 Web UI 默认启动为例；模型插件可替换。

• 适用的客户端、Agent 或 API：dsh CLI/Web UI（默认 http://127.0.0.1:3080）；底层由 Cordis 元框架驱动。

• 推荐的推理档位和参数：框架文档未在 README 给出 effort 建议；模型侧仍按官方 low/high/max 配置。

可直接使用的内容

官方 README 的启动方式（原文）：

# 从 npm 运行（默认启动 Web UI 于 http://127.0.0.1:3080 并打开浏览器）
npx @deepseek-ai/dsh web

# 不自动打开浏览器
npx @deepseek-ai/dsh web --no-open

# 从源码运行
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

官方公告要点（X @deepseek_ai，2026-08-13）：

DeepSeek Harness v0.1 现已在开发者预览版中推出！
向全球开发代理框架的开发者开放，并以 MIT 许可开源代码库。
由 Cordis 元框架驱动，核心理念：一切皆插件。
模型、工具、技能、会话、沙箱、文件系统、循环、编排和 UI 均可替换。

测试/工作流步骤

1. 先确认 Node.js 环境，npx @deepseek-ai/dsh web 启动 Web UI；SSH 场景下只打印主机 URL（本地端口转发由 SSH 客户端/编辑器负责）。

2. 阅读 docs/ 的 development guide 与 architecture 文档，理解插件边界（模型/工具/技能/会话/沙箱/文件系统/循环/编排/UI）。

3. 用示例（examples/）跑通一个最小 Agent 任务，替换默认模型插件为 deepseek-v4-pro，记录工具与技能插件的装载方式。

4. 因为是开发者预览版，升级前锁定版本并备份配置；关注 GitHub Discussions 与 dsh-plugin 主题的插件生态。

5. 在目标任务上对比 harness 默认行为与 API 直连的差异（系统提示、工具协议、成本），再决定是否投入生产。

原始证据与数据

• 仓库规模（采集时）：约 12,940 commits、176k stars、19.1k forks、MIT 许可；最新发布 0.1.0-rc.8；含 docs/、examples/、packages/、python/、apps/web 等目录。

• README 明确：“DeepSeek Harness is currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.”

• README 明确插件架构：“everything is a plugin, and is powered by Cordis, whose design is described in A Programming Paradigm for Spatiotemporal Composability.”

• 官方 X 公告（2026-08-13）同步发布 V4-Pro GA，说明 Harness 与 V4-Pro 同期推出、定位为官方 Agent 框架。

适用边界

• 开发者预览版：兼容性破坏变更频发，README 已明确警告；本文只记录 README 与官方公告，未执行安装或运行。

• “一切皆插件”是架构承诺，不等于所有插件都稳定；第三方插件需自行审计（MIT 许可不担保安全）。

• Harness 的 Web UI/CLI 是 DeepSeek 官方开源项目，与 DeepSeek 商业 API 服务相互独立；接入 API key 时注意密钥管理与费用。

• 框架能力与 V4-Pro 模型能力是两个层面：harness 会引入自己的系统提示与工具协议，不能把“harness 表现”等同于“模型表现”。

来源摘录或观察（仅做合规短引）

官方 X 公告：“DeepSeek Harness 是一个围绕一个核心理念构建的代理框架：一切皆插件。模型、工具、技能、会话、沙箱、文件系统、循环、编排和 UI……”。