跳到正文
DSH 积木书

DeepSeek Harness · 源码图解

一切都是积木。

这是一本给五岁小孩也能翻懂的架构图画书。机器人会想、会写日记、会动手；每一块本事都是可以拔掉再换上的插件。

先听故事看整座积木城看一轮对话

积木城剖面

窗户

client ui-*

信箱

webserver

接待

apiproxy

技能

skill

计划

plan

帮手

subagent

待办

todo

纸笔

fs

跑腿

spawn

围栏

box

嘴巴

shell

眼镜

code map

日记

session

心跳

loop

工具柜

tools

脑子

llm

Cordis 底板 · Context · Fiber · 可逆副作用

当前源码快照

DeepSeek Harness 0.1.1-rc.2

基于官方 2026-08-21 发布的 227 个包清单，源码提交 b150a55。

官方发布

  • 图片成为原生输入：DeepSeek 适配器会经 Files API 上传、复用并自动预处理图片。

  • 子 Agent 能直接接入 Claude Code、Codex 与 ACP，并通过控制、报告和任务面板协作。

  • 执行链更稳：修复 Bubblewrap 逃逸路径，并补齐持久 PowerShell、超时与文件观察策略。

  • 工具与界面继续积木化：多行提问、插件清单、图片附件、网页搜索和压缩都有独立包。

十层积木城

打开总图

  1. 01

    底板 · Cordis

    像乐高底板。没有它，积木会散架。

  2. 02

    拼法 · Profile / Bundle

    先选玩具盒，再按说明书一层一层叠。

  3. 03

    主干 · Agent Loop

    机器人的心跳：听一句话、想一步、动手、再想。

  4. 04

    脑子 · LLM

    真正会说话的那块积木，可以换成别的牌子。

  5. 05

    手脚 · 执行世界

    手、脚和围栏必须待在同一个房间里。

  6. 06

    日记 · Session

    发生过的事都写在本子上，合上再打开还能接着看。

  7. 07

    本领 · 能力插件

    教机器人新本事：查网页、请帮手、写待办。

  8. 08

    窗户 · Host + Client

    屋子里有一扇窗，你从窗外看机器人工作。

  9. 09

    规矩 · 人机协作

    大人决定哪些积木能碰，哪些要先举手。

  10. 10

    其它 · 配套

    胶水、尺子、测试积木，让整座城不晃。

铁律

插件可换，日记不撒谎

Everything is a plugin. Every run is traceable.

打开

底板

五块积木卡住世界

插件、上下文、inject、事件、可逆副作用。

打开

接头

换一只手，整座城搬家

定义、提供方、消费方。fs 和 subprocess 必须成对走。

打开

阅读顺序

  1. 01积木故事五岁也能听懂
  2. 02两条铁律插件与日记
  3. 03总图整座积木城
  4. 04Cordis 底板积木怎么卡住
  5. 05怎么启动先铺哪一层
  6. 06一轮对话机器人怎么想
  7. 07可换接头换一块手
  8. 08事件总线谁在喊谁
  9. 09模块目录每一块积木
  10. 10词汇表名字对照

常见问题

全部问答

这本积木书对应哪个 DeepSeek Harness 版本？

当前内容已对齐官方 dsh-v0.1.1-rc.2（提交 b150a55，发布于 2026-08-21）。该源码快照包含 227 个 packages/*/package.json；目录页精编主干与代表性插件，而不是把 227 个包逐一平铺。

DeepSeek Harness 是什么？

DeepSeek Harness（dsh）是开源 agent 运行时。它不把模型写死在内核里：模型适配器、工具、会话、沙箱、循环和 UI 全部是插件。核心口号是 Everything is a plugin，以及 Every run is traceable。

Cordis 在 dsh 里做什么？

Cordis 是底板。插件向共享 Context 贡献 Service、类型化事件和可逆副作用。卸载 fiber 时登记自动撤销。没有需要打补丁的特权内核；扩展方式是把插件挂到旁边。

Everything is a plugin 是什么意思？

每一块能力都是可替换积木。换 LLM 适配器不必改循环；换文件系统提供方，Bash、PTY、LSP 可以跟着走。配置里选择、替换、扩展，不必改 dsh 源码。