dsh-usage-dashboard：把用量报表接到 DeepSeek Harness 宿主 Web 的 /usage

它是做什么的？

它是 DeepSeek Harness（DSH）的用量报表展示插件，把 dsh-usage-stats 生成的 HTML 用量报表挂到宿主 Web 服务器的 /usage 路径上。它解决的是报表生成与报表访问分离的问题：报表数据归 dsh-usage-stats 所有，而这个 DSH 插件只负责把结果页面接到宿主 Web 上，不修改任何其它工程。插件为纯 ESM、零依赖，由 SJTUMalPan 维护，采用 MIT 协议，鉴权直接复用宿主登录态，没有自己的令牌体系。

核心功能

• 路由挂载：通过宿主提供的 Web 路由注册接口，把报表页面挂到可配置的绝对路径上，默认 /usage。
• 复用宿主鉴权：调用宿主的请求校验接口复用 Host/Origin 围栏与会话 Cookie，能打开 DSH GUI 的浏览器在同一 origin 下即可打开报表页，未登录返回 401，Host/Origin 不通过返回 403。
• 请求时现读磁盘：每次请求都重新读取报表文件，重新生成报表后刷新页面即可看到新数据，无需重启宿主 Web 服务。
• 规范响应行为：非 GET/HEAD 方法返回 405 并带 Allow 头，报表文件缺失返回 404 且不回显配置路径，正常响应为 text/html 并带 no-store 与 nosniff 头。
• 装载期校验配置：挂载路径必须是以 / 开头、非根、无尾斜杠且不含查询串或片段的绝对路径，非法值在装载期即抛错，而不是留到请求时才 404。
• 卸载自动注销：路由随插件卸载自动注销，不残留挂载点。

怎么使用这个插件？

在 DSH 中启用后，先在同一个地址登录 GUI，然后直接访问 /usage 即可打开报表，不用再抄一个令牌。报表本身由 dsh-usage-stats 生成，把生成的 HTML 文件路径填进配置的 reportPath 即可；缺省时读取本包内的 report 目录下的报表文件，放对位置就能零配置运行。挂载路径与报表路径两项配置都可省略，需要调整时在插件配置里改 path 与 reportPath 就行。重新生成报表后刷新页面即可看到最新数据，无需重启宿主 Web 服务。需要注意的是，报表含工程名、会话 id 与花费等内部信息，不要把它挪到宿主的免鉴权路径上；页面可用性跟随宿主 Web 服务，宿主不可用时报表页也打不开。

报错怎么排查？

访问报表页返回 401 表示当前浏览器未通过宿主认证，先在同一个地址登录 DSH GUI 再打开即可。返回 403 说明 Host/Origin 校验未通过，检查访问地址是否与宿主同源。返回 405 说明请求方法不是 GET 或 HEAD，改用浏览器直接访问。返回 404 说明报表文件不存在，确认 reportPath 指向的文件已生成且路径正确。若插件装载阶段直接抛错，多半是 path 配置非法，按官方说明改成以 / 开头、非根、无尾斜杠且不含查询串或片段的绝对路径。