DeepSeek Harness (DSH) 采用插件化架构，dsh-sophnet-balance 是其中一款用于 SophNet 余额查询的插件。它针对在 DSH Web GUI 中开发或调试智能体时需要实时监控额度与用量的场景，提供内嵌式的状态展示与数据查询功能。
插件定位¶
该插件由 caijiachen34 维护，采用 MIT 许可证。其核心作用是在 DSH Web 界面中集成 SophNet 的账户数据查询能力，使开发者无需离开当前工作流即可查看余额、充值状态、信用额度及历史用量。
核心功能¶
- 输入框状态指示：在输入框右侧显示一个呼吸灯圆点，实时反映 SophNet 余额状态（绿色 = 正常，黄色 = 偏低，红色 = 余额不足或无余额）。
- 液态玻璃面板：点击圆点展开面板。顶部展示总余额及状态徽标，下方列出充值/赠送/信用额度/当前欠款/提醒阈值的明细。面板主体为用量视图，包含 Token 总量、请求量、费用汇总，支持按服务或按日期查看明细，默认查询近 30 天。
- 自动启用机制：插件通过宿主端检测当前模型提供商，仅在使用
sophnet提供商（包括modlens-sophnet等包装名）时才显示控件；切换走其他提供商后控件自动隐藏。 - 冲突处理：同一输入框内会自动隐藏
opencodego查询插件的呼吸灯，避免视觉干扰。
安装¶
使用 dsh plugin 命令安装，指定 profile 为 web：
dsh plugin --profile web add github:caijiachen34/dsh-sophnet-balance
安装完成后需要重启 dsh web，以使新增的客户端模块进入浏览器清单。
典型用法¶
1. 配置 API Key¶
插件会优先读取 SOPHNET_API_KEY 环境变量（该变量通常由 DSH 的 LLM 提供商配置复用）。若未配置，可在面板内手动输入，Key 会缓存至 ~/.dsh/.sophnet-state.json。
2. 查看余额¶
切换到 sophnet 提供商后，输入框右侧呼吸灯即显示状态。点击圆点展开面板查看详细余额信息。
3. 查询用量¶
面板默认显示近 30 天的用量明细。可在面板内选择起止日期进行查询。面板展示按服务、按日期的 Token 统计及费用详情。
注意事项与限制¶
- 提供商依赖：插件必须在使用 sophnet 提供商时才会显示，切换走其他提供商后控件会自动隐藏。
- 数据延迟：用量统计存在延迟。如果查询的时间窗口内没有调用记录，统计数据可能全为 0。
- API 结构差异：官方文档与实测返回结构存在差异（例如
services字段在文档中为单数，实测为复数），插件已做兼容处理。文档未列出creditLimit/currentDebt等字段，但实测接口会返回，插件会据此显示信用额度与欠款行。 - 开发调试：如需本地开发调试，可在插件源码目录外执行
dsh plugin --profile web add file:/绝对/路径/dsh-sophnet-balance。
结语¶
对于使用 SophNet 作为模型提供商的开发者，dsh-sophnet-balance 提供了便捷的本地余额与用量监控入口。源码托管在 GitHub，可供进一步查阅或贡献。
