用户指南
用户指南
深入掌握 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 标记的插件包
Python SDK
跳过 Web UI，用 Python 程序化启动 Harness 并调用同一套 API
从 Codex / Claude Code 迁移
模型层兼容、hooks.json 桥接与原生 Cordis 插件三条渐进路径
配置参考
设置、凭据、环境变量、模型与权限配置的精选速查
工具参考
agent 可用工具的精选速查：文件、命令、委派、目标与插件
阅读建议
- 想搞懂
dsh启动器的每个参数、profile 的叠加顺序，直接看 CLI 与 Profile。 - 想让不同会话使用不同人设与工具，从 Agent Preset 开始。
- 想给 agent 装可复用指令、或让它长期自动推进一件事，见技能与目标。
- 想并行委派子 agent 或编排多 agent 流程，见 Subagent 与工作流。
- 从 Codex 或 Claude Code 迁移，见迁移指南。
- 查配置键或工具清单，见配置参考与工具参考。
- 想扩展 Harness 本身，可以先读开发者指南。
开发者预览
DeepSeek Harness 目前处于开发者预览阶段，正在快速迭代，未来可能出现破坏兼容性的变更。本文档描述的是当前行为。