前言¶
DeepSeek Harness(DSH)的 Web 界面默認走系統主題令牌。想換一套固定視覺、又不想改應用源碼時,常見做法是手動改 CSS 或 fork 前端——維護成本高,升級也容易斷。
dsh-theme-endfield 走另一條路:作爲純 Client 半部插件,只覆蓋主題令牌並注入一張樣式表,不動 Host 側代碼。下面介紹它是什麼、能做什麼,以及如何安裝與調整。
這是什麼¶
dsh-theme-endfield(維護者 ymh0000123)是 DSH 的 Web 主題插件,參考《明日方舟:終末地》官網視覺風格,在 SkillHub 分類爲「趣味換裝」。核心視覺是奶油紙底、墨黑文字、信號黃強調、全直角工業編輯風。
插件在 GitHub 開源(MIT 許可證,當前 package.json 版本 1.0.0),不修改 DSH 應用代碼,僅通過 Client 運行時覆蓋主題令牌並注入樣式。
視覺參考來源爲終末地官網:國內版 https://endfield.hypergryph.com,國際版 https://endfield.gryphline.com。
設計語言¶
README 將設計語言概括爲下表,完整色板、令牌映射與對比度規則見倉庫 docs/design-language.md。
| 維度 | 取值 |
|---|---|
| 紙底 | 亮 #e8e8e2 / 暗 #101110 |
| 文字 | 亮 #101110 / 暗 #f5f5f0 |
| 強調色 | 谷地黃 #fff500(默認)或武陵青 #14d0d0,設置頁一鍵切換 |
| 字體 | Arial / Helvetica Neue / PingFang SC / Microsoft YaHei,開啓 tnum 等寬數字 |
| 圓角 | 全部 0(狀態點、頭像、加載圈保留圓形),可切回圓角 |
核心功能¶
主題覆蓋¶
安裝後,插件通過 DSH Client 的 theme 服務與 styles 內建能力,把界面切換到終末地風格。Host 半部(index.js)爲空實現,全部邏輯在 client.js:令牌覆蓋、樣式表、設置頁與各功能圖層。
十個可配置開關¶
設置入口爲 設置 › 終末地主題設置。共四組、十個開關,由 localStorage 持久化,文案跟隨 DSH 語言設置(中/英)。各開關行爲細節見 docs/features.md。
| 組 | 開關 | 默認 |
|---|---|---|
| 01 主題 | 終末地主題(總開關) | 開 |
| 主題配色(谷地黃 / 武陵青) | 谷地黃 | |
| 主題圓角(直角 / 圓角) | 直角 | |
| 02 背景 | 等高線背景 | 關 |
| 動態等高線 | 開(需先開啓等高線背景) | |
| 背景水印 | 開 | |
| 水印保持顯示 | 關(需先開啓背景水印) | |
| 03 動畫 | 啓動加載動畫 | 關 |
| 04 娛樂 | 雷霆大字 | 關 |
| 大字入場動畫 | 關(需先開啓雷霆大字) |
部分開關有依賴關係:例如動態等高線需先開等高線背景,大字入場動畫需先開雷霆大字。
安裝與啓用¶
在 web profile 下執行官方安裝命令:
dsh plugin --profile web add github:ymh0000123/dsh-theme-endfield
重啓或重新加載 web profile 後生效。安裝完成後,到 設置 › 終末地主題設置 按需調整開關。
卸載:
dsh plugin --profile web rm dsh-theme-endfield
典型用法¶
日常:安裝後調設置¶
- 執行上述
add命令並重新加載 web profile。 - 打開 設置 › 終末地主題設置。
- 按需切換總開關、配色(谷地黃 / 武陵青)、圓角,以及背景、動畫、娛樂相關選項。
臨時試用(不安裝)¶
README 提供了通過 Cordis 動態插件試用的方式,適合先體驗再決定是否長期安裝:
- 複製
client.js裏apply(ctx) { ... }的函數體; - 用
cordis_define新建插件,粘貼爲 Client 代碼(return { apply(ctx) { ... } }),再用cordis_run激活; - 刷新頁面生效;在 Run 卡片上停止插件即完全卸載(令牌層與樣式層自動拆除)。
注意:client.js 依賴 DSH Client 運行時的 theme 服務與 styles 內建,不能在普通瀏覽器裏直接運行。
適用場景與注意¶
適合誰
- 長期在 DSH Web 界面工作、希望界面有統一終末地工業編輯風的用戶。
- 只想換膚、不想改 DSH 源碼或 fork 前端的開發者。
使用前注意
- 插件以當前
dsh進程權限運行。安裝前建議閱讀 GitHub 倉庫 源碼,確認client.js行爲符合預期,並覈對 MIT 許可證。 - SkillHub(
https://www.skillhub.cn)是獨立的 DSH 插件社區目錄,與 DeepSeek / 幻方無官方從屬關係;目錄頁用於發現插件,安裝仍以 README 中的dsh plugin命令爲準。 - 部分背景與動畫功能(如等高線、啓動加載動畫)會增加渲染開銷;若機器較慢,可先關閉 02、03 組中的裝飾項,只保留主題令牌與配色。
開發與校驗¶
維護者提供了靜態校驗與測試腳本,主題樣式表以 JavaScript 模板字符串形式維護,部分改動可能在「文件仍能解析」的情況下靜默失效,因此用腳本固化不變量:
node check.js # 樣式表不變量(模板字符串、註釋配平、變量定義、:root 陷阱)
node selftest.js # 反向驗證 check.js 真能抓到那些問題
npm test # 全部校驗:配色 / 設置頁 / 渲染 / 覆蓋率 / 性能
部分測試需在真實瀏覽器中量像素,本機需安裝 Chrome;check.js、selftest.js 及若干設置頁、配色相關測試可在純進程內運行。詳見 docs/testing.md。
結尾¶
dsh-theme-endfield 把 DSH Web 界面換成終末地官網的奶油紙底、墨黑文字與信號黃強調,通過十個本地持久化開關控制配色、背景與娛樂效果,安裝與卸載各一條 dsh plugin 命令。