前言¶

DeepSeek Harness（DSH）的对话界面默认偏工具化：余额、用量、会话状态分散在不同区域，长时间开发时不易一眼看清「现在在干什么、花了多少钱」。社区里已有不少界面增强思路，多数仍是对照官方 DOM 做补丁。dsh-plugin-whale 由维护者 www12456 发布，归类为趣味换装，用 DSH 自己的视觉语言做纯前端增强：输入框下方一条随会话状态游动的鲸鱼状态条、侧栏粮仓式余额展示，以及峰谷分时用量估算、定时发送和小消遣模式，不依赖额外远程服务。

下面介绍插件定位、核心能力、安装方式与使用注意。

这是什么¶

dsh-plugin-whale 是 DSH 客户端插件（npm 包名 dsh-plugin-whale，当前资料中版本为 1.2.0，MIT 许可）。README 将其概括为：给对话界面加余额粮仓、游动蓝鲸状态条、峰谷谷价、消遣小游戏与定时发送，风格对齐官方界面，实现侧为纯前端。

插件通过 Cordis bundle 补丁挂入 profile，浏览器侧逻辑集中在单文件 lib/client.js，宿主侧 lib/index.js 仅声明配置 schema。DeepSeek Harness 仍处于 developer preview，本插件按 0.2.x 客户端接口实现；升级 DSH 后若布局错位，可向仓库提 issue。

核心功能¶

鲸鱼状态条¶

状态条占满输入框下方整行，对应三种泳姿：静止、思考中、工作中。鲸鱼会跟随会话节奏变化——空闲时缓慢游动，思考时摆尾变慢，执行命令时加速；一轮回答结束后会跃出水面捕食一次。同一区域在「谷时」会随机点亮一段绿色海面（单向匀速，亮度可在设置中调节），「峰时」绿段消失。

余额粮仓与用量金额¶

侧栏底部、账户行上方增加粮仓图标。单击展开充值、赠送、今日消耗等汇总；总余额低于预警阈值（默认 30 元）时，图标由蓝变橙。鼠标悬停金额可查看峰/谷分项与所依据单价档位。

用量（Token）面板中额外增加一行：按官方价目与本地 token 增量、结合峰谷分时规则估算的消耗金额，便于日常心里有数；README 明确说明这不是平台对账工具。

定时发送¶

输入框工具行提供沙漏入口：设定时、分后选择「定时发送」，待发送内容吸附在输入框上沿，到点自动发出。等待期间单击时间可改期，双击可撤回并重新编辑。

消遣模式¶

在粮仓弹层内通过鲸鱼开关开启：小鱼与米饭从右向左漂动，点击鲸鱼跃起接住；需避开海洋垃圾。插件会记录本轮得分与历史最高。

设置项¶

路径为 设置 → 余额与用量。资料中记载的配置字段包括：whaleScale（鲸鱼缩放）、alertThreshold（余额预警阈值）、greenBrightness（谷时绿段亮度）、snackSpeed（消遣模式中零食速度）、showDiagnostics（诊断开关）、whaleStyle（鲸鱼线稿 / 填色）。

图标均为手写 SVG（七个矢量路径，线宽与 DSH 线性图标一致），构建时内联进 lib/client.js，运行时不发额外图标请求。

安装与启用¶

需已安装 DeepSeek Harness（dsh 桌面版，或 npx @deepseek-ai/dsh web）。安装命令以 README 原文为准：

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

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

若 dsh plugin 提示需要 profile，可指定桌面配置：

dsh plugin --profile desktop add dsh-plugin-whale

安装后重启 DSH。正常挂载时，输入框下方出现鲸鱼条，侧栏账户行上方出现粮仓图标。

典型用法¶

1. 看状态：通过鲸鱼条泳姿判断当前会话处于空闲、思考还是执行命令；每轮回答结束留意跃水捕食动画。
2. 看钱：点粮仓展开余额；低于阈值时注意图标变橙。悬停金额查看峰/谷拆解。
3. 定时：点工具行沙漏，选时分后定时发送；到点前可改期，双击撤回。
4. 玩：在粮仓弹层点鲸鱼图标开关消遣模式，再点一次结束。

适用场景与注意¶

适合希望在 DSH 里同时看清会话状态、余额与粗略用量金额、又需要定时发消息或短暂放松的开发者。插件声明 不碰密钥：余额与用量仅通过宿主已有账户接口读取，不写账号信息；本地仅缓存「上次余额」用于首屏占位。不上传数据：无远程请求（资料载明唯一外链为官方定价页，用于核对价目）。

安装前应自行查看源码与 MIT 许可证。插件以当前 dsh 进程权限在浏览器中运行，权限边界与 DSH 一致。

兼容性（摘自 README）：

结尾¶

dsh-plugin-whale 把状态、余额、分时用量与定时发送收进同一套官方风格 UI，适合作为 DSH 0.2.x 下的界面增强插件试用。目录与元信息可在 SkillHub 查看，源码与 README 在 GitHub 仓库维护。

• 目录页：https://www.skillhub.cn/plugins/www12456/dsh-plugin-whale
• GitHub：https://github.com/www12456/dsh-plugin-whale