20 课入门 dsh guobinmengxiang-rgb/dsh-getting-started

English homepage is README.md.

Learn DeepSeek Harness

从 0 把官方 dsh 跑起来，每次只加一层。

s01 → s02 → s03 → s04 → s05 → s06 → s07 → s08 → s09 → s10

s11 → s12 → s13 → s14 → s15 → s16 → s17 → s18 → s19 → s20

[!CAUTION]
别 pip 装错那个也叫 dsh 的包。
PyPI 包名 deepseek-harness-cli（Henry Zhang），子命令 dsh doctor / dsh chat，会抢走 dsh。
官方 CLI：@deepseek-ai/dsh。官方 Python SDK：deepseek-harness-sdk（也不是 pip install deepseek-harness）。
自检：which -a dsh。

哲学

Agent = Model + Harness。模型是灵魂、是驾驶者；Harness 给它一双手。

你不是在写智能，你是在给智能一双能干活的手。

s01 那 30 行 while True 就是这双手的最小形态：模型举手要 bash → 你跑 → 结果喂回去 → 直到它说做完了。官方 dsh 的 ctx.agentLoop 是同一个循环的生产版。

别 fork packages/ 去改循环。循环本身也是插件。Cordis 里，模型适配器、工具注册表、会话日志、以及 agent loop 本身，全部挂在共享 ctx 上：卸载时注册自动收回。没有特权核心可补丁。

Model-visible means logged. 模型看见的每一条，都必须能从 session log 重建。deriveMessages() 从日志投影历史，不是另存一份。

教学 30 行证明循环；官方 dsh 把循环、工具、会话、UI 全部插件化。web / headless 只是两套模板；dsh-base 是每一套的第一层。

快速开始

先看循环（教学内核，不需要 Node）
pip install -r requirements.txt
cp .env.example .env # 填 DEEPSEEK_API_KEY
python s01_run_dsh/code.py

再跑官方产品
npx @deepseek-ai/dsh web

教学循环证明 harness 是什么；npx 才是 DeepSeek 官方产品。

浏览器打开 http://127.0.0.1:3080。这是官方 README 的第一条路径。

包：@deepseek-ai/dsh@0.1.0-rc.6（MIT）。更短的一页命令：QUICKSTART.md

课程

| | 课 | 一句话 |
| s01 | 一个循环 + bash | python s01_run_dsh/code.py；产品入口仍是 npx @deepseek-ai/dsh web |
| s02 | Settings → 模型 + Key | 官方截图；Key 只写，落盘 $DSH_HOME/.credentials.yaml |
| s03 | 选择工作区 + 权限批准 | Composer 没选工作区之前是灰的 |
| s04 | 第一句真实任务 | Summarize this repository and identify its main packages. |
| s05 | 四种模式总表 | standard / PTC / minimal / cordis |
| s06 | 同一句任务，极简 vs PTC | 双工具基准 vs Code Mode 拼工具 |
| s07 | 无头一锤子 | dsh --profile headless "job" |
| s08 | 插件点到为止 | dsh plugin + topic dsh-plugin，装一个都不要强迫 |
| s09 | 官方 Python SDK | pip install deepseek-harness-sdk（非 Windows） |
| s10 | 读文档加能力 | 官方 docs/user/develop/basic；不改源码、不贴假插件 |
| s11 | Everything is a plugin | ctx.sessions / systemPrompt / tools / agents / agentLoop / llm |
| s12 | profile 分层 | dsh-base 第一层；后一层整行替换 |
| s13 | turn / step | 官方周转；pre-step；turn-stopping |
| s14 | session log | Model-visible means logged；deriveMessages |
| s15 | 事件闸 | waterfall 必须 next()；turn-stopping 是 serial |
| s16 | 小红书格式化插件 | format.mjs + defineTool；源码 overlay |
| s17 | 插件配置 | Schemastery Config，不是普通对象 |
| s18 | 打包安装 | dsh.bundle 对 dsh.profile；prepare 与 allowBuilds |
| s19 | 三篇小红书 | 标题不超过二十；课程仓库链接 |
| s20 | 预览边界 | 会破兼容；不要改 packages |

这是开发者预览。官方原话：THERE WILL BE COMPATIBILITY-BREAKING CHANGES。

材料截至 2026-08-16。Node 实测 20.19.2。不要 clone 官方仓库来上课跑 Web UI——npx 就够。s09 示例按官方 SDK 文档需要仓库里的 examples/。写插件（s16）才走官方从源码运行加 overlay。

官方

- Web UI 指南
- 架构
- Python SDK
- 开发插件

Copyright (c) 2026 国彬 张 / 老张教你用AI · MIT