Electricitysheep/dsh-handbook

# DeepSeek Harness 白皮书 · dsh-handbook

DeepSeek Harness 中文手册 × 生态观察中心——从 0 到 1 玩转 dsh，跟着 780 帖讨论区看懂生态 · 中文 · [English](./README.en.md)

📖 [在线阅读](https://electricitysheep.github.io/dsh-handbook/) · 📄 [下载 PDF](https://github.com/Electricitysheep/dsh-handbook/releases) · ⭐ [点 Star 支持](https://github.com/Electricitysheep/dsh-handbook/stargazers)

· 15 章手册 · 195 帖社区响应 · 280+ Stars

[!WARNING]

dsh 当前 GitHub 版本为 v0.1.3-alpha.1（预发布 tag；npm 已发布线 0.1.2-rc.1），生产环境请谨慎评估，详见 [ℹ️ 版本说明](#ℹ️-版本说明)。

## 🚀 快速体验（30 秒）

# 1. 安装（需要 Node.js ≥ 22）
npx -y @deepseek-ai/dsh web

# 2. 浏览器打开 http://127.0.0.1:3080，开始对话
# 3. 或跑一次性任务（适合脚本/CI）
dsh --profile headless "你好，请用一句话介绍自己"

想系统学？看 [🗺 学习路径（3 天计划）](./docs/roadmap.md)；想先跑？[第 2 章：五分钟快速上手](./docs/02-quickstart.md)；想速查？[📇 一页速查卡](./docs/cheatsheet.md)

30 秒看懂 dsh Web UI：新建会话 → 输入任务 → 模型选择 → 发送 → AI 回复

## 🎯 这是什么

DeepSeek Harness（`dsh`）是 DeepSeek 官方 2026-08-13 开源的 Agent 运行时——一个"一切皆插件"（everything is a plugin）的框架。

但官方文档以架构说明为主，缺少一条从零上手的路径。

这本白皮书补上这条路：从"什么是 Agent 运行时"讲起，到安装、使用、开发插件、性能调优——每一章都有可复制、可运行的命令，全部在本机实测验证。目标是：任何一个开发者，跟着这本书都能从 0 到 1 用起来、写起来。

### 为什么值得读（而不是只看官方文档）

## 🎁 这本能给你什么

## 🌟 感谢与社区

首先要感谢每一位 Star、回复和投稿——这本手册不是一个人的作品，是 dsh 社区一起"长"出来的。

发布两天，很幸运得到了这些反馈：

内容随讨论区持续更新（[沉淀流水线](./docs/research/feedback-pipeline.md)，19 项可追踪）。如果你觉得有用，Star 是对我们最大的支持。

## 🔭 生态观察（第 15 章·全景报告）

把 1804 个插件仓库的数据盘点 × 780 帖讨论区定性观察交叉验证，5 个关键结论：

6 个能力缝（官方可优先建）：视觉通道 · 记忆 seam · 桌面 TUI 协议 · 评测闭环 · Windows 一等支持 · 插件 registry

完整报告（含对开发者/选型者/观望者的建议）：[第 15 章](./docs/15-ecosystem-report.md)

## 📚 目录（从 0 到 1）

### 🟢 阶段 1 · 入门：认知与上手

### 🔵 阶段 2 · 开发：骨架与插件

### 🟠 阶段 3 · 实战：场景与调优

### 🟣 阶段 4 · 生态：能力与编排

### 🔴 阶段 5 · 进阶：复杂案例与展望

### 📎 附录

## 💎 内容精华速览（点开即看，不止链接）

📖 第 1 章：认识 DeepSeek Harness —— 三个直觉 + 能力矩阵