chore: 初始化 dsh-enhancements 留档仓库
- 插件源码:dsh-usage(用户头像 + DeepSeek 官方 API 消耗面板) - 工具:dl-gh.mjs(node fetch 下载 gh,绕开沙箱 curl 限制) - 文档:PLAN.md 路线图 + mmx 视觉桥接补丁说明 - 资产:DeepSeek 鲸鱼图标
This commit is contained in:
@@ -0,0 +1,35 @@
|
||||
# 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)
|
||||
Reference in New Issue
Block a user