前言¶
在 DSH Web 界面裏，輸入框右下角的發送 / 停止生成按鈕一直是默認箭頭圖標。對長期在 Harness 裏調試 Agent、發消息的開發者來說，這塊區域視覺上是固定的，和 DeepSeek 品牌元素也沒有關聯。若你只想在不改業務邏輯的前提下，給主按鈕換一套官方鯨魚標識並在 Agent 運行時加一點動效，dsh-whale-icon 就是針對這一個控件的 Client 端換裝插件。
下面介紹插件做什麼、如何安裝，以及實現上動了哪些地方。
這是什麼¶
dsh-whale-icon（倉庫 feiniao1933/dsh-whale-icon）由維護者 feiniao1933 發佈，在社區目錄中歸類爲「趣味換裝」。它只替換會話輸入框裏主發送 / 停止按鈕的圖形與樣式：默認箭頭改爲取自 Harness primitives 的 FISH_LOGO_PATH 官方鯨魚路徑，並使用主題的 DeepSeek 藍；Agent 運行或消息發送過程中，鯨魚會遊動，並帶聲吶光暈與按鈕外發光，本輪結束後恢復靜止。
模型選擇器、權限、Plan 及其他輸入框控件保持宿主默認樣式，不涉及模型選擇或後端邏輯。
核心功能¶
依據項目 README，插件在 Web 客戶端上提供以下能力（均已在本節資料中核實）：
- 圖標與配色：主按鈕 glyph 換爲 DeepSeek 官方鯨魚標識，顏色跟隨主題的 DeepSeek 藍。
- 按鈕質感：縱向藍色漸變、頂部高光、多層投影、內高光與內陰影，懸停時鯨魚輕擺、按鈕上浮，按下時壓縮並出現內凹陰影。
- 運行態動效：會話處於運行或發送中時，鯨魚遊動，帶柔和聲吶光暈與按鈕發光；深色模式使用單獨的漸變、陰影與更亮的藍色鯨魚。
- 無障礙：尊重系統
prefers-reduced-motion，在要求減弱動態時停止遊動動畫。 - 作用範圍：僅
conversation.composer.bar內的主按鈕；其餘 composer 控件不改。
當前 package.json 版本爲 1.2.0，engines.dsh 要求 >=0.2.2-rc.1；README 寫明在 DSH 0.2.2-rc.1、macOS 上開發與驗證，且需要 Web 客戶端（dsh web 或桌面 Web 界面）並已安裝會話 UI。
安裝與啓用¶
插件無獨立安裝腳本，除宿主 Web 客戶端外無額外依賴。安裝前請自行查閱倉庫源碼與 MIT 許可證；插件以當前 DSH 進程的權限在瀏覽器端執行 Client 注入，不發起網絡請求、不保存數據，但仍建議在信任來源的前提下安裝。
先做 profile 確認：下面命令裏的 web 需換成你實際使用的 DSH profile 名稱。
從公開 Git 倉庫安裝：
dsh plugin --profile web add github:feiniao1933/dsh-whale-icon
若希望安裝可復現，可固定到某一提交（將 <commit> 換爲具體 hash）：
dsh plugin --profile web add git+https://github.com/feiniao1933/dsh-whale-icon.git#<commit>
經過上面的步驟，Client 會通過 cordis.patch.yml 注入到 @deepseek-ai/dsh-client-ui-conversation，dsh.client.immediately 爲 true，無需再單獨寫配置文件項。重啓或刷新 Web 客戶端後，在會話輸入框主按鈕上即可看到藍鯨樣式。
典型用法¶
本插件不提供 CLI 子命令或額外配置字段，典型用法就是安裝到 Web profile 後正常使用 DSH 會話：發送消息、在 Agent 運行中點擊停止，觀察按鈕在靜止、懸停、按下、發送與運行幾種狀態下的外觀與動畫。
驗證步驟可簡化爲：
- 啓動帶 Web UI 的 DSH（
dsh web或桌面 Web 界面）。 - 打開任意會話，查看輸入框右下角主按鈕是否爲藍色鯨魚而非默認箭頭。
- 發送一條會觸發 Agent 運行的消息，確認運行期間鯨魚遊動與光暈；回合結束後恢復靜止。
實現方式（便於排查）¶
README 說明發送按鈕由 ui-conversation 在 conversation.composer.bar 插槽內渲染，沒有單獨圖標插槽。Client 端大致三步：
- 通過穩定的
data-slot錨點與_primary類定位主按鈕，將圖形替換爲官方鯨魚路徑。 - 在
conversation.composer.dock註冊不可見小組件，用useSessionStatus讀取當前會話運行狀態並同步到文檔。 - 由 CSS 根據該狀態驅動靜止、懸停、按下、發送與運行等外觀。
全部爲瀏覽器端本地邏輯：無 HTTP 路由、無網絡請求、不改模型選擇。鯨魚路徑來自 DeepSeek Harness 品牌 primitives；DeepSeek 名稱與鯨魚標識歸 DeepSeek 所有。
適用場景與注意¶
適合誰：使用 DSH Web 界面、希望在不動業務插件的前提下給發送 / 停止按鈕做品牌向趣味換裝的開發者。
不適合或需注意：
- 僅面向 Web Client（
dsh.client.platform爲web），非 Web 會話界面不會生效。 - 宿主 DSH 版本需滿足
>=0.2.2-rc.1，與 README 中的測試版本不一致時，樣式或錨點可能因上游 UI 變更而失效，需對照倉庫 Issue 或自行適配。 - 社區目錄 skillhub.cn 上的條目 與 GitHub 一樣屬於社區收錄，並非 DeepSeek / 幻方官方應用商店；安裝命令與行爲以倉庫 README 爲準。
結尾¶
dsh-whale-icon 把改動範圍收斂到輸入框主按鈕：官方藍鯨圖標、立體按鈕樣式，以及在 Agent 運行時的遊動反饋，其餘 composer 控件保持默認。若需要查閱元信息或提 Issue，可使用目錄頁 https://www.skillhub.cn/plugins/feiniao1933/dsh-whale-icon 與源碼倉庫 https://github.com/feiniao1933/dsh-whale-icon 。
