五分钟上手 DeepSeek Harness

DeepSeek Harness 是什么

DeepSeek Harness（简称 dsh）是 DeepSeek AI 开发的开源 agent harness（智能体框架），采用一切皆插件的架构，由 Cordis 驱动，以 MIT 许可证发布。它把工具、模型适配器、文件访问乃至 agent 循环本身都组织成挂载在共享上下文中的插件，因此你可以像搭积木一样组合出一套属于自己的智能体。

当前版本处于开发者预览阶段，迭代很快，未来可能出现破坏兼容性的变更，使用时请留意版本更新。

安装要求

• Node.js：官方通过 npm 运行，需先安装 Node.js，建议使用最新的 LTS 版本。
• 从源码构建时另需 Git 与启用了 Corepack 的 pnpm。
• 需要 API key 才能让模型真正工作：可选用 DeepSeek API key，或任何兼容的模型提供方。

安装步骤

最简单的运行方式是通过 npx 直接启动，无需手动安装任何东西：

npx @deepseek-ai/dsh web

如果你希望使用最新开发版本、参与贡献或修改源码，可以从仓库构建：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

启动与 Web UI

启动后，终端会打印访问地址，默认是 http://127.0.0.1:3080，用浏览器打开即可进入 Web UI。dsh web 是 dsh --profile web 的快捷别名，启动的是内置的 web profile（由 dsh-base 与 dsh-web-app 两个组合包构成）。

首次使用只需三步：

1. 打开设置 → 模型，填入 DeepSeek API key 并保存——模型路由立即可用，不需要重启服务器。
2. 点击选择工作区，把启动 dsh 时所在的项目目录加进去并选中；选中前会话输入框不可用。
3. 新建会话，直接描述任务即可。agent 可以读写工作区文件、运行命令、委派子任务；当操作超出当前权限策略时，Web UI 会先征求你的批准。

dsh 进程会把调用目录作为默认的文件系统位置，所以一般建议在工作区目录里启动它。

接下来

• 安装插件：从 GitHub 或 npm 装第一个插件
• 编写第一个 Cordis 插件：自己动手注册一个工具
• Cordis 进阶：Service、Event 与生命周期
• 想给生态添砖加瓦？去申请收录页面提交你的插件。