DeepSeek Harness (DSH) 的 Web 界面通過插件機制支持功能擴展。針對界面視覺定製，社區提供了 TangSan 插件。它不改變底層邏輯，僅通過覆蓋樣式和注入資源，將生成的唐三形象作爲背景、品牌標識和設置入口。
這是什麼¶
TangSan 是一個爲 DSH Web GUI 提供的唐三形象美化層。由用戶 bauerelizabeth07139 維護，採用 MIT 許可證。它將一張 16:9 的唐三插畫作爲界面背景，並將方形頭像注入爲側邊欄和會話標題的品牌標識，同時提供一套可視化的設置面板來調整外觀參數。
核心功能¶
-
聊天背景
插件內置的 16:9 藝術品被掛載爲全屏背景層。該層固定且不可點擊。同時，插件會降低界面表面（Shell）的透明度，使背景圖透出來，而不是被不透明的界面遮擋。 -
外觀控制
通過設置面板實時調整以下參數：- 不透明度：控制界面表面（如側邊欄、對話框）的透明度，數值越低背景越明顯。
- 模糊：對背景圖應用高斯模糊效果。
- 暗色遮罩：在背景上覆蓋一層與主題色匹配的遮罩（暗色模式下爲黑色，亮色模式爲白色），用於提升文字可讀性。
- 位置：調整背景圖的
background-position。
-
品牌標識替換
通過官方插槽sidebar.brand.mark和conversation.hero.brand.mark，將默認的 Logo 替換爲插件自帶的唐三方形頭像。 -
獨立設置頁
在 DSH 的設置菜單中新增「唐三美化 TangSan」頁面。該頁面提供參數預覽、開關和保存功能，是管理插件外觀的唯一入口。 -
標籤頁圖標
當品牌標識開啓時，瀏覽器標籤頁的 favicon 會跟隨唐三頭像；關閉後恢復默認圖標。 -
本地服務
插件通過 DSH Web 服務器提供資源（/api/tangsan/...），瀏覽器無需訪問外部網絡即可加載圖片和配置。
安裝與啓用¶
CLI 安裝（Web Profile）¶
在終端執行以下命令安裝到當前啓動的 Web 配置文件：
dsh plugin --profile web add bauerelizabeth07139/tangsan
桌面應用安裝¶
桌面版應用通過內置插件管理器安裝：
- 打開 Plugins（插件）面板。
- 選擇 Add plugin（添加插件）。
- 輸入插件地址：
https://github.com/bauerelizabeth07139/tangsan
- 在新出現的 tangsan 條目中點擊啓用。
注意：DeepSeek Harness Desktop 啓動時使用的是 desktop 配置文件，而上述 CLI 命令默認安裝到 web 配置文件。因此，直接在桌面應用中通過 CLI 安裝不會生效，必須使用應用內的插件管理器。
無 Git 環境¶
如果系統未安裝 Git，owner/repo 形式的安裝命令會報錯（git is not recognized）。此時應使用 HTTPS 方式安裝：
dsh plugin --profile web add https://codeload.github.com/bauerelizabeth07139/tangsan/tar.gz/main
典型用法¶
安裝並啓用插件後：
- 打開 Settings（設置）。
- 找到 唐三美化 TangSan 頁面。
- 根據喜好調整壁紙不透明度、模糊程度和遮罩。
- 保存設置，界面會立即應用新樣式。
卸載時使用 CLI：
dsh plugin --profile web remove tangsan
注意事項¶
-
配置文件路徑
插件的配置文件默認位於$DSH_HOME/tangsan.json（即~/.dsh/tangsan.json）。該文件也可通過 HTTP 接口訪問。 -
Manifest 語法錯誤
插件加載器在啓動時會解析配置文件，如果 manifest JSON 開頭出現多餘逗號（, {），會導致 Harness 崩潰。桌面版的“禁用第三方插件”功能無法修復此問題，需要手動編輯文件刪除該逗號。 -
Git 依賴
使用dsh plugin安裝時，底層依賴pnpm，它會調用git ls-remote。確保 PATH 中包含 Git 可執行文件，否則無法通過簡寫地址安裝。
短結尾¶
TangSan 插件爲 DSH Web 界面提供了一套完整的視覺主題方案，涵蓋了背景、圖標和交互控件。它通過本地服務提供資源，保持了界面的純淨與穩定。更多細節和源碼，可參考其 GitHub 倉庫。
