DeepSeek Harness · Version Lineage · 2026.06 — 2026.09 · 26 releases

把 Agent 的
每一层都做成插件
an agent harness where nothing is privileged

从内部 MVP 到开发者预览,dsh 用了 112 天。真正的加速发生在最后一个月: 26 个版本、148 条架构决策记录、16 480 次提交。 但这些数字不是重点——重点是它一次也没有给自己留下特权的内核: 模型适配器、工具、会话日志、连主循环本身,全部可替换、全部可回放。
26releases · 0.0.1 → 0.1.5
5公开版本族 · rc / alpha
148决策笔记 · 发布窗口内
16480提交 · 全部历史
112dMVP → 开发者预览
0.1.4被跳过的版本号

02 四条主线

版本号是四条互不相干的工作线共享的刻度

同一个 0.1.5-rc.2 里,同时装着发布管线的修补、模型目录的切换、会话格式的迁移和侧边栏的交互。 按「谁在动、动什么」重新归类,散乱的 26 个版本立刻显出秩序:四条线各自推进,只在版本号上打个照面。

Ⅰ · 发布基础设施

把 217 个 private: true 的清单、933 条手写 ^0.0.1 兄弟依赖,变成三条互不等待的独立发布序列。版本号第一次变得可以真实消费。

217 清单解私 rc.1 → 三流分离 rc.3 → 公开 scope rc.6 → dist-tag 映射 rc.8

Ⅱ · 产品功能

模型能做的动作。子代理、agent 团队、工作流、沙箱、后台作业、上传、日程——每一样都以插件形式进入,没有一样写死在核心里。

子代理 seam 0.1.0 → agent 团队 rc.8 → 工作区注册 0.1.2 → 文件预览 0.1.5

Ⅲ · 架构内核

决策笔记定义的事情。能力接缝、会话格式版本、跨进程写租约、嵌入式流记录器——层与层之间的契约,改一次就要写一条记录。

能力接缝 · 微内核事件 06月 → v3 信封 09-06 → 弃用同步读 09-09

Ⅳ · 客户端形态

人看到的界面。Web 端从能被跨域打到、能折叠提问卡,长到有右栏、有并排预览、有反馈对话框,最后装进一个 Electron 壳。

Web 层级 07月 → 桌面打包 08-25 → 右栏基座 09-04 → 侧边栏 09-08

03 版本账本

31 天,26 个版本,四条线各走各的

每一行是发布窗口里真实的一天;节点落在它实际发布的日期上——所以哪里挤成一团,哪里就真的挤成一团。 加粗的是改变了后续演进的节点,其余是版本序列的正常刻度。

Ⅰ 发布 ·repo

能不能发出去、发到哪儿、叫什么 tag

0.0.1-rc.1 · rc.2解私 217 个清单 · 修预发布版本
0.1.0-rc.6dsh 家族转为 public
0.0.1-rc.3 → 0.1.0-rc.6三流分离 · 补发 vendor 同族 · scope 转公开
0.1.0-rc.7 · rc.8修发布 bump 清单路径
0.1.1-rc.1文档站随 tag 发布
0.1.2-alpha.1alpha 序列起点
0.1.2-alpha.3投影 viewKey 变更令牌
0.1.2-alpha.4存储版本读兼容
0.1.2-alpha.5备份跳过抢救
0.1.2-rc.1alpha → rc 收口
0.1.5-alpha.1版本号跃迁(无 0.1.4)
0.1.5-rc.1 · rc.2同日收口 · feedback 回移

Ⅱ 功能 ·feat

模型能做的动作,全部以插件进入

0.0.1-rc.2提示词优化
0.1.0-rc.7可折叠提问卡 · pty beta
0.1.0-rc.8agent 团队 · 视觉目录 · 推理内容回传
agent 团队多 agent 编排进入核心功能面
0.1.1-rc.1延续清理 · 文档站 md 投影
0.1.3-alpha.1跨进程写租约 · 技能模糊排序
0.1.3-alpha.2模型切换公告 · 人机收件箱对齐
0.1.5-alpha.2侧栏图片预览(回滚 Mermaid 预览)
0.1.5-rc.1默认模型切至 V4.1 Flash · 保留 V4 目录

Ⅲ 内核 ·arch

层与层之间的契约,改一次记一条

发布前 · 06.11 → 07.19事件溯源会话 · 微内核事件 · 能力接缝 · 会话持久化 · GUI/RPC 层级
发布前 · 07.31 → 08.10目标自有事件 · profile 插件包 · 会话日志版本机制
08.22单一 dsh 启动器
08.30仅存 JSONL
09.05客户端资源模型 · 共享控制原语
09.06v3 会话信封(唯一格式版本号)
09.09弃用同步会话事件读

Ⅳ 客户端 ·client

人看到的界面,从网页长到桌面

发布前 · 07.19GUI 层级与 RPC 协议
0.1.0-rc.2UI 几何 · 侧栏动效 · 轨迹加载更多
0.1.0-rc.7可折叠提问卡 · Safari 文本域回流
08.25Electron 打包与更新 · 会话观察
Electron 桌面一个版本号钉住壳与 dsh 依赖
09.04右栏基座 · 可点链接样式
09.05客户端资源模型 · 侧栏文本预览与文件树
09.07响应式信息栏 · 模型切换公告
09.08侧栏默认页 · 文件图标 · 预览 · 反馈对话框
09.09桌面就地 profile · 侧栏与预览打磨

读法:行距即真实间隔——每一行对应 2026-08-11 起的真实一天,所以哪里挤成一团,哪里就真的挤成一团。 前两行留给发布前的里程碑(06—08 月),那时还没有版本号可挂。 加粗节点不是「最大的版本」,而是留下了后续所有版本都要遵守的约束。

Prologue · 2026.06.10 — 06.30

内核之夜。仓库以 README 与微内核架构文档开启;6 月 11 日一天落下五条最重要的决策——事件溯源会话、微内核事件分类、内容块词汇、能力接缝、质量门。到月底,持久化、Web 接缝、子代理接缝都已成型。

骨架 · 2026.07.01 — 07.31

决策最密的一个月。7 月 19 日单日 9 条:Web 客户端架构、插件命令注册、目标工具、zstd 会话日志。沙箱、审批、MCP、工作流、并行工具调用全部就位。

成形 · 2026.08.01 — 08.10

从内核转向产品。agent 团队、上下文表单词汇、web 日程、profile 插件包、Windows 沙箱。8 月 10 日 9 条:发布序列、npm 上线流程、会话日志版本机制——为公开做准备。

发布 · 2026.08.11 — 09.10

31 天,26 个版本。发布机制解私并转公开,随后功能、内核、客户端三线同时铺开。9 月 5—6 日两天 33 条决策,是全期最密的两天。

04 发布机制

版本号不是记号,是发布语义的载体

这 26 个版本之所以读得懂,是因为 dsh 把版本号背后的每一条规则都写成了决策记录: 哪些包一起动、tag 由谁创建、预发布落到哪个 dist-tag。

三条独立序列

dsh | vendor(9 个 Cordis 包,各自版本线)| native(musl 工具链,每架构一次构建)。互不等待:发 dsh 不重发框架,发框架不重发 native。

版本从本地落地

release:dsh 接受 major / minor / patch / 显式版本;一次写入发布族、全部私有包与工作区根(静态版本一致性门要求两者相等),然后 CI 只校验与上传,从不对仓库写入。

tag 是一本账

vendor 的每个包各持一个 tag,记录它上次发布自哪个提交;bump 读最新 tag、diff 目录决定是否发布——不引入任何状态文件。tag 是提交指针而非发布证明,故 bump 还要向 registry 查证版本是否真的存在。

dist-tag 映射

alpha → alpha · canary → canary · 其余预发布含 rc → next · 稳定版 → npm 默认的 latest。npm dist-tag 是可变别名,不参与版本优先级。

公开时间点

dsh 家族在 2026-08-13 转为 public(0.1.0-rc.6 那批),与 vendor / native 序列同时;没有任何发布路径传 --access,因为一个 flag 无法服务三个结论不同的序列。

桌面是唯一带回滚的更新

CLI 至今没有自升级。桌面走 electron-updater(autoDownload = false,由用户触发),并且一个桌面版本号同时钉住 Electron 产物与它的 dsh 依赖——更新 dsh 必须发一次 Electron 发布。

为什么是 0.1.5,不是 0.1.4

跳号是一个决定,
不是一个失误

0.1.3-alpha.2 之后直接进入 0.1.5-alpha.1;0.1.4 在整个仓库历史里从未存在过一次—— 无论是提交、清单还是 tag。同一段时期,私有的 desktop-host 也在自己的分叉线上按 0.1.5-* 推进。

这正好是这套「版本号即发布语义」的做法在起作用:当一次发布要同时覆盖两个分叉的产物时,较晚的那条线决定号码。 被跳过的号码没有被浪费,它只是没被用上。

0.0.1rc.1 → rc.5 同日发布 · 发布机制在试跑,不是产品在迭代
0.1.0rc.1 → rc.8 · 内核长齐:Web 客户端、agent 团队、发布通道、品牌指南
0.1.1rc.1 · 文档站随 tag 发布,唯一的 rc
0.1.2alpha.1 → alpha.5 → rc.1 · 跨度最长的一段,持久化格式收口
0.1.3alpha.1 → alpha.2 · 只发 alpha,是短命分叉线
0.1.4从未存在 · 被 0.1.5 分叉线吸收
0.1.5alpha.1 → alpha.2 → rc.1 → rc.2 · 48 小时走完 4 个版本

05 架构逻辑

「一切皆插件」不是口号,
是一张所有权表

dsh 的架构文档里有一张接缝表:每一行 = 一个服务、它的所有者、实现、消费者、伴随插件。 没有特权内核的实现方式,就是把「谁拥有什么」逐条写成可校验的事实。以下两条是其余一切的底座。

能力接缝

核心服务(ctx.sessions · ctx.tools · ctx.systemPrompt · ctx.storage · ctx.workspaceFiles …) 与接缝(ctx.llm · ctx.settings · ctx.credentials · ctx.sessionPersistence · ctx.subagentModelSelection …) 分列两侧;每个接缝都注册实现、声明消费者,共约四十行。

事件溯源会话

会话是追加式的事件流,一个事件词汇贯穿内核;持久化是它的一种投影(JSONL / sqlite), 客户端视图又是一种投影。因此「可回放」不是功能,是数据结构的直接推论。

可换的不止工具

llm-deepseek 与 llm-pi-ai 并列注册在同一个 ctx.llm 接缝下; session-title 有三个可换提供者;子代理后端可以是 Claude Code 或 Codex。 连主循环都作为插件运行。

客户端同源

Web、CLI、桌面共用同一套 RPC 与投影;桌面不另立一套,而是用 Electron 壳 + 打包的 Node.js 与 pnpm 启动一个私有的 desktop-host 子进程, 走 dsh-app:// 协议,不开监听端口。

convergence · 2026.09.10

省下来的抽象,
最后都花在了人身上

发布窗口内 148 条决策记录里,架构 27 条、功能 23 条、缺陷 21 条,其余是流程与测试。 到窗口末尾,真正的重量压在了客户端:9 月 5—6 日两天产出 33 条决策,是 112 天里最密的两天。

这不是「前端补作业」。前两个月把内核做成了可替换的接缝——所以界面最后可以做乘法:右栏、并排预览、文件树、反馈流, 每一样都作为独立插件挂上去,而不是切开内核塞进去。

内核事件溯源 · 能力接缝 · 所有权表 · 无特权插件
持久化JSONL 事件流 · zstd · v3 信封 · 跨进程写租约 · 备份跳过抢救
编排子代理平级 steer · agent 团队 · 工作流 · 目标 · 日程 · 后台作业唤醒
界面右栏基座 · 会话统计药丸 · 共享原型控件 · 侧边栏 · 反馈对话框

06 美术参考

这套界面没有设计师供图,
所以它把美学写成了规范

风格系统的决策记录开门第一句就是原因:「GUI 没有设计师供图;样式由 agent 写、agent 审。」 于是美术不靠审美直觉维持,而靠 token 表、编码规则表(12 项)与偏差记录表。 下列全部取自仓库中的 ui-theme 与 docs/web-styling.md 的真实取值。

Palette · 静态色阶

两层 token:static 持真实值,alias 持语义。特性组件只准消费 alias。

deepseek品牌蓝 · 450 / 500
neutral-bluish界面基底 · 冷灰
neutral纯灰 · 无蓝相
amber注意 / 待处理
red危险 / 失败
green成功 / 完成
blue信息 / 中性链接

Decisions · 七条不可协商

取自 design-platform.css 与样式系统决策记录。这些是结论,不是建议。

  • 01

    品牌主色不是蓝。--dsw-alias-brand-primary 在明暗两态都指向冷灰(bluish-50 / bluish-1000)。 品牌蓝 rgb(65,118,230) 只出现在按钮填充等少数位置——界面本身是无色的。

  • 02

    圆角是超椭圆,不是圆弧。全局 corner-shape: superellipse(1.5)——介于正圆 (1) 与 squircle (2) 之间。 正圆形状须显式写回 corner-shape: round,否则会被压变形。

  • 03

    发丝描边 0.5px。按钮、输入、卡片、分隔线一律半像素,Chromium 正好画成一个设备像素;更宽的中性实边会被规范拒绝。

  • 04

    悬浮面不用边框,用阴影。菜单/弹层/模态 border: 0,阴影的第一层就是那条发丝线; 阴影与 alias 边框同时出现会被校验挡下。

  • 05

    字号不进 token。尺寸写 px,但永远与行高配对(16/24 · 14/22 · 12/18);间距走 4 的倍数。 token 只覆盖颜色、圆角、动效、字体栈、阴影。

  • 06

    暗色模式只在 token 表里发生。属性选择器整表覆盖,body[data-ds-dark-theme]; 特性组件里零个主题选择器,动态值走 CSS 变量桥。

  • 07

    不引入组件库,不用 Tailwind。CSS Modules + clsx;跨特性的控件复用只能走共享原语,视觉差异落成那里的 prop。

Geometry · 几何与层级

同样的矩形:只改圆角规则。第三格是超椭圆被显式退回正圆的样子。

6—7px卡片 / 面板
超椭圆 1.5
10—12px容器 / 浮层
超椭圆 1.5
pill须退回 round
否则弧线走形
  • —

    阴影三级:elevation-panel · elevation-prominent · composer 专用的 elevation-soft(更大的模糊、更低的 alpha)。

  • —

    动效唯一写法:var(--dur*) var(--ease),且只过渡 opacity / transform / background-color / shadow。

  • —

    滚动条全局统一,组件内写 ::-webkit-scrollbar 属违规;源文本与 diff 行禁止折行以保列。

  • —

    点击链接:走 --dsw-alias-link + 字重 500,静止无下划线,悬停/聚焦给 3px 偏移的点线下划线。

Type & Origin · 字体与出处

字体栈是系统栈 + 中文回退,不引外部字体;代码字体刻意省略裸 monospace 尾项。

界面字体
-apple-system
BlinkMacSystemFont
'Segoe UI'
'PingFang SC'
'Hiragino Sans GB'
'Microsoft YaHei'
Helvetica Neue · Arial
代码字体
'SF Mono'
'JetBrains Mono'
'Fira Code' · Consolas
'Liberation Mono'
Menlo · Courier
'PingFang SC'
'Microsoft YaHei'
  • —

    为什么不写 monospace:Windows 上中文会回退到宋体,在等宽语境里格外刺眼——所以尾项被主动去掉。

  • —

    视觉基线 = Chat 前端。品牌蓝初值 #3964fe、灰阶、气泡与侧栏几何、阴影层级,都来自对 Chat 前端的调研。

  • —

    偏离必须记账。任何离开基线的取值,先在偏差表里留下一行(日期 / 项 / 原因),再落代码。审美分歧被转成了可追溯的事实。

  • —

    重量 510 的坑:Figma 的 510(SF Pro 可变字重)在本 UI 里一律渲染为 500——非可变 webfont 会不可预测地取整。

07 判读

哪些是节点,
哪些只是刻度

26 个版本不必等重。按「是否改变了后续所有版本都要遵守的东西」分级,真正的节点不到十个; 而其中最重要的几条,恰恰是不写在版本号里的那些。

六个节点

  • 0.0.1-rc.1 · 解私
    217 个清单解私、933 条兄弟依赖改写——版本号第一次可以真实消费。
  • 0.1.0-rc.6 · 转公开
    scope 变 public,与 vendor / native 序列同步。产品从这一刻起有外部用户。
  • 0.1.0-rc.8 · agent 团队
    多 agent 编排进入核心功能面,视觉模型目录同批到位。
  • 08-25 · Electron 桌面
    一个版本号钉住壳与 dsh 依赖;不开端口、用私有协议,也是唯一带回滚的更新路径。
  • 09-04 → 09-08 · 右栏与侧边栏
    客户端从「一个对话页」变成「一个工作台」;两天 33 条决策。
  • 09-06 · v3 会话信封
    格式版本机制落地,读兼容与备份跳过抢救同日确立——持久化从此可迁徙。

三条被低估的线

  • 发布序列
    它没有用户可见功能,却决定了之后每个版本能不能被安装。26 个版本里最底层的一个。
  • 决策笔记本身
    148 条记录构成一套工程制度,而非文档。它把「为什么」变成了可检索、可校验、可冻结的资产。
  • 样式即规范
    无设计师供图的前提下,把审美判断转成 token、规则表和偏差账——这是美术被工程化的一次实例。

不必高估的

  • 0.0.1-rc.2 / rc.4 / rc.5
    发布机制试跑。同日多版本不表示功能跃迁,只表示流水线在修。
  • 0.1.1-rc.1
    唯一的单 rc 版本;文档站随 tag 发布是工程改进,不是能力变化。
  • 0.1.3-alpha.1 / alpha.2
    只发 alpha 的短命分叉线,随后被 0.1.5 吸收——包括那个被跳过的号码。

该承认的风险

  • 「开发者预览,不要依赖」
    README 自陈会有破坏性变更。26 个版本里 1795 次修复提交,正是这个状态的代价。
  • CLI 无自升级
    桌面有,命令行没有。装机用户的升级路径仍是手工的。
  • 品牌与生态边界
    官方明确:衍生项目不得在名称中使用全称,推荐缩写 DSH——生态刚起步,授权边界已先划好。

conclusion

真正的交付物
不是那 26 个版本

112 天里,dsh 把「几乎没有东西是特殊的」做成了可校验的事实:工具可换、模型适配器可换、会话日志可投影、主循环本身也是插件, 每一处替换都对应接缝表里的一行、决策笔记里的一条。

版本号只是这件事的副产品。所以 0.1.4 的存在与否无关紧要—— 当「什么可以变」已经被逐条写清楚时,号码只是一个刻度,不是一种承诺。

DeepSeek Harness · Version Lineage · 26 releases / 148 agent notes / 16480 commits · 2026.06 — 2026.09

数据源 ~/project/dsh-official · 快照 a305303422(2026-09-10)· 版本号取自 release 提交 · 日期为提交日期

逾期说明 快照之后 0.1.5 正式版与后续版本的发布未收录 · 需要更新时重跑本次抽取流程即可

接缝与样式取值取自仓库当前源码 · 非官方文档,分析判断部分为独立结论

← 返回单页集 · 姊妹篇 DeepSeek 研究谱系 2023—2026