前言¶
DeepSeek Harness（DSH）的 Web 界面默認配色偏通用；若希望長時間盯屏時界面更剋制、正文與鏈接對比度仍可讀，單靠改 CSS 往往與 DSH 的 token 體系脫節。下面介紹維護者 xwtaidev 發佈的第三方 bundle xwtaidev/dsh-morandi-theme：把 Obsidian 側莫蘭迪色板改寫成 DSH 可消費的語義 token 覆蓋層，淺色像紙白與深褐字，深色像暖墨底與霧白字，不新增一套獨立「主題菜單項」，而是疊在 DSH 原有的淺色 / 深色 / 跟隨系統之上。
這是什麼¶
Morandi · 紙與墨（發佈包名 @xwtaidev/dsh-theme-morandi）是面向 Web 客戶端的主題 bundle，色彩設計改編自 obsidian-morandi-theme（MIT，Copyright © 2026 xwtaidev）。工程參考 DSH 官方 decoration 模板的 bundle 結構，不包含原主題的 Obsidian CSS 或字體文件；圖標爲本項目原創。
核心功能¶
- 明暗兩套 token：淺色爲紙白背景、深褐正文、冷陶棕輔助；深色爲暖墨背景、霧白正文、冷霧藍強調。明度按正文、鏈接、主按鈕與狀態提示用途調整，兼顧可讀性。
- 語義覆蓋而非新主題項：通過
ctx.theme.overrideTokens註冊顏色與標題字體 token；在 DSH 外觀裏仍選淺色、深色或跟隨系統，跟隨系統時由 DSH 監聽系統明暗並選用對應色值。正文、代碼、終端字號與字體仍由 DSH 設置控制。 - 標題字體策略：Markdown 一至三級標題默認用系統襯線；用戶設置了正文字體時，標題優先使用該字體；標題字號與行高隨 DSH 正文字號變化。
- 邊界清晰：不注入樣式表、不讀寫其他包 DOM、不下載字體；主題客戶端僅註冊 token，宿主入口爲空，不主動讀文件、訪問憑據或發起網絡請求（安裝插件與 DSH 本身可能涉及網絡或 profile 修改，屬宿主行爲）。
多主題同時啓用時，DSH 按覆蓋層註冊順序逐 token 合成，後註冊的同名 token 獲勝；要穩定外觀建議只啓用一個主題 bundle。
安裝與啓用¶
這是獨立工程，不會自行寫入 DSH 配置或目標目錄。在支持 theme.overrideTokens 的 DeepSeek Harness 中操作：
- 打開 插件 → 添加插件 → 安裝第三方插件。
- 輸入本倉庫的絕對路徑，或公開地址：
https://github.com/xwtaidev/dsh-morandi-theme
- 確認安裝後在插件管理器中啓用該 bundle；生效狀態與警告以安裝器返回爲準。更新已安裝包後可能需要重啓以加載新模塊。無需構建或安裝運行時依賴。
復現特定版本時，安裝前請覈對並固定 Git 完整提交 SHA。npm 包名 @xwtaidev/dsh-theme-morandi 僅在發佈到 npm 後可用於 npm 安裝；公開 GitHub 倉庫不等於已發佈 npm 包。第三方索引源需單獨收錄並由用戶添加，公開倉庫或 GitHub Release 不會自動上架。
從舊本地開發版遷移： 原包名爲 @local/dsh-morandi-theme，與現包名是不同插件身份。更新前備份 DSH profile，先禁用並卸載舊包，再安裝新包，確認舊條目已移除並重新測試；不要假設更名會自動升級。
典型用法¶
安裝並啓用後，在 DSH 外觀設置中選擇淺色、深色或跟隨系統即可看到對應莫蘭迪 token。禁用或卸載 bundle 會釋放其註冊的 token 層，恢復先前的主題或覆蓋層。
維護者在倉庫內用 Node 自帶測試驗證註冊與切換邏輯（不等同於 GUI 目視驗收）。需要支持 node:test 的 Node.js（建議 Node 18 或更新），無第三方依賴：
cd dsh-morandi-theme
npm test
適用場景與注意¶
適合需要在 DSH Web 端使用低飽和、紙墨感配色、且宿主已提供 theme.overrideTokens 與 @deepseek-ai/dsh-client-ui-theme 注入能力的用戶。作者報告曾手動測試本地開發版，更改包名後仍應重新安裝並驗證；README 尚未聲明完整驗收的 DSH、Node 或操作系統版本範圍。
插件以當前 DSH 進程權限運行；安裝前應閱讀源碼與 LICENSE，確認許可與行爲符合你的環境。截圖與包內對比度檢查不構成完整安全或無障礙認證。
結尾¶
Morandi · 紙與墨把 Obsidian 莫蘭迪色板收斂爲 DSH 語義 token 層，在保留 DSH 明暗與字體設置的前提下統一界面氣質。目錄與詳情可在社區插件頁查看，源碼與說明見 GitHub：
- 目錄頁：https://www.skillhub.cn/plugins/xwtaidev/dsh-morandi-theme
- 倉庫：https://github.com/xwtaidev/dsh-morandi-theme
