dsh-whale-subagent

by 1while1

GitHub ↗

2 主题与外观github收录于 08-23

DeepSeek Harness 的鲸鱼娘主题 subagent 巢：像素动画 subagent 卡片与实时状态

A whale-girl themed subagent nest for the DeepSeek Harness, featuring pixel-animated subagent cards, real-time

安装

$ dsh plugin --profile web add github:1while1/dsh-whale-subagent

GitHub 源码安装：首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络，DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单，不构成兼容性或安全审查；安装前请审阅源码，不熟悉的插件先在不含密钥的环境试用。

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/                截图