前言¶

在開發基於 DeepSeek Harness (DSH) 的智能體時，經常會遇到需要處理顏色格式、計算對比度或生成配色方案的場景。如果直接讓大模型輸出 RGB 值往往不夠精確，或者需要手動編寫轉換邏輯。DSH 的插件生態提供瞭解決這一途徑。

插件簡介¶

dsh-color 是一個 DSH 客戶端插件，由用戶 uckkk 維護。它使用純 Node.js 實現，專注於顏色處理。

核心功能¶

該插件提供以下能力：

• 顏色格式互轉：支持 Hex、RGB、HSL 三種格式之間的相互轉換。
• 輔助計算：提供補色計算、明暗計算以及前景文字對比度計算。

安裝與啓用¶

安裝該插件需要使用 DSH CLI。

1. 執行安裝命令：

    dsh plugin add dsh-color

或者通過 GitHub 倉庫安裝：

    dsh plugin add github:uckkk/dsh-color

2. 安裝後，需要在項目的 profile 目錄下的 package.json 中配置 dsh.profile.bundles。在配置文件中添加 "dsh-color" 字段，以將其加載到運行環境中。

典型用法¶

安裝成功後，在 DSH 會話中即可調用插件註冊的工具。例如，查詢某個 Hex 顏色的 RGB 和 HSL 值，以及推薦的前景文字顏色：

這個顏色 #3b82f6 的 rgb 和 hsl 是什麼，配什麼文字顏色
→ 調用 color_convert(color="#3b82f6")

適用場景與注意事項¶

• 適用場景：該插件適合需要生成高可讀性的 UI 配色，或者進行精確的顏色數值計算的智能體開發。
• 安全注意：安裝即在本機運行第三方代碼，請自行審閱源碼（GitHub 倉庫）。
• 依賴要求：該插件依賴 @deepseek-ai/cordis (>= 4.0.1) 和 @deepseek-ai/dsh-tools (>= 0.1.0-rc.6)。

總結¶

dsh-color 通過封裝純 Node.js 的計算邏輯，爲 DSH 提供了精確的顏色處理能力。開發者可以在智能體開發中直接調用其接口，無需重複造輪子。更多細節可查閱 SkillHub 目錄 或 GitHub 倉庫。