前言¶
用 NewAPI 搭中转站的开发者，查用量通常有两条路：登录站点后台翻页面，或者把令牌写进脚本里调接口。前者要切换上下文，后者要把系统访问令牌落到本地代码里。这个插件的做法是第三条路：在 DeepSeek Harness（DSH）Web 界面里做一个侧边栏入口，填一次站点地址和系统访问令牌，余额、消费、请求数、令牌明细直接在面板里看。
下面介绍 zzh407/dsh-newapi-usage 这个 DSH Web 插件：它解决什么问题，怎么安装，面板里具体有什么，以及使用上的限制。
这是什么¶
- 插件名：
dsh-newapi-usage，仓库zzh407/dsh-newapi-usage，维护者 zzh407，分类属于社区目录里的「联网工具」。 - 定位：一个 DSH Web 插件，用来查看一个或多个 NewAPI 站点的账户余额与用量。
- 核心区别：令牌不需要写进插件配置文件或浏览器代码。插件把站点地址和令牌存在 DSH 的本地凭据里，请求由 DSH Host 发出，浏览器侧只拿脱敏结果。
- 许可证：MIT License。当前版本
1.0.1，要求 Node.js >= 20。
安装与启用¶
安装走 DSH 的插件命令，从 GitHub 装：
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:zzh407/dsh-newapi-usage
装完如果命令提示需要重启，就重启一次 DSH Web 进程。重启后侧边栏会出现 NewAPI 用量 入口。
插件要求使用 DSH 的 Web profile，并且启用 Web UI、Connection、Credentials、Layout、Sidebar 这几个服务；否则侧边栏挂不上。
配置站点¶
面板里没有预置站点，第一次使用需要手动添加：
- 点侧边栏的 NewAPI 用量。
- 点 站点管理 → 添加站点。
- 填站点名称（可选）、站点地址（如
https://newapi.example.com）和系统访问令牌。 - 点 保存。保存时面板会尝试访问站点，地址或令牌不对会直接报错。
- 要加第二个站点就重复上面几步，之后通过面板顶部的站点按钮切换。
系统访问令牌（通常以 nap_ 开头）一般在 NewAPI 控制台的「个人设置 → 系统访问令牌」里生成，具体入口以站点界面为准。用于模型调用的 sk-... 中继密钥不能替代它，管理接口不认。
编辑已有站点时，令牌留空表示保留原值；要轮换令牌就填新值。已保存的完整令牌不会从 Host 返回到浏览器。
两个地址上的坑，README 明确写了：插件不跟随 HTTP 重定向（避免把令牌转发到别的地址），所以遇到重定向要填最终的 API 站点地址；地址里也不能嵌入用户名或密码。
面板能看到什么¶
- 账户概览：余额、累计消费、累计请求次数、今日消费、本月消费、RPM/TPM。
- 近 7 天消费图表，按天展示消费变化。
- 令牌明细：各个 API Key 的已用额度、剩余额度、无限额度标记和状态。
- 多站点管理：添加、编辑、删除站点，凭据独立保存。
金额是换算出来的展示值，不是结算汇率。插件优先从 /api/status 读站点的额度倍率和货币符号，读不到时按每单位货币 500,000 quota 的默认倍率算，金额 = quota / quota_per_unit。
统计口径与刷新¶
面板的数字来自这几个接口：
| 指标 | 接口 |
|---|---|
| 余额、累计消费、请求次数 | /api/user/self |
| 今日、本月消费、RPM/TPM | /api/log/self/stat，消费类型 type=2 |
| 近 7 天消费 | 每天分别查一次 /api/log/self/stat |
| API Key 明细 | /api/token/ |
| 额度倍率、货币符号 | /api/status |
清单说明：
- 日期边界按浏览器本地时区算每天、每月的起点。
- 趋势图刻意不用
/api/data/self，因为它的聚合方式会随版本或站点配置变化，每日统计接口更稳定。 - 缓存约 60 秒；打开面板时加载一次，停留期间每 2 分钟自动刷新，也可以点 刷新 手动更新。
- 加载是分阶段的：先出账户概览，日/月统计和令牌明细在后台取，完成前用面板轮询补齐。
隐私与权限¶
- 站点名称、地址、令牌保存在 DSH 本地凭据记录
newapi-usage/sites里，凭据文件由 DSH 管理，不属于插件仓库内容。 - 浏览器通过本地 DSH 已鉴权的 Connection 路由请求，只有 Host 会访问你配置的 NewAPI 站点。接口请求通过
Authorization请求头带上该站点的令牌。 - 插件本身不含统计分析、遥测或第三方代理。
- 安装插件等于信任它的源码，以及它申请使用的 DSH Host/Client 服务权限。它是以当前 dsh 进程的权限运行的，所以安装前应先打开仓库审查代码，确认调用的接口和权限范围符合预期。
- 只添加可信站点，尽量用能满足查询需求的最小权限令牌。不要把自己真实令牌、账户数据或本地凭据文件提交到 GitHub。
谁适合用¶
适合已经在用 DSH Web profile、同时跑着 NewAPI 中转站的开发者。站点和接口版本差异比较大的情况（比如二次开发改了 /api/log/self/stat 的返回结构），插件遇到不可用的统计或令牌接口会弹错误或警告，这类站点需要先确认接口兼容性。如果你的站点没有上面那四个管理接口，面板拿不到数据，装了也用不起来。
结语¶
这个插件的价值在于把「查中转站用量」这件事收敛到 DSH 侧边栏里，凭据不落浏览器、不进配置文件，刷新策略和统计口径也写清楚了。生态上它是社区开发的插件，挂在第三方目录里，不是 DeepSeek 官方出品。
- 目录页：https://www.skillhub.cn/plugins/zzh407/dsh-newapi-usage
- GitHub：https://github.com/zzh407/dsh-newapi-usage
