前言¶
在 DSH 里做 DeepSeek 相关开发或日常对话时，余额、峰谷时段和今日用量往往要切到别的页面或插件面板才能看到。社区里已有「小鲸鱼 + 余额挂件」一类客户端插件，功能完整但界面与交互偏臃肿。下面介绍维护者 Cdkgfp 发布的 dsh-whale-pro：在保留鲸鱼挂件与余额能力的前提下，用常驻信息栏和内联设置页收拢冗余部分，面向 DSH Desktop 为主的使用场景。
这是什么¶
dsh-whale-pro 是 DSH 的 bundle 插件，包名、挂载 id 与 GitHub 仓库名均为 dsh-whale-pro。简介为：DSH 桌面端小鲸鱼简洁版——常驻梁文峰 / 梁文谷 / 时间线 / 余额信息栏，并大幅优化原插件冗余部分。
本仓库是 DeepSeek-Balance-Whale-Widget 的简洁分支（fork），基于上游 0.4.2 改造；当前正式版为 0.4.4（含认证安全修复）。代码部分为 MIT 许可；美术与音频素材按仓库内 PROVENANCE.md 说明提供，版权归上游作者及贡献者所有。
分类上属于 客户端 插件；GitHub 星标以目录页展示为准（抓取时为 0）。仓库尚未发布到 npm，安装以 GitHub 源或桌面端 plugin_manager 为主。
核心功能¶
常驻信息栏与峰谷时间线¶
右下角鲸鱼头顶显示紧凑信息栏：余额、赠金、充值余额、今日已用等。梁文峰 / 梁文谷 / 时间线连续展示为峰谷进度条，并标出当前时间线。
自动提示泡泡¶
余额变化、提问、每轮消耗、授权、余额预警、今日预算等场景可分别配置：每种有独立开关、内容编辑和预览。点击鲸鱼不再打开旧的大泡泡；自动提示泡泡保留。
内联设置页¶
通过菜单按钮打开设置（可在「行为」里隐藏菜单按钮，此时右键鲸鱼唤出；移动端长按约 1.5 秒）。设置分为四类，横线分隔、胶囊开关，修改即时生效：
- 外观：角色、大小、角色图管理。
- 行为：避让滚动条、隐藏菜单按钮、文字框显示开关。
- 音效：总开关、按压 / 任务结束 / 提问 / 授权四类音量与试听；音频片段导入、试听、删除；音效组选择（音量滑条 0–100，默认 100%）。
- 自动提示泡泡：总开关、六种场景、泡泡图片库。
两处「总开关」关闭后，对应分组整体变灰且不可操作。
本地记账与凭据¶
余额变化按观测累计「今日已用」；账本与设置保存在本机 $DSH_HOME（通常为 ~/.dsh），例如 .dshw-usage.json、.dshw-size.json 等。API 密钥通过 DSH 凭据服务读写，不写入插件配置文件；未配置凭据时挂件仍会加载，余额与今日已用可能为空或显示 —，不影响 DSH 本身。
余额取数优先使用凭据中的 DEEPSEEK_API_KEY；若只登录 DeepSeek 账号而未配置 API key，较新的 DSH 会使用账号登录态。
安装与启用¶
安装前请知悉：插件以当前 DSH 进程权限运行，管理类写操作依赖宿主认证与（默认可选的）回环地址检查；远端管理须配置 DSHW_ADMIN_HOSTS 且不能关闭认证。安装前应自行查看仓库源码与 LICENSE。
DSH Web / CLI¶
在 Web 或 CLI 形态下执行：
dsh plugin --profile web add github:Cdkgfp/dsh-whale-pro
安装后重启 dsh web，再按 Ctrl+F5 刷新页面。
官方桌面客户端¶
桌面端读取 desktop profile；dsh plugin 按设计拒绝直接操作 desktop profile，不要照搬上面的 --profile web 命令。
在桌面端会话里使用宿主内置的 plugin_manager 安装：
github:Cdkgfp/dsh-whale-pro
也可将仓库克隆到固定目录后，用 plugin_manager 的本地 link: 方式指向该目录；挂载 id 与包名均应为 dsh-whale-pro。若已安装旧包 dsh-whale-compact 或同名插件，应先报告来源与版本，用宿主支持的方式卸载再装，勿删除用户账本、设置、角色图、音频或凭据。
首次安装后若界面未出现，请完全退出 DSH（含托盘）再重新打开。当前 npm 未发布时，Web 侧仍用 github:Cdkgfp/dsh-whale-pro；发布后 Web 可改为 dsh plugin --profile web add dsh-whale-pro。
与旧安装、凭据名的关系¶
升级前若使用过非 DSHW_ 前缀的自定义凭据名，需在模型设置中改用 DSHW_ 开头名字（最多 64 个字母、数字或下划线）并重新配置密钥；插件不会自动改名或删除旧凭据。
典型用法¶
- 安装并重启或刷新后，在界面右下角找到小鲸鱼与头顶信息栏，确认峰谷条与余额字段是否符合预期。
- 打开设置页：调整外观中的角色与大小；在「行为」中按需隐藏菜单按钮或开启文字框显示。
- 在「自动提示泡泡」中为余额预警、今日预算等场景打开开关并编辑文案，用预览确认后再使用。
- 在「音效」中调节四类提示音量，或导入音频片段并选择音效组；需要静音时关闭音效总开关即可。
- 凭据与余额：在 DSH 模型设置中配置
DEEPSEEK_API_KEY或依赖较新宿主的账号登录态；本地今日已用由插件在本机$DSH_HOME内累计，无需手动导出。
适用场景与注意¶
适合谁：主要在 DSH Desktop 上工作、希望一眼看到 DeepSeek 余额、峰谷时段与今日用量，又不需要旧版大泡泡交互的用户。Web 模式也可安装，但桌面端请走 plugin_manager。
宿主能力：0.4.4 通过运行时检查强制要求宿主提供 connection.requestRejection(req) 等准入接口；缺少该能力的旧宿主需升级 DSH。README 记录桌面开发环境曾为 DSH Desktop 0.2.1-rc.3，0.4.4 的隔离后端回归尚未在真实桌面会话中复测，升级后建议自行验证管理页与余额拉取。
安全与网络：自定义余额/探活接口不跟随重定向；云元数据、link-local 等危险地址会被拒绝。反向代理部署时应在代理入口限制管理访问，插件不信任 X-Forwarded-For 等头证明本机身份。
生态说明：DSH 社区插件目录（如 skillhub、dshbase、dsh-plugin.org 等）为独立站点，与 DeepSeek / 幻方无官方从属关系；本仓库带 dsh-plugin topic 可被市场扫描收录，但未发 npm 时不会出现在仅列出 npm 一条命令安装的内置 Plugin Hub 中。
结尾¶
dsh-whale-pro 把鲸鱼挂件上的峰谷、时间线与余额收成常驻栏，并用内联设置与可选自动泡泡替代冗余交互，适合在 DSH 桌面端长期开着看用量。进一步了解可访问插件目录页与 GitHub 仓库：
- 目录页：https://www.skillhub.cn/plugins/Cdkgfp/dsh-whale-pro
- GitHub：https://github.com/Cdkgfp/dsh-whale-pro
