前言¶
DeepSeek Harness（dsh）的 Web 界面通常偏工具化，適合處理任務，但本地使用時如果想換一套更明顯的外觀，再順手聽一點本地音樂，可以看看這個主題插件。
dsh-theme-cyberpunk 是一個面向 DeepSeek Harness Web 界面的賽博朋克主題插件：它提供霓虹氛圍、可切換的背景圖庫，以及一個右上角可拖動、可收起的 HUD。HUD 裏包含「賽博 / 默認」外觀切換和本地音樂播放器，歌單與播放狀態會持久化。
這是什麼¶
dsh-theme-cyberpunk 是一個 DSH Web 主題插件，倉庫位於 dlpufan/dsh-theme-cyberpunk，許可證爲 MIT。
它解決的是兩個小問題：
- 給
dsh的 Web 界面換一個賽博朋克外觀，並且可以一鍵切回默認外觀。 - 在右上角提供一個 HUD，裏面可展開本地音樂播放器和背景圖庫。
它不是獨立應用，也不是官方應用商店裏的系統組件，而是 DSH 插件生態裏的一個主題包。
核心功能¶
下面介紹已覈實的幾項能力。
- 提供賽博朋克外觀主題：旋轉 RGB 色輪、霓虹光斑、細密 CRT 掃描線、暗角等氛圍特效。
- 內置暗色霓虹城市背景，並支持添加、切換、刪除本地背景圖，且記住選擇。
- 提供「賽博 / 默認」外觀一鍵切換，偏好持久化。
- 提供右上角可拖動、可收起的 HUD，HUD 位置可記住。
- 提供本地音樂播放器：
- 添加本地音頻組成歌單；
- 播放 / 暫停；
- 上一首 / 下一首；
- 隨機順序；
- 循環模式：關 / 列表 / 單曲；
- 進度拖動與音量調節；
- 歌單與播放狀態持久化。
- 支持添加
mp3/flac/wav等本地音頻文件。 - 系統開啓「減少動態效果」時自動禁用動效。
安裝與啓用¶
安裝前需要滿足：
- Node.js 22+
- pnpm
- 已安裝並初始化 DeepSeek Harness，且可運行
dsh web
可以按下面方式安裝。
從 GitHub 倉庫安裝¶
dsh plugin --profile web add "github:dlpufan/dsh-theme-cyberpunk"
安裝後啓動 Web profile：
dsh web
然後刷新瀏覽器。
本地目錄安裝¶
在插件目錄內執行：
dsh plugin --profile web add .
然後執行：
dsh web
刷新瀏覽器即可。
手動激活備用配置¶
如果安裝後沒有自動激活，可以檢查：
$DSH_HOME/profiles/web/cordis.patch.yml
在文件中添加：
- insert:
- id: theme-cyberpunk
name: dsh-theme-cyberpunk
保存後重啓 DSH Web。
注意：cordis.patch.yml 頂層必須是 YAML 數組，空文件或純註釋會報錯。
典型用法¶
安裝並運行 dsh web 後，刷新瀏覽器，右上角會出現一個膠囊 HUD。
切換外觀¶
點擊 HUD 的「賽博 / 默認」按鈕，可在賽博朋克外觀與默認外觀之間切換。綠點亮起表示賽博朋克開啓。
拖動和收起 HUD¶
拖動 HUD 的手柄可調整 HUD 位置，位置會被記住。
點擊 HUD 的收起按鈕，可將其收起爲單個音符按鈕；再點擊可展開。
使用本地音樂播放器¶
點擊 HUD 的音符圖標，可打開或收起本地音樂播放器。
在播放器中：
- 使用添加按鈕選擇本地音頻文件，可添加
mp3/flac/wav等文件。 - 點擊歌單中的曲目開始播放。
- 使用播放 / 暫停按鈕控制播放。
- 使用上一首 / 下一首切換曲目。
- 開啓或關閉隨機順序。
- 切換循環模式：關 / 列表 / 單曲。
- 拖動進度條跳轉播放位置。
- 調節音量。
歌單與播放狀態會持久化，但刷新頁面後狀態會回位，不會自動播放。
刪除歌單中的曲目時，會同時從 IndexedDB 刪除對應數據。
管理背景圖庫¶
點擊 HUD 的圖片圖標，可打開或收起背景圖庫。
在背景圖庫中：
- 點擊內置默認背景，可切回內置暗色霓虹城市圖。
- 添加本地背景圖，新圖會進入圖庫。
- 點擊縮略圖切換爲對應背景。
- 刪除某張背景圖。
如果刪除的是當前背景，會自動切回內置默認霓虹城市圖。
適用場景與注意¶
這個插件適合本地使用 DeepSeek Harness Web 界面、想換一套賽博朋克外觀，並且希望在頁面裏直接放一個本地音樂播放器的場景。
使用前注意：
- 插件會以當前
dsh進程權限運行，安裝前建議檢查源碼與許可證。 - 許可證爲 MIT。
- 本地音頻和背景圖屬於本地文件數據，刪除歌單條目會同時從 IndexedDB 刪除。
- 刷新頁面後，音樂播放器會回到上次持久化狀態，但不會自動播放。
- 系統開啓「減少動態效果」時，插件會自動禁用動效。
卸載：
dsh plugin --profile web remove dsh-theme-cyberpunk
結尾¶
dsh-theme-cyberpunk 的價值比較具體：它不改變 dsh 的核心能力，而是給 Web 界面加上一層賽博朋克外觀，並把外觀切換、背景圖庫和本地音樂播放器放進右上角 HUD。
如果只是想給本地 DeepSeek Harness Web 界面換個更帶氛圍的樣式，同時順手播放本地音樂，它是一個比較直接的選擇。
GitHub 倉庫：
https://github.com/dlpufan/dsh-theme-cyberpunk
社區目錄頁：已覈實資料未給出固定 URL，可按插件名在 DSH 社區目錄中查找。
