前言¶
DeepSeek Harness (DSH) 的 Web profile 在展示工具調用卡片時使用 SVG 圖標作爲前導標識。dsh-tool-emoji 插件通過注入樣式，將這些 SVG 圖標替換爲 Emoji，同時保留卡片的所有原始內容（標題、摘要、終端輸出等），不改變 DSH 的原有邏輯。
插件介紹¶
該插件由 LWLAymh 維護，採用 MIT 許可證。它不註冊 tool.call.toolview，而是僅注入一個全局樣式表，通過 CSS 隱藏內置 SVG 圖標並在同一位置渲染 Emoji。
核心功能¶
- 圖標替換：根據工具類型將前導圖標替換爲 Emoji。
- 內容保留：不移除或替換原始卡片內容。
- 錯誤狀態：在工具出錯時，前導圖標顯示 😫。
- 自定義配置：支持在 DSH 設置頁面自定義 Emoji 或上傳圖片（PNG/JPEG/GIF/WebP/BMP）作爲圖標。
- 兼容性：支持
dsh-edit-guardian兼容性。
安裝與啓用¶
- 運行安裝命令：
dsh plugin --profile web add git+https://github.com/LWLAymh/dsh-tool-emoji.git
- 重啓 Web profile 以使更改生效：
dsh --profile web
插件不支持熱重載，必須在安裝後重啓進程。
典型用法¶
- 在 DSH 設置頁面打開 Tool emoji 面板。
- 使用獨立開關控制特定工具的圖標顯示，或使用主開關控制插件整體啓用/禁用。
- 在自定義輸入框中輸入任意 Emoji 或文本。
- 上傳本地圖片作爲圖標（注意：圖片僅存儲在
localStorage中，單張最大 1MB，不支持 SVG）。 - 使用 Reset 按鈕可重置爲默認 Emoji。
適用場景與注意¶
- 適用範圍：僅適用於 Web profile。TUI 和 headless profile 沒有圖標 UI 表面，無法顯示該插件效果。
- 依賴關係：插件依賴官方 DOM 結構（如
data-tool、data-variant屬性）。若未來 DSH 版本更改這些結構，CSS 選擇器可能失效。 - 兼容性細節：若使用
dsh-edit-guardian，需確保使用暴露data-tool屬性的構建版本，否則 Emoji 不會應用到edit或pwsh等行。
結尾¶
dsh-tool-emoji 提供了一種輕量級的視覺定製方式，適合希望在不修改代碼的情況下調整 DSH 工具卡片展示的開發者。
