dsh-token-monitor

English · 简体中文

整个插件，除了这一行字以外，由DeepSeek Harness生成

给 DeepSeek Harness 用的悬浮小窗：显示账户余额、当前对话已消耗的 token，以及按官方价目估算的本次对话花费。

贴在窗口右边缘的一个窄竖条 + 展开卡片，可拖动、可收起，不占阅读空间。

┌──────────────────────┐ ┌──┐
│ ● 你的对话标题     × │ │¥ │
│ 余额        ¥25.87   │ │25│
│ 本对话     ≈¥0.42 25.4M│ │.8│
└──────────────────────┘ └──┘
        悬停后展开明细 ↑

功能

• 余额：读 DeepSeek 账号服务，显示充值钱包（悬停可看赠送余额）
• 本对话消耗：累加该会话里每次模型调用的 usage
• 本次对话花费：按 DeepSeek 官方价目估算，分模型、分高峰/空闲时段
• Search / Fetch 计费：统计 web_search / web_fetch 调用次数，按官方 5 元/千次计价 （官方说明 2026-11-01 00:00 前不计费，插件会按日期自动决定是否计入）
• 价格每月自动更新：从官方价目页抓取，缓存 30 天，抓失败就继续用旧值
• 跟随当前对话：切换会话立即刷新（识别 DOM 选中态，宿主按标题/id 反查）
• 跟随应用语言：简体中文 / English，应用里切语言即时同步
• 可拖动：竖条上下拖，浮窗与竖条始终垂直对齐；位置按视口比例记忆
• 不打扰：悬停 320ms 才展开明细；鼠标停在 × 那一排时不展开，避免点不中

安装

插件是标准的 DSH bundle，同时带 host 半（index.js）和 client 半（client.js）。

命令里的 <profile> 换成你要装的 profile 名；桌面版就是 desktop。 dsh plugin 会把参数原样转给 pnpm，所以任何 pnpm 能装的 spec 都行。

方式 A：从 GitHub 直装（推荐，当前唯一可直接用的一键方式）

dsh plugin --profile <profile> add github:Ta9y/dsh-token-monitor

方式 B：图形界面

设置 → 插件 → 安装，粘贴 github:Ta9y/dsh-token-monitor。

方式 C：手动（适合本地开发调试）

cd $HOME\.dsh\profiles\desktop
pnpm add file:C:/path/to/dsh-token-monitor

然后把 dsh-token-monitor 加进该目录 package.json 的 dsh.profile.bundles 数组。

方式 D：从 npm

⚠️ 尚未发布到 npm，这条命令现在会 404。等发布后可用：

dsh plugin --profile <profile> add dsh-token-monitor

安装后需要重启一次 DSH 进程：host 半的代码走 ESM 缓存，重载插件不会重新执行。 之后改 ui.js / config.json 只要刷新页面即可。

配置

config.json（插件目录下，改完刷新页面生效，不用重启）：

{
  "pollSeconds": 10,        // 页面轮询间隔（秒）
  "balanceSeconds": 60,     // 余额查询间隔（秒）
  "autoPrices": true,       // true = 每月从官网抓价；false = 只用手写的 prices
  "searchPer1000": 5,       // Search 单价（元/千次）
  "fetchPer1000": 5,        // Fetch 单价（元/千次）
  "searchBillingFrom": "2026-11-01",
  "prices": {               // 元 / 百万 token，按模型 + 时段
    "deepseek-flash": {
      "offpeak": { "cacheHit": 0.02, "cacheMiss": 1, "output": 4 },
      "peak":    { "cacheHit": 0.04, "cacheMiss": 2, "output": 8 }
    },
    "deepseek-v4-pro": {
      "offpeak": { "cacheHit": 0.15, "cacheMiss": 4.5, "output": 13.5 },
      "peak":    { "cacheHit": 0.3,  "cacheMiss": 9,   "output": 27 }
    }
  }
}

花费是怎么算的

单位：元 / 百万 token。高峰 = 北京时间工作日 9:00–12:00、14:00–18:00，其余时段（含周末）为半价。

• 模型从会话的 requestContext() 读出；未知模型回落到 deepseek-flash
• 按调用发生的时段计价：每次 usage 按事件时间分进「高峰桶 / 空闲桶」，各用自己的单价
• Search / Fetch 按次计费，和 token 是两笔账
• 法定节假日未处理，所以结果是估算，不是账单金额

价格来源：DeepSeek 官方价目页， 由插件每月自动抓取并缓存在 prices.auto.json（含 fetchedAt）；解析失败时保留旧值。

隐私

• 不读取登录令牌、不碰 API Key
• 余额只通过 DSH 自己的账号服务（ctx.deepseekAccount.getBalance()）读取
• 不向任何第三方发请求；唯一的出站请求是每月一次抓官方价目页
• 数据只在本机内存 + 浏览器 localStorage（竖条位置）里
• 本地写入的文件：debug.log（诊断，可删）、token.txt（页面随机令牌）、prices.auto.json（价格缓存）

兼容性

• 需要 DSH 0.2.x（@deepseek-ai/dsh-base + dsh-web-app 组合）
• 桌面端通过 dsh.client 客户端模块注入；纯浏览器模式（dsh web）通过 index 注入
• 只在 Windows 的 desktop profile 上实测过

已知限制

• 只统计主会话，不含子任务（subagent）的花费
• 会话必须是 Host 内存里的 live session 才能统计；冷会话显示 —
• 法定节假日的高峰/空闲判断不准（会影响估算）

开发

index.js            host 半：读余额、累加 usage、HTTP 路由、价格抓取
client.js           client module：把 ui.js 挂进页面，并桥接应用语言
ui.js               悬浮窗本体：纯 DOM + Shadow DOM，无构建、无依赖
cordis.patch.yml    bundle 层：插入插件行
config.json         默认配置
test/smoke.mjs      假 ctx 的回归测试（npm test）
test/prices.mjs     拿真实官方页面验证价格解析（npm run test:prices）

两个容易踩的坑

1. bundle patch 插入新行必须用 insert:。- id: xxx 是「覆盖已存在条目」的语义， 条目不存在时只打印 patch: entry "xxx" not found 然后静默跳过 —— 插件看起来装好了但根本没加载。

   - insert:
       - id: dsh-token-monitor
         name: 'dsh-token-monitor'
   

2. 路由/注入注册必须包在 ctx.effect() 里。否则插件热重载时旧路由不会释放， 新实例注册同名路径直接抛 duplicate route，apply 半路夭折（表现为"改了代码没反应"）。

发布到 GitHub

cd dsh-token-monitor
git init
git add .
git commit -m "feat: dsh-token-monitor 1.0.0"
git branch -M main
git remote add origin https://github.com/Ta9y/dsh-token-monitor.git
git push -u origin main

如果想换仓库地址，改 package.json 里的 repository / homepage / bugs 三处即可。

仓库建好后记得加 Topics（右侧 About 旁的齿轮）：

dsh-plugin  dsh  deepseek-harness  deepseek  plugin  token  cost  balance

dsh-plugin 是检索 DSH 插件时最主要的标签。

License

MIT