鲸鱼娘·灵动挂件

DeepSeek Harness (DSH) 支持通过插件扩展功能。对于习惯在代码或终端中监控 Token 消耗和上下文占用的开发者，缺乏直观的视觉反馈会影响使用体验。本插件在 DSH 桌面环境中提供了一个桌面挂件，实时展示 DeepSeek 的余额、用量以及上下文占用情况，并提供交互式物理反馈。

功能概览¶

挂件包含以下核心功能：

鲸鱼娘立绘：图片与音效内嵌，无网络依赖。
资源监控：实时显示余额、用量、上下文占用进度条（≥90% 会主动提醒）以及峰谷时段提醒。
交互与彩蛋：支持甩抛弹跳、中键弹弓抛掷、右键菜单配置、彩蛋气泡以及音效切换。
性能调节：提供省电模式、毛玻璃强度调节、底板透明度调节等功能。

安装与启用¶

通过 DSH 命令行工具安装该插件：

dsh plugin add nickkkkkk123123/dsh-whale-girl

安装完成后，鲸鱼娘将默认显示在 DSH Desktop 右下角。

使用方法¶

显示与交互：在 DSH Desktop 右下角显示鲸鱼娘。按住鼠标中键拖动可进行弹弓抛掷，松手后挂件会沿原位置方向弹射。
配置修改：在挂件上点击右键，通过可视化菜单修改配置，如切换音效、调节弹弓力度、开启省电模式等。
彩蛋触发：点击挂件可触发随机台词或彩蛋；空闲 2~5 分钟后挂件也会自动开口说话。

配置说明¶

挂件配置保存在 ~/.dsh/.whale-girl-config.json。你可以通过右键菜单可视化修改，也可直接编辑该文件：

{
  "soundMode": "cute",
  "showProgress": true,
  "showBubble": true,
  "showBalance": true,
  "showPeak": true,
  "slingPower": 20,
  "ecoMode": true,
  "frost": 4,
  "panelOpacity": 0.82,
  "lowBalance": 10
}

字段	说明
`soundMode`	音效模式：`cute`（可爱合成音）或 `duck`（鸭叫）
`showProgress`	是否显示上下文占用进度条
`showBubble`	是否显示彩蛋/随机台词气泡
`showBalance`	是否在详情里显示余额
`showPeak`	是否显示峰谷提醒
`slingPower`	中键弹弓发射力度系数（5~60）
`ecoMode`	省电模式开关：空闲 60 秒暂停漂浮动画并停用毛玻璃
`frost`	毛玻璃强度（0~16），0 为关闭
`panelOpacity`	底板与菜单透明度（0.2~1），默认 0.82 对应 18% 不透明度
`lowBalance`	余额预警线（元），低于该值触发气泡提醒，0 为关闭

注意事项¶

流式输出卡顿：在 DSH 进行流式输出时，挂件可能会出现卡顿。这是 DSH 官方的流式渲染瓶颈导致的，并非本插件问题。
网络依赖：图片与音效已内嵌，无需网络请求即可使用。
数据残留：卸载插件后，DSH_HOME（默认为 ~/.dsh）目录下会残留 .whale-girl-config.json、.whale-girl-usage.json 等数据文件，若需彻底清理需手动删除。
API Key：需在 DSH 中配置 DEEPSEEK_API_KEY 才能读取余额信息。
资源占用：安装包约 346KB，不产生额外进程，但在流式输出时可能受 DSH 主进程性能影响。