前言¶
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:默認主題NordTwilightGitHubAtom 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