dsh-magpie-usage
Magpie 额度：把本机 Magpie 网关的账号额度/余额/用量，以三种承载位（输入框/底边栏/悬浮球）+ 设置独立一列呈现。只读、无登录、无依赖。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:mamabuku/dsh-magpie-usage#85f48926a549ef3cd57f866a42247cb9154de7ba
Magpie Usage 以 dsh-magpie-usage 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Magpie Usage Panel for DeepSeek Harness — a persistent dashboard for the accounts, quotas and balances of your local Magpie gateway. It reproduces Magpie's own Usage page 1:1 inside DSH, with every derived number following Magpie's real algorithms (reverse-engineered and documented). Read-only: no logins, no config changes, no requests that Magpie itself does not already make.
把本机 Magpie 网关的账号额度、余额与用量，做成 DeepSeek Harness（DSH）里的常驻看板；面板结构与数值口径 1:1 复刻 Magpie 自己的「用量」页。
127.0.0.1:3425）；npm run install
脚本会先备份再改写 ~/.dsh/profiles/desktop/cordis.patch.yml（插入 4 行挂载块）与 ~/.dsh/profiles/desktop/package.json（加 link 依赖），然后建好 node_modules 软链。完成后重启 DSH 生效。
设仓库绝对路径为 $REPO（即本仓库根目录），profile 目录为 ~/.dsh/profiles/desktop：
profile 的 package.json 加 link 依赖：
"dependencies": {
"dsh-magpie-usage": "link:$REPO"
}
建软链：
mkdir -p ~/.dsh/profiles/desktop/node_modules
ln -s "$REPO" ~/.dsh/profiles/desktop/node_modules/dsh-magpie-usage
在 ~/.dsh/profiles/desktop/cordis.patch.yml 里插入 4 行块：
# Mount the Magpie usage bundle. Host routes live in ./index.js.
- insert:
- id: dsh-magpie-usage
name: 'dsh-magpie-usage'
改完重启 DSH。三步的顺序不限，但三处都齐了才会被加载。
安装后打开 设置 → 「Magpie 用量」一列，可调：
| 设置 | 说明 |
|---|---|
| 承载位 | 「输入框附近」（会话输入框旁的胶囊，点开面板）或「悬浮球」 |
| 悬浮球大小 / 面板高度 | 32–72px / 120–360px 滑杆，随承载位切换显示 |
| 密度 | 紧凑 / 标准 |
| 显示项 | 进度条、重置时间、余额、本期用量、今日积分、更新时间，逐项开关 |
| 数据源 | 实时（读 Magpie 接口）/ 仅缓存（只读本地快照） |
| 刷新频率 | 15s / 30s（默认）/ 60s |
面板本身：标题栏可拖动，双击标题栏复位位置；悬浮球同理可拖动、双击回默认角落。周期切换（今天 / 7 天 / 30 天 / 全部）只影响「汇总与调用数」，不影响额度卡。
派生值一律按 Magpie 自己的真实算法计算（从 Magpie 二进制取证，见 docs/MAGPIE-SPEC.md）：
routed × 100 / used 换算好整窗估算（holds.tokens / holds.cost），面板直接取值；holds.cost 计价单位是 USD（API 标价），面板按 ~/.cache/magpie/fxrate.json 的汇率换算成 ¥ 后显示。已用% − 100 × (now − startsAt) / (resetsAt − startsAt)，负数用真减号 −（U+2212）。runsOutAt 字段；vendor 侧未给的字段不冒充，显示「数据不足」。npm run audit：把面板快照与 Magpie 原始接口逐项比对并逐行打印，失败退出码非零。它需要本机 Magpie 在跑；CI 或无 Magpie 的环境请跳过这一步。设计契约见 docs/DESIGN.md，面板结构见 docs/ARCHITECTURE.md，产品规范见 docs/SPEC.md。
npm run uninstall
# 或
./scripts/rollback.sh # 可选参数：profile 目录，默认 ~/.dsh/profiles/desktop
两者都只动 cordis.patch.yml 的插入块、profile package.json 的 link 依赖与 node_modules 软链，幂等，重复执行安全；不删源码树，也不动你的面板偏好。
workbuddy、lobster、sub2api 等没有内置图标的 provider，用品牌色首字母块代替；已覆盖的原生图标（codex / cline / factory / deepseek / zcode / zhipu）提取自本机 Magpie，见 assets/icons/README.md 与提取脚本 scripts/extract-magpie-icons.mjs。