← 返回列表
⚠ 装前注意
可切换的 DSH Web 浮层，聚合 Claude、Codex 和 opencode-go 的订阅配额通过全新的…
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/9/19 · 已提供中文文档
综合分
30.3
GitHub 分
30.3
用户评分
—
★ Stars
1
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add ajceee/dsh-subscription-overlay未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
信任档位：已验证本站已于 1 天前真实安装成功
- 是什么
- dsh 原生插件 · tool
- 装得上吗
- 本站已真实安装成功（非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 6 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/24
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/23（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包@dsh-external/dsh-subscription-overlay（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/23 21:25:41
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-client-ui-slots@deepseek-ai/schemastery@deepseek-ai/dsh-credentials@deepseek-ai/dsh-settings@deepseek-ai/dsh-tools@deepseek-ai/dsh-client-store用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-subscription-overlay
可切换的 DSH Web 浮层，聚合 Claude、Codex 和 opencode-go 的订阅配额（通过全新的 OAuth/会话获取），外加一个 commandcode 可用性探测和本地月度消耗台账。
诚实原则：commandcode 没有配额端点，因此该卡片仅显示探测状态（在线/离线 + 延迟）和本地消耗 —— 绝不显示捏造的百分比。当未设置月度预算时，完全不渲染百分比条。
功能说明
- 浮层悬浮组件（shell.overlay 插槽，独立插件 id —— 与自带的 dsh-quota 胶囊组件共存）：可拖拽胶囊 或 环形模式、告警徽标、点击打开 4 供应商面板、过期触发的刷新。
- 4 供应商面板：按窗口显示用量条 + 重置时间，涵盖 claude（5 小时/7 天）、codex（主/次）、opencode-go（5 小时/7 天/月度）；commandcode 仅显示探测 + 消耗。
- 切换：Ctrl+Shift+S 热键、设置区开关，以及宿主主开关。隐藏时会卸载胶囊/环形组件 和 面板，并停止轮询。
- 设置区（顺序 56，紧邻 Task Router）：主开关、四个供应商开关、轮询间隔（1–60 分钟）、告警阈值（1–100%）、commandcode 月度预算（以 token 计，0 = 仅跟踪，不显示 %）。
- 同源 HTTP API（所有 POST 均需 x-dsh-subscription-overlay CSRF 请求头）：
- GET /plugins/dsh-subscription-overlay/api/status → { refreshedAt, providers[4], alertPct, overlay, enabled, settings }
- POST /plugins/dsh-subscription-overlay/api/refresh → 强制重新获取
- POST /plugins/dsh-subscription-overlay/api/probe → commandcode 重新探测
- POST /plugins/dsh-subscription-overlay/api/settings → 经校验的补丁
- POST /plugins/dsh-subscription-overlay/api/ledger/append → { model, tokens } 回退消耗写入
安装
前置条件：DSH 0.1.5-rc.1 或更高版本，Node 20+。
dsh plugin --profile web add C:/Projects/dsh-subscription-overlay
重启一次 DSH Web 进程（bundle 列表变更需要重启）
dsh --profile web --dump-config | grep dsh-subscription-overlay # 加载器行检查
下次加载 Web 时，订阅额度胶囊组件会出现（右下角，可拖拽）。按 Ctrl+Shift+S 隐藏/显示它。
用法
- 点击胶囊组件打开面板；刷新按钮强制重新获取。
- 设置 → 订阅额度浮层：切换供应商、刷新频率、告警 %、月度预算。
- commandcode 卡片：探测按钮重新探测 GET {baseURL}/models；本月消耗显示本月至今的 token 数，以及（仅当预算 > 0 时）占预算的百分比。
- API 密钥绝不存放在设置中 —— 凭据通过 DSH 凭据域解析，并带有环境变量/会话文件回退（见 docs/SPIKE.md §2.1）。
截图
浮层胶囊组件/面板会在 bundle 加载后渲染于运行中的 DSH Web GUI 内（安装后需重启）。截图将从实时会话添加至此：
docs/screenshots/pill.png、docs/screenshots/panel.png、docs/screenshots/settings.png。
开发
npm install
npm run typecheck # 宿主
npm run typecheck:client # 浏览器客户端
npm run build # tsdown → lib/index.js + lib/client.js
node --test tests/*.test.ts # 8 个测试
布局
- src/index.ts — 宿主：fresh-fetch 聚合、commandcode 探测、burn
账本、设置校验、HTTP 路由。
- src/client/ — 浏览器：SubscriptionPanel、OverlaySettingsSection、
controller（快照存储 + API 桥接）、locale（zh/en）、styles。
- docs/SPIKE.md — DSH/wezterm API 探针（先例 + 结论）。
- cordis.patch.yml + package.json#dsh — 官方 profile-bundle 安装。
许可证
MIT — 见 LICENSE。