DeepSeek Harness API 用量监控插件

DeepSeek Harness (DSH) 的核心架构基于插件扩展。在使用多模型或多供应商的场景下，实时掌握当前的 API 调用情况和 Token 消耗是控制成本和排查问题的关键。dsh-api-usage-monitor 插件旨在为 DSH 提供统一的用量观测能力，它不依赖于特定的 LLM 供应商，而是通用地读取当前正在使用的 API。

定位与特性¶

这是一个 DeepSeek Harness (DSH) 永久插件（bundle）。它可以在设置页呈现当前用量、分对话用量，并可扫描会话日志读取历史用量。重启后依然生效。

核心功能¶

该插件提供以下能力：

实时读取当前 API：监测当前连接的模型提供商和模型名称。
当前用量：展示累计的 Token 使用情况，支持按 API/模型分组，每 2 秒自动刷新。
分对话用量：按会话（sessionId）聚合的调用次数、Token 用量与所用 API。
历史记录：支持扫描持久化会话日志中的用量记录，读取插件启动之前的用量。
设置页呈现：在 DSH 设置面板注册独立页面展示数据。

安装步骤¶

该插件通过 dsh plugin 命令安装，并需在配置文件中登记。

执行安装命令：

    dsh plugin --profile web add github:DrFaithinT/dsh-api-usage-monitor

编辑 $DSH_HOME/profiles/web/package.json，在 dsh.profile.bundles 数组中添加 "dsh-api-usage-monitor"：

    {
      "dsh": {
        "profile": {
          "bundles": [
            "@deepseek-ai/dsh-base",
            "@deepseek-ai/dsh-web-app",
            "dsh-api-usage-monitor"
          ]
        }
      }
    }

重启 DSH Web 进程：

    dsh web

验证：打开 设置 → API 用量 页面查看数据。

典型用法¶

插件支持在对话中通过 @ 提及进行快速操作，或通过设置页查看详情。常用操作包括：

查看数据：询问当前统计到的 Token 数量。
调整刷新：将设置页刷新间隔从 2 秒调整为 5 秒。
查看历史：增加按天分组的用量统计。
版本管理：回滚到上一个版本。

注意事项¶

数据存储：所有数据仅存于插件内存，不落盘、不上传。
持久性：永久版插件重启后依然生效；v1 动态挂载版本重启后消失。
通信方式：Host ↔ Client 之间只走同源 HTTP JSON，不依赖 Typert RPC。
许可证：MIT 许可证。

总结¶

dsh-api-usage-monitor 为 DSH 用户提供了轻量级的 API 用量观测方案。通过设置页和历史日志扫描，它可以满足从实时监控到历史复盘的多种需求。