前言¶
DeepSeek Harness（DSH）插件生態允許通過插件擴展掛件功能。原生的 dsh-whale-widget 沒有接受外部指令的接口，只能被動輪詢。dsh-whale-emote 作爲一個獨立層，不修改第三方掛件文件，而是通過注入腳本操作掛件節點，讓 Agent 能通過本地 HTTP 調用觸發表情、氣泡和音效。
核心功能¶
- 情緒觸發：Agent 通過本地 HTTP 調用，觸發表情包從掛件旁邊彈出。
- 非侵入式：不修改第三方掛件文件，通過注入腳本操作。
- 狀態欄：提供狀態條功能，自動反映 Agent 當前工具運行狀態（如奮筆疾書、翻箱倒櫃）。
- 聯動支持：支持 Live2D 模型聯動、決策提醒音效自動觸發。
- 健康探針：提供診斷接口，用於排查顯示環節問題。
安裝與啓用¶
使用官方安裝命令添加插件，安裝後需重啓 dsh web。
dsh plugin --profile web add github:harmless0819-dev/dsh-whale-emote
典型用法¶
插件提供 PowerShell 腳本和 HTTP 接口兩種調用方式。
PowerShell 腳本¶
# 列出情緒
.\emote.ps1 -List
# 觸發情緒
.\emote.ps1 囂張
# 帶氣泡觸發
.\emote.ps1 委屈 -Text "才、纔不是呢"
# 決策提醒（必彈 + 音效）
.\emote.ps1 -Decision 困惑 -Text "這兩個方案選哪個？"
# 清除情緒
.\emote.ps1 -Clear
# 手動覆蓋活動狀態
.\emote.ps1 -Activity "正在讀圖紙" -ActivityEmoji "📐"
HTTP 接口¶
# 觸發情緒
curl.exe "http://127.0.0.1:3080/dsh-emote/set?emotion=囂張&text=hello"
配置與注意事項¶
- 配置修改：配置項需在 profile patch 的
config段修改。 - 重啓服務：添加新表情或修改配置後，需重啓
dsh web。 - 狀態條邏輯：狀態條具備粘滯期和兜底邏輯，能反映 Agent 的當前工具運行狀態。
相關鏈接¶
- GitHub: https://github.com/harmless0819-dev/dsh-whale-emote
- 目錄: https://www.skillhub.cn/plugins/harmless0819-dev/dsh-whale-emote
