安装 DeepSeek Harness：配置与首跑指南
更新于 August 16, 2026 · 首次发布 August 16, 2026
这是 DeepSeek Harness 的实用操作指南：如何启动 dsh、组合模式的工作原理，以及最值得体验的官方演示。
最快速的上手方式
npx @deepseek-ai/dsh web在本地 http://127.0.0.1:3080 启动 Web 界面。开始前必须完成两项设置：
- 设置 → 模型： 输入 DeepSeek API Key，无需重启即可生效。
- 选择工作区： 添加并激活项目目录，否则会话编写器将保持禁用状态。
启动后，智能体可以读写文件、执行终端命令、委托子智能体并进行规划，执行前会按权限策略请求确认。
源码安装与构建
git clone https://github.com/deepseek-ai/deepseek-harness
pnpm install
pnpm run build
pnpm dsh web环境要求：Node 22.19+、Git 2.26+，通过 Corepack 使用固定版本 pnpm@11.7.0。API Key 可配置于环境变量或根目录的 .env 文件中。
配置文件与插件包 (Profiles & Bundles)
在 Cordis 架构中，一切皆插件。Profile 是命名的插件组合，包含有序的 Bundle 列表及自定义补丁。官方内置三套模板：
dsh-base: 模型适配器、基础工具与持久化。dsh-web-app: 浏览器交互界面。dsh-headless: 适合 CI/CD 和自动化的单次无头运行模式。
四层配置覆盖顺序
配置按固定顺序解析，后层覆盖前层：
- Profile Bundles（预设插件包）
- Profile Patches（配置补丁）
- Home Patches（全局用户补丁）
- CLI Overlays（命令行参数 —— 最高优先级）
常见问题
如何快速安装和运行 DeepSeek Harness？
运行 npx @deepseek-ai/dsh web 即可在本地 3080 端口启动 Web 界面，或通过 git clone 源码编译运行。
DeepSeek Harness 中的 Profile 是什么？
Profile 是命名的插件组合，定义了加载的插件包及补丁规则，如 dsh-base 和 dsh-headless。
配置覆盖的四层解析顺序是什么？
顺序为：插件包、配置文件补丁、用户全局补丁、命令行参数。命令行参数具有最高优先级。
相关文章
想将这些方法用于您的技术栈吗？ 请准备好供应商账单、网关日志和主要工作流；我们会梳理成本驱动因素与节省空间。 预约免费审查 →