# dsh-plugins-model-usage **Repository Path**: playnb/dsh-plugins-model-usage ## Basic Information - **Project Name**: dsh-plugins-model-usage - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-14 - **Last Updated**: 2026-11-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # dsh-model-usage DeepSeek Harness 插件:按模型统计会话日志里的 token 用量,并读取各订阅的剩余额度。 - 设置 → **订阅额度** 页:各订阅的剩余窗口百分比、余额和重置时间; - 输入框下方:当前会话所选模型的额度(点开看全部); - Agent 工具:`subscription_quota`(订阅额度)、`model_usage`(按模型统计 token)。 ## 装哪些、看哪些,由你的配置决定 插件**不自带订阅清单**。它读取 LLM 注册表里当前 profile 实际配置的模型供应商(也就是「设置 → 模型」里配置的那些),逐个取额度: - 你在「设置 → 模型」里加一个供应商(例如 Kimi 编码套餐),面板就多一行; - 删掉它,那一行跟着消失; - 只注册但没有配好凭据/登录的供应商不会显示——没配的东西不该占一行; - 插件不认识的平台会显示「此平台没有已知的额度接口」,而不是猜一个数字。 平台识别规则:先看路由 id(`zai`、`zai-coding-cn`、`kimi-coding`、`minimax`、`minimax-cn`、`openai-codex`、`deepseek-account`),再看你在该路由上配置的 endpoint 域名(`z.ai`、`bigmodel.cn`、`kimi.com`、`minimax`、`chatgpt.com`)。额度地址取 endpoint 的域名部分,不会把模型协议路径(`/v1` 等)带过去。 ## 安装 ```sh dsh plugin --profile desktop add git+https://gitee.com/<你的账号>/dsh-model-usage.git ``` 或在桌面端:插件管理器 → 安装 → 填入上面的地址。安装后重启应用。 ## 配置(可选) 默认不需要任何配置。只有插件认不出的网关,才需要在自己的 profile `cordis.patch.yml` 里补一句 `type`: ```yaml - id: model-usage name: '@dsh-plugins/model-usage' config: overrides: ztai: type: litellm-budget # 可选:zai-coding-plan / chatgpt-codex / litellm-budget / kimi-coding / minimax-token-plan / deepseek-account baseUrl: https://ztai.ztgame.com label: GiantLiteLLM some-route: hidden: true # 从面板里隐藏这个路由 ``` `overrides` 的键是模型供应商的 route id(模型选择里携带的那个 `provider`)。也支持 `baseUrls`、`credential`(凭据引用名)、`record`(凭据记录名)。 想完全自己掌控清单,可以写 `providers` 数组,它会**取代**自动发现: ```yaml - id: model-usage name: '@dsh-plugins/model-usage' config: providers: - id: zai-coding-cn label: GLM 编码套餐 type: zai-coding-plan credential: ZAI_CODING_CN_API_KEY ``` ## 凭据 插件只按**凭据引用名**取密钥,不保存任何密钥;引用名来自你在该路由上的配置(`apiKeyEnv`),没配则用该平台的原生环境变量: | 平台 | 默认引用 | | --- | --- | | GLM / z.ai | `ZAI_API_KEY`、`ZAI_CODING_CN_API_KEY` | | Kimi 编码套餐 | `KIMI_API_KEY` | | MiniMax | `MINIMAX_API_KEY`、`MINIMAX_CN_API_KEY` | | LiteLLM 网关 | 该路由 `apiKeyEnv` 指向的引用 | | Codex(ChatGPT) | 在 Harness 里登录 ChatGPT(记录 `llm-pi-ai/openai-codex`) | | DeepSeek 账号 | 在 Harness 里登录 DeepSeek 账号(走宿主账号服务) | 凭据值放在凭据库 `refs` 或同名环境变量里即可。 ## 已知限制 - 各平台的额度接口都不是公开 API,平台改接口时面板会显示"不支持"或报错,不会给出错误数字; - MiniMax 只给整体额度,不按模型拆分; - 只认识上表那几个平台,其余平台显示"没有已知的额度接口"(可用 `overrides.type` 手动指定); - 只在浏览器端渲染的会话数据(图片附件)不参与统计。 ## License MIT