前言¶
DeepSeek Harness（DSH）的聊天界面默認樣式由客戶端主題決定，長時間對着同一套背景工作時，不少人希望在不改 DSH 核心主題 token 的前提下，單獨調整聊天區的氛圍、可讀性和一點個性化細節。社區插件 dsh-chat-skin（聊天外觀工坊）面向 Web / Desktop 客戶端，通過 bundle + client 雙半結構注入樣式與配置界面：背景、遮罩、毛玻璃、動畫、字體和 emoji 圖標均可實時預覽，配置寫在本機，重啓後仍保留。
下面介紹插件定位、能力與安裝方式，並給出文檔中的可復現用法與使用注意。
這是什麼¶
dsh-chat-skin 由維護者 huangyuanhu3-dev 發佈，在 SkillHub 社區目錄中歸類爲「趣味換裝」。插件不依賴第三方運行時包，Host 半邊僅使用 Node 內建模塊；客戶端通過 Cordis patch 掛載，自帶 cordis.patch.yml，無需手寫 Host/Client 行。
一句話：給 DSH 聊天區（可選整個應用界面）換背景並微調玻璃質感、字體與圖標，所有改動本地持久化，不進入對話或模型上下文。
核心功能¶
背景¶
- 8 套內置氛圍：深海鯨歌、極光夜航、櫻花微光、賽博霓虹、紙感留白、苔原森林、落日航線、極夜極簡。
- 支持自定義 CSS 漸變、純色、圖片 URL；可上傳本地壁紙（PNG / JPEG / WebP / GIF / AVIF，最大 12 MiB），文件只保存在本機。
- 鋪法（鋪滿 / 完整 / 平鋪）、位置、不透明度、亮度、飽和度、對比度、模糊、暗角均可調。
作用範圍與全局玻璃¶
- 作用範圍可在「聊天區」與「整個應用」之間切換。
- 「整個應用」模式下，側邊欄、設置面板、右側欄共用可調玻璃材質：色調、側欄透明度、設置面板透明度、模糊、描邊、陰影；面板色調可跟隨背景自動取色或單獨指定。聊天區透明後，壁紙可鋪到側欄和設置頁背後。
深淺、文字與氣泡¶
- 遮罩深淺 0–95%，遮罩顏色可調。
- 文字明暗可隨背景亮度自動切換，也可強制淺色字 / 深色字。
- 聊天氣泡與輸入框支持毛玻璃，以及氣泡不透明度、描邊、陰影。
CSS 動畫與高級樣式¶
- 內置緩慢漂移、呼吸縮放、橫向移動、輕輕起伏、極光流動等效果；週期、幅度、緩動可調，並尊重系統「減少動態效果」。
- 「高級 → 自定義 CSS」可寫
@keyframes與任意選擇器，樣式追加在插件規則之後，可覆蓋內置規則。
字體與圖標¶
- 字體：系統 / 微軟雅黑 / 宋體 / 楷體 / 圓體 / 等寬，或自定義
font-family；字號、行高、字間距、字重可設，代碼字體可單獨指定。 - 圖標：助手 / 用戶 / 運行中三個 emoji；可選消息頭像（窄屏自動隱藏）；運行中圖標可替換爲任意 emoji。
入口¶
- 設置 →「聊天外觀」完整頁面。
- 右上角快捷面板：開關、4 套預設、遮罩、模糊、動畫、字體。
安裝與啓用¶
README 未給出 dsh plugin add github:… 一類遠程一鍵命令；安裝方式爲將包目錄納入當前 profile 的 bundle 列表。先做目錄放置，再在 profile 中聲明依賴並加入 bundles，最後重啓或熱加載。
- 把
dsh-chat-skin目錄放到 profile 可解析的位置，例如：
$DSH_HOME/profiles/<profile>/vendor/dsh-chat-skin
- 在該 profile 的
package.json中加入依賴：
"dsh-chat-skin": "file:./vendor/dsh-chat-skin"
-
將
"dsh-chat-skin"寫入dsh.profile.bundles。 -
重啓 DSH，或通過插件管理器熱加載 bundle。
package.json 中聲明 Node >= 22.12.0；當前包版本爲 1.0.0，許可證 MIT。
數據與 Host 路由¶
- 配置：
$DSH_HOME/dsh-chat-skin/config.json - 上傳壁紙：
$DSH_HOME/dsh-chat-skin/assets/ - 瀏覽器即時緩存：
localStorage["dsh-chat-skin:v1"]
Host 註冊三條同源路由：GET/POST /dsh-chat-skin/api（讀寫配置）、POST /dsh-chat-skin/upload?name=…（上傳壁紙）、GET /dsh-chat-skin/asset/<file>（讀取壁紙）。寫請求帶同源檢查；上傳僅接受白名單圖片類型。
典型用法¶
快捷預設與完整頁¶
日常可在右上角 🎨 面板快速開關皮膚、套用 4 套預設並微調遮罩、模糊、動畫與字體；需要細調背景鋪法、全局玻璃或高級 CSS 時，進入設置 →「聊天外觀」。
自定義 CSS 示例¶
在「高級 → 自定義 CSS」中粘貼 README 示例即可本地驗證效果：
/* 讓背景緩慢左右流動 */
[data-conversation-region="chat"]::before {
animation: myFlow 22s ease-in-out infinite alternate !important;
}
@keyframes myFlow {
from { transform: scale(1.08) translate3d(-2%, 0, 0); }
to { transform: scale(1.12) translate3d(2%, 0, 0); }
}
/* 給助手消息加一條左側光線 */
[data-chat-flow-kind="assistant"] {
border-left: 1px solid color-mix(in srgb, #22d3ee 38%, transparent);
padding-left: 14px;
}
插件依賴穩定 DOM 鉤子（如 data-conversation-region="chat"、data-chat-flow-kind），不綁定構建時哈希類名；氣泡玻璃通過 [class*="_bubble"] 等子串探針做漸進增強，選擇器不匹配時僅少一層玻璃，不會拋錯。
適用場景與注意¶
適合誰： 長期在 DSH Web / Desktop 上對話、希望本地個性化聊天背景與可讀性，且接受配置與壁紙不同步到其他設備的用戶。
生態說明： DSH 奉行「一切皆插件」；SkillHub 目錄頁（https://www.skillhub.cn/plugins/huangyuanhu3-dev/dsh-chat-skin）是社區站點，與 DeepSeek / 幻方無官方從屬關係。
權限與安全： 插件以當前 DSH 進程權限運行，安裝前建議閱讀倉庫源碼與 MIT 許可證，確認上傳與靜態文件路由行爲符合你的環境策略。
已知限制（來自 README）：
- 玻璃效果依賴 DSH 現有的
_bubble/_composer類名片段；大改版後背景、字體、圖標仍可用，玻璃可能失效。 - 「整個應用」實驗模式會把背景鋪到
#root，不透明面板仍可能遮住部分背景。 - 未修改 DSH 主題 token，light / dark 仍由 DSH 自身切換；建議在兩種主題下各檢查一次對比度。
結尾¶
dsh-chat-skin 把聊天背景、遮罩、毛玻璃、動畫、字體和 emoji 圖標收進同一套本機配置，實時生效且重啓保留，適合作爲 DSH 客戶端側的「趣味換裝」類插件使用。
- 社區目錄：https://www.skillhub.cn/plugins/huangyuanhu3-dev/dsh-chat-skin
- 源碼與完整說明：https://github.com/huangyuanhu3-dev/dsh-chat-skin
