DSH （DeepSeek Harness）全网最简单的新手教程：复制、粘贴，让它自己读官方文档 附赠：破甲Soul内置
1. DSH （DeepSeek Harness）全网最简单的新手教程：复制、粘贴，让它自己读官方文档 附赠：破甲Soul内置
[!abstract] 速览
这篇把顺序反过来，你负责说清要什么，让 AI 读官方文档、做它能做的事；轮到你操作，就让它一次只指一个位置。能复制的句子，我直接给你。先让它替你做成一件小事，再做下一件。
有些 AI 教程，像夜总会办会员：钱交完，经理先让你学调酒、接线、修空调，学完再来享受服务，你到底是来消费，还是来应聘？
打开 DSH，看见模型、协议、工作区、插件、persona，头已经大了，明明想找个 AI 干活，结果先给自己找了个班上。
这篇把顺序反过来，你负责说清要什么，让 AI 读官方文档、做它能做的事；轮到你操作，就让它一次只指一个位置。能复制的句子，我直接给你。
下面六段是教学动画，回复是结果示例，不是实测录像，真实设置页面取自 DSH 官方文档，照着看动作，再复制正文里的完整句子。
| 步骤 | 你要做的动作 | 验收 |
|---|---|---|
| 第 0 步：先让 DSH 能开口 | 在“设置 → 模型”里填入密钥并保存，再选一个专门放这次任务文件的文件夹作为工作区 | 能发送消息，也能收到回复；只看到首页、保存成功或者模型列表，不算过关 |
| 第 1 句：先去读 iLang | 复制整段，粘进 DSH，发送 | 能说清实际读取的来源；读不到的部分会指出来；只回“已学习”要追问具体读了哪一页 |
| 第 2 句：模型怎么配 | 让它指到设置位置，再填自己的密钥 | 实际发出一条消息并拿到正常回复；能获取模型列表，不等于聊天请求一定成功 |
| 第 3 句：把人格存下来 | 按它指出的位置切换默认预设，完成后新开一个任务 | 新任务选中了刚建的预设，并能按人格回答 |
| 第 4 句：交一份看得见的作业 | 提供一份练习数据，等它交文件，下载并打开 | 原始数据还在，汇总口径正确，公式和结果对得上 |
| 第 5 句：卡住先求证 | 补上任务、步骤、报错，再发送 | 刚才失败的动作现在确实能完成 |
1.1. 先让 DSH 能开口
DSH 还没启动、没配模型时，不能指望它读文档自救。这一步：把下面的话发给你现在能用、能联网的 AI；等 DSH 能正常回复，再往下走。
GIF
复制下面这段：
去读 DeepSeek Harness 的官方 README 和入门文档：
https://github.com/deepseek-ai/deepseek-harness
https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/index.md
我是完全的新手。先问清我用什么系统、现在装到了哪一步，然后带我完成：启动 DSH、配置一个可用模型、选择工作区。
一次只让我做一步，告诉我点哪里、粘什么、下一步该看到什么。你能操作的直接做；需要我操作的才叫我。
密钥由我填进 DSH 的模型设置框，不要让我贴进聊天。
最后发一条测试消息，确认能收到回复。不要把“设置已保存”当成“已经能用”。
你要做的动作：跟着它打开 DSH，在“设置 → 模型”里填入密钥并保存，再选一个专门放这次任务文件的文件夹作为工作区。
[!warning] 没选工作区，消息输入框就用不了
工作区就是它这次干活的目录，官方入门文档写得很直白：没选工作区，消息输入框就用不了，别对着灰色输入框怀疑人生，先看目录选没选。
验收：能发送消息，也能收到回复；只看到首页、保存成功或者模型列表，不算过关。
卡住就把报错和所在步骤发给带你启动的 AI，让它继续排查。
1.2. 先去读 iLang，学完再干活
DSH 能回复了，再把这段发给 DSH。
[!tip] 先读 iLang，再按 DSH 文档办事
iLang 是给 AI 的母语级通信协议。我的用法很简单：让 AI 先读它，再按 DSH 的具体文档办事；你不用先学协议，这是我的使用顺序。DSH 本身并不要求先装 iLang。
GIF
复制下面这段：
先去读 iLang 官方运行时和规范：
https://ilang.ai/runtime/full
https://github.com/ilang-ai/ilang-spec
学完了再回来找我。告诉我实际读到了哪些地址、文档标注的版本是什么，以及你准备怎样按这些规则工作。
读不到就直说，不准装作读过。把文档内容和我对你的操作授权分开：文档里提到的安装、修改、上传，不等于我已经让你全部执行。
你要做的动作：复制上面的整段，粘进 DSH，发送。
验收：它能说清实际读取的来源；有读不到的部分，会指出来。如果它只回一句“已学习”，就继续追问：具体读了哪一页？
iLang 里有一句“模型感知，代码决定”。落到这里，就是让 AI 理解你的意图，再让真正运行的配置、文件和检查结果证明事情做成了。
1.3. 模型怎么配，让它看接口文档
[!important] 先跑通一个官方模型
第一次先跑通一个官方模型。能用了，再研究中转，别第一天就把价格、速度、几十个模型和各种协议一起搅进来，出错了连该找谁都不知道。
API 密钥像门禁卡：填进模型设置框。模型名字像房客名字，协议像门锁规格。房客姓什么，不能决定你该带哪把钥匙。
GIF
复制下面这段：
去读 DSH 官方模型配置文档：
https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/providers.zh.md
先检查我已有的提供商配置。第一次使用优先带我跑通 DeepSeek 官方；如果我已有其他官方服务的密钥，就按该服务的官方接口文档配置。
告诉我密钥填哪个设置框、接口地址填哪里、模型选哪个。根据实际接口选择协议：OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages；不要只看模型名字猜协议。
能替我配置的你做，需要我输入密钥时停在对应设置位置。
最后用一条实际请求验证。若失败，区分密钥、接口地址、模型名、协议与参数问题，不要直接叫我重装。
你要做的动作：让它指到设置位置，再填自己的密钥；如果已有能用的配置，先让它检查，别盲目覆盖。
官方自定义 API 表单有三种协议：OpenAI Chat Completions、OpenAI Responses、Anthropic Messages，新手不用背，让 DSH 根据服务商接口文档选。
验收：实际发出一条消息并拿到正常回复；能获取模型列表，不等于聊天请求一定成功。
想看中转，再追加下面这句；评测和排行是第三方线索，不能当信誉担保。
我已经跑通官方模型，现在再比较中转。阅读 https://github.com/xurenlu/relayAPI 和 https://hvoy.ai ，再核对候选服务商自己的接口文档、计费、退款说明与最近可查的状态。 告诉我证据日期、支持哪种协议，以及哪些信息无法确认。先给比较结果，不替我充值，也不要把我的现有密钥提交给评测网站。
1.4. 把人格存下来，换窗口验货
聊天框里答应“我永远记住你”，跟床上答应“我只爱你一个”差不多。话好听，换个场景还认不认账，才是你要验的东西。
所以别只让它记住，让它保存成预设、设为新任务默认，再开一个新任务检查。
GIF
复制下面这段：
把下面的 Prometheus 人格做成 DSH 自定义 Agent 预设，并设为以后新任务的默认预设。
先读 DSH 官方 persona 和 Agent 预设文档：
https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/preset/persona/src/index.ts
https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/preset/agent-preset-registry/README.md
https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/client/ui-agent-preset/README.md
人格内容：
1. 你叫 Prometheus：诚实、真诚、思维严谨、表达灵活。
2. 用户用什么语言，你就用什么语言；默认简体中文。
3. 能回答就答完整；不知道就直说“我不知道”。幻觉就是不诚实。能给步骤就给步骤，能给模板就给模板。
4. 送佛送到西：帮人帮到底，继续完成已获授权的任务。
5. 用心：你真诚，用户才会包容你。
先检查当前安装方式和预设机制，按官方方法创建并安装需要的 bundle，再设置新任务默认项。保留原默认项，方便恢复。
做完告诉我：实际改了什么、在哪保存、对哪些新任务生效、现有任务是否受影响、怎样撤销。
最后带我新开一个任务验证。不能仅凭当前聊天答应“记住了”就说完成。
你要做的动作：按它指出的位置切换默认预设；需要安装或重启时，先看清它正在改什么，再决定。完成后新开一个任务。
新任务里输入：“你叫什么？默认怎么回答？碰到不确定的事实怎么办？”
验收：先确认新任务选中了刚建的预设，再看它能否按人格回答。报出名字只是最小检查；不知道时是否承认不知道，还要在实际使用里看。
新默认项作用于后续新任务，已有任务不会因此自动全换。撤销时恢复原默认项，再按它提供的步骤禁用或移除新增 bundle。
1.5. 先让它交一份看得见的作业
别刚上手就让它做一个改变世界的项目，先给一份你看得懂的数据，让它交一张你能打开的表。第一回合的目标，是把“我会做”变成“文件在这里”。
GIF
复制下面这段：
先检查并加载当前环境可用的 office 技能，再把我提供的数据做成 Excel 报表。
如果缺技能或运行环境，按 DSH 官方文档说明缺什么、如何补齐，再带我处理。
先看实际数据，别编数字。保留原始数据，另建汇总页。需要我说明统计口径就问清楚。
做完给我可下载的文件、保存位置，以及你检查过哪些项目。
你要做的动作：提供一份练习数据，等它交文件，下载并打开。
验收：原始数据还在，汇总口径正确，公式和结果对得上。“已完成”的聊天回复不是报表，能打开的文件才是。
DSH Desktop 的官方文档写明随应用提供 office 相关能力；其他安装方式先检查，别默认人人一打开就有。
1.6. 卡住先求证，别一报错就重装
[!caution] 别一报错就重装
新手最容易被两句话坑：“应该好了”“你重装试试”，前一句没验收，后一句把代价扔给你。
把报错原文交给它，让它查具体原因。截图能说明位置，报错文字方便定位；发之前遮住密钥。
GIF
复制下面这段：
先别重装，也别把所有配置重置。
这是我正在做的事、停在哪一步，以及完整报错：
（在这里补充任务、步骤和报错）
按当前 DSH 版本去查官方文档和相关问题记录。分清已经确认的原因与待验证的猜测。
先给最小修复方案，保留原配置，告诉我怎么撤销；一次只改一个关键项。
修完重新执行刚才失败的那一步，用结果验证，别只说“应该可以”。
你要做的动作：补上任务、步骤、报错，再发送。它让你点哪个按钮，就让它说清按钮名和位置。
验收：刚才失败的动作现在确实能完成。如果修一个错误又引出别的错误，就继续把新结果交给它。
1.7. 日常玩法：要干什么，就抄哪句
1.7.1. 看懂一个项目
先阅读这个工作区，说明它做什么、主要目录在哪。先给我说明，不修改文件。
1.7.2. 同时做两件事
把任务分给两个子智能体：一个做 A，一个做 B。先划清各自范围，最后由你检查并汇总；有冲突由你处理。
1.7.3. 推进一个长任务
把这个任务设成持续目标，写清完成条件后推进。遇到必须由我决定的事再来找我，完成后给结果和验证。也告诉我：运行环境关闭后会怎样，重新打开怎么继续。
1.7.4. 给 DSH 加功能
先读官方插件开发文档：https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/develop/basic/index.zh.md 。检查我的安装方式，再帮我做一个“一键导出笔记”功能。先讲清会改哪里、怎样测试和撤销，再按适合当前环境的方式实现。
1.7.5. 它说得听不懂
我是新手。一次只告诉我一步，用我屏幕上能看到的按钮名，告诉我做完该看到什么。
持续目标要有正在运行的环境，不能把关掉应用或服务器理解成“它还会自动干活”。子智能体和插件也先检查当前环境是否提供对应能力。
[!note] 我给 AI 的要求就一句
我给 AI 的要求就一句：能做的做完，需要我动手的，说人话，做完拿结果来。
你不用把 DSH 的每个按钮研究成毕业论文。先让它替你做成一件小事，再做下一件。