前言¶
DeepSeek Harness (DSH) 採用插件化架構。當用戶或開發者希望在不修改源碼的情況下改變 Web 客戶端的視覺風格或增加交互組件時,可以通過安裝主題插件來實現。本插件提供了一套完整的視覺替換方案和交互組件。
插件定位¶
這是一個名爲“神里綾華 · 冰華主題 + 桌面寵物”的 DSH Web 客戶端主題插件,由 l-vM2k 維護,開源許可爲 MIT。
核心功能¶
插件主要包含以下功能:
- 立繪展示:半透明的神里綾華立繪會貼在屏幕右側。
- 交互式桌面寵物:Q 版綾華小頭會趴在聊天輸入框的右上角。點擊該區域可觸發語音與文字氣泡同步。
- 環境特效:背景中會混合飄落櫻花花瓣與雪花,大小不一,密度稀疏。
- 主題配色:使用冰藍色進行 UI 配色,支持亮色和暗色雙模式。
安裝與啓用¶
安裝命令如下:
dsh plugin --profile web add github:l-vm2k/dsh-ayaka-theme
安裝完成後,啓動 Web 客戶端即可生效:
dsh --profile web
插件結構¶
插件遵循 DSH Bundle 標準,包含以下關鍵文件和配置:
package.json:聲明 bundle 和 client 層。cordis.patch.yml:定義掛載點。assets/:存放圖片和音頻資源。src/:包含 Node 層和瀏覽器層的邏輯。
關鍵配置說明¶
在 package.json 中,dsh 字段用於區分 bundle 和 client 層:
* dsh.bundle.patch:指向 cordis.patch.yml,用於識別 bundle 類型。
* dsh.client:聲明瀏覽器端插件,注入依賴並立即執行。
在 cordis.patch.yml 中,使用一行 insert 操作:
- insert:
- id: ui-ayaka-theme
name: '@l-vm2k/dsh-ayaka-theme'
這行配置會同時觸發兩個動作:掛載 Node 層(註冊路由)和發現 Client 層。
注意事項¶
使用本插件前,請確保 DSH Web 進程當前的主題爲深色模式。如果使用亮色模式,界面可能會因配色衝突而顯示爲白色。