前言¶
在 DeepSeek Harness（DSH）里長時間寫提示、調會話，界面大多仍是宿主默認的淺色或深色面板。社區裏已有若干主題類插件，多半隻做配色或少量裝飾。若你希望側欄、輸入框和彈窗統一成石墨玻璃質感，背景裏還有可調的流體粒子與鼠標彈性網格，又能在設置裏一鍵關掉、不改動原本的淺色 / 深色偏好，「高達 · 石墨」（dsh-gundam-graphite-theme）就是針對這類需求的客戶端皮膚插件。下面按定位、功能、安裝與設置說明用法。
這是什麼¶
「高達 · 石墨 / Gundam Graphite」由維護者 machi12 發佈，在 SkillHub 插件目錄 中歸類爲趣味換裝類；倉庫見 GitHub。當前包版本爲 1.0.1（以 package.json 爲準）。
插件是 客戶端主題（platform: web）：在桌面版與 Web 版共用同一套客戶端注入機制，不修改 Electron 的 app.asar，也不是預加載層注入。它內置黑灰機甲壁紙，把宿主側欄、輸入卡、設置彈窗等面板統一爲半透明石墨色，並在背景層疊加銀灰粒子、視差、呼吸燈與可選的鼠標彈性網絡。關閉「啓用石墨皮膚」即可恢復原生外觀。
核心功能¶
壁紙與面板¶
- 內置 1672×941 黑灰機甲圖，按窗口比例裁切；左側壓暗、右側漸顯，正文區域保持可讀。
- 壁紙遮罩 0–85%、壁紙虛化 0–16px 可調，用於平衡氛圍與文字對比度。
- 石墨玻璃面板：側欄、輸入框、彈窗等 不透明度 60–100% 可調（默認約 86%）。
動效（均可單獨或成組關閉）¶
- 景深視差：鼠標移動時遠景煙塵與近景機體反向位移，相對位移最多約 6px。
- 紅光呼吸與火星：眼部與裝甲燈條緩慢呼吸；流體開啓時，燈附近偶爾出現少量暗紅火星。
- 流體粒子：流場、渦旋、星雨三種軌跡；亮度、數量（20–240）、速度（0.15–2×）可調。
- 鼠標彈性網絡：五種交互模式（排斥回彈、吸引回彈、漣漪擴散、旋渦扭轉、呼吸脈衝）；影響半徑 80–320px、強度 0–100%。觸摸設備（
pointer: coarse）自動關閉該功能。
宿主行爲與性能¶
- 主題啓用期間臨時以深色呈現，不改寫用戶原有的淺色 / 深色偏好；關總開關即恢復。
- 動效幀率上限 20–60fps（默認 30）；頁面隱藏、最小化或系統「減少動態效果」時暫停。
- 設置通過 DSH 宿主持久化，重啓後保留，不依賴
localStorage。 - 背景圖層不攔截鼠標事件，並對輔助技術標記爲
aria-hidden。
環境要求¶
需要 DeepSeek Harness 0.2.0-rc.2 及以上（engines.dsh >= 0.2.0-rc.2）。
安裝與啓用¶
任選一種方式安裝後，需完全退出並重新打開 DSH（桌面版關窗口可能只是進托盤）；Web 版刷新頁面即可。裝好後路徑：設置 → 通用設置 → 高達 · 石墨。
方式一：插件市場（README 推薦）¶
DSH 插件市場 → 分類「主題」→「高達 · 石墨」→ 安裝，然後重啓應用。
方式二：Release 包（離線 / 內網）¶
從 Releases 下載 dsh-gundam-graphite-theme.tgz，在本機執行：
dsh plugin add ./dsh-gundam-graphite-theme.tgz
方式三：從 GitHub 安裝¶
dsh plugin add github:machi12/dsh-gundam-graphite-theme
若使用 pnpm 且首次安裝提示將 dsh-gundam-graphite-theme 加入 allowBuilds，按提示加入後重試即可；包內已帶預構建的 lib/，一般無需本地編譯。指定配置時可加 --profile <name>（桌面版示例路徑以本機安裝目錄爲準）：
& 'D:\dsh\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add github:machi12/dsh-gundam-graphite-theme
首次安裝需要包管理器能拉取依賴 @deepseek-ai/schemastery；壁紙與動效資源內嵌在包內，不訪問外部圖片服務。
典型用法¶
只要壁紙、不要動效¶
在設置面板關閉 動效總開關：靜態壁紙保留，粒子、彈性網絡、呼吸與視差全部停止。
調節可讀性¶
壁紙過亮或過暗時，調高 壁紙遮罩 或 面板不透明度；需要弱化背景細節時可增加 壁紙虛化。
臨時停用皮膚¶
不必卸載：關閉 啓用石墨皮膚 即恢復宿主原生外觀。卸載時使用：
dsh plugin remove dsh-gundam-graphite-theme
設置項概覽¶
主題面板共 16 項，改動實時生效並自動保存。下表爲 README 中的默認值與範圍摘要：
| 設置 | 默認 | 範圍 / 選項 |
|---|---|---|
| 啓用石墨皮膚 | 開 | 開 / 關 |
| 動效總開關 | 開 | 開 / 關 |
| 流體與粒子 | 開 | 開 / 關 |
| 鼠標彈性網絡 | 開 | 開 / 關 |
| 壁紙景深視差 | 開 | 開 / 關 |
| 粒子流動類型 | 流場 | 流場 / 渦旋 / 星雨 |
| 網絡交互模式 | 排斥回彈 | 五種模式 |
| 壁紙遮罩 | 40% | 0–85% |
| 壁紙虛化 | 6px | 0–16px |
| 面板不透明度 | 86% | 60–100% |
| 流體亮度 | 40% | 0–100% |
| 粒子數量 | 100 | 20–240 |
| 流動速度 | 0.65× | 0.15–2× |
| 網絡彈性強度 | 50% | 0–100% |
| 鼠標影響半徑 | 180px | 80–320px |
| 動效幀率上限 | 30fps | 20–60fps |
宿主未連接時，控件會顯示爲不可用。
適用場景與注意¶
適合誰：希望在 DSH 主界面獲得統一黑灰機甲氛圍、又能在設置裏細調粒子與網格交互的開發者；需要內網離線裝包時可用 Release 的 .tgz。
插件權限：客戶端插件隨 DSH 進程在本地 Web 界面中運行，安裝前建議查看倉庫源碼與許可證。代碼以 MIT 發佈；壁紙爲作者提供的圖片，不包含在 MIT 範圍內，對外分發或商用前需自行確認圖片授權（見倉庫 THIRD_PARTY_NOTICES.md）。
兼容性邊界：不改動 Electron 原生窗口邊框、也不保證覆蓋第三方插件自繪面板；DSH 大版本若調整主題變量或會話容器，可能需要插件適配。
常見問題：裝完無變化時，確認已完整重啓或刷新；與淺色偏好不衝突——僅在使用皮膚期間臨時深色顯示。
結尾¶
「高達 · 石墨」把壁紙、石墨玻璃面板與可調 Canvas 動效收進一個客戶端主題，總開關與動效分離開關讓回退成本很低。目錄頁：https://www.skillhub.cn/plugins/machi12/dsh-gundam-graphite-theme；源碼與完整說明：https://github.com/machi12/dsh-gundam-graphite-theme。SkillHub 爲社區插件目錄，與 DeepSeek / 幻方無官方從屬關係。
