前言¶
用 DeepSeek Harness（DSH）的 Web 界面长时间对话时，输入框底部会有一行统计信息，其中包含「缓存命中」等指标。若想知道当前 DeepSeek 账号还剩多少可用余额，通常要切到平台用量页或设置里查看。下面介绍的插件 dsh-plugin-account-balance 由社区维护者 cailikelog 发布，分类为联网工具，作用是在同一行里、紧挨缓存命中右侧显示剩余额度，减少来回切换。
这是什么¶
dsh-plugin-account-balance 是一个 DeepSeek Harness 插件包（dsh.bundle.patch + dsh.client）。它在 conversation.composer.dock 插槽注册一个 id 为 account-balance 的格子（order: 2，缓存命中为 order: 1），通过宿主提供的 remote.account 读取钱包摘要，不在客户端复制凭据。
- 维护者：cailikelog
- 仓库：https://github.com/cailikelog/dsh-plugin-account-balance
- 目录页：https://www.skillhub.cn/plugins/cailikelog/dsh-plugin-account-balance
- 包版本（package.json）：
0.1.0，许可证 MIT
核心功能¶
显示逻辑以 README 为准：
- 在输入框底部统计行展示合计金额（充值余额 + 赠金余额，按币种合计）。
- 鼠标悬停可看到拆分，例如「充值余额 ¥9.99 · 赠金余额 ¥5.26」。
- 点击该格打开 DeepSeek 平台用量页；页面可见时每 60 秒刷新一次。
- 读不到钱包时显示
--，仍保留格子，避免整行布局跳动。
数据通过 remote.account 的 getState()（登录态与用量页地址）和 getBalance()（钱包摘要）获取。注册与读取挂在 remoteAccess.whenAccess('account/watch') 下：对端没有账号访问权限时不注册；权限收回时拆除。
样式不依赖主题包，使用 --dsw-* / --dsh-* CSS 变量并内联。与本仓库 packages/client/ui-settings-account 中的 AccountBalancePill 使用同一格子 id，不要同时启用两份，后注册的会替换先注册的。
前提¶
- 使用 DSH Web 界面（
dsh web），且 profile 中存在conversation.composer.dock插槽（官方 web 组装自带）。 - 使用 DeepSeek 账号登录。仅 API Key 的组装没有账号态，插件不会显示任何内容。
- 账号侧能查到钱包摘要；若显示
--，设置里「账号与余额」往往也是「前往开放平台查看」，属于账号侧问题而非插件故障。
安装与启用¶
仓库不带预构建产物；client.js 为手写模块装载包。安装方式有两种。
从 Discover 安装¶
profile 启用了插件市场（@deepseek-ai/dsh-experimental-plugin-market-bundle）时，在 设置 → 插件 → 发现 的索引源中加入：
https://cai-like.com/dsh-plugin-account-balance/index.json
说明：GitHub Pages 的 cailikelog.github.io/... 会 301 到上述自定义域名，市场抓取把重定向当作失败，索引源请用自定义域名这一条。
也可在对话里让 Agent 使用内置工具 plugin_market 搜索（读取 profile 里配置的索引源），例如询问是否可用 plugin_market 搜 account balance。
手工安装¶
在 profile 目录执行以下步骤（README 中在干净环境实测可装上 0.1.0）：
# 1. 装进 profile 的 node_modules
cd ~/.dsh/profiles/web # Windows: C:\Users\<你>\.dsh\profiles\web
pnpm add github:cailikelog/dsh-plugin-account-balance
# 2. 在 profile 的 cordis.patch.yml 里插入一行（文件末尾追加，注意 YAML 数组缩进）
- insert:
- id: dsh-plugin-account-balance:pill
name: dsh-plugin-account-balance
# 3. 重启
dsh
卸载¶
删除 cordis.patch.yml 里对应的 - insert: 及其下两行，pnpm remove dsh-plugin-account-balance，再重启 DSH。
典型用法¶
安装并重启后，用 DeepSeek 账号登录 Web 界面，在输入框底部统计行中，缓存命中右侧应出现金额（如 ¥14.79）。悬停查看充值与赠金拆分，点击跳转用量页。若长期为 --，先确认账号登录态与开放平台钱包是否可查。
开发或自测时可克隆仓库后运行：
pnpm install
pnpm test
test/smoke.cjs 模拟浏览器装载 client.js 并对注册与渲染做断言。
适用场景与注意¶
适合谁： 经常在 DSH Web 里对话、且用 DeepSeek 账号（非纯 API Key 组装）的开发者，希望在 composer 底部一眼看到剩余额度。
运行与权限： 插件随当前 DSH profile 与进程运行，余额数据经宿主 remote.account 通道读取；安装前建议浏览仓库源码与 MIT 许可证，确认符合你的环境策略。
已知限制（README）：
client.js内CLIENT_VERSION = '0.2.1-rc.3'会作为x-client-version发给平台；若平台校验版本，改该常量即可。- 金额为浮点求和、向下取两位，仅用于展示，不参与计费。
DeepSeek Harness 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文所述安装源与仓库均来自维护者 cailikelog 公开资料。
结尾¶
dsh-plugin-account-balance 把 DeepSeek 账号剩余额度嵌进输入框底部统计行，与缓存命中并列，适合需要边对话边盯余额的场景。更多信息见 GitHub 仓库 与 SkillHub 目录页。
