Adachi-Hougetsu/dsh-api-tools

README 摘要

dsh-api-tools 为 DeepSeek Harness（dsh）Web 界面打造的两个实用插件： 1. API 用量统计 （dsh-api-meter + dsh-ui-api-meter）——按模型、按对话统计 token 用量 2. 一键刷新 （dsh-refresh + dsh-ui-refresh）——设置面板里的灰色刷新按钮，重启 dsh web 截图提示：可自行将面板截图放入 docs/api-meter.png 后显示在这里。 功能 API 用量统计 - 侧边栏底部入口，点击打开大窗口 - 顶部四项总量：总 Tokens、缓存命中率、调用次数、推理 Tokens - 每日堆叠柱状图（x 轴日期）：未命中输入（蓝）/ 输出（深蓝）/ 缓存命中（浅蓝），可切换 7 / 14 / 30 天 / 全部 - 按模型分类、按对话（会话）明细（点击展开该会话的模型用量） - 数据每 5 秒自动刷新 一键刷新 - 设置面板内容列头部（关闭按钮旁）的小圆形刷新按钮 - 点击确认后自动重启 dsh web（约 30 秒），无需手动操作终端 安装 --profile web 换成你实际使用的 profile 名；没有指定过 profile 时，默认 web 界面使用 web 。 使用 安装后重启 dsh web： - 侧边栏底部出现「API 用量」图标 → 点击打开用量面板 - 打开「设置」→ 内容列头部（右上角）出现灰色圆形刷新按钮 → 点击刷新 历史数据自动回算 插件升级前（旧版本没有按会话统计）的调用记录，会在 首次启动时自动回算 ： - 自动读取 /.dsh/sessions 下的会话日志，重建按会话的用量明细 - 无需任何手动操作，日志里会显示 backfilled N historical calls - 如果你希望强制重建，可以手动运行： （需 dsh web 处于停止状态；脚本会先备份现有 usage.json ） 配置 插件数据保存在 /.dsh/storages/api-meter/usage.json ，可在 profile 的 cordis.patch.yml 中覆盖： 卸载 常见问题 重启后历史会话数据没出现？ 确认 dsh web 完整重启过一次（首次启动时自动回算），并检查日志中是否有 api-meter: backfilled 字样。 总量与会话明细数字不一致？ 总量按 provider/model 统计，会话明细按对话统计；同一调用会计入两者，但旧版本无会话信息的调用只计入总量。 刷新按钮点击后页面没反应？ 确认 dsh-refresh 已安装且 dshCmd 指向正确的 dsh CLI 路径（见配置）。 许可 MIT 相关链接 - DeepSeek Harness - 插件打包与安装指南（官方） - dsh-plugin…

分类