🐋 Whale Voyage
你跑 agent 的时候,有只鲸鱼在旁边替你看着海。
装不上?先跑 只读体检 · 需要有人帮你落地?付费服务(每月 3 单)
这是什么
一个 DeepSeek Harness(dsh)插件。
你派给 agent 一个任务,少则几分钟多则半小时。这段时间你干嘛?切出去刷手机?还是盯着干巴巴的转圈?
Whale Voyage 在对话区养了一只小鲸鱼。agent 在干活的时候,它就在旁边的海里游——下潜、上浮、甩尾巴。长任务做完了,它会寄回一张明信片,上面印着这次远行的日期、改了几个文件、跑了多久测试。
有点像旅行青蛙,只不过这只青蛙不是在随机旅行,它是真的在陪你工作。
纯观察者。不注册工具、不注入提示词、不调模型、不花一个 token。 agent 完全不知道它存在。
效果演示
| 主界面(右下角飘着鲸鱼) | 相册(明信片图鉴) |
|---|---|
![]() |
![]() |
你会看到什么
- 对话区就是海面——鲸鱼飘在对话里,你可以摸它头、拖着它到处跑
- 下潜 = agent 在干活——它潜得更深,周围变暗
- 上浮喷水 = 任务做完了——它冒出头喷个水,庆祝一下
- 长任务寄明信片——珊瑚苗圃、磷虾集市、洋流赛道、海沟边缘、和海豚同游……每张都是你的工作记录
- 右下角按钮打开相册——翻看所有明信片,像翻一本航海日志
- 标签页标题和 favicon 实时更新——切到别的窗口也能看到它是在干活还是在摸鱼
- 授权请求会变成一封"家书"——轮到你介入的时候它会提醒你
安装
前置:你已经装好了 dsh,并且有 pnpm(dsh plugin 会把参数转发给 pnpm;没有的话先执行 corepack enable && corepack prepare pnpm@latest --activate)。
# 克隆本项目
git clone https://github.com/wzysbkzsd/dsh-whale-voyage.git
cd dsh-whale-voyage/plugin
# 安装依赖并构建
npm install
npm run build
# 链接到 dsh(必须带 --profile,否则会报 required option)
dsh plugin --profile web link .
然后重启 dsh,对话区右下角应该就能看到海面和鲸鱼了。
上面三步已在干净目录实测通过:npm install → npm run build(含自查与两套 tsc)→ 63/63 测试 → 链接进全新的 DSH_HOME 后 /whale-voyage 返回 200、事件流持续输出 state 快照。
起不来、端口被占、模型报 MISSING_CREDENTIAL?先跑一遍只读体检(检查 Node 版本、profile、凭据、插件软链、端口、权限模式):
node tools/preflight/src/index.mjs --workspace .
对应修法见 修复手册;仍然不行再看免费自查:TROUBLESHOOT.md。
想先看看效果不想装?启动 dsh 后访问 http://127.0.0.1:你的端口/whale-voyage?demo=1,会回放一次完整的航次演示。
它承诺不做什么
这是我做这个插件时最在意的事,写在这里接受监督:
- 不改 agent 的任何行为——只听事件,不插手
- 对模型完全隐形——不注册工具、不注入系统提示词
- 不接管授权流程——dsh 原生的授权弹窗该怎么弹还怎么弹
- 零 token 消耗——所有文案都是确定性映射,不调模型
- 出问题不连累 agent——异常一律吞掉降级,不往 agent 循环里抛
- 一条命令干净卸载——不留驻留进程、不改写 dsh 文件
一些设计上的小事
- 明信片不是随机发的——超过你自己历史时长 70% 的任务才算"远行",才会寄明信片。短任务它就捡个贝壳回来。这样不管你任务都是 30 秒还是 30 分钟,体感都是约三成的任务有收获。
- 每张明信片上有邮戳——航次序号、日期、改了几个文件、测试过没过。画面可以重复,但记录不会。
- 支持多会话并行——同时跑两个任务,海里就有两只鲸鱼。它们各干各的,不打架。
- 摸头有亲密度,摸多了它会从"初识"慢慢变成"同舟",还会戴围巾、提灯笼。
- 有个"专业模式"——收起所有动画,变成一行一个航次的状态条。数据照记,只是不展示。
技术栈
- TypeScript,状态机是纯函数(输入事件序列 → 输出状态)
- 63 个单元测试 + 样本回放 + 混沌测试,全绿
- 前端零框架,原生 DOM + CSS 动画
- 美术资源:立绘是 AI 生成后程序切分,明信片是手绘水彩风
装不上?可以找我
我做这个插件时踩过的坑,基本就是你会踩的那些:依赖解析卡死、Node 版本过低、端口占用、MISSING_CREDENTIAL、插件装完分不清是真生效还是空挂崩溃。
可以按次找我做诊断和落地(每月限 3 单):服务说明。我只承诺过程和交付物,不承诺收入或涨粉;不接自动养号、自动刷评论这类需求。
License
鲸鱼形象基于 DeepSeek 官方鲸鱼的 Q 版粉丝创作,不声称与 DeepSeek 官方存在关联。


No comments yet. Be the first to write one.