前言¶
DeepSeek Harness（DSH）的 Web 外壳默认界面偏功能向，长时间写代码、跑对话时，主题、壁纸和阅读区对比度往往要靠自己改样式或忍受默认观感。社区里也有零散 CSS 或手工改 profile 的做法，升级或换机时不好复现，卸载也不干净。
下面介绍维护者 Zenolzx 发布的 DeepSeek Harness Desktop Themes（npm 包名 dsh-desktop-themes）。它是一个可安装、可配置、可卸载的桌面外观插件，只走 DSH 真实存在的插件接口（theme 服务、settingsScope、slots、cordis.patch.yml 组合层），不修改宿主核心文件；卸载后由插件 fiber 的 dispose 释放副作用，界面可恢复。
- 目录页：https://www.skillhub.cn/plugins/Zenolzx/deepseek-harness-desktop-themes
- 源码：https://github.com/Zenolzx/deepseek-harness-desktop-themes
- 平台：Web（DSH 浏览器外壳）；宿主进程侧负责配置持久化
- 技术栈：TypeScript + React（客户端）+ Cordis（DSH 插件运行时）
- 当前版本（package）：1.7.2；许可证 MIT
这是什么¶
一句话：为 DSH Web 端提供六套签名主题、字体与壁纸、粒子与光影、毛玻璃与自定义配色，以及可选桌宠的桌面外观插件。
默认组合为黑金星穹主题、黑曜石月殿壁纸与月灵狐桌宠；所有设置在「设置 → 桌面外观」页实时预览，并通过宿主设置存储与 IndexedDB 持久化（自定义壁纸 blob 不进 localStorage）。
核心功能¶
资料中的能力按分组归纳如下，便于对照设置页。
主题与排版¶
- 六套主题：量子蓝、极光幻境、薄荷清风、樱雾、日落流光、黑金星穹；主题卡片含背景/面板/文字/强调色/粒子缩略与风格标签。
- 界面字体与代码字体独立下拉，各 8 组预设；选项用对应字体预览，并显示「已安装 / 回退」。
- 字号、行高、字重、连字、平滑等排版项可调。插件不内置字体文件，推荐自行安装 LXGW WenKai（界面与中文正文）与 Maple Mono（代码），未安装时按回退栈降级。
壁纸与桌面元素¶
- 每套主题有专属内置壁纸；支持本地选择、拖放、最近使用与预览。
- 填充方式：填充 / 适应 / 居中 / 拉伸 / 平铺；可调缩放、透明度、模糊、亮度、饱和度、暗色遮罩、主题色混合。
- 自定义壁纸存 IndexedDB（数据库名
dsh-desktop-themes）；内置壁纸以builtin:<theme-id>引用。 - 桌宠「月灵狐」：可拖拽定位、单击打开快捷菜单；眨眼、摇头、摆尾与呼吸等动效；发声有 6 种语调预设。
动效、玻璃与阅读区¶
- 光影：强度档位、光标跟随柔光、背景视差、柔光呼吸。
- 粒子：十种预设；密度、数量、大小、速度、透明度、连线、鼠标互动、自动配色等。
- 透明与毛玻璃：窗口/侧边栏/面板/输入区透明度（0.55 下限）、模糊强度及降级。
- 内容区：Diff 高亮、文档预览与代码区卡片式不透明底；粒子不穿过阅读区；薄荷清风支持「经典 / 焕新」切换。
- 自定义配色：七色主题、协调配色生成、对比度检测与修正；可命名保存、复制、删除；内置主题可复制后编辑。
性能与配置管理¶
- 动画速度：静止 / 舒缓 / 标准 / 活跃。
- 性能等级：省电（约 14–24 粒子、20 FPS）、均衡（默认，36–64 粒子、30 FPS）、高质量（72–112 粒子、60 FPS）。
- JSON 导入导出（
dsh-desktop-themes.json，带 schema 校验与版本迁移）；分组或全部恢复默认值。
配置 schemaVersion 当前为 3，写入宿主设置约 350ms 防抖；设置页提供「保存全部设置」同步正式 API 并写本地备份。
安装与启用¶
插件由宿主侧（设置持久化）与客户端侧（主题/外观/设置页）组成；安装包声明 dsh.bundle，会自动注册插件行。旧版若在 profile 的 cordis.patch.yml 里手工写过 desktop-themes 行，升级前应先备份并移除，避免重复挂载。
1、安装依赖包¶
推荐安装已构建的 tgz（桌面端插件管理器也可选该文件）：
dsh plugin --profile web add file:D:/path/to/dsh-desktop-themes-1.7.2.tgz
若包已发布到 npm，也可：
dsh plugin --profile web add dsh-desktop-themes
从 GitHub 源码安装时，prepare 会在安装端执行构建；若环境不允许构建脚本，应使用预构建的 .tgz。
2、重启 Web 外壳¶
dsh web
重启后打开「设置 → 桌面外观」。本地开发时，在仓库目录可用：
npm run deploy:web
该命令会构建带时间戳的开发包、安装到 web profile 并按需重启 DSH；不自动重启时用 npm run deploy:web:no-restart。
验证时可执行 dsh plugin --profile web list 确认插件在列表中，并在浏览器访问 DSH Web 地址（README 示例为 http://127.0.0.1:3080）查看设置项是否出现。
典型用法¶
在设置页调整外观¶
- 启动
dsh web后进入 DSH Web 界面。 - 打开「设置 → 桌面外观」。
- 选择主题卡片、壁纸与粒子/光影档位；拖动透明度与模糊滑块时配置会防抖写入
$DSH_HOME/settings.yaml的ui-desktop-themes命名空间。 - 满意后点击「保存全部设置」，刷新后应优先恢复明确保存的版本。
导入导出与重置¶
- 导出：在设置页将当前配置导出为
dsh-desktop-themes.json。 - 导入：选择 JSON 文件，经 schema 校验与版本迁移后应用。
- 全部重置会回到黑金星穹、内置黑金壁纸与月灵狐默认组合。
卸载¶
dsh plugin --profile web remove dsh-desktop-themes
dsh web
若要清空残留设置：删除 $DSH_HOME/settings.yaml 中 ui-desktop-themes: 分节；在浏览器清理 dsh-desktop-themes 的 IndexedDB，并删除 localStorage 键 dsh-desktop-themes:explicit-config:v3。
适用场景与注意¶
适合谁： 长期在 DSH Web 外壳里编程与对话、希望主题/壁纸/字体一套配置可持久化、且需要卸载即恢复的用户。
开发与贡献者： 构建需 Node.js ≥ 20（README 在 Node 24 验证过）。常用命令：
npm install
npm run typecheck
npm test
npm run build
npm pack
安全与权限： 插件以当前 dsh 进程权限运行；安装前请自行查看源码与 MIT 许可证，确认组合层与设置命名空间符合你的策略。社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，本文不构成官方背书。
已知限制（摘要）： 宿主内置 ui-theme 仍只支持 light/dark/system，插件主题写在 ui-desktop-themes.theme；自定义壁纸依赖 IndexedDB；毛玻璃主要作用于插件自有 .dth-glass 表面，产品 DOM 不由插件硬改。
结尾¶
DeepSeek Harness Desktop Themes 把桌面观感收敛成一个标准 DSH 插件：六套主题与配套壁纸、字体与粒子动效、可持久化的自定义壁纸与配色，卸载时不留宿主补丁。需要细节时可查阅仓库 README 中的 docs/install.md、docs/configuration.md、docs/fonts.md 与 docs/performance.md。
