前言¶

DeepSeek Harness（DSH）是一个面向 AI Agent 开发的 CLI 工具，其核心设计理念是「一切皆插件」。在实际开发与调试过程中，开发者需要持续追踪 Token 消耗、缓存命中率、实际费用以及接口延迟等关键指标，以便优化模型调用策略和控制成本。dsh-metrics-panel 是一个为 DSH 生态设计的监控面板插件，它能在 Web 界面中提供实时统计功能，解决上述痛点。

功能特性¶

该插件主要提供以下能力：

• 实时统计：统计 Token 用量、缓存命中、费用与延迟。
• 可视化展示：提供概览曲线、请求明细与错误清单。
• 多维聚合：支持按模型、供应商、工具进行用量与费用聚合。
• 计费配置：支持可配置的计费单价，用于计算实际费用。
• 界面定制：支持主题切换（浅色/深色/跟随系统）与面板配色切换（5套），并支持全量刷新历史数据。

安装与启用¶

安装前请确保已安装 DeepSeek Harness CLI (@deepseek-ai/dsh)。通过官方插件命令安装：

dsh plugin --profile web add github:bulai-z/dsh-metrics-panel

安装完成后，启动 Web 界面即可使用：

dsh web

使用方法¶

打开页面后，在侧边栏底部找到「监控面板」入口并点击。

• 时间筛选：使用顶部的时间范围选择器（1h/24h/7d/30d/90d）查看不同时间维度的数据。
• 费用配置：在「费用」分区设置单价与货币单位，点击保存后实时重算。
• 历史数据：点击「全量刷新历史」可补齐未打开过的会话数据。

注意事项¶

• 数据持久化：面板数据基于运行期内存态，插件停止或进程重启后数据会清空。
• 安全脱敏：HTTP 请求示例中的 Authorization 字段已脱敏为 <redacted>。
• 声明检查：若安装后提示 declares no dsh.bundle，说明 package.json 中的 dsh.bundle 声明缺失，插件无法激活。

结语¶

dsh-metrics-panel 是一个实用的 DeepSeek Harness 辅助工具，适合需要在开发过程中实时监控模型调用成本与性能的开发者。更多细节可查看其GitHub 仓库或社区目录。