跳到正文

DeepSeek Harness · 源码图解

一切都是积木。

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

积木城剖面

窗户

client ui-*

信箱

webserver

接待

apiproxy

技能

skill

计划

plan

帮手

subagent

待办

todo

纸笔

fs

跑腿

spawn

围栏

box

嘴巴

shell

眼镜

lsp

日记

session

心跳

loop

工具柜

tools

脑子

llm

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

十层积木城

打开总图
  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 是什么?
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 源码。
模型可见即已记录是什么意思?
抵达模型请求的一切必须能从仅追加的 Session 日志重建。deriveMessages() 只投影 surface 事件,不是另存一份聊天数组。这是运行时不变量,也是 Every run is traceable 的来源。