在侧栏加一个港口页面,小鲸鱼会按时间自己出海,从 GitHub、arXiv、B 站、Hacker News 或 V2EX 的公开列表里取材,回港时带回一张插画明信片,只介绍一样东西;正文由默认模型写,模型不可用时用模板。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-whale-voyage
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:ViolaTan55/dsh-whale-voyage
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
给 DeepSeek Harness 养一只放养的小鲸鱼。它在港口里歇够了就自己出海,逛真实的互联网,回港时寄给你一张明信片,带回一件「土特产」——它真的看到、觉得你会喜欢的东西,附原链接。一张明信片只介绍一样东西。


预览图由插件自己的画图代码渲染,明信片上的词是示例数据。
- 港口:左侧栏「出海」。看它在不在家、去了哪片海、什么时候回来。
- 塞纸条:写上你想让它留意的东西(比如「agent 记忆」)。它会揣着出门,七成时候照着找,剩下的时候按自己的兴趣逛。
- 明信片:像旅行相册,同一片海每次换着镜头拍——远景里小小的它、凑到镜头前的大脸、看风景的背影、半水下、从天上俯拍。回港时刻定天色,天气和姿势各不相同,带回的那样东西会出现在画里(房子的门牌、一条弹幕、一个对话气泡、一页论文)。正文是它用你 DSH 的模型写的,土特产只从它真实取到的条目里挑,不编造。
- 明信片册 / 海图:收过的明信片都在册子里;去过的海会在海图上点亮。
- 谷时靠岸(可选):写明信片要调一次模型。打开后,如果回港时赶上 DeepSeek 高峰(北京时间工作日 9–12、14–18 点),它会在港外等到谷时再靠岸。
- 快速模式(试玩):航程和休息都缩短到 1–2 分钟。
五片海
| 海域 | 取材 | 能用纸条关键词 |
|---|---|---|
| 代码群岛 | GitHub 最近 3–14 天新建、星数靠前的仓库(每趟随机换时间窗和页码) | 能 |
| 论文深海 | arXiv 最新的 AI / NLP / ML 论文 | 能 |
| 弹幕湾 | B 站综合热门 | 不能 |
| 黑客海峡 | Hacker News 首页 | 能 |
| 闲聊礁 | V2EX 今日热议 | 不能 |
都是免 key 的公开接口。某片海连不上(比如网络访问不了 Hacker News),它会自动绕去别的海,并记住这片海 24 小时:这期间很少再挑它、绕路时也排在最后,海图上标「最近起雾」;五片都连不上就「起雾」,寄回一张空手的明信片。带回过的链接不会再带第二次。
安装
dsh plugin --profile web add dsh-whale-voyage
本地开发版:
dsh plugin --profile web add link:/path/to/dsh-whale-voyage
dsh --profile web
用到的模型
写明信片用 DSH 的默认模型(agentDefaultModel)。默认路线没有凭据时(比如新建配置默认走 API key、而你是账号登录),会改用 DeepSeek 账号路线 deepseek-account / deepseek-flash。都不可用时用内置的模板话写明信片,土特产照常带回。每次回港最多调一次模型,输出上限 1200 token;模型有 none / minimal / low 这类低推理档时用低档,没有就用模型默认档。
时间怎么走
航程在 DSH 开着时推进。DSH 关着期间到点的航程,下次启动时一次结算,只寄一张。状态存在 $DSH_HOME/plugin-data/dsh-whale-voyage/state.json(默认 ~/.dsh)。
结构
| 文件 | 作用 |
|---|---|
voyage.js |
航程核心(不依赖 DSH):海域取材、挑海、峰谷时段、明信片提示词与解析、模板兜底 |
index.js |
宿主半区:存档、10 秒一次的时间推进、调模型写明信片,挂 GET /api/dsh-whale-voyage/state 和 POST /api/dsh-whale-voyage/action |
client.js |
浏览器半区:侧栏入口(有新明信片时亮小点)、港口画面、明信片(SVG 插画)、册子、海图、设置 |
test/ |
npm test |
两个接口都先过 DSH 自己的访问检查(Host / Origin 围栏和浏览器登录,和 DSH 自家接口是同一道);写接口另外只接受同源、带 x-whale-voyage: 1 头的请求。
还没做
- 去好友的 DSH 串门、互寄明信片(需要一个中转信箱)
- 在新会话首页的像素鲸上标出它在不在家
- 回港时推送到手机(可接
dsh-im) - 用真实网页截图做明信片插画
- 法定节假日的峰谷调休
链接
同类插件
PC2005-cloud/dsh-pet#dsh-pet★ 6367
DSH Web UI 桌面宠物,Windows / macOS / Linux 三端可用:浏览器浮层或透明置顶桌面窗口,106 个透明动画、带挤压与粒子的甩抛反弹物理、随会话事件实时联动的工作状态气泡、碎碎念与带持久记忆的对话、余额展示、表情包配图、多开同屏,并支持直接放入的自定义动画与宠物种类(pet pack)。
flizzywine/dsh-tavern#dsh-tavern★ 1636
基于 DeepSeek Harness 的 Agent 酒馆,兼容 SillyTavern 生态,人物卡导入即玩,支持多种模型和手机游玩。桌面端从「设置 → 酒馆启动器」安装酒馆。 基于 2NF/dsh-profile-bridge(MIT)改造的启动器:把酒馆下载到独立 DSH 配置并在重启时切换。与上游插件不能同装——两者都占用 /profile-bridge 通道。
Alterssss/dsh-bili-whale★ 1062
一条按自己作息过日子的 B 站插件:宿主里每 60 秒一次心跳,在设定的作息窗口里随机挑一个时刻叫醒专用会话(今天不想看是按概率跳过),再交给自带的 38 个子命令——信息流、字幕、弹幕、评论、ffmpeg 抽帧、两本日记。每天最多发 N 条评论/动态并 @ 主人(默认 3,按配额账本计数,撞到限流或验证码就停手)。同时轮询评论回复、私信和直播间弹幕;除主人以外的回复先入队,等主人在设置页批准。设置 → 养鱼 写 ~/.dsh/bili-whale.config.json;cookie 单独在 ~/.bili-ai/credentials.json,只写不回显。HTTP 路由只认回环地址并过 DSH 信任栅栏。抽帧需要 Node 18+ 与 ffmpeg。
Nagi-ovo/dsh-ads★ 728
2005 年中文站点风格的整活广告插件:侧栏广告/信息流/角落弹窗 + 假关闭叉,素材全虚构。
yyh-001/dsh-meme★ 581
聊天表情包:纯文本斗图、情绪主动发图、像 QQ/微信 一样发图、AI 自动学图、自定义表情包。
vlln/whale-girl★ 409
桌面宠物(QQ 宠物形态):右下角悬浮、可拖拽/投喂/玩耍。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。