前言¶
DSH 的插件生態裏，Web 端的狀態提示可以做得更具體。dsh-whale-animation 針對 DeepSeek Harness Web 的 turn status，加入六組原創鯨魚循環動畫，並用一個輕量 animation director 在定時播放和關鍵詞覆蓋之間切換。下面介紹它的已覈實能力、安裝方式和使用注意。
這是什麼¶
LeemanCheung/dsh-whale-animation 由 LeemanCheung 維護，採用 MIT 許可證。
它做的事情是爲 DSH Web 的 turn status 增加視覺狀態：六隻原創鯨魚循環動畫，以及一個輕量動畫 director。已覈實事實中說明其範圍是 strictly visual：no accounts, model tools, storage, workspace reads, networking, or user-content processing。
核心能力¶
下面幾項是插件已覈實提供的能力：
- 六個動畫狀態：Deep Dive、Sonar、Tool Run、Stream、Calm、Retry。
- 定時播放：每 9 秒輪換一次 playlist。
- 關鍵詞覆蓋：當出現可識別的 search、tool、writing、waiting 或 error 文本時，關鍵詞檢測會覆蓋定時 playlist；包含英文和中文關鍵詞。
- Reduced motion 回退：按狀態使用 matching PNG frames；系統啓用 reduced motion 時停止 playlist 輪換，並使用 matching PNG frame。
- 主題和視口支持：支持 dark-theme，並在 84 / 72 / 60 px 三檔顯示尺寸下適配。
- 自包含資源：內置 WebP 和 PNG assets；zero runtime external requests；activation makes no external request。
- 嚴格視覺範圍：不包含賬號、模型工具、存儲、workspace reads、networking 或用戶內容處理。
安裝與啓用¶
下面命令將固定版本 v0.4.0 安裝到 DSH Web profile：
dsh plugin --profile web add github:LeemanCheung/dsh-whale-animation#v0.4.0
如果希望跟隨 main branch，可以使用：
dsh plugin --profile web add github:LeemanCheung/dsh-whale-animation
安裝後，需要對 DSH Web 執行 hard-refresh。如果當前 profile 已經緩存了 client bundle，重啓 DSH。
升級與卸載¶
升級時先移除，再重新安裝：
dsh plugin --profile web remove dsh-whale-animation
dsh plugin --profile web add github:LeemanCheung/dsh-whale-animation#v0.4.0
卸載命令爲：
dsh plugin --profile web remove dsh-whale-animation
開發與驗證依賴¶
開發和驗證要求 Node.js 20+。
重新生成動畫和文檔資產還需要 Python 3 和 Pillow。
package.json 中聲明的 peerDependencies 爲：
{
"@deepseek-ai/cordis": "^4.0.1",
"@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6"
}
適用場景與注意¶
適合的場景：
- 你希望給 DSH Web 的 turn status 增加更直觀的視覺反饋。
- 你希望插件在 reduced motion、dark theme 和不同視口下保持可讀。
- 你希望動畫資源自包含，運行時不發起外部資源請求。
- 你只需要視覺狀態，不引入賬號、模型工具、存儲、workspace reads、networking 或用戶內容處理。
需要注意：
- 插件以當前 dsh 進程權限運行；安裝前應檢查源碼和 MIT 許可證。
- 本文使用的安裝命令固定到
v0.4.0；如需跟隨 main branch，使用不帶#v0.4.0的安裝命令。 - Reduced motion 下，插件會停止 playlist 輪換，並使用 matching PNG frame。
- 運行時資產請求爲零，activation 不發起外部請求。
鏈接與目錄¶
GitHub 倉庫：
https://github.com/LeemanCheung/dsh-whale-animation
社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應理解爲官方應用商店。目錄頁入口可以從倉庫 README 中的社區目錄徽章進入；本文不在此列出未經驗證的目錄頁 URL。
