江晨
fdafd5d6b3
- 插件源码：dsh-usage（用户头像 + DeepSeek 官方 API 消耗面板） - 工具：dl-gh.mjs（node fetch 下载 gh，绕开沙箱 curl 限制） - 文档：PLAN.md 路线图 + mmx 视觉桥接补丁说明 - 资产：DeepSeek 鲸鱼图标
36 lines
1.7 KiB
Markdown
36 lines
1.7 KiB
Markdown
# dsh-usage — 用户头像 + API 消耗面板
|
||
|
||
在 DeepSeek Harness 侧边栏底部（设置旁）添加一个 Codex 式**用户头像**入口，
|
||
点击弹出模态面板，展示 **DeepSeek 官方 API 余额/消耗**，并可一键打开官网用量页。
|
||
|
||
## 效果
|
||
|
||
- 侧边栏底部（设置按钮旁）：圆形 🐋 头像按钮（窄栏只显图标，宽栏带"API 用量"文字）
|
||
- 点击 → 居中模态面板：
|
||
- 账户可用状态
|
||
- 各币种：总额 / 赠送余额 / 充值余额（来自官方 `GET https://api.deepseek.com/user/balance`）
|
||
- 按钮：刷新 / 打开官网用量页 / 关闭
|
||
|
||
## 实现
|
||
|
||
| 端 | 机制 |
|
||
|---|---|
|
||
| Host | `harness.handle('usage/balance')`：shell 运行 node 脚本读取 `%DSH_HOME%\.credentials.yaml` 的 `DEEPSEEK_API_KEY`，调用官方余额 API，返回 JSON（密钥不出进程日志）；`usage/openPortal`：打开官网用量页 |
|
||
| Client | `sidebar.footer.action` 注册头像按钮；`shell.overlay` 注册模态面板；两个组件通过插件内微型 store 共享开关状态；样式用主题 CSS 变量（`--dsw-alias-*`） |
|
||
|
||
## 为什么用官方 API
|
||
|
||
DeepSeek 官方提供余额接口（`/user/balance`），返回 `is_available` + `balance_infos[]`。
|
||
用量明细官网暂无公开 API，故面板提供"打开官网用量页"（platform.deepseek.com/usage）兜底。
|
||
|
||
## 文件
|
||
|
||
- `host.js` — Host 半（RPC + 官方 API 调用）
|
||
- `client.js` — Client 半（头像 + 模态 UI）
|
||
- 部署方式：通过动态 Cordis 插件（`cordis_define` / `cordis_run`）或本仓库 `presets/` 下的预设文件
|
||
|
||
## 前置
|
||
|
||
- `%DSH_HOME%\.credentials.yaml` 中存在 `DEEPSEEK_API_KEY`
|
||
- 官方余额 API 需可访问（api.deepseek.com）
|