秋月不会解梦的头像 秋月不会解梦

KOKONA HARNESS · DESKTOP SHELL FOR DSH

一个 DeepSeek Harness(dsh)桌面外壳。 Electron + 网页渲染的内核,补上现有那些半成品桌面端缺的两件事。

① 内核与应用分开更新

外壳和 DSH 内核各自版本化。每个已安装的内核版本放在独立目录,切换或回滚都不用重装应用;内置基线内核让首次启动可以离线完成。

② 自定义深色标题栏

无边框窗口,没有那条白色的系统标题栏。窗口控制按钮和应用自己的侧栏品牌处在同一条 48px 线上,拖拽区域只占用真正空白的像素 —— 所以应用的控件和 dsh-better-sidebar 都照常工作。

SHELL Electron 外壳 原生 TS,无框架
KERNEL DSH 内核 按版本独立目录
TITLEBAR 48px 深色标题栏 无边框 · 自绘
UPDATES 内核与外壳分开更新 可切换 · 可回滚
PLATFORM Windows · macOS · Linux MIT 许可

它做了什么

NEVER PATCHES THE KERNEL

01 — 双轨更新

内核与应用分开更新

外壳和 DSH 内核各自版本化,每个已安装的内核版本落在 <userData>/runtime/<version> 独立目录,切换或回滚都不用重装应用。

  • 安装是原子的:先装到 <version>.installing,成功后才改名就位
  • 激活版本文件不完整时按固定版本重装,不查 registry,修复不卡网络
  • registry 查询有 8 秒超时
  • 内置基线内核,首次启动可以离线完成
02 — 标题栏

自定义深色标题栏

Windows / Linux 无边框;macOS 用 titleBarStyle: 'hidden' 保留红绿灯。 注入的浮层读取 DSH 自己的 --dsh-frame-top-clearance(48px), 让控件和侧栏品牌对齐。

  • 拖拽由按真实布局算出的多个小拖拽段完成,可交互元素全部排除
  • 窗口控制按钮钉死在最右,永不移动
  • 应用右上工具簇整体左移一次,这一行读作 [应用按钮][窗口控制]
  • dsh-better-sidebar 不受影响:不占右栏宽度,也不碰 --dsh-sidebar-height
03 — 外壳集成

注入 DSH 网页,从不改内核

只以我们自己的 profile 启动公开 CLI,并往它服务的页面注入浮层; 锚点是结构化的,React 重渲染由 MutationObserver 兜底重注入。

  • 设置头部按钮:DSH 终端(在 DSH_HOME 开终端并把当前内核的 node_modules/.bin 加进 PATH)、重启菜单(重新加载界面 / 重启 / 重启进安全模式)
  • 检查更新选项卡:内核更新 + 外壳更新(国内优先 Codeberg,国外优先 GitHub)
  • 安全模式:从官方 web 模板生成兄弟 profile <profile>-safe,不加载任何插件
  • 插件市场:dshmarket 作为预设插件安装
  • 右栏残留面板:右栏折叠后把仍挂载的面板 display:none,不再糊掉右半屏
04 — 窗口与托盘

关闭只是隐藏,内核继续跑

窗口无边框。关闭(自绘关闭按钮或系统关闭)只是隐藏,不退出, 长任务不断;唯一的退出路径是托盘菜单里的「退出」。

  • 托盘左键:显示并聚焦主界面
  • 托盘右键:显示主界面 / 退出
  • 从托盘退出会先停内核再退出
  • 窗口标题强制为 KokonaHarness,DSH 页面的 document title 改不掉它
  • 快捷键 Ctrl/Cmd + Shift + K 开关内核管理面板
05 — 架构

外壳与内核的关系

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 安装当前频道版本。