dsh-pet-bridge

dsh-pet-bridge

把 DeepSeek Harness 的 agent 活动状态（思考 / 干活 / 等待 / 完成 / 出错） 实时写进一个状态文件，供桌面宠物读取并切换表情与气泡。

配合 DSH 桌宠（Live2D 版） 使用：鲸鱼娘会跟着 agent 的真实状态换表情，气泡里显示当前正在做什么。

它是怎么工作的

只监听 一个 DSH 事件流：session/event。这个 feed 已经按顺序携带了 所有状态跃迁，比分散监听 agent/status + tools/pre-execute + agent/error 可靠得多。

事件 → 状态映射：

两个关键点：

1. tool/result 本身不改变状态（只更新气泡细节）。否则一个回合里 "写文件 → 跑命令 → 写文件" 会让状态反复跌回通用的 working， 表情闪个不停。
2. 回合被中断时必须释放，这里映射到 interrupted 而不是硬清空 —— 既不会永远卡在"工作中"，又能让鲸鱼娘演一下"被打断了"。

旧版桌宠（只认 6 个状态）遇到这些新状态会退回默认表情，不会报错， 所以桥接和桌宠可以分开升级。

写文件有两层节流（状态去重 + minGapMs 最小间隔）， 工具连续调用不会把磁盘打爆。

状态文件格式

{
  "title":    "DSH Agent",
  "bubble":   "正在执行 read …",
  "status":   "reading",
  "progress": 0.6
}

status 取值（16 个）：

idle thinking waiting working reading writing running searching delegating planning proud struggling longtask done error interrupted

安装

dsh plugin --profile web add file:F:\碧蓝航线blender\实验性天空\dsh-pet-bridge

然后重启 dsh web 使其生效。

验证是否挂上：

dsh --profile web --dump-config

输出末尾应该出现：

# == dsh-pet-bridge
- id: pet-bridge
  name: dsh-pet-bridge
  config:
    statePath: '...'

配置

全部在 cordis.patch.yml 的 config: 下：

依赖

• inject: ['fs'] —— 硬依赖文件系统服务。用 ctx.get('fs') 可选访问 会有静默失败的风险：插件可能在服务就绪前就被 apply，拿到 undefined， 然后什么都不做且不报错。

许可

MIT。桌宠所用的 Live2D 模型版权另属其作者，与本插件无关。