dsh-plugin-whale

给 DSH 的对话界面，加一条鲸鱼。 一条会跟着会话状态游动的鲸鱼、一只替你算清每一分钱的粮仓， 外加一个到点才把话发出去的沙漏 —— 全部长成 DSH 自己的样子，不像外挂。

DeepSeek Harness 还处在 developer preview，插件 API 会变。本插件按 0.2.x 的客户端接口实现， 升级 DSH 后如果某个位置错位，请提 issue。

它做了什么

	功能	在哪
🐋	鲸鱼状态条：静止 / 思考中 / 工作中三种泳姿，一轮回答结束后跃出水面捕一次食	输入框下方（占满整行）
🏺	余额粮仓：点一下展开充值、赠送、今日消耗；低于预警值图标变橙	侧栏底部、账户行上方
🌊	峰谷谷价：谷时随机点亮一段海面为绿色（单向匀速、亮度可调），峰时消失	鲸鱼条
💸	用量与金额：Token 用量面板里多一行按官方价目、峰谷分时算出的消耗金额	用量面板
🎮	消遣模式：小鱼和米饭从右往左漂，点鲸鱼跃起接住；海洋垃圾别碰。记录本轮与历史最高	粮仓弹层里的鲸鱼开关
⏳	定时发送：沙漏设定时分，到点才发；等待中的消息吸附在输入框上沿，点时间改期、双击撤回	输入框工具行
⚙️	设置：余额预警阈值、绿色亮度、鲸鱼缩放、鲸鱼风格（线稿 / 填色）、零食速度、诊断开关	设置 → 余额与用量

图标都是手画的

七个 SVG，全部是矢量路径，跟 DSH 自己的线性图标同一套粗细（主体 1.6、细节 1.1）：

                

源文件在 assets/icons/，构建时会内联进 lib/client.js（运行时不发额外请求）。

安装

需要已经装好 DeepSeek Harness（dsh，桌面版或 npx @deepseek-ai/dsh web 都行）。

# 从 npm（已发布时）
dsh plugin add dsh-plugin-whale

# 直接从 GitHub
dsh plugin add github:<your-name>/dsh-plugin-whale

装完重启 DSH，输入框下方会出现鲸鱼条，侧栏账户行上方多出粮仓图标。

如果 dsh plugin 提示需要 profile，加上你自己的：dsh plugin --profile desktop add dsh-plugin-whale。

用起来

1. 看状态：鲸鱼条会跟着会话走 —— 空闲时慢慢游，思考时摆尾变慢，执行命令时加速； 一轮回答结束会跃出水面吃一条小鱼。
2. 看钱：点侧栏的粮仓图标，展开余额；总余额低于阈值（默认 30 元）时图标从蓝变橙。 把鼠标停在金额上可以看拆解：峰/谷各花了多少、按哪档单价算的。
3. 定时：点输入框工具行里的沙漏，选好时、分，按「定时发送」；这条消息会挂在输入框上沿， 到点自动发出。点时间可以改期，双击可以撤回重新编辑。
4. 玩：打开粮仓弹层，点那枚鲸鱼图标开启消遣模式；再点一次结束。

它不做什么

• 不碰你的密钥：纯前端插件，余额与用量只通过宿主已有的账户接口读取，不写任何账号信息； 本地只缓存「上次余额」用于首屏占位。
• 不上传数据：没有远程请求，唯一的外链是官方定价页（用来核对价目）。
• 不算平台账单：消耗金额是按官方价目 × 本地 token 增量估算的，用于「心里有数」，不是对账工具。

兼容性

DSH	状态
0.2.1（desktop / web）	已验证：鲸鱼条、粮仓、预警、峰谷、用量金额、消遣模式、定时发送
0.2.0	基本可用，个别插槽 DOM 有差异
0.1.x	未适配

开发

pnpm install
python3 build_plugin.py        # src/client.js + 资源 → lib/client.js

• lib/index.js —— 宿主半边：只声明配置 schema（whaleScale / alertThreshold / greenBrightness / snackSpeed / showDiagnostics / whaleStyle）。
• lib/client.js —— 浏览器半边：所有 UI 都在这里，单文件、无运行时依赖（除 @deepseek-ai/schemastery）。
• cordis.patch.yml —— 作为 bundle 层挂进 profile 的补丁。

改完把 lib/ 一起提交，用户端不需要自己构建。

宣传片

72 秒、4K60 的成片在 Releases 里：

• promo-4k60.mp4 — 3840×2160 / 60fps / 带合成配乐
• promo.html — 网页版，双击即播（?t=22.6 可定位到某一秒）

制作过程

这支插件是 2026-10-19 到 11-08、四个会话里一点点磨出来的：178 条需求，从"图标线条再细一点"到 "定时卡片的圆角减小到 50%"，中间还返工过一次鲸鱼跃出水面的遮挡。仓库里放了两份过程文档：

docs/对话诉求汇总.md · 16.7 KB

给人读的总结版。回答两个问题：当初到底提了什么、为什么这么提。

• 开头一张表：四个会话的代号、时间跨度、输入条数（A 98 / B 26 / C 32 / D 22），各干了什么；
• 五个阶段：立风格（把图标和鲸鱼画对）→ 进插件（接真实余额与用量）→ 交出去测（修 bug + 第一版宣传片） → 定时发送（独立做，最后并入）→ 新功能（消遣模式、沙漏、改期撤回）；
• 压缩清单：按时间顺序，同一天里连续的微调合并成一条，可以当"这些年我提过的需求"检索；
• 从输入里看出的偏好：先原型后插件、给参数不给形容词、参考图不必复刻、出错先要诊断、版本留档、 口径要精确，以及贯穿始终的那条要求 —— 体面。

docs/user-messages-timeline.md · 32.4 KB

原始档案：178 条输入按时间排开，带时间戳和所属会话（58995c0a 等前 8 位）。 适合对照上面的总结看原文，也适合当作"一个插件从零到发布，人到底说了些什么"的样本。

两份文档都做过脱敏：诊断报告原文（含当时的账户余额）、本机绝对路径、临时文件路径都已剔除或打码， 只保留需求本身。生成脚本见仓库外 发布/redact_docs.py。

许可

MIT © 2026