DeepSeek Harness 插件：实时显示 DeepSeek 账户余额并支持官方充值

在使用 DeepSeek Harness（DSH）进行智能体开发时，监控 API 调用额度与余额是日常维护的一部分。传统的做法往往需要登录网页后台查看，不够直观。dsh-deepseek-balance 插件解决了这个问题，它将 DeepSeek 账户余额直接集成到 DSH 的界面中，并提供官方充值入口。

这是什么¶

stellight/dsh-deepseek-balance 是一个由 Stellight 维护的静态 dual-face 插件，基于 MIT 许可证开源。它通过调用官方接口，在页面内实时展示账户余额并提供充值入口。

核心功能¶

实时余额
插件调用官方接口 api.deepseek.com/user/balance，展示可用总额、充值余额和赠送余额（支持多币种 CNY/USD）。

自动刷新
每 60 秒自动刷新一次余额，支持手动点击“立即刷新”。界面包含状态灯（绿/黄/红）和“更新于 HH:MM:SS”的时间戳。

官方充值
提供“官方充值 ↗”按钮，点击后在新标签页打开 platform.deepseek.com/top_up，并提供 API Key 创建入口。

嵌入式 UI
卡片显示在左侧边栏底部、Cordis Plugin 选项上方（sidebar.footer.action 插槽）。支持明暗主题自适应；当侧边栏收起（rail）时，显示金额图标。

密钥管理
支持手动输入、更换或清除 API Key。界面仅显示掩码（sk-···xxxx）。

安装与启用¶

1. 找到你的 DSH profile 目录（默认为 ~/.dsh/profiles/web/）。
2. 在该目录内执行安装命令：

    npm install dsh-deepseek-balance

3. 编辑 profile 的 package.json，添加依赖与 bundle 条目：

    {
      "dependencies": {
        "dsh-deepseek-balance": "1.1.1"
      },
      "dsh": {
        "profile": {
          "bundles": [
            "dsh-deepseek-balance"
          ]
        }
      }
    }

（包内的 `cordis.patch.yml` 作为 bundle 自举补丁在每次启动时自动应用，不会被消费。）

4. 重启 DSH（执行 dsh web）。卡片将自动出现在左侧边栏底部，无需额外批准或每次重装。

典型用法¶

密钥获取顺序
插件按以下顺序获取 API Key：
1. 会话内存（用户在面板中输入的密钥）；
2. 进程环境变量 DEEPSEEK_API_KEY；
3. DSH 凭证库 ref DEEPSEEK_BALANCE_API_KEY（位于 ~/.dsh/.credentials.yaml）。

适用场景与注意¶

该插件采用静态 dual-face 架构，无构建步骤。客户端与宿主的通信走同源 HTTP 路由（页面由 dsh 的本地 web 服务器提供），不依赖动态插件专属的 host.call 机制。

安全说明
仓库代码中不包含任何 API Key。密钥仅在本机进程内用于调用官方余额接口，不落地、不出网。安装前应检查源码与许可证。

总结¶

该插件为 DSH 用户提供了在本地界面直接管理 DeepSeek 账户余额与充值的能力，无需频繁切换网页。

• GitHub 仓库
• SkillHub 目录