在 DeepSeek Harness(DSH)的 Web GUI 開發中,將矢量 SVG 圖標轉換爲像素風格通常需要手動重繪或複雜的 CSS 處理。dsh-pixel-icons 插件通過運行時修改,解決了這一痛點,能將界面圖標統一轉換爲 1px 像素塊風格。
插件定位¶
dsh-pixel-icons 是由 TableRogue 維護的趣味換裝類插件。它不依賴構建步驟,通過運行時修改 DOM 節點實現圖標風格轉換,同時保留 React 節點的 identity,不破壞界面交互邏輯。
核心功能¶
- 圖標光柵化:運行時將所有
fill="currentColor"的 SVG 圖標重建爲 1px 像素塊。 - 高質量處理:採用 3× 超採樣配合塊平均算法,確保細線連續、粗細均勻。
- 智能過濾:自動跳過功能性 SVG 元素(如進度環),不影響 UI 邏輯。
- 無侵入修改:原地修改 DOM,保留 React 節點 identity,側欄摺疊等交互正常。
安裝與啓用¶
安裝後插件會自動追加進 profile 的 dsh.profile.bundles,啓動 dsh --profile web 即生效。
dsh plugin --profile web add github:TableRogue/dsh-pixel-icons
配置與調參¶
插件支持通過配置項微調像素化效果。修改配置後需刷新頁面重新光柵化。
- SCALE:超採樣倍數(默認 3)。數值越小,像素顆粒越大;數值越大,線條越精細。
- 0.35:塊平均覆蓋率閾值。調整此值可改變細線跨塊的判定邏輯。
使用示例¶
安裝後,可以通過以下命令驗證插件是否生效:
dsh --profile web --dump-config
在輸出配置中查找 # == dsh-pixel-icons 層即可確認。
臨時使用方式¶
若需臨時測試或單次進程使用,可將 src/client.js 文件頭註釋中的內容提取出來,填入 cordis_define 的 code.client 中執行 cordis_run。
結尾¶
dsh-pixel-icons 體現了 DSH “一切皆插件” 的理念。安裝前建議檢查源碼與許可證(MIT)。