dsh-usage-stats

为 DeepSeek Harness 网页端提供多供应商账户监测与 Token 用量分析。

Provider balances, subscription quotas, and token-usage analytics for the DeepSeek Harness Web GUI (dsh web).

展示图使用脱敏演示数据；插件不会把 API Key、Cookie、管理 PAT 或上游原始响应发送到浏览器。

🐋 OrcaRouter sponsors this project and is available as an optional OpenAI-compatible provider. Learn more · Referral link.

一眼看懂 / At a glance

	能力	说明
💳	统一账户卡片	API 供应商显示余额，Token Plan 显示分窗口额度；面板一次只呈现当前供应商
📊	Token 用量分析	今日、本月、累计、缓存命中率、月历热图，以及按日期/供应商/模型下钻
💰	估算费用与预算	按事件时间匹配历史价格，提供日/月费用、session 级聚合及可选预算预警
🔄	后台监测	账户按 active/detail/background 自适应刷新；间隔可配置或完全关闭，本地 Token 聚合保持独立运行
🧩	可扩展适配器	支持 New API、Sub2API、通用余额模板，以及声明式 JSON Pointer 自定义查询
📦	安全导出	提供 daily/session CSV 与版本化 JSON；Unicode、CSV 公式前缀和不完整费用均安全处理
🔒	本机安全边界	数据端点仅接受回环 GET；OrcaRouter preset 仅由带防跨站请求头的显式回环 POST 写入；凭据只在服务端解析

界面支持中文和英文。浏览器只请求当前选择的 provider；账户自动刷新由服务端统一调度。手动刷新会更新用量、供应商列表，并强制刷新当前账户，不会批量强制请求其他供应商。

快速安装 / Quick start

本版本为 @ychris12138/[email protected]。npm 与市场安装要求该精确版本已经发布；发布前验收使用从冻结提交构建并核对哈希的本地 .tgz。

基础功能支持 @deepseek-ai/dsh >= 0.1.0-rc.6。安装时选择实际使用的 profile：命令行网页通常是 web，Desktop 使用 desktop；不要把插件装到另一个 profile 后只刷新当前窗口。DSH Desktop 的 DeepSeek Account 登录余额接入依赖 DSH 0.2.0-rc.2+ 提供的 Host account service；旧版 Harness 仍继续使用 API Key 余额路径。

确认 npm 上存在本版本后，优先安装精确版本；DSH Desktop Market 使用同一个包：

dsh plugin --profile web add "@ychris12138/[email protected]"

Desktop 安装时将上面的 --profile web 改为 --profile desktop，并使用 Desktop 对应的 DSH CLI。只有明确测试未发布 source/RC 时才使用 GitHub 来源；验收指定候选版本时优先安装从该提交打出的本地 .tgz，以免跟随分支变化。GitHub main 可能领先 npm stable。

安装后重启对应 profile 的 DSH Host；Desktop 需要退出并重新打开应用，然后刷新客户端。只刷新窗口不会加载新的服务端插件。侧边栏底部会出现“用量/余额”（Usage/Balance）入口。

插件市场 GUI 安装（DSH Community Market，Path A 标准来源）

本仓库按 DSH Community Market 目录 adapter 指南 的标准来源（Path A） 接入，无需修改 Market 代码。内置两份目录数据：

• catalog/catalog-source.json — 来源 manifest（catalog-source.schema.json v1.0.0）
• catalog/v1/plugins.json — 标准 provider page（catalog-provider-page.schema.json v1.0.0）

使用前提（重要）：市场托管安装只接受 npm registry 的精确稳定版本，git 条目仅可浏览。dsh-usage-stats 这个 npm 名已被其他项目占用，因此目录条目身份使用 @ychris12138/dsh-usage-stats。本版本 package 与 catalog 元数据均为 0.3.6；目录中的版本号不代表 npm 发布已完成。每个新版本都按以下顺序发布：

1. 在 release 分支运行 npm run release:sync -- <version> 同步 package、lockfile、README 与 catalog，检查候选包。npm 发布前不要把新 catalog 合入 main，因为 Pages 会自动部署。
2. 从冻结的 .tgz 发布 scoped 公共包：npm publish /absolute/path/to/ychris12138-dsh-usage-stats-0.3.6.tgz --access public --registry=https://registry.npmjs.org/，再核对 registry tarball 与冻结包的哈希。
3. npm 包核验通过后，将 main 快进到冻结的发布提交，触发 Pages 部署；核验 https://ychris12138.github.io/dsh-usage-stats/v1/plugins 的精确版本（manifest 与 endpoint 必须同源、HTTPS 443、无凭据）。
4. 在 DSH 插件市场 → 来源管理 → 添加来源，粘贴 manifest URL：https://ychris12138.github.io/dsh-usage-stats/catalog-source.json，选择后即可走「可恢复安装边界」GUI 安装。

目录若先指向尚未发布的版本，市场安装会 fail-closed，这是预期行为。只有 npm、Pages catalog 与 Desktop Market 实际安装全部验证后，才算完成发布。

升级或卸载：

dsh plugin --profile web update "@ychris12138/dsh-usage-stats"
dsh plugin --profile web remove "@ychris12138/dsh-usage-stats"

<strong>兼容安装器：无法使用 dsh plugin 时展开</strong>

PowerShell、命令提示符和 macOS/Linux 终端使用同一条命令：

…