前言¶
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