dsh-stats-dashboard

⚠️ 已停止独立维护：本项目的完整功能已经合并到 dsh-usage-dashboard-plus。请迁移到 Plus，不要与 Plus 同时安装。

This repository is deprecated. Its full implementation has been merged into dsh-usage-dashboard-plus. Use Plus for new installations.

📊 DeepSeek Harness 插件 — 用量统计看板：按供应商/模型汇总响应速度、调用日志、Token 用量与费用估算

---

✨ 功能特点

核心指标

• 缓存命中率 — 全局和分模型的缓存效率一目了然
• 响应速度 — 平均耗时、首 Token 延迟 (TTFT)、吞吐量 (tok/s)
• Token 用量 — 输入/输出/缓存读/缓存写 完整统计
• 费用估算 — 基于内置 DeepSeek 官方定价表实时计算

多维度分析

• 供应商维度 — 支持 DeepSeek、OpenCode、OpenCode-Go 等多供应商
• 模型维度 — 按 deepseek-v4-flash、deepseek-v4-pro 等分模型统计
• 会话维度 — 跨会话汇总，单会话筛选
• 时间维度 — 日期范围筛选，实时更新

交互功能

• 🔄 实时刷新 — 手动刷新获取最新数据
• 📥 CSV 导出 — 导出筛选后的调用日志
• 🔍 多维筛选 — 搜索/供应商/模型/会话/日期范围
• ⬆️⬇️ 表格排序 — 点击列头按任意指标排序

数据展示

• 7 张总览卡 — 调用次数、费用、缓存率、输出、输入、缓存读、缓存写
• 供应商芯片 — 快速查看各供应商用量和费用
• 模型统计表 — 12 列详细指标，按需排序
• 调用日志 — 最近 500 条调用明细，含完整费用和性能指标

---

📦 安装

推荐迁移方式

请停用当前 profile 中的 dsh-stats-dashboard，改为安装：

dsh plugin --profile web add dsh-usage-dashboard-plus

Plus 已包含本仓库的 usageDashboard projection、调用日志、TTFT、响应速度、缓存率、Token 统计、费用估算和 CSV 导出，并且额外支持余额、今日花费和外部视觉调用统计。

下面的安装方式仅用于查看历史版本或开发旧代码，不建议新用户继续使用。

方式一：通过 DSH 插件命令（推荐）

dsh plugin --profile web add "github:1HelloMan1/dsh-stats-dashboard#main"

方式二：手动安装

# 克隆仓库
git clone https://github.com/1HelloMan1/dsh-stats-dashboard.git

# 复制到 DSH profile 的 node_modules
cp -r dsh-stats-dashboard ~/.dsh/profiles/node_modules/

# 编辑 DSH profile 的 cordis.patch.yml，添加插件 insert
echo '
- insert:
    - id: stats-dashboard
      name: "dsh-stats-dashboard"
' >> ~/.dsh/profiles/web/cordis.patch.yml

# 重启 DSH
kill $(pgrep -f "dsh web") 2>/dev/null
npx @deepseek-ai/dsh web

方式三：通过 npm（待发布）

npm install -g dsh-stats-dashboard
dsh plugin --profile web add dsh-stats-dashboard

---

🚀 使用

1. 启动 DSH Web 界面
2. 点击左下角 设置 齿轮图标
3. 切换到 插件 选项卡
4. 点击 统计看板 标签页
5. 看到完整的用量统计看板

筛选数据

• 搜索框 — 模糊搜索供应商、模型、会话名
• 供应商下拉 — 按供应商筛选（或点击右侧供应商芯片）
• 模型下拉 — 按模型筛选
• 会话下拉 — 按具体会话筛选
• 日期范围 — 选择开始和结束日期

导出数据

1. 先用筛选器选择要导出的范围
2. 点击 导出 CSV 按钮
3. 自动下载 dsh-stats-YYYY-MM-DD.csv 文件
4. 可用 Excel 直接打开（UTF-8 BOM 编码，无乱码）

---

⚙️ 配置

内置定价表

插件内置 DeepSeek 官方定价（CNY/百万 tokens）：

模型	输入（未命中）	缓存读	输出
deepseek-v4-flash	¥1.00	¥0.02	¥2.00
deepseek-v4-pro	¥3.00	¥0.025	¥6.00
deepseek-chat	¥2.00	¥0.50	¥8.00
deepseek-reasoner	¥4.00	¥1.00	¥16.00

自定义定价

编辑 lib/index.js 中的 PRICING 对象添加新模型：

const PRICING = {
  "your-provider\u0000your-model": {
    inputUncachedCny: 1.0,
    cacheReadCny: 0.02,
    outputCny: 2.0
  }
};

---

📁 文件结构

dsh-stats-dashboard/
├── lib/
│   ├── index.js      # Host 端：投影注册、定价表、费用计算
│   └── client.js     # Client 端：看板 UI 组件
├── cordis.patch.yml  # DSH bundle patch 声明
├── package.json      # 插件元数据
└── README.md         # 本文件

---

🔧 工作原理

数据流

会话日志 → dsh-session-stats 投影 → session.list RPC
     ↓
dsh-token-meter 投影 → Token 用量 + 费用估算
     ↓
Client 拉取 session.list → 聚合/筛选/渲染

后端投影

• sessionStats — 调用次数、耗时（LLM/首Token/解码）、Token 桶
• tokenUsage — 输入/输出/缓存读/缓存写 Token
• usageDashboard（本插件注册）— 按 provider/model 聚合统计 + 调用日志

前端组件

• StatsLine — 底部统计条（响应速度、缓存率、Token 汇总）
• ContextMeter — 上下文占用环
• UsageDashboardTab — 设置页统计看板（本插件）

---

🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支：git checkout -b feature/amazing-feature
3. 提交更改：git commit -m 'Add amazing feature'
4. 推送到分支：git push origin feature/amazing-feature
5. 提交 Pull Request

开发环境

# 克隆仓库
git clone https://github.com/1HelloMan1/dsh-stats-dashboard.git
cd dsh-stats-dashboard

# 链接到 DSH profile（开发模式）
ln -s $(pwd) ~/.dsh/profiles/node_modules/dsh-stats-dashboard

# 修改代码后，刷新 DSH 页面即可生效（无需重启）

---

📄 License

MIT License - 详见 LICENSE

---

🔗 相关资源

• DeepSeek Harness — DSH 官方仓库
• awesome-deepseek-harness — DSH 生态插件列表
• DSH 插件开发指南 — 官方插件开发文档
• DeepSeek API 定价 — 官方 API 价格

---

🙏 致谢

• DeepSeek — 提供强大的 AI 模型
• DeepSeek Harness — 开源 Agent 框架
• 所有 DSH 社区贡献者

---

如果觉得有用，请给个 ⭐ Star 支持一下！