开始使用
什么是 DeepSeek Harness
DeepSeek Harness 的核心思想、架构与三种使用形态
DeepSeek Harness（命令行工具名 dsh）是 DeepSeek AI 开发的开源智能体框架（agent harness）。它的核心理念只有一句话：
一切皆插件（Everything is a Plugin）
Harness 的每一项能力——工具、技能、目标、子代理、界面区块、模型路由——都以插件的形式存在，并通过 Cordis 组合在一起。其设计思想见论文 A Programming Paradigm for Spatiotemporal Composability。
它能做什么
在一个会话中，agent 可以：
- 读写文件：读取、创建、修改工作区里的文件；
- 执行命令：在你的许可下运行 shell 命令；
- 委派工作：派发子代理并行处理独立任务；
- 编排工作流：把复杂任务拆成多阶段流程；
- 使用技能：加载文档写作、代码审查、设计等专项技能；
- 维护目标：围绕一个长期目标持续多轮推进；
- 自我扩展：通过动态插件在运行中给自己加装新能力。
三种使用形态
| 形态 | 命令 | 适合场景 |
|---|---|---|
| Web GUI | dsh web（或 npx @deepseek-ai/dsh web） | 日常使用：对话、审批、管理工作区 |
| Headless | dsh --profile headless "任务" | 脚本化调用：一次性任务、CI 集成 |
| 插件管理 | dsh plugin --profile <name> ... | 为某个 profile 安装/卸载插件 |
Web 与 headless 两个 profile 首次使用时会从内置模板自动初始化；其他 profile 需要通过 dsh plugin 创建。
一张图看懂
核心概念速览
- Profile：一组有序的插件束（bundle）叠加层，决定这个入口加载哪些能力。
- Agent Preset：单个会话的智能体组合（persona、提示词、工具、技能），来自
cordis.yml配置。 - Skill：可复用的任务型指令包，按需加载（如
astro、code-review）。 - Goal：跨多轮自动推进的持久化完成目标。
- Subagent / Workflow：子代理委派与多代理编排。
- 动态 Cordis 插件：临时扩展运行时的 Host 能力与浏览器 Client 界面。
适合谁
- Vibe Coding / AI 办公新手：装好即用，用自然语言描述目标，agent 负责读写文件与执行命令。
- 有经验的用户：通过 profile、preset、技能与工作流把 Harness 调成自己的形状。
- 插件开发者：用 Cordis 组合模型扩展 Harness 的一切，见开发者指南。
注意事项
开发者预览
Harness 目前处于开发者预览阶段，快速迭代中，未来可能出现破坏兼容性的变更。用于生产前请评估风险。
下一步：安装与启动