快速判断

安装前先看这几项

配置资料: 配置资料部分完整
配置难度: 未知，待补配置
适合新手: 建议具备相关经验
兼容状态: 声明兼容，尚未实测
验证状态: 源码已审阅，未标记运行实测

配置资料部分完整

本站已整理安装目标，但尚未补齐该插件的全部专属配置。完成配置前需要核对固定来源。

仍需核对：插件专属配置项、成功验证结果、首次使用示例、数据清理方法。

中文教程

按照固定来源完成安装、配置与验证

教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。

查看 DeepSeek-Balance-Whale-Widget 安装与配置教程 →

功能

这个插件能做什么

在 DSH Web 右下角显示可拖拽的鲸鱼余额挂件，读取 DeepSeek API 余额，并可用平台令牌按小时 Token 分桶估算当日用量。

适合谁

希望改善 DSH 界面、终端或日常交互体验的用户。

使用门槛

该插件涉及较高配置难度或敏感权限，不建议在生产工作区直接试装。

准备

安装前准备

本站尚未核验该插件的专属前置条件。请先准备独立 Web Profile、测试工作区，并核对固定来源中的运行时、外部服务和账号要求。

安装

如何安装 DeepSeek-Balance-Whale-Widget

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到: web Profile
DSH 基线: 0.1.1-rc.2
安装来源: GitHub 源码（锁定提交）
固定目标: github:MeteorNOX/DeepSeek-Balance-Whale-Widget#973076b4d327

01
检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：
环境检查
```
node --version && pnpm --version
```
02
安装到 Web Profile
这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。
GitHub 源码（锁定提交）
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget#973076b4d327
```
03
如遇构建脚本拦截
GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建；只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yaml 中 allowBuilds，审阅脚本后再重复上一步，不要使用全局放行。
04
确认 Bundle 已进入配置
安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 dsh-whale-widget或对应 Bundle 层。
检查配置
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
```
05
启动并完成最小验证
启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Web
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 web
```

卸载与回退

测试不通过时先停止 DSH，再从同一 Profile 移除插件。移除后重新运行配置检查，确认对应 Bundle 层已经消失；插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除

npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove dsh-whale-widget

阅读 DSH 插件安装基础指南核对项目 README

配置

插件专属配置

专属配置路径和字段尚未完成核验，请不要根据同类插件猜测参数名。

验证

配置检查与成功结果

本站尚未获得插件专属的验证命令和期望结果。安装后只能确认 Bundle 是否进入组合配置，不能据此宣称插件功能已经运行通过。

使用

第一次使用建议这样验证

以下步骤是根据插件类别提供的安全验证顺序，不是作者仓库的专用命令。具体入口和参数仍以固定提交对应的 README 为准。

启用插件后检查 DSH 页面是否出现新的界面入口
用一个临时会话验证交互是否符合预期
关闭插件并确认原界面可以正常恢复

权限

它可能接触哪些数据和能力

控制浏览器使用服务凭据读取本地文件

读取本机 DSH Credential Provider 中的 DEEPSEEK_API_KEY；可选读取从 DeepSeek 平台网页会话复制的 DEEPSEEK_PLATFORM_TOKEN，并把两类凭据分别发送到 DeepSeek 官方余额或平台用量接口

数据存储：尚未完成独立核验，测试前应确认插件是否写入工作区、用户目录、数据库或外部服务。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

排查

故障排查与数据清理

本站尚未整理插件专属故障模式。遇到问题时先停止 DSH、保存日志、核对固定提交对应的 README，不要反复扩大权限重试。

清理边界待核对：从 Profile 移除插件通常不会自动删除插件创建的数据、外部账号或凭据。

证据

兼容性与审阅记录

兼容性说明

插件版本 0.2.5，采用 DSH Bundle 格式且没有声明明确 peer 版本；本站完成固定提交静态审阅，未使用真实 DeepSeek 账户验证余额和用量接口

数据流

本机 DSH 凭据 → 插件 Host → api.deepseek.com 余额接口和可选 platform.deepseek.com 用量接口 → 金额、Token 与峰谷估算 → 本机 /dsh-whale/*.json 路由和 Web 挂件；本地账本最多保留约 30 天日用量。

源码审阅结论

已审阅固定提交的完整打包入口、凭据解析、余额/用量请求、账本和 Web 路由。代码不把令牌返回浏览器，但 balance.json 与设置路由未做同源或身份校验，并返回 Access-Control-Allow-Origin: *；不要把 DSH Web 直接暴露到不可信网络。平台令牌来自网页会话而非普通 API Key，权限和失效机制需由用户自行承担，DeepSeek 调价后内置估算也可能过时。

来源与维护信息

本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后，请重新核对作者说明。

精确来源: GitHub：MeteorNOX/DeepSeek-Balance-Whale-Widget（外部链接，在新标签页打开）
来源登记表: GitHub dsh-plugin Topic（外部链接，在新标签页打开）
来源快照: GitHub Topic 采集记录
固定提交: 973076b4d327
许可证: MIT
主要语言: JavaScript
中文资料: 有中文专题说明

DeepSeek-Balance-Whale-Widget