用户指南
用户指南
深入掌握 DeepSeek Harness：CLI 与 profile、agent preset、技能与目标、subagent 与工作流、插件与 Python SDK
欢迎来到用户指南。如果你已经通过安装与启动把 DeepSeek Harness 跑起来，并且走完了 Web GUI 快速上手，这一部分会帮你把它调成自己的形状：从启动参数、按会话组装 agent（智能体），到技能、目标、多 agent 编排与程序化调用。
章节速览
CLI 与 Profile
启动器参数、profile 配置层、headless 一次性任务、插件管理与 dump-config
Agent Preset
按会话组装 agent：persona、工具、提示词段落与技能，来自一份 agent.cordis.yml
技能与目标
skill（技能）按需加载可复用指令包；goal 让会话围绕一个长期目标持续多轮推进
Subagent 与工作流
把工作委派给子 agent，或用工作流脚本编排大规模多 agent 协作
第三方插件
在 profile 中安装并使用带 dsh-plugin 标记的插件包
Cordis 插件市场
通过 cordis.run 发现 dsh.bundle 插件、阅读配置指引，再由 profile 安装与激活
Python SDK
跳过 Web UI，用 Python 程序化启动 Harness 并调用同一套 API
从 Codex / Claude Code 迁移
模型层兼容、hooks.json 桥接与原生 Cordis 插件三条渐进路径
配置参考
设置、凭据、环境变量、模型与权限配置的精选速查
工具参考
agent 可用工具的精选速查：文件、命令、委派、目标与插件
选择扩展方式
| 你的目标 | 优先选择 | 从哪里开始 |
|---|---|---|
| 给 agent 一套可复用的做法、规范或领域知识 | Skills | 技能与目标 |
| 接入已有的外部工具或数据服务 | MCP client 桥接 | Cordis、MCP 与 Skills |
| 安装一项可分发的模型、工具、UI 或工作流能力 | 第三方插件 | 在 cordis.run 发现候选，再看插件指南 |
| 隔离任务、并行推进或编排多个 agent | Subagent / 工作流 | Subagent 与工作流 |
它们可以配合使用：插件由 Cordis 组合，插件可提供 Skills 或 MCP 桥接，而子 agent 也可以调用这些能力。
阅读建议
- 想搞懂
dsh启动器的每个参数、profile 的叠加顺序，直接看 CLI 与 Profile。 - 想让不同会话使用不同人设与工具，从 Agent Preset 开始。
- 想给 agent 装可复用指令、或让它长期自动推进一件事，见技能与目标。
- 想并行委派子 agent 或编排多 agent 流程，见 Subagent 与工作流。
- 想从社区市场挑选扩展，先在 cordis.run 阅读插件页，再按第三方插件在目标 profile 中安装；市场收录不等于安全背书。
- 从 Codex 或 Claude Code 迁移，见迁移指南。
- 查配置键或工具清单，见配置参考与工具参考。
- 想扩展 Harness 本身，可以先读开发者指南。
开发者预览
DeepSeek Harness 目前处于开发者预览阶段，正在快速迭代，未来可能出现破坏兼容性的变更。本文档描述的是当前行为。