dsh-ccx：为 DeepSeek Harness 桌面版换上动态背景

前言¶

DeepSeek Harness（DSH）桌面版默认界面较单调，长期使用容易产生视觉疲劳。静态壁纸虽然简单，但无法随时间或交互变化；更换主题又需要修改宿主样式，侵入性强且难以维护。

下面介绍一个 DSH 插件，通过复用上游场景渲染器并适配 DSH 桌面版，让界面背景从静态变为动态，同时保持界面可读性与交互一致性。

这是什么¶

dsh-ccx 是一个为 DeepSeek Harness 桌面版提供的主题与背景插件，由维护者 Witherwithwinter 开发，分类为模型推理。它不改变 DSH 的核心逻辑，而是通过注入页面与 Cordis 插件半边，为 DSH 提供动态场景渲染、壁纸视频库、UI 表面透明与 Appearance 设置面板的复刻。

核心功能¶

10 种动态场景¶

插件内置 10 种 1:1 来自上游 Rice-dog/code-codex 的场景渲染器，全部 MIT 许可，原样分发：

银河光场 Milky Way：旋转星系 + 五色调色板 + 开场动画
辉光地平线 Glow Horizon：地平线辉光，方向四选、滚轮惯性
层峦 Layered Mountain：视差山脊 + 日照着色，渲染比例可调
云穹 Heavenly Cloud：云层穹顶，三档渲染质量
极光电离层 Aurora：极光帘 + 电离层波动
黑洞 Black Hole：吸积盘/光线/渲染器分组，影院/透镜/余烬三预设
云列车 Cloud Train：列车车窗视角的云海，三染色可调
粒子成像 Particle Image：把图片采样成 56 万粒子，支持本地图库、自动轮播、鼠标交互、开场汇聚
像素雕塑 Pixel Sculpt：WebGL2 实例化浮雕方块，图片高度场 + 指针涟漪，自带完整参数面板
闪烁方块 Blinking Squares：方块矩阵闪烁波纹，方向四选、键盘随机波纹

壁纸 / 视频素材库¶

支持导入图片或 MP4/WebM，提供三种适配模式：铺满、完整显示、平铺。壁纸与场景互斥切换，实时生效。

实时生效¶

所有参数调整直接推给运行中的渲染器，不重建舞台、不重播开场动画。全部状态落宿主 state.json，多窗口 / 重启后一致；场景参数只存增量，渲染器内嵌默认值始终是真值。

UI Surface Opacity¶

通过通配透明让界面底色让位给背景，四个分区独立滑杆调节不透明度：会话侧栏、对话区、消息输入区、右侧栏。额外提供背景压暗与模糊。停用后输入框恢复原生样式，圆角交界的缺口自动补齐，输入卡片周边的原生阴影与座位渐变一并清理。DSH 自己的设置页不受影响——设置面板保持宿主原生样式，背景照常透出。

Appearance 面板¶

左下角齿轮弹出 Appearance 面板，包含 12 张外观卡片（10 场景 + 壁纸 + 表面蒙版）与场景设置 popover，结构对齐上游 code-codex 0.5.7 真实 UI。启用某外观时已打开的设置面板自动关闭。

安装与启用¶

插件要求 DeepSeek Harness 桌面版（当前验证版本 0.2.1-rc.2+）。仓库自带构建产物 lib/，所有安装方式都不需要本地构建。

方法 A：让 DSH 安装 npm 包¶

在 DSH 桌面版的会话里直接让它安装：

安装 npm 包 dsh-ccx

DSH 的 plugin_manager 会解析包的 dsh.bundle 元数据并装配进 desktop profile。装完重启 DSH 桌面版生效。

方法 B：GitHub 源码¶

安装 github:Witherwithwinter/dsh-ccx

同样重启生效。

方法 C：手工编辑 profile¶

编辑 ~/.dsh/profiles/desktop/package.json：

{
  "dependencies": {
    "dsh-ccx": "^0.8.9"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "dsh-ccx"
      ]
    }
  }
}

然后在 profile 目录里 pnpm install，重启 DSH 桌面版。

桌面 profile 没有 web 端的 patchReload: live 热装配，改配置、升级插件都需要重启 DSH。

典型用法¶

安装后，左下角齿轮 ⚙ 弹出 Appearance 面板。从卡片中选择场景（如层峦、银河光场）或壁纸，通过设置 popover 调整参数（渲染比例、方向、染色等）。在 Appearance 面板或设置页中调节 UI Surface Opacity 滑杆，让不同区域透明化。所有变更实时反映，无需刷新或重建场景。

适用场景与注意¶

适合希望在 DSH 桌面版拥有动态背景、个性化主题，同时保持界面交互一致性的用户。

注意：插件以当前 DSH 进程权限运行，安装前建议阅读源码与许可证。场景渲染器与设置面板复刻上游 code-codex 与 DSH 真实 UI，本项目与 DeepSeek、code-codex 均无隶属或背书关系。

已知限制¶

原生菜单栏（应用 / 编辑）不参与透明化：它是 Electron 非客户区，页面 CSS、bundle 进程、desktop-host 都不可达——背景从窗口内容区顶部开始，不含 OS 菜单条。需要 DSH 本体配合（不设应用菜单或 win.setMenu(null)）。
窗口完全遮挡 / 最小化到托盘时场景暂停渲染：Chromium 原生遮挡检测让页面进入 hidden，渲染器停帧；窗口恢复可见即继续。刚唤出的一瞬可能看到合成残影，属显示层暂态。
Particle Image 首次启用需要图库：默认图库自动播种到 IndexedDB；若「图库未就绪」，重启一次 DSH 让播种完成即可。
Pixel Sculpt 的设置在未启用时也可调（实时写入并持久化，下次启用生效），「暂停动画」开关仅在场景启用中可用。
变形曲线以数值行呈现，未实现上游的曲线编辑器；开机恢复的上架过渡动画未移植。
web 端 DSH 未适配、未测试。

生态背景¶

DSH 理念是「一切皆插件」，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-ccx 通过复用上游场景渲染器并适配 DSH 桌面版，为用户提供了一套可即时生效、可精细控制的动态背景与界面透明化方案。如需进一步了解或查看源码，可访问其目录页与 GitHub 仓库。