dsh-refined:爲 DSH 前端提供 Obsidian Border 風格的主題與 Markdown 美化

前言

DeepSeek Harness(DSH)的插件機制允許在 Web 端擴展前端行爲。dsh-refined 是一個面向 DSH 前端的純前端擴展,用於把 DeepSeek-Refined 的效果移植到 DSH,爲 DSH 前端注入 Obsidian Border 風格的 Markdown 美化與多主題配色。

它主要解決 DSH Web 界面中的兩類問題:一是整站配色統一,二是 Markdown 消息的標題、引用塊、粗體、斜體、行內代碼和公式等元素的視覺層次。維護者爲 djh2203,許可證爲 MIT。

這是什麼

dsh-refined 是 DeepSeek-Refined 的 DeepSeek Harness 移植版。它不注入腳本,不改動 DSH 源碼,屬於純前端擴展,安裝後可隨時卸載恢復原樣。

該插件提供 5 套主題,並通過主題切換按鈕讓用戶在 DSH 會話頭部直接切換配色。對於已有 DSH Web 部署,它可以作爲一個獨立插件安裝;對於只想臨時體驗的場景,也可以通過會話動態創建插件運行。

核心功能

5 套主題

支持以下主題:

  • Border:默認主題
  • Nord
  • Twilight
  • GitHub
  • Atom One

深色模式和淺色模式自動跟隨系統。

整站配色覆蓋

插件通過 theme.overrideTokens() 覆蓋 DSH 的 --dsw-alias-* CSS 變量,使整站配色統一生效。

Markdown 美化

插件對 DSH 前端中的 Markdown 元素做視覺增強:

  • 各級標題左側增加彩色圓角豎條
  • 引用塊使用 Border 點陣圖案背景,並附帶品牌色圓角豎條
  • 粗體
  • 斜體
  • 行內代碼
  • KaTeX 公式

以上元素使用獨立配色。

主題切換

會話頭部右側會出現調色板按鈕,用於一鍵切換主題。

主題選擇保存在瀏覽器 localStorage 中,後端重啓後仍會保持。

安裝與啓用

部署級安裝

先確認本機可用 pnpm。dsh plugin 依賴 pnpm,如果提示找不到 pnpm,先全局安裝:

npm i -g pnpm

然後安裝插件並重啓 DSH:

dsh plugin --profile web add github:djh2203/dsh-refined
dsh web --port 3080

安裝完成後,可以在 DSH 的 Settings → 插件 頁面查看部署級插件清單,並在任意會話頭部右側確認是否出現調色板按鈕。

本地試裝

如果要在本地路徑試裝,可以使用本地文件路徑:

dsh plugin --profile web add file:/絕對路徑/dsh-refined

更新

更新插件後需要重啓 DSH:

dsh plugin --profile web update dsh-refined
dsh web --port 3080

卸載

卸載插件後同樣需要重啓 DSH:

dsh plugin --profile web remove dsh-refined
dsh web --port 3080

沒有 pnpm 環境

如果沒有 pnpm,也可以使用 install.sh 完成安裝:

git clone https://github.com/djh2203/dsh-refined dsh-refined
cd dsh-refined
./install.sh web
dsh web --port 3080

動態會話體驗

如果只是臨時體驗,可以複製 main.js 全文,在 DSH 中新建一個會話,把全文發送到輸入框,讓助手將其創建爲動態 Cordis 插件並運行。

出現運行卡片後,點擊「允許」授權。授權後主題即可生效,會話頭部右側會出現調色板按鈕。

注意:動態插件屬於會話級擴展,進程重啓後會失效。重啓 DSH 後如果沒有效果,應改用部署級安裝。

適用場景與注意

適合已經部署 DSH Web,並希望在不改動 DSH 源碼的情況下統一前端主題和 Markdown 觀感的場景。

使用前需要注意:

  • 插件以當前 dsh 進程權限運行。
  • 安裝前應檢查源碼與許可證。
  • 動態插件爲會話級,進程重啓後需重裝。
  • 部署級插件常駐,後端重啓不丟,所有會話生效。
  • Settings → 插件 頁面只顯示部署級插件清單;動態粘貼版屬於創建它的那個會話,只在聊天裏的運行卡片可見。
  • 未移植原版中的以下功能:行內代碼點擊複製、消息寬度 75% 與表格寬度 70%。

package.json 中聲明 dsh.bundle patch 爲 ./cordis.patch.yml,client platform 爲 web。

小結

dsh-refined 以純前端方式給 DSH 前端增加 5 套主題和 Markdown 美化能力,適合用於統一 DSH Web 的界面觀感。安裝、更新和卸載都通過 dsh plugin 命令完成,動態粘貼版則適合作爲臨時體驗方式。

GitHub:https://github.com/djh2203/dsh-refined

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜