DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

miko-cn /

miko-cn/dsh-commandcode-quota

Verified

Command Code usage panel for DeepSeek Harness: credits, 5-hour/weekly windows, request stats, plan tiers, API key editor; Settings tab + draggable floating capsule

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@0ecd9cb9

Command Code 用量面板 for DeepSeek Harness

Command Code 用量面板

npm ci dsh license powered by dsh

在 DeepSeek Harness 里,直接看 Command Code 的额度、窗口和请求量。

一个设置页 · 一个可拖动的浮窗胶囊 · 9 档套餐识别 · 内置 API key 管理


亮点

💳 套餐额度 本期剩余 / 总额度、已用百分比、续费日期,额外购买的额度单独列出
⏱ 滚动窗口 5 小时与每周窗口的已用 / 上限 / 重置时刻,实时值来自 Command Code 接口
📊 本期请求 请求数、成功率、花费、输入输出 token,打开即刷新、此后每分钟更新
🎚 套餐档位 自动按订阅识别 Go / GOAT / Pro / Max / Ultra / Teams Pro,也可手动指定
🪟 桌面浮窗 液态毛玻璃外壳的胶囊:Logo + 双行进度条,拖到任意位置,位置本地记忆,点开是完整浮层
🔑 API key 设置页直接填写 / 清除,写入 DSH 凭据库,不落配置文件、不下发浏览器

界面

浮层与浮窗胶囊    设置页

左:液态毛玻璃浮层 + 双行进度条浮窗胶囊 · 右:设置 → Command Code 页面

快速开始

1. 安装插件

dsh plugin --profile <profile> add @yumiku/dsh-commandcode-quota

或在 DSH 会话里用 plugin_manager:install_bundle,target 填 @yumiku/dsh-commandcode-quota。 npm 尚未发布时,也可以直接装 GitHub Release 的预构建包:

https://github.com/miko-cn/dsh-commandcode-quota/releases/latest/download/dsh-commandcode-quota.tgz

2. 配置 API key

如果你已经用 cmd login 登录过,或者 DSH 正在用 Command Code 作为模型供应商(COMMAND_API_KEY),插件会自动复用,无需配置。 否则打开 设置 → Command Code → API key,粘贴一个 Command Code API key 保存即可——密钥只写入 DSH 凭据库。

3. 刷新页面

设置里出现「Command Code」页签,桌面上出现浮窗胶囊。

用自建 Discover 索引安装(不依赖任何市场)

仓库自带一份 format-1 插件市场索引 market/index.json,可以在 DSH 的 Discover 页签里直接订阅:

  1. DSH → Plugins → Discover → Manage index sources

  2. 添加:

    https://raw.githubusercontent.com/miko-cn/dsh-commandcode-quota/main/market/index.json
    
  3. 在 Discover 里搜索 “Command Code”,选版本安装(安装参数是 @yumiku/dsh-commandcode-quota@1.0.2)。

索引由 scripts/build-index.mjs 从根 package.json 和 npm 发版时间生成,并用官方 @deepseek-ai/dsh-plugin-market-index 校验过。发新版本后重跑一次脚本即可;新增插件时在同一份索引里加一条。

面板里都有什么

套餐额度

Command Code 的月额度是一个池子,面板显示「剩余 / 总额度」和已用百分比。额度按月重置、不结转;额外购买的额度、赠送额度会单独显示。

5 小时 / 每周窗口

Command Code 在月额度之上还有两个滚动窗口,用来限速:

  • 5 小时窗口:任意 5 小时内最多能用多少 credits(GOAT 是 14)
  • 每周窗口:任意 7 天内最多能用多少 credits(GOAT 是 35)

窗口从你第一笔请求开始计时,5 小时 / 7 天后整段归零,不是按自然日重置。面板显示每个窗口的已用、上限、重置时刻和百分比。credits 不等于美元:对全额额度模型 1 credit ≈ $1 用量,对高额度模型按倍率折算,所以同样的「14」在不同模型组合下对应的美元不同。

本期请求

按计费周期统计:请求数、成功率、花费、输入 / 输出 token。打开面板时强制刷新(绕过本地缓存),之后每分钟自动刷新一次;面板底部显示「更新于 X 秒前」。

套餐档位

插件内置 9 个档位(individual-go、individual-goat、individual-pro、individual-max、individual-ultra、teams-pro、individual-provider 等),默认从订阅的 planId 自动识别,档位表提供月额度与窗口上限的兜底值;窗口上限以接口实时返回为准。设置页可以手动切换档位(只影响显示与换算,不会改动你的订阅)。

配置

- id: commandcode-quota
  name: '@yumiku/dsh-commandcode-quota'
  config:
    apiKey: ''                 # 留空则自动查找;推荐用设置页写入凭据库
    apiKeyEnv: COMMAND_CODE_API_KEY
    apiBase: https://api.commandcode.ai
    planOverride: ''           # 默认档位,页面上的手动选择优先生效
    cacheMs: 45000             # Host 侧缓存时长(打开面板时强制刷新)
    timeoutMs: 12000

API key 解析顺序

  1. 设置页保存的 key(DSH 凭据库,COMMAND_CODE_API_KEY,优先于环境变量)
  2. 环境变量 COMMAND_CODE_API_KEY(apiKeyEnv 可改名)
  3. 环境变量 COMMANDCODE_API_KEY、COMMAND_API_KEY
  4. ~/.commandcode/auth.json(cmd login 生成)
  5. ~/.dsh/.credentials.yaml

架构

flowchart LR
  subgraph Browser[DSH Web UI]
    S[设置页 · Command Code]
    C[浮窗胶囊 + 浮层]
  end
  subgraph Host[DSH Host]
    R[HOST 路由<br/>/dsh-commandcode/api/*]
    K[(DSH 凭据库)]
  end
  CC[api.commandcode.ai<br/>/alpha/whoami · billing · usage/summary]

  S -->|读取 / 保存 key| R
  C -->|读取报表| R
  R -->|Bearer key| CC
  K --> R

数据流很简单:Host 半拿着 API key 调 Command Code 的内部接口(与 cmd CLI 的 /usage 同源),整理成一份报表挂在同源路由上;客户端半只读报表,永远拿不到 key。两个路由都过 DSH 的请求门禁。

路由 作用
GET /dsh-commandcode/api/report 账号、额度、窗口、本期请求(?refresh=1 强制刷新)
GET /dsh-commandcode/api/key key 是否配置、来源、是否可写(不含值)
POST /dsh-commandcode/api/key 保存 / 清除 key(写入 DSH 凭据库)

开发

仓库是纯 JavaScript,无需构建:

node --check index.js
node --check client.js
node test/test-client.mjs          # 桩浏览器环境:槽位注册、设置页、浮窗、浮层
node test/test-host.mjs <api-key>  # 真实接口:报表 + key 状态

界面素材(banner、预览图)由 scripts/make-assets.mjs 渲染,需要 sharp:

$env:SHARP_PATH='<path-to-node_modules>/sharp'; node scripts/make-assets.mjs

发布

  • npm:@yumiku/dsh-commandcode-quota,npm publish(publishConfig.access=public)
  • CI:push / PR 跑语法检查、manifest 校验、客户端冒烟测试、npm pack --dry-run
  • Release:推 v* 标签自动 npm pack 并创建 GitHub Release,资产名固定为 dsh-commandcode-quota.tgz
  • 插件市场:投稿草稿见 marketplace/awesome-dsh-plugin.yml
  • 自建 Discover 索引:market/index.json(node scripts/build-index.mjs 生成),用户可在 Plugins → Discover 里添加该 URL

已知限制

  • 逐条请求明细只存在于 Command Code Studio 的登录会话接口(/internal/usage*,需要网页 cookie),API key 拿不到,所以面板只做本期汇总。
  • /alpha/* 是 CLI 内部接口,未在公开文档中承诺稳定性;字段缺失时面板会降级显示而不是报错。
  • Command Code 是第三方服务,本插件只是它的数据看板,与 Command Code 官方无隶属关系。

License

MIT

—/ 5

No ratings yet

Verified DSH bundle

Commit 0ecd9cb9ea4e

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout