fiven577/dsh-whale-widget-sankou

Name: fiven577/dsh-whale-widget-sankou
Author: fiven577

Desktop桌面端 Native原生 ⭐ 3 MIT Pets & Fun桌宠与娱乐 Vision & Media视觉与多媒体 Usage & Cost用量与计费

DSH 小鲸鱼余额挂件·三口皮肤版 —— 基于 MeteorNOX/DeepSeek-Balance-Whale-Widget（MIT）的修改版：自定义桌宠“三口”形象/语音/不同状态动画，含余额提醒与菜单修复

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This is a native web widget plugin built exclusively for DeepSeek Harness (DSH), a forked modified version of the original DeepSeek balance whale widget that adds a custom skin for the character Sankou. It docks permanently to the bottom-right corner of the DSH web interface, displaying your remaining DeepSeek API balance, today's total usage, and consumption per conversation turn. It also includes an interactive desktop pet that you can click and interact with directly. To install it, you need to have DSH Desktop or the DSH CLI installed and have configured your DeepSeek API key first.

The widget retains all features from the original version, including 60-second auto-refresh of balance, manual refresh on click, drag and snap to any edge of the screen, and support for peak-valley pricing with different text skins. New additions include custom voice interaction for the pet, an "angry" state triggered by 6 quick taps within 2 seconds, a "full" reminder when cumulative consumption hits a set threshold, and a transparent eating animation when a new consumption is logged. It is ideal for DSH users who want to keep track of their API usage while having a cute interactive pet on their interface.

You can install the plugin directly via the DSH CLI by running dsh plugin --profile web add github:fiven577/dsh-whale-widget-sankou, or install it from a local directory if you are modifying the code yourself. After installation completes, you need to fully exit and restart DSH Desktop, then refresh the page with F5 to see the widget. All code is licensed under the MIT license, and the custom character assets added in this fork are also open for reuse as long as you attribute the original source. If you run into issues like the widget not showing up, check your installation status and restart DSH.

这是专为DeepSeek Harness（DSH）打造的原生网页挂件，是原DeepSeek余额小鲸鱼挂件的修改分支，新增了角色「三口」的定制皮肤。它常驻在DSH Web界面右下角，可显示DeepSeek API剩余余额、今日已消耗额度、每轮对话消耗统计，同时自带可交互桌宠。

本挂件保留了原版全部特性，支持余额60秒自动刷新、手动刷新，支持拖拽四边吸附，自带峰谷计价模式和随机台词气泡。新增了自定义语音互动、2秒内连点6次触发生气状态、累计消耗满额的吃撑提醒、每轮消耗触发的吃透明动画等功能。适合需要追踪DeepSeek API使用情况同时喜欢可爱互动桌宠的DSH用户使用。

安装前需要先配置好DeepSeek API密钥，可通过DSH CLI直接从本仓库安装，或本地链接安装，安装后需要完全退出重启DSH再刷新页面。代码部分遵循MIT许可，新增的定制角色素材也开源共享，二次分发需要注明原出处。如果遇到挂件不显示等问题，可检查安装状态后重启刷新即可。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-whale-widget-sankou（fiven577/dsh-whale-widget-sankou）
仓库：https://github.com/fiven577/dsh-whale-widget-sankou
本站详情页：https://www.yhbd.top/plugins/fiven577-dsh-whale-widget-sankou/
本站登记：类型 client · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 3 · 最近提交 2026-09-22 · 主语言 JavaScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意

Only 3 stars - very few users, little community feedback星标只有 3，几乎没人在用，遇到问题缺少社区反馈
Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端：安装会下载可执行文件，请核对发布者与校验和

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add github:fiven577/dsh-whale-widget-sankou

把 fiven577/dsh-whale-widget-sankou 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

6.0 KB · 缓存于 2026-09-17 19:38:18 · 6.0 KB

DSH 小鲸鱼余额挂件 · 三口皮肤版（dsh-whale-widget-sankou）

本仓库为 MeteorNOX/DeepSeek-Balance-Whale-Widget（dsh-whale-widget，MIT License，Copyright © 2026 MeteorNOX）的修改版（fork）。原版 LICENSE 已原样保留在 LICENSE。本仓库的代码修改在下方「与原版的差异」列出；自定义角色素材与语音的使用说明见「素材说明」。

DSH Web 界面右下角的常驻余额挂件：显示 DeepSeek API 余额 + 今日已用 + 每轮对话消耗，并带一只名叫三口的桌宠（支持自定义形象/状态/音效）。

📺 效果演示

视频打不开时，可直接下载或点击打开 docs/demo.mp4。

特性

原版全部能力（保留）：

常驻自启：随 DSH Web 界面打开自动出现在右下角
余额 60s 自动刷新 + 点击手动刷新；余额变化数字滚动动画
今日已用：小鲸鱼记账 / 实时·令牌两种模式
每轮对话消耗统计与弹泡
拖拽 + 四边吸附、按压 Q 弹、汉堡菜单（大小/音量/气泡开关等）
峰谷文案皮肤（默认 / 梁文峰谷 / !?强强?!）与峰谷计价
随机台词气泡、rua.gif 动图（内容详见原版 README）

三口皮肤版新增（2026-09）：

自定义形象：桌宠本体由鲸鱼换成角色「三口」的透明立绘（构图与尺寸与原鲸鱼一致，可自行替换 assets/DSniang1.png）
语音互动：
- 音效菜单新增「语音·点击(嗯？)」选项（默认）：单次点击角色播放 嗯？.wav，新点击会停掉上一条避免叠音
- 每轮对话消耗提示出现时同步播放 吃.wav
生气状态：2 秒内连点 ≥6 次 → 形象切换为 生气.png，随机播放 干嘛.wav / 嗯.wav（自动轮换不重复），维持 5 秒；生气期间点击音效静音，可再次快速连点重复触发
余额提醒（吃撑）：菜单新增「余额提醒」——支持固定档位（0.1/1/10/100/1000）或自定义（0.1~1000，精确到 0.1）；自上次提醒起累计消耗满设定金额 → 形象切换 太撑了.png、以原版气泡弹出「已吞X元」、随机播放 这也太多了.wav / 打嗝.wav（延迟 1.6s 避免叠音），维持 5 秒
吃透明动画：每轮消耗提示时，角色会播放一段带 alpha 的「吃」透明动画（assets/eat.webp，由素材作者提供的吃.mov 转码，约 2.1s），随后自动恢复静态形象；加载失败自动降级为仅音效
各类状态相互协调：生气/吃撑互斥、吃动画可被打断、点击热区随形象同步、菜单修复（状态失步与点击被形象像素吞掉导致菜单打不开的问题）

与原版的差异

核心代码文件 lib/index.js 在原版 0.2.10 基础上修改，主要差异：

assets/：新增角色素材（见下）
lib/index.js：
- 后端新增路由 /dsh-whale/state.png（生气/吃撑形象）、/dsh-whale/extra.wav（新增语音）、/dsh-whale/eat.webp（透明动画）
- size 配置扩展 soundSet=voice 与 remindOn/remindYuan 持久化
- 前端新增：语音播放（防叠音）、连点生气、余额累计吃撑提醒（原版样式气泡）、吃动画状态机、闲置/点击音效策略、菜单余额提醒 UI（档位+自定义）
- 修复：菜单开关状态失步导致的“点不开菜单”、点击被形象像素拦截吞掉的问题
移除了原作者代码中针对作者本机的绝对路径回退（D:/TestBox/...），素材一律从包内 assets/ 加载

素材说明

代码：MIT，原作者版权见 LICENSE；本仓库代码署名与修改记录见本 README。
自定义素材（角色「三口」形象图、全部 wav 语音、eat.webp 动画）：为作者（fiven577）原创/定制素材，随本仓库一并发布。任何使用请同时遵守 MIT（代码部分）与素材作者意愿：二次分发素材请保留本说明并注明出处。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 fiven577/dsh-whale-widget-sankou 的 README.md。在 GitHub 查看原文 →