DSH入门

非官方指南

DeepSeek Harness 入门

从第一次对话到自己的插件

给 0 基础用户的实用指南。先学会用,再理解原理,最后扩展它。

本书地图

10 章 + 附录。可以按顺序读,也可以直接跳到需要的一章。

01

认识 DSH:模型、Harness、Agent

先分清模型、Harness 和 Agent,知道 DSH 到底在做什么。

约 5 分钟 · 2,372 字 · 11 个小节
02

第一次启动:桌面、模型、工作区

从桌面入口、模型连接和一个小工作区开始。

约 4 分钟 · 1,965 字 · 12 个小节
03

第一次任务:把需求说清楚

用“目标 + 输入 + 约束 + 验收”完成第一个任务。

约 4 分钟 · 1,857 字 · 12 个小节
04

工作区、文件与权限

看懂工作区边界、审批和破坏性操作。

约 4 分钟 · 2,111 字 · 12 个小节
05

会话、上下文与记忆

理解 Session、上下文窗口,以及为什么它会忘事。

约 4 分钟 · 1,991 字 · 12 个小节
06

工具与技能:Agent 的手和脑

认识工具、计划、子代理和 Skill 的分工。

约 4 分钟 · 2,157 字 · 13 个小节
07

模式与 Preset:同一个模型,不同工作方式

标准、创造、PTC、极简,什么时候用哪个。

约 4 分钟 · 2,238 字 · 13 个小节
08

插件、Bundle 与 Profile:给 DSH 装能力

Plugin、Bundle、Profile 三层,以及怎么安装。

约 5 分钟 · 2,568 字 · 13 个小节
09

创造模式:从使用者到扩展者

创造模式能做什么、安全边界,以及一个真实插件案例。

约 8 分钟 · 4,032 字 · 12 个小节
10

排错、安全与继续学习

常见错误、成本控制和安全清单。

约 3 分钟 · 1,718 字 · 9 个小节
附

附录

术语表、提示词模板和速查表。

约 3 分钟 · 1,487 字 · 6 个小节

认知篇

把真实项目里的取舍,整理成可以直接交给 Agent 执行的判断清单。

认知篇

从 CLI 到 DSH 插件:一套让 Agent 少走弯路的判断顺序

这不是 API 清单,而是一套在让 Agent 设计、实现、测试和发布插件时,减少返工和错误的判断顺序。

独立文章

三条阅读路线

日常使用 第 1–7 章:先把工作区、权限、上下文和工具用熟。
装插件/技能 第 1–8 章:理解 Plugin、Bundle、Profile 和 Preset。
做插件 第 1–9 章:进入创造模式,完成一次最小扩展。

关于这本书

这是一本非官方的 DSH 入门书,写给第一次让 Agent 读写文件、执行任务的人。它不追求讲完所有 API,而是先帮你建立正确的工作方式:小工作区、先只读、先计划、再验收。

基于 DeepSeek Harness Desktop 0.2.1-rc.2 · 正文 CC BY-NC-ND 4.0 · 代码 MIT
GitHub · GitHub Pages

↑