DeepSeek Harness 采用“一切皆插件”的架构。对于开发者而言,在开发过程中实时查看账户 API 余额,或者让智能体(Agent)具备查询余额的能力,是提升效率的关键需求。dsh-deepseek-account 插件通过在 Web GUI 侧边栏增加钱包按钮,解决了这两个问题。
插件定位¶
这是一个为 DeepSeek Harness 设计的账户插件。它不直接存储 API 密钥,而是作为 UI 和工具的补充层,帮助用户在侧边栏快速查看余额,并为 Agent 提供查询余额的接口。该插件由 sunyuhuirong 维护,遵循 MIT 许可证。
核心功能¶
该插件提供以下已核实的能力:
- 侧边栏钱包按钮与余额弹窗:在 Web 界面的侧边栏中增加一个钱包按钮。点击后显示余额卡片。该功能适配了侧边栏的不同状态(rail/wide sidebar)。
- 智能体工具接口:向 Harness 中的 Agent 暴露
deepseek_balance工具,允许 Agent 在运行时主动查询账户余额。 - 国际化支持:提供英文和简体中文界面。
安装与启用¶
在安装前,请确保你的 DeepSeek Harness 环境满足要求:Node.js 版本需为 ^22.19 或 >=24,且使用 ~/.dsh profiles。
安装插件并启用 Web profile:
dsh plugin add @deepseek-ai/dsh-deepseek-account --profile web
安装完成后,无需额外的配置步骤。你只需在 Harness 的 Settings 中配置好 DEEPSEEK_API_KEY 凭证即可。插件会自动读取该凭证。
工作原理¶
该插件分为两部分协作运行:
- Host Half (
src/index.ts,src/balance.ts):
负责注册deepseek_balance工具。当 Agent 调用该工具时,Host half 会通过 Harness 的凭证服务读取DEEPSEEK_API_KEY,并调用 DeepSeek 的余额 API 获取数据。 - Client Half (
src/client/):
负责注册到settings.triggerExtraslot。这会在侧边栏的设置按钮旁插入钱包按钮,并负责渲染余额卡片的弹出层。
注意事项¶
- 仅显示余额:该插件目前仅用于显示余额,不涉及其他账户操作。
- 密钥安全:API 密钥由 Harness 统一管理。本插件不会存储密钥,它们始终保留在 Harness 的 Settings 下的
DEEPSEEK_API_KEY凭证中。 - 源码审查:由于插件运行在本地进程权限下,建议在使用前查阅源码:https://github.com/sunyuhuirong/deepseek-account。
结语¶
dsh-deepseek-account 是一个轻量级且安全的辅助工具,它将余额查询功能无缝集成到了 DSH 的工作流中。通过侧边栏按钮和 Agent 工具的结合,开发者可以更专注于智能体逻辑的开发,而不必手动切换页面查看余额。