前言¶
DeepSeek Harness(DSH)的界面配色由设计 token 驱动,默认主题未必符合长时间盯屏时的习惯。若你已在 Vim、Neovim 或 Obsidian 等环境里用过 Everforest,会希望 Web 与 Desktop 端也能沿用同一套绿调、偏护眼的色阶,而不是在 DSH 里单独再调一套颜色。
下面介绍社区插件 dsh-everforest(维护者 FormalistBlue,GitHub 仓库 FormalistBlue/dsh-everforest)。它在 DSH 插件目录中归类为「趣味换装」,通过覆盖 --dsw-* / --shiki-* token 为 DSH Web 与 Desktop 提供 Everforest 深色 / 浅色 × Hard / Medium / Soft 共 6 档配色,不改组件结构。
这是什么¶
dsh-everforest 是发布在 npm 上的 DSH 主题插件(包名 dsh-everforest,当前版本 0.2.1)。简介为:Everforest color themes (Dark, Light × Hard, Medium, Soft) for DeepSeek Harness (DSH) Web and Desktop.
配色方案源自 sainnhe/everforest;默认深浅配对对齐 Everforest Enchanted(深色 Soft、浅色 Hard)。插件本体为 MIT 许可证。
核心功能¶
六档主题矩阵¶
插件提供 深色 / 浅色 与 Hard / Medium / Soft 的组合,共 6 张色卡可选。默认:深色 Soft、浅色 Hard。
设置页行为¶
- 路径:Settings → Everforest。顶部为「跟随系统 / 深色 / 浅色」外观控制;下方为 6 张色卡。
- 选中后即时生效并保存。
- 点另一深浅色组的色卡会同时切换 DSH 全局外观偏好;「跟随系统」可恢复自动跟随。
- 同一地址多标签页时,强度选择会实时同步。
- 「恢复默认」只重置深浅强度,不改写 DSH 的全局外观偏好。
- 中英文文案随 DSH 语言切换。
实现方式与首帧¶
- 仅通过 token 覆盖配色,不修改组件样式。DSH 升级若 token 改名,缺失项退回原生配色,不会白屏。
- Host 在 Client 加载前注入当前配色:Web 的 loading 页与首帧(含 spinner 与进度弧)即为 Everforest;Electron 冷启动最多 1 帧原生色。
- 浅色档正文面向
bg0提亮 25% 并做对比度守卫(正文对比度 ≥ 4.5:1)。
未覆盖范围¶
资料中明确列出:终端 ANSI 16 色、brand / 文件图标 artwork、逐级标题彩色尚未覆盖。完整 token 清单见仓库 docs/reference/token-inventory.md。
兼容性¶
目标 DSH 0.2.1-rc.2;engines.dsh 为 >=0.2.1-rc.2 <0.3.0-0。
安装与启用¶
在 DSH 插件管理页打开 Add plugin → Install a third-party plugin,输入包名安装:
dsh-everforest
本地开发时也可直接选择本仓库目录。或由 Agent 调用 plugin_manager 的 install_bundle,目标为 dsh-everforest。
安装前请自行查看仓库源码与 THIRD_PARTY_NOTICES.md 中的第三方署名。插件在当前 DSH 进程权限下运行,与从 SkillHub 等社区目录获取的其它第三方插件一样,社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。
典型用法¶
- 按上一节完成安装并启用插件。
- 打开 Settings → Everforest。
- 在顶部选择「跟随系统」「深色」或「浅色」。
- 在对应深浅组内点击 Hard / Medium / Soft 色卡,界面立即切换并持久化。
- 若只需恢复默认强度配对,使用「恢复默认」;全局明暗仍由顶部外观项或系统决定。
适用场景与注意¶
适合谁:长期用 DSH Web 或 Desktop、且希望界面与 Everforest 生态一致的开发者;需要在同一套 DSH 版本(0.2.1-rc.2 及以上、低于 0.3.0)上快速换肤、多标签同步主题选择的用户。
注意:
- Node 引擎要求
>=20(见package.json)。 - 不要凭仓库名自行拼接未在 README 中出现的 CLI 安装命令;以插件管理页输入
dsh-everforest或install_bundle为准。 - 主题能力绑定 DSH 的 client 注入(
@deepseek-ai/dsh-client-ui-theme等);升级 DSH 主版本前请对照engines.dsh范围。
结尾¶
dsh-everforest 把 Everforest 的六档配色落到 DSH,安装包名固定为 dsh-everforest,在设置页即可完成深浅与强度切换。目录页:https://www.skillhub.cn/plugins/FormalistBlue/dsh-everforest;源码与说明:https://github.com/FormalistBlue/dsh-everforest。