dsh-cyrene-balance
在 DeepSeek Harness 里查询 DeepSeek API 余额与今日消费，支持今日额度上限、超限提醒与只看今日额度 / 只看余额两种视图。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:bestlike093/dsh-cyrene-balance#e677dc249725b807b211b8198958460f6b659c57Cyrene Balance 以 dsh-cyrene-balance 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
到 Releases 下载安装包，解压后复制到 ~/.dsh/profiles/node_modules/，再在 profile 的 cordis.patch.yml 里注册。
| 安装包 | 大小 | SHA-256 |
|---|---|---|
dsh-cyrene-balance-1.0.0.zip | 7.6 KB | 9ce06859481f7cd381ebd66c181d592db5567dac6a096c7a737f60df8c29fc7b |
在 DeepSeek Harness（DSH）里查询 DeepSeek API 余额与今日消费，支持今日额度上限、超限提醒，以及「只看今日额度 / 只看余额」两种视图。
这是 Cyrene 版「昔涟 · 余额桌宠」的 DSH 移植版：去掉桌面立绘与气泡 UI，保留查询、额度、提醒与账本能力。
GET https://api.deepseek.com/user/balance，展示余额、赠金、今日消费、今日充值、峰谷时段⚠ 今日额度已超限today：只报今日已用 / 额度 / 剩余balance：只报余额all：全部信息view 就用它cp -r dsh-cyrene-balance ~/.dsh/profiles/node_modules/dsh-cyrene-balance
在 ~/.dsh/profiles/web/cordis.patch.yml 里插入：
- insert:
- id: dsh-cyrene-balance
name: dsh-cyrene-balance
config:
apiKey: sk-你的Key
balanceThreshold: 20
dailyLimit: 30
重启 dsh web。
解压后把整个目录复制到 ~/.dsh/profiles/node_modules/dsh-cyrene-balance/，再按上面的 YAML 注册。
toolsseam 不支持热重载，首次安装或改代码后需要重启。
| 字段 | 类型 | 默认 | 说明 |
|---|---|---|---|
apiKey | string | 空 | DeepSeek API Key；留空时读环境变量 DEEPSEEK_API_KEY |
balanceThreshold | number | 20 | 余额提醒阈值（元），0 表示关闭 |
dailyLimit | number | 0 | 今日额度上限（元），0 表示关闭 |
view | string | all | 默认视图：all / today / balance |
dataDir | string | $DSH_HOME/plugin-data/dsh-cyrene-balance | 自定义数据目录 |
| 工具 | 作用 | 关键参数 |
|---|---|---|
deepseek_balance | 查询余额与今日消费 | view（可选） |
balance_set_limit | 调节今日额度与提醒阈值 | limit、threshold（至少一个） |
balance_set_view | 设置默认视图 | view（必填） |
balance_status | 查看设置与上次查询 | 无 |
balance_history | 查看最近 7 天消费 | 无 |
示例：
deepseek_balance(view="today") # 只看今日额度
deepseek_balance(view="balance") # 只看余额
balance_set_limit(limit=40) # 今日额度改成 40 元
balance_set_limit(limit=0) # 关闭今日额度
balance_set_view(view="today") # 以后默认只报今日额度
| 位置 | 内容 |
|---|---|
settings.json | 阈值、今日额度、默认视图 |
ledger.json | 今日消费/充值与最近 30 天归档 |
last.json | 最近一次查询结果 |
https://api.deepseek.com/user/balance| 能力 | Cyrene 版 | DSH 版 |
|---|---|---|
| 桌面立绘 / 气泡 / 小表情 | 有 | 无（DSH 是 Web Agent） |
| 余额与今日消费 | 有 | 有 |
| 今日额度调节 | 右键菜单 + 对话 | 工具调用 + 配置 |
| 额度特殊提醒 | 高亮脉动气泡 + 音效 | 结果里的醒目警告文案 |
| 只看今日额度 / 只看余额 | 气泡视图 | 查询视图 + 默认视图 |
MIT