# DeepSeek Harness 余额插件

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

English: [README.md](README.md)

## 运行要求

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

## 安装

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

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

```bash
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`。 |

## 升级与卸载

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

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

## 开发与发布

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

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