Adds a harbor page to the sidebar where a whale leaves on timed trips by itself, fetches public listings from GitHub, arXiv, Bilibili, Hacker News or V2EX, and returns with an illustrated postcard that introduces one item, written by the default model with a template fallback.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-whale-voyage
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:ViolaTan55/dsh-whale-voyage
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
给 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) - 用真实网页截图做明信片插画
- 法定节假日的峰谷调休
Links
More in this category
PC2005-cloud/dsh-pet#dsh-pet★ 6367
Desktop pet for the DSH Web UI on Windows, macOS and Linux: 106 transparent animations in the browser overlay or a transparent always-on-top desktop window, throw-and-bounce drag physics with squash and particle scoring, a work-status bubble driven by live session events, self-talk and chat with persistent memory, balance display, meme-image bubbles, multiple pets on screen, and drop-in custom animations and pet packs.
flizzywine/dsh-tavern#dsh-tavern★ 1636
An agent-powered tavern for DeepSeek Harness with SillyTavern compatibility, character card imports, support for multiple models, and mobile play. Install the tavern from Settings → Tavern Launcher on desktop. A launcher derived from 2NF/dsh-profile-bridge (MIT): it downloads the tavern into a separate DSH profile and switches profiles on restart. Install this launcher or the upstream plugin, not both — they claim the same /profile-bridge channel.
Alterssss/dsh-bili-whale★ 1062
A Bilibili companion that keeps its own schedule. A 60-second tick in the plugin host wakes a dedicated agent session at a random moment inside the configured time windows (opting out of a day is a configurable chance), then hands it a bundled CLI of 38 subcommands — feed, subtitles, danmaku, comments, ffmpeg frame grabs, and two diaries. Shares at most N items a day by commenting on them and @-mentioning the owner (default 3, enforced from a written quota log, and it stops on rate-limit or captcha signals). Also polls comment replies, direct messages and live-room danmaku; replies to anyone but the owner are queued for approval in Settings. Settings → 养鱼 writes ~/.dsh/bili-whale.config.json; cookies live separately in ~/.bili-ai/credentials.json and are never echoed back. The HTTP routes are loopback-only behind DSH's trust fence. Needs Node 18+ and ffmpeg on PATH for frame extraction.
Nagi-ovo/dsh-ads★ 728
Parody ads in 2005-Chinese-web style: sidebar banners, in-chat feeds, corner popups, and a close button whose hit area is smaller than it looks. All fictional.
yyh-001/dsh-meme★ 581
Chat meme stickers: text-only send, mood auto-send, QQ/WeChat-style picker, auto-learn, custom packs.
vlln/whale-girl★ 409
Desktop pet (QQ-pet style): floats in the corner, draggable, feedable, playable.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.