dshDSH 学习手册

DeepSeek Harness · Everything is a Plugin

逐章读懂 DSH，
看清 Agent Harness 的每一种能力

一份面向中文读者的 DeepSeek Harness 渐进式学习手册：从「它是什么」到「它还能做什么」，用 18 章建立完整认知。

从第一章开始 →直接看能力地图

章节: 18
板块: 3
阅读门槛: 零

学习路径

按顺序读最省力，也可以直接跳到感兴趣的板块。

Part 1

功能理解

建立整体认知

s01DSH 是什么：一切皆插件DeepSeek Harness 的定位、核心理念与五分钟上手。s02入口模式与命令行dsh 的四种入口、参数透传规则与退出行为。s03Profile 与组合包：配置即产品理解 DSH 最核心的抽象：profile 按层叠加组合包，patch 决定最终形态。s04Web 与 Headless：两种运行形态交互工作台与一次性任务运行器，分别怎么用、适合什么场景。

进入功能理解板块 →

Part 2

常用扩展

能力全景盘点

s05终端与命令执行bash、持久 PTY 终端、PowerShell——agent 执行命令的全部姿势。s06文件读写与代码编辑read/write/edit、str_replace_editor、glob/grep——agent 的文件操作全家桶。s07任务、目标与后台作业todo_write 管清单、goal 管长目标、job_* 管后台——agent 的自我管理三件套。s08Subagent：多代理协作委派任务给子代理：continuable 与 one-shot 两种后端，以及一套控制工具。s09Workflow 与 Ralph：规模化编排用 JavaScript 脚本编排子代理大军，以及 Ralph 的全新-agent迭代循环。s10Skill 系统：给 AI 的工作说明书把反复交代的流程写成文件，agent 接到同类任务时按流程执行。s11Web 访问与外部生态web_search/web_fetch 之上的可替换提供方，以及 MCP、ACP 两个互操作协议。s12上下文管理：压缩、计量与外溢上下文窗口是稀缺资源：compaction、token-meter、spill 三层机制。s13计划模式与人机交互先规划后执行：exit_plan_mode 的审批流，与 ask_user_question 的暂停等待。s14定时任务与会话查询让 agent 定时醒来干活，以及跨会话检索历史事件的能力。s15能力全景地图50 个能力包一次看全：DSH 还能做什么？这一章给答案。

进入常用扩展板块 →

Part 3

原理解析

浅层概念科普

s16插件分层叠加原理Cordis 的五个核心概念、四种事件分发模式，以及「没有内核」的架构含义。s17一次 dsh 命令的旅程从敲下命令到模型回答：启动、组装、轮次、步骤、工具流水线的全景。s18如何扩展 DSH「想加一个能力，该动哪里？」——归属位置表、官方 cookbook 与动态插件实验。

进入原理解析板块 →

什么是 DSH？

DeepSeek Harness 是 DeepSeek 开源的插件化 Agent Harness：模型适配、工具、会话日志、甚至 agent loop 本身，全部是可替换的插件。

阅读第 1 章 →

组合即产品

profile 按层叠加组合包，一份配置树决定整个运行时形态。

一切皆插件

换掉一个提供方就能换掉文件系统、终端甚至 agent loop。

双形态运行

dsh web 打开浏览器工作台，headless 一条命令跑完任务。

深可扩展

从加一个工具到改一个循环，都有文档化的扩展点。