前言¶

在使用 DeepSeek Harness Web 進行調試或開發時，默認的發送按鈕圖標較爲通用。若希望將主發送按鈕替換爲 DeepSeek 官方鯨魚 Logo，可以使用此插件。

核心功能¶

1. 圖標替換：將對話輸入欄的主發送按鈕圖標替換爲鯨魚 Logo。
2. 行爲保持：不改變發送、停止等按鈕的實際交互邏輯，僅修改外觀。
3. 樣式實現：利用 CSS mask 疊加官方鯨魚圖形，顏色跟隨按鈕文字色（currentColor）。
4. 主題適配：支持亮色和暗色主題，圖標顏色會自動切換。
5. 精準覆蓋：純瀏覽器端樣式覆蓋，零依賴，不誤傷停止按鈕、隊列按鈕等其他圖標。

安裝與啓用¶

本插件通過本地包安裝，本質是執行 pnpm add，會將插件寫入 dsh.profile.bundles。

# 在 web profile 下安裝
dsh plugin --profile web add <路徑>/dsh-external-ds-whale-send-button-0.1.0.tgz

# 驗證配置是否寫入
dsh --profile web --dump-config

# 重啓服務使配置生效

動態用法（臨時）¶

在「創造模式」會話中，可以通過定義 lib/client.js 的插件對象並調用 cordis_run 來臨時加載此插件。注意，這種方式重啓服務後插件會丟失。

卸載¶

dsh plugin --profile web remove @dsh-external/ds-whale-send-button

工作原理¶

插件註冊爲 browser roster 的 client 包。初始化時會向 document.head 注入一段帶 data-plugin-css 標籤的 <style>。

1. 定位：使用 [data-composer-card] 選擇器配合發送箭頭 path 的唯一 d 前綴精確定位主發送按鈕。
2. 隱藏：隱藏原上傳箭頭的 SVG 元素。
3. 疊加：使用 CSS mask 疊加 DeepSeek 官方鯨魚圖形（路徑來自 dsh 自帶的 favicon.svg）。
4. 顏色：設置 background-color: currentColor，使鯨魚顏色隨按鈕文字色變化。

自定義¶

若需調整圖標樣式，修改 lib/client.js 中的參數：
- width/height：設置圖標大小（默認 16px）。
- background-color：設置固定顏色（如 DeepSeek 藍）。
- mask：調整圖標縮放方式。

修改後重新打包並使用 dsh plugin --profile web add 更新。

注意事項¶

• 僅支持 web profile。
• 本地包安裝方式需要重啓服務才能生效。
• 動態插件方式重啓即丟失。

結語¶

此插件通過純 CSS 方式實現了 UI 定製，適合需要在 DSH Web 界面中強化 DeepSeek 品牌感知的開發者。