安装 DeepSeek Harness:配置与首跑指南
Updated August 16, 2026 · first published 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(命令行参数 —— 最高优先级)
Related
Want this applied to your own LLM spend? FinOps LLM runs a free audit of your AI costs and shows where the savings are. Book free audit →