前言¶
长时间在 DeepSeek Harness(DSH)Web 客户端里调试智能体时,界面往往长期使用默认主题:功能完整,但视觉反馈单一。DSH 采用「一切皆插件」的架构,主题同样可以以插件形式安装,在不改核心代码的前提下替换背景与配色。下面介绍社区维护的 dsh-theme-desert-dusk:以「大漠孤烟直,长河落日圆」为意象,为 Web GUI 绘制全屏荒漠黄昏场景,并同步调整 UI 设计令牌。
这是什么¶
@zhangwenlei1404/dsh-theme-desert-dusk 是面向 DeepSeek Harness Web GUI 的主题插件,由维护者 zhangwenlei1404 发布,在 SkillHub 目录中归类为 趣味换装。它解决的是:在浏览器端为 Harness shell 增加自定义视觉层,并让控件颜色与场景协调,而不是只换一张静态壁纸。
插件当前版本为 1.0.0(见仓库 package.json),许可证为 MIT。实现上不依赖外部图片文件,场景由 CSS 与内联 SVG data URI 绘制,可在离线环境下继续显示。
核心功能¶
背景场景(内联 SVG)¶
插件在应用背后绘制单块全视口 inline SVG,不发起额外网络请求。资料中列出的画面元素包括:
- 黄昏天空渐变:由紫向朱砂、淡金过渡
- 远山后下沉的圆日与柔光
- 穿越沙丘的长河及落日倒影
- 四层沙丘,前景更深
- 四队雁阵向南飞行,随距离变淡、变小
- 星空轻微闪烁;在系统
prefers-reduced-motion下关闭闪烁
UI 与可读性¶
通过 ctx.theme.overrideTokens 覆盖 18 个 --dsw-alias-* 设计令牌,含浅色与深色成对配置:基础/抬升表面、边框、文本标签、品牌强调色及四种语义状态色。
同时将 shell 顶层容器设为透明,使背景场景透出;在画面与 UI 之间加入对比遮罩(scrim),以保证文字可读性。调色板覆盖使用 !important,插件启用时会压过当前活动主题自身的令牌。
运行形态¶
资料明确说明:无 Host 服务、无后台进程、无网络访问。客户端侧通过 dsh 元数据注入 @deepseek-ai/dsh-client-ui-theme,platform 为 web,immediately 为 true。
安装与启用¶
主题插件需安装在实际提供 Web 客户端的 profile 上。若你的 profile 不叫 web,将下面命令中的 web 换成你的 profile 名称。
从 npm 包名安装:
dsh plugin --profile web add @zhangwenlei1404/dsh-theme-desert-dusk
或不经 npm,直接从 GitHub 仓库安装:
dsh plugin --profile web add github:zhangwenlei1404/dsh-theme-desert-dusk
安装完成后,在浏览器中对 Harness 页面执行硬刷新(Ctrl+Shift+R 或 Cmd+Shift+R)。
卸载可在 Settings → Plugins 中禁用,或执行:
dsh plugin --profile web remove @zhangwenlei1404/dsh-theme-desert-dusk
典型用法¶
该插件属于 bundle 类型(cordis.patch.yml 补丁),没有单独的配置文件字段或 CLI 子命令。典型流程只有三步:
- 确认 Web 客户端对应的 DSH profile 名称(默认为
web)。 - 使用上文任一
dsh plugin --profile … add …命令安装。 - 硬刷新页面,在设置中确认插件已启用。
若同时启用多个主题类插件,需注意本插件的令牌覆盖带 !important,启用期间会优先于其他主题的别名令牌。
适用场景与注意¶
适合谁: 希望在本地或内网 Harness Web 界面上获得统一「大漠黄昏」氛围的开发者;需要纯前端、离线友好的背景方案、不希望主题拉取远程图片时也可考虑。
权限与安全: 插件随当前 DSH 进程与客户端注入逻辑运行。安装前应阅读 GitHub 仓库 源码并核对 MIT 许可证。社区目录 SkillHub 插件页 为独立站点,与 DeepSeek / 幻方无官方从属关系,不等同于官方应用商店。
其他说明: 降低动态效果的用户可通过系统「减少动画」设置关闭星空闪烁。若硬刷新后样式未更新,先检查 profile 是否与 Web 服务一致,再在插件设置中确认未禁用。
结尾¶
dsh-theme-desert-dusk 把诗句中的大漠、长河、落日与归雁落到 Web GUI 背景上,并用成对的设计令牌统一界面配色;安装命令简短,卸载路径清晰。进一步了解可访问 SkillHub 目录页:https://www.skillhub.cn/plugins/zhangwenlei1404/dsh-theme-desert-dusk,源码与 README:https://github.com/zhangwenlei1404/dsh-theme-desert-dusk。