dsh-session-stats-panel

Readme

<div align="center">

# 📊 dsh-session-stats-panel
### 💰 DeepSeek Harness 实时会话统计 · 官方峰谷计费 · 账户余额看板插件

[![Marketplace](https://img.shields.io/badge/Harness%20Marketplace-Available-purple.svg?style=flat-square&logo=deepseek)](https://github.com/a1113622001/dsh-session-stats-panel)
[![Release](https://img.shields.io/npm/v/dsh-session-stats-panel?style=flat-square&color=blue&logo=npm)](https://www.npmjs.com/package/dsh-session-stats-panel)
[![Node](https://img.shields.io/badge/Node.js-%3E%3D20-green?style=flat-square&logo=node.js)](https://nodejs.org/)
[![License](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](LICENSE)

[English](./README.en.md) · [简体中文](./README.md)

</div>

---

## 📖 项目简介

**dsh-session-stats-panel** 是已上架 **DeepSeek Harness 官方插件市场** 的会话计量与成本监控客户端插件。

无侵入式挂载在页面右侧，实时展示当前会话的 **Token 缓存命中率**、**官方峰谷计费估算**、**DeepSeek 官方账户余额**、**运行时长** 与 **累计 Tokens**，让大模型 Agent 开发的成本与效率一目了然。

---

## 🛒 插件市场与安装方式

### 方式 1：通过 Harness Web 插件市场一键安装（推荐）
1. 打开 DeepSeek Harness Web 界面（默认 `http://127.0.0.1:3080`）；
2. 进入 **`设置 (Settings)`** -> **`插件市场 (Plugin Inventory / Market)`**；
3. 搜索 **`dsh-session-stats-panel`**，点击 **`安装 (Install)`** 即可完成热加载。

### 方式 2：通过 Harness CLI 命令行安装
```bash
# 官方插件名一键添加
dsh plugin add dsh-session-stats-panel

# 或指定 profile 安装
dsh plugin --profile web add dsh-session-stats-panel

# 或直接从 GitHub 安装
dsh plugin add github:a1113622001/dsh-session-stats-panel
```

---

## 📊 监控指标看板

| 核心指标 | 数据源与计算方式 | 业务价值 |
| :--- | :--- | :--- |
| **平均命中率** | `cacheReadTokens / 计费输入 Tokens` | 直观评估 Prompt Caching 优化效果 |
| **会话估算费用** | 按照 DeepSeek 官方峰谷价格表动态计算 | 精确核算单次 Agent 任务运行成本 |
| **剩余账户余额** | 服务端凭据隔离路由拉取（每 2 分钟刷新） | 避免 Key 暴露前端的同时实时监控余额 |
| **累计 Tokens** | 未命中输入 + 缓存读写 + 输出（千分位展示） | 掌握上下文膨胀与消耗规模 |
| **模型请求次数** | 会话中模型调用步骤（`steps`）计数 | 监控 Agent 思考轮数与工具调用频次 |

---

## 🕒 2026 官方最新峰谷定价支持

插件内置 DeepSeek 官方最新峰谷计费规则（按北京时间自动切换）：
- **工作日高峰时段**（周一至周五 09:00–12:00，14:00–18:00）：按标准基准价计费；
- **工作日空闲时段**（其余时段）：**全线 5 折半价计费**；
- **周末全天特惠**（2026年8月23日起周六、周日全天）：**全天统一按照低谷/空闲时段 5 折计费**；
- **模型覆盖**：原生支持 `deepseek-v4-flash`、`deepseek-v4-pro`、`deepseek-v4-flash-vision-exp` 及历史/兜底模型。

---

## 🔒 服务端凭据隔离安全设计

```mermaid
flowchart LR
    subgraph Browser ["🌐 前端浏览器 (Panel UI)"]
        UI["会话面板看板 (仅 GET 请求余额数值 / 0 密钥暴露)"]
    end

    subgraph Backend ["🖥️ Harness 后端服务"]
        Route["/plugins/session-stats-panel/balance 路由"]
        Cred["Credentials 服务 (本地存储安全解析)"]
    end

    subgraph Official ["☁️ DeepSeek 官方接口"]
        API["DeepSeek 官方账户余额 API"]
    end

    UI -->|GET 轮询| Route
    Route --> Cred
    Cred -->|附带 Key 请求| API
    API -->|返回 Balance 数据| Route
    Route -->|仅下发纯数值| UI
```

---

## 📄 开源许可证

本项目采用 [MIT License](LICENSE) 授权开源。