dsh-whale-subagent · 鲸鱼娘小窝

DeepSeek Harness 插件:把派发出去的每个 subagent 变成一张看得见的卡片。

为什么要做这个

派发 subagent 之后,它基本是个黑盒:

• 不知道它进行到哪一步,只能干等
• 不知道它脑子里在想什么,方向偏了要等跑完才发现
• 任务清单、最新发言都藏在会话里,要翻半天
• 想让某个子代理换个模型,得改代码重新跑

这个插件把以上全部摊开:每个子代理一张卡片,思考(THINK)、任务清单(TODO)、最新发言(SPEAKS)实时更新;同时提供一个带模型选择的 subagent_ex 工具,派发时直接指定 provider/model,不用改代码。

长什么样

鲸鱼娘像素动画是它的皮,实时状态是它的里。运行中的子代理在卡片上走路,完成的发呆,戳一下有反应;点击卡片翻到背面,是深色控制台,THINK/TODO 分栏查看。

侧栏卡片	全屏小窝

卡片特写:

功能

• 实时卡片:THINK / TODO / SPEAKS 随事件流更新,不用轮询 LLM
• 自动建卡:任何方式派发的 subagent(包括内置 subagent 工具)都会自动住进小窝,无需显式登记
• 模型选择:subagent_ex 支持 provider / model 参数,配套 list_llm_models 查询可用模型
• 翻转卡片:正面摘要,背面 THINK/TODO 控制台
• 全屏小窝:560px 大卡片,运行中展示思维过程,完成后展示报告(状态分流布局)
• 过滤器:ALL / LIVE / DONE

安装与运行

这是一个动态 Cordis 插件:定义只存在于 DSH 进程内存,需要 AI 会话执行 cordis_define + cordis_run 激活。

• host.js — Host 半区源码(工具注册、状态收集、RPC)
• client.js — Client 半区源码(侧栏 UI、精灵渲染)
• sprite.json — 鲸鱼娘 9 帧动画数据(64×72 RLE)

⚠️ sprite.json 是硬依赖:Host 代码里写死了读取路径(D:/AI学习/deepseek插件/subagent和鲸鱼娘/sprite.json)。移动文件必须同步改 Host 里的 SPRITE_PATH 并重新发布,否则进程重启后鲸鱼消失。文件已加载进内存时不受影响。

文件结构

dsh-whale-subagent/
├── host.js              Host 半区源码
├── client.js            Client 半区源码
├── sprite.json          精灵数据(运行时必需)
├── architecture.md      实现细节与踩坑记录
└── docs/                截图

License

MIT