前言¶
在 DeepSeek Harness(DSH)里长时间跑对话或调试插件时,钱包余额和当前是否处于高峰计价,往往要另开页面或凭记忆估算。官方价目表又区分高峰与空闲时段,周末、节假日规则并不直观。社区插件 dsh-sidebar-status(维护者 sunzphy,分类:联网工具)把账号充值余额、赠金(若有)以及当前高峰/空闲时段固定在侧边栏底部,并提供一键跳转官方充值页,减少上下文切换。
这是什么¶
dsh-sidebar-status 是面向 DSH Web 客户端的浏览器侧插件(MIT 许可,当前 package 版本 0.1.0)。它在侧边栏底部占用一块固定状态区域,展示 DeepSeek 账号钱包余额(充值余额 + 有赠金时的赠金余额)和按中国大陆价目表口径计算的高峰时段 / 空闲时段;余额走 DSH 的 account 子系统,不读取 DEEPSEEK_API_KEY,也不调用 api.deepseek.com/user/balance 那条 API Key 路线。
界面示意(来自项目 README):
余额 ¥10.46 ⟳ ● 空闲时段 去充值
- 余额:有数据时显示;拿不到时静默省略,不会显示 0 或占位符。
- ⟳:手动刷新余额。
- 时段:鼠标悬停可看下一段高峰或空闲何时开始;时段为本地计算,与是否登录无关,只要插件能算出就会显示。
- 去充值:打开官方充值页。
目录页:https://www.skillhub.cn/plugins/sunzphy/dsh-sidebar-status
源码与说明:https://github.com/sunzphy/dsh-sidebar-status
核心功能¶
余额¶
余额仅在窗口聚焦和每轮回答结束时各读一次,没有定时轮询。数据来自已登录 DeepSeek 账号的钱包,依赖 DSH >= 0.1.7-rc.2 才具备的 account 子系统。
高峰 / 空闲时段¶
规则对齐 DeepSeek 中国大陆价目表:高峰为北京时间周一至周五(不含中国法定节假日)9:00–12:00、14:00–18:00,单价为空闲时段的两倍;空闲为其余时间,含周末与法定节假日全天。
实现上:周末与元旦、劳动节、国庆等固定日期按规则判断;清明用寿星公式;春节、端午、中秋用天文推算(Meeus 新月级数 + Intl 月份标签),无需每年维护节日表。调休拼出的连休未建模——仅因调休而实际放假的工作日可能仍显示为高峰,误差方向是「报价比实际贵」,不会报便宜。
插槽选择、CSS 与天文算法细节见仓库 lib/client.js 顶部注释与各 #region 段落。
安装与启用¶
Web 侧一条命令安装,刷新页面即可:
dsh plugin --profile web add github:sunzphy/dsh-sidebar-status
其它方式:
- 从 Releases 下载
.tgz,执行dsh plugin --profile web add <文件路径>。 - 桌面端(Electron):
--profile desktop会被 CLI 拒绝。若手工安装,需将包放入~/.dsh/profiles/desktop/node_modules/,并在~/.dsh/profiles/desktop/cordis.patch.yml追加宿主条目(不要写inject:,本插件无宿主侧行为;误写不存在的服务名会导致插件无法启动且界面无明显报错):
- insert:
- id: sidebar-status
name: 'dsh-sidebar-status'
卸载 Web 安装:
dsh plugin --profile web remove dsh-sidebar-status
手工安装则删除补丁中对应行并删除包目录。
环境要求与典型结果¶
| 条件 | 说明 |
|---|---|
| DSH | >= 0.1.7-rc.2(engines 与 README 一致) |
| 账号 | 要看余额需已登录 DeepSeek 账号;仅 API Key 无登录时只有时段 |
| 计价口径 | DeepSeek 中国大陆价目表 |
DSH 版本通道¶
account 子系统在 0.1.7 才加入。npm 上 latest 仍为 0.1.5-rc.3(无 account),npx @deepseek-ai/dsh web 默认只能看时段、拿不到余额。需要余额时请显式使用 next:
npx @deepseek-ai/dsh@next web
DeepSeek Harness 桌面版自带 0.1.7-rc.2,一般无需单独切换通道。
登录与 Web / 桌面¶
账号登录在官方实现里是桌面版(Electron)渲染器专属(未检测到 dshDesktop 则不注册账号能力)。因此:
| 环境 | 余额 | 时段 |
|---|---|---|
| 桌面版 + 已登录账号 | ✅ | ✅ |
| 桌面版 + 仅 API Key | ❌ | ✅ |
纯 dsh web |
❌(无登录入口) | ✅ |
| Web,但曾在桌面版登录过 | ✅(凭据共享) | ✅ |
适用场景与注意¶
适合在 DSH 侧边栏常驻查看钱包与当前计价时段、并需要从同一位置跳转充值的开发者。插件在当前 DSH 进程权限下运行,安装前建议浏览仓库源码与 MIT 许可证,确认符合你的安全与合规要求。
社区目录 SkillHub 与 GitHub 仓库由社区维护,与 DeepSeek / 幻方无官方从属关系;DSH 生态遵循「一切皆插件」,本插件是其中一条可选扩展。
结尾¶
dsh-sidebar-status 把账号余额、峰谷时段和充值入口收到侧边栏底部:时段本地可算、不依赖登录;余额则绑定 DSH 0.1.7 的 account 与桌面登录能力。安装命令以 README 为准,Web 用 --profile web add github:sunzphy/dsh-sidebar-status 即可。