前言¶
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
