Ⅰ · 发布基础设施
把 217 个 private: true 的清单、933 条手写 ^0.0.1 兄弟依赖,变成三条互不等待的独立发布序列。版本号第一次变得可以真实消费。
217 清单解私 rc.1 → 三流分离 rc.3 → 公开 scope rc.6 → dist-tag 映射 rc.8
DeepSeek Harness · Version Lineage · 2026.06 — 2026.09 · 26 releases
从内部 MVP 到开发者预览,dsh 用了 112 天。真正的加速发生在最后一个月: 26 个版本、148 条架构决策记录、16 480 次提交。 但这些数字不是重点——重点是它一次也没有给自己留下特权的内核: 模型适配器、工具、会话日志、连主循环本身,全部可替换、全部可回放。
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 版本账本
每一行是发布窗口里真实的一天;节点落在它实际发布的日期上——所以哪里挤成一团,哪里就真的挤成一团。 加粗的是改变了后续演进的节点,其余是版本序列的正常刻度。
能不能发出去、发到哪儿、叫什么 tag
模型能做的动作,全部以插件进入
层与层之间的契约,改一次记一条
人看到的界面,从网页长到桌面
读法:行距即真实间隔——每一行对应 2026-08-11 起的真实一天,所以哪里挤成一团,哪里就真的挤成一团。 前两行留给发布前的里程碑(06—08 月),那时还没有版本号可挂。 加粗节点不是「最大的版本」,而是留下了后续所有版本都要遵守的约束。
内核之夜。仓库以 README 与微内核架构文档开启;6 月 11 日一天落下五条最重要的决策——事件溯源会话、微内核事件分类、内容块词汇、能力接缝、质量门。到月底,持久化、Web 接缝、子代理接缝都已成型。
决策最密的一个月。7 月 19 日单日 9 条:Web 客户端架构、插件命令注册、目标工具、zstd 会话日志。沙箱、审批、MCP、工作流、并行工具调用全部就位。
从内核转向产品。agent 团队、上下文表单词汇、web 日程、profile 插件包、Windows 沙箱。8 月 10 日 9 条:发布序列、npm 上线流程、会话日志版本机制——为公开做准备。
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 只校验与上传,从不对仓库写入。
vendor 的每个包各持一个 tag,记录它上次发布自哪个提交;bump 读最新 tag、diff 目录决定是否发布——不引入任何状态文件。tag 是提交指针而非发布证明,故 bump 还要向 registry 查证版本是否真的存在。
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-* 推进。
这正好是这套「版本号即发布语义」的做法在起作用:当一次发布要同时覆盖两个分叉的产物时,较晚的那条线决定号码。 被跳过的号码没有被浪费,它只是没被用上。
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 天里最密的两天。
这不是「前端补作业」。前两个月把内核做成了可替换的接缝——所以界面最后可以做乘法:右栏、并排预览、文件树、反馈流, 每一样都作为独立插件挂上去,而不是切开内核塞进去。
06 美术参考
风格系统的决策记录开门第一句就是原因:「GUI 没有设计师供图;样式由 agent 写、agent 审。」
于是美术不靠审美直觉维持,而靠 token 表、编码规则表(12 项)与偏差记录表。
下列全部取自仓库中的 ui-theme 与 docs/web-styling.md 的真实取值。
两层 token:static 持真实值,alias 持语义。特性组件只准消费 alias。
取自 design-platform.css 与样式系统决策记录。这些是结论,不是建议。
品牌主色不是蓝。--dsw-alias-brand-primary 在明暗两态都指向冷灰(bluish-50 / bluish-1000)。
品牌蓝 rgb(65,118,230) 只出现在按钮填充等少数位置——界面本身是无色的。
圆角是超椭圆,不是圆弧。全局 corner-shape: superellipse(1.5)——介于正圆 (1) 与 squircle (2) 之间。
正圆形状须显式写回 corner-shape: round,否则会被压变形。
发丝描边 0.5px。按钮、输入、卡片、分隔线一律半像素,Chromium 正好画成一个设备像素;更宽的中性实边会被规范拒绝。
悬浮面不用边框,用阴影。菜单/弹层/模态 border: 0,阴影的第一层就是那条发丝线;
阴影与 alias 边框同时出现会被校验挡下。
字号不进 token。尺寸写 px,但永远与行高配对(16/24 · 14/22 · 12/18);间距走 4 的倍数。 token 只覆盖颜色、圆角、动效、字体栈、阴影。
暗色模式只在 token 表里发生。属性选择器整表覆盖,body[data-ds-dark-theme];
特性组件里零个主题选择器,动态值走 CSS 变量桥。
不引入组件库,不用 Tailwind。CSS Modules + clsx;跨特性的控件复用只能走共享原语,视觉差异落成那里的 prop。
同样的矩形:只改圆角规则。第三格是超椭圆被显式退回正圆的样子。
阴影三级: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 偏移的点线下划线。
字体栈是系统栈 + 中文回退,不引外部字体;代码字体刻意省略裸 monospace 尾项。
为什么不写 monospace:Windows 上中文会回退到宋体,在等宽语境里格外刺眼——所以尾项被主动去掉。
视觉基线 = Chat 前端。品牌蓝初值 #3964fe、灰阶、气泡与侧栏几何、阴影层级,都来自对 Chat 前端的调研。
偏离必须记账。任何离开基线的取值,先在偏差表里留下一行(日期 / 项 / 原因),再落代码。审美分歧被转成了可追溯的事实。
重量 510 的坑:Figma 的 510(SF Pro 可变字重)在本 UI 里一律渲染为 500——非可变 webfont 会不可预测地取整。
07 判读
26 个版本不必等重。按「是否改变了后续所有版本都要遵守的东西」分级,真正的节点不到十个; 而其中最重要的几条,恰恰是不写在版本号里的那些。
conclusion
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 正式版与后续版本的发布未收录 · 需要更新时重跑本次抽取流程即可
接缝与样式取值取自仓库当前源码 · 非官方文档,分析判断部分为独立结论