DeepSeek Harness 余额插件

这是一个独立的 DeepSeek Harness（DSH）Web 插件。在侧边栏底部、设置按钮上方显示 DeepSeek API 账户余额；每 30 秒自动刷新，也可手动刷新。

English: README.md

运行要求

• DSH 0.1.0-rc.8 Web profile
• Node.js 22 或更高版本
• 已在 设置 → 模型 中保存 DeepSeek API Key，或用 DEEPSEEK_API_KEY 环境变量启动 DSH

安装

dsh plugin --profile web add @tempuspatia/dsh-deepseek-balance

重启 Web 服务并强制刷新浏览器：

dsh web --no-open

打开 http://127.0.0.1:3080。余额入口位于侧边栏底部、设置上方；折叠侧边栏时显示状态点，展开后显示主要币种余额。点击入口可立即刷新。

隐私与网络边界

API Key 只保留在本机 DSH Host 进程中，浏览器不会接收、保存、记录或显示它。插件仅由 Host 请求 GET https://api.deepseek.com/user/balance，再通过 DSH 本机回环服务把标准化的公开余额数据返回浏览器。不会发送会话消息、文件、文件路径或遥测数据。

故障排查

提示	处理方式
余额不可用	确认 DSH 正在运行，然后刷新浏览器。
请先保存 DeepSeek API Key	在 设置 → 模型 保存 DEEPSEEK_API_KEY，然后重启 DSH。
无法读取余额	确认当前供应商兼容 DeepSeek，并且 Key 可以访问 /user/balance。

升级与卸载

dsh plugin --profile web update @tempuspatia/dsh-deepseek-balance
dsh plugin --profile web remove @tempuspatia/dsh-deepseek-balance

执行后重启 DSH。卸载只移除插件，不会修改模型、凭据或会话。

开发与发布

npm ci
npm test
npm run lint
npm run validate:manifest
npm run validate:package
npm pack --dry-run

贡献方式见 CONTRIBUTING.md，安全报告方式见 SECURITY.md。项目使用 MIT 许可证。