前言¶

DSH 0.1.x 尚未暴露公開 icon resolver，部分 settings 與 sidebar 目標在沒有可靠匹配或原始圖標時，會回退到同一個 Settings 齒輪。dsh-icon-theme 用於在 DSH 的 settings 與 sidebar 表面上自動發現可圖標化的目標，並讓用戶按穩定鍵選擇或恢復圖標。

這是什麼¶

dsh-icon-theme 是 yzke 發佈、MIT 許可的 DSH 插件，面向 DeepSeek Harness 的 settings 與 sidebar 表面，提供自動發現、用戶可自定義的圖標。它適合需要處理 settings.section 與 sidebar.footer.action 圖標一致性的 DSH 0.1.x 環境。

核心功能¶

下面介紹插件明確提供的能力。

• 自動發現 live 的 settings.section 與 sidebar.footer.action 貢獻；當側邊欄部分渲染且無法按順序關聯時，使用 audited per-plugin 記錄。
• 按穩定鍵保存圖標選擇，例如 settings.section:market；不使用翻譯標籤或 DOM 位置作爲持久化依據。
• 內置 121 個字形：50 個 Fluent UI 16 Regular 字形、70 個官方 DSH UI 字形，以及 1 個 audited monochrome dsh-market 字形。
• 運行時不使用 icon CDN、webfont、Iconify API、GitHub 請求或包掃描。
• 卸載或熱重載時恢復所有 host SVG，並移除自有 DOM 標記和樣式。
• 對未渲染貢獻和非圖標卡片只報告，不假裝已更改。
• 當目標沒有可靠匹配且沒有原始圖標時，回退到 Settings 齒輪。
• 頁面列出已發現目標、穩定鍵、兼容狀態和當前圖標來源；支持按功能名、ID 或圖標搜索，篩選 Settings、sidebar、unrecognized、customized 條目，選擇字形，以及恢復單個或全部目標爲自動行爲。
• Settings 使用固定命名空間、同源 Host endpoint，只接受 overrides 和 originalPolicy；不能讀取或修改其他插件命名空間。

安裝與啓用¶

先使用插件命令安裝：

dsh plugin --profile web add dsh-icon-theme

安裝後重啓 dsh web，再打開：

Settings → Icons

如果從源碼安裝，執行以下步驟：

git clone https://github.com/yzke/dsh-icon-theme.git
cd dsh-icon-theme
npm ci
npm run build
dsh plugin --profile web add link:"$PWD"

源碼構建需要 Node.js 22 或更新版本。

支持的 DSH peer range 是：

>=0.1.0-rc.6 <0.2.0-0 || >=0.1.1-rc.0 <0.2.0-0 || >=0.1.2-alpha.1 <0.2.0-0

該範圍包含 source-only dsh-v0.1.2-alpha.1 GitHub preview。

卸載時使用：

dsh plugin --profile web remove dsh-icon-theme

然後重啓 dsh web。插件會在卸載時恢復所有 host SVG，並移除自有 DOM 標記和樣式。

典型用法¶

啓用後，在 Settings → Icons 頁面中完成以下操作：

1、按功能名、ID 或圖標搜索目標。

2、篩選 Settings、sidebar、unrecognized 或 customized 條目。

3、爲單個目標選擇字形。

4、恢復單個目標或全部目標爲自動行爲。

當 dsh-better-sidebar 已安裝時，它的 Settings 行圖標默認作爲可信原始圖標保留；只有用戶選擇 replace-generic 或手動覆蓋時才替換。

適用場景與注意¶

適合在 DSH 0.1.x 中使用 settings.section 或 sidebar.footer.action 貢獻，並希望減少統一齒輪迴退的場景。

需要注意：

• 檢測只讀取 DSH slot metadata 和兩個渲染 UI 表面；不檢查用戶文件或其他插件 bundles。
• DSH 0.1.x 尚未暴露公開 icon resolver，因此兼容層 intentionally narrow and reversible。
• sidebar fallback fingerprints 固定到上游修訂版本，可能需隨插件 DOM 變化定期更新。
• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼、依賴與 MIT 許可證。

鏈接¶

GitHub：

https://github.com/yzke/dsh-icon-theme