内核与应用分开更新
外壳和 DSH 内核各自版本化,每个已安装的内核版本落在
<userData>/runtime/<version> 独立目录,切换或回滚都不用重装应用。
- 安装是原子的:先装到
<version>.installing,成功后才改名就位 - 激活版本文件不完整时按固定版本重装,不查 registry,修复不卡网络
- registry 查询有 8 秒超时
- 内置基线内核,首次启动可以离线完成
KOKONA HARNESS · DESKTOP SHELL FOR DSH
一个 DeepSeek Harness(dsh)桌面外壳。
Electron + 网页渲染的内核,补上现有那些半成品桌面端缺的两件事。
外壳和 DSH 内核各自版本化。每个已安装的内核版本放在独立目录,切换或回滚都不用重装应用;内置基线内核让首次启动可以离线完成。
无边框窗口,没有那条白色的系统标题栏。窗口控制按钮和应用自己的侧栏品牌处在同一条 48px 线上,拖拽区域只占用真正空白的像素 —— 所以应用的控件和 dsh-better-sidebar 都照常工作。
NEVER PATCHES THE KERNEL
外壳和 DSH 内核各自版本化,每个已安装的内核版本落在
<userData>/runtime/<version> 独立目录,切换或回滚都不用重装应用。
<version>.installing,成功后才改名就位
Windows / Linux 无边框;macOS 用 titleBarStyle: 'hidden' 保留红绿灯。
注入的浮层读取 DSH 自己的 --dsh-frame-top-clearance(48px),
让控件和侧栏品牌对齐。
[应用按钮][窗口控制]dsh-better-sidebar 不受影响:不占右栏宽度,也不碰 --dsh-sidebar-height
只以我们自己的 profile 启动公开 CLI,并往它服务的页面注入浮层;
锚点是结构化的,React 重渲染由 MutationObserver 兜底重注入。
DSH_HOME 开终端并把当前内核的 node_modules/.bin 加进 PATH)、重启菜单(重新加载界面 / 重启 / 重启进安全模式)web 模板生成兄弟 profile <profile>-safe,不加载任何插件dshmarket 作为预设插件安装display:none,不再糊掉右半屏窗口无边框。关闭(自绘关闭按钮或系统关闭)只是隐藏,不退出, 长任务不断;唯一的退出路径是托盘菜单里的「退出」。
显示主界面 / 退出KokonaHarness,DSH 页面的 document title 改不掉它Ctrl/Cmd + Shift + K 开关内核管理面板KokonaHarness(Electron 外壳)
main/ 应用生命周期、窗口、IPC
runtime/ 内核版本管理(基线 + npm 频道)
core/ profile 初始化 + 启动 dsh 进程 + 就绪探测
preload/ 窗口控制桥 + 往 DSH 页面注入标题栏
renderer/ 启动页 + 内核管理面板(原生 TS,无框架)
DSH 内核(@deepseek-ai/dsh) <- 按版本装到 <userData>/runtime/<version>
启动命令: node <bin> --profile kokona --no-open --port <free>
数据目录: $DSH_HOME(默认 ~/.dsh,与官方客户端共用)
从不修改内核:只以我们自己的 profile 启动公开 CLI,并往它服务的页面注入标题栏浮层。
RELEASE / MIRROR
环境要求:PATH 里有 Node.js ^22.19.0 || >=24(用于跑内核),
以及 pnpm >=11(用于插件管理)。未内置基线内核时,
应用首次启动会从 npm 安装当前频道版本。