前言¶
DSH(DeepSeek Harness)Web GUI 每次打开新对话,首页都是同一句「探索未至之境 预览版」。这句文案写在前端产物里,想换掉它,常规做法是直接改前端文件,DSH 每次升级都得重做一遍。
dsh-hero-custom 把这件事做成插件:不改官方文件,所有修改都在「设置 → 主界面标题」这一页完成,改文字、字号、颜色、字体、位置、光效、动态特效和鲸鱼图标,实时预览、自动保存。下面介绍它的安装与使用。
这是什么¶
dsh-hero-custom 是一个 DSH web 插件,由 Lumera114514 维护,当前版本 1.0.0,MIT 许可证。它解决的问题很具体:在不动官方文件、不影响会话数据的前提下,自定义新对话首页的标题区域——包括主标题「探索未至之境」、「预览版」徽标,以及标题前的鲸鱼图标。
核心功能¶
已核实的能力如下:
- 主标题文字:修改「探索未至之境」
- 徽标文字:修改或隐藏「预览版」徽标,留空即隐藏
- 字号:0–96px,填 0 表示恢复默认 26px
- 颜色:任意颜色
- 字体:手动输入,或一键选择楷体 / 宋体 / 黑体 / 圆体 / 等线 / 无衬线
- 位置:X / Y 偏移,范围 -300 到 300px
- 光效:霓虹辉光,可开关,带颜色、半径和强度 1–4 层
- 标题特效:无 / 流光(渐变流动)/ 呼吸 / 彩虹循环
- 鲸鱼图标:大小(填 0 表示恢复默认 24px,等比缩放)、颜色、动画(游动 / 弹跳 / 旋转 / 摇摆 / 脉冲)
两个实现细节值得单独说明:
防闪现。点击「新建对话」时,插件用预隐藏加帧级替换的方式处理标题,旧文字不会先闪一下再变成新文字。
持久化。设置保存在本机 $DSH_HOME/hero-custom.settings.json,重启不丢。
安装与启用¶
运行环境要求 Node >= 20。从 npm 安装:
dsh plugin --profile web add dsh-hero-custom
也可以从本地目录安装:
dsh plugin --profile web add ./path/to/dsh-hero-custom
装好后重启 dsh:
dsh --profile web
如果用的是 DSH Desktop,直接重启应用即可。
插件本身免构建:lib/ 目录是预构建产物,没有 prepare 脚本,安装时不会触发编译。
典型用法¶
装好并重启后,按下面的步骤配置:
1、打开「设置 → 主界面标题」,所有配置项都在这一页。
2、改主标题文字;如果不想看到「预览版」,把徽标文字留空即可隐藏。
3、按需调整字号、颜色、字体和 X / Y 偏移。
4、需要光效就打开霓虹辉光,选颜色、半径和强度层数;标题特效在无 / 流光 / 呼吸 / 彩虹循环之间选。
5、鲸鱼图标同理,可调大小、颜色,并从游动 / 弹跳 / 旋转 / 摇摆 / 脉冲里选一个动画。
6、改动实时预览、自动保存到 $DSH_HOME/hero-custom.settings.json,不需要手动导出导入。
想恢复默认字号或图标大小,把对应数值填 0 即可。
兼容性说明¶
插件定位页面元素用的是打包运行时里的哈希类名:.pXSMma_headlineText(主标题)、.pXSMma_previewBadge(徽标)、.pXSMma_fish(鲸鱼图标),对应 DSH web 0.1.0-rc.6 运行时。同时它内置了按原文「探索未至之境 / 预览版」匹配的兜底逻辑,DSH 升级导致哈希类名变化时,一般仍能通过文本匹配找到目标元素。
适用场景与注意¶
适合两类人:想让首页标题符合自己习惯或审美的 DSH web 用户;不想为改一句文案去维护前端补丁的人。
使用前注意三点:
1、插件以当前 dsh 进程的权限运行,安装前建议先阅读源码并确认许可证。源码在 GitHub 仓库公开,许可证为 MIT。
2、这是纯 UI 文案定制,不修改任何官方文件、不影响会话数据;设置只存在本机 $DSH_HOME/hero-custom.settings.json,不上传任何数据。
3、运行需要 Node >= 20。
小结¶
dsh-hero-custom 把「改一句首页文案」从改前端文件的体力活,变成了设置页里的一次点击,配合防闪现和持久化,改完即生效、重启不丢。
- 社区目录页(独立站点,与 DeepSeek 官方无从属关系):https://www.skillhub.cn/plugins/Lumera114514/dsh-hero-custom
- GitHub 仓库:https://github.com/Lumera114514/dsh-hero-custom