DSH 余额记账小鲸鱼:4808 星的插件、一张取数对比表、四个坑

它做的事就三件：右下角常驻一只小鲸鱼，显示余额、今日已用、每轮对话消耗；60 秒自动刷新；逐轮明细保留 90 天、逐日归档 365 天。数据全落本机，不上传遥测。

装完第一个要选的，就是怎么读余额。两种方式差别不小：

能配 Key 就配，Key 的账本最准；不想配就用账号登录态，在「设置→账号与余额」登录 DeepSeek 账号即可，一分钱 Key 都不用建。

34 个厂商模板也分两类：DeepSeek、OpenRouter、Kimi、MiniMax、智谱这类能直接查余额；硅基流动、火山方舟、OpenAI 没有余额接口，余额显示 --，今日已用按会话事件估算。

这个插件没有 peerDependencies，但几个版本直接决定行为，照着版本号对：

其中 0.3.15 的「安全边界」最重要：凭据只发往内置端点，所有写请求来源不是本机回环就一律 403，接口地址还禁带用户名密码。也就是说，远端别人改不了你的记账配置。

1. 桌面端用错 profile。桌面客户端读的是 desktop profile，CLI 会拒绝 --profile desktop；你用 --profile web 装完，桌面窗口「右下角什么都没有、也不报错」。正确做法是在桌面端会话里让宿主内置 plugin_manager 装。 2. 余额报「未配置 DEEPSEEK_API_KEY」。要么在 DSH 凭据里配 key，要么账号登录，二选一。 3. 保存设置报 403。这是 0.3.15 安全边界在起作用，写操作只认本机回环，是正常防护不是 bug。 4. 装了 IDM/迅雷会抢音效请求。下载管理器拦截挂件音频，每次打开弹下载确认框，把 127.0.0.1/localhost 加进站点排除名单。

三步走完：先 dsh plugin --profile web add dsh-whale-widget，重启后 Ctrl+F5；再选好取数方式，能配 Key 就配、不想配就账号登录；最后把 127.0.0.1 加进下载管理器排除名单。做完这些，右下角那只小鲸鱼就开始给你报账了。