Skip to content

dsh-token-panorama

Verified

dsh-token-panorama · v1.0.5 · MIT · Web UI

Token panorama for DSH: totals, cache hit rate, peak/off-peak cost, calendar heatmap, session tree, workspaces, CSV/JSON export, plus context clear/compact actions, prompt optimization, and auto answers for ask_user_question batches.

Install

dsh plugin add dsh-token-panorama

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

Token Panorama for DSH(用量概览 · 中文说明)

一个 DeepSeek Harness 功能插件,看清全部会话的 token 去向:一个面板汇总累计总量、日历热力图、趋势曲线、 模型分布、逐会话用量明细,以及 CSV / JSON 导出。另带三组工具:上下文清理 / 压缩按钮、提示词优化按钮, 以及在你不在场时代答 ask_user_question 的问答功能。

数据全部来自平台自带的会话持久化服务,不解析日志文件,也不依赖任何第三方库。

功能

  • 累计统计:总 token 消耗,输入 / 输出 / 缓存读取 / 缓存写入各多少,调用了多少次。
  • 缓存命中率:缓存读取占输入侧 token 的比例,命中和未命中的绝对量都列出来。
  • 成本折算:按 DeepSeek 分时段价格(高峰 / 空闲)估算花费,峰谷金额分开列。
  • 日历热力图:GitHub 风格的周列视图,也可以切成每月一个小日历。
  • 趋势曲线:按日 / 周 / 月 / 年聚合,悬停时间点看具体数值。
  • 模型分布:按用量排序展示各模型来源(Provider/模型ID)的 token 与调用次数;同一模型 ID 来自不同 Provider 时各占一行。点某个模型后,下方统计(热力图、趋势、成本、峰谷、会话列表) 只算它一个,再点一次取消。
  • 工作区分布:按会话头记录的工作目录分组,一眼看出哪个项目最耗 token。
  • 会话用量明细:默认只列主会话,点箭头展开名下的子代理,卡片高度不会跟着子代理数膨胀。 表头可排序,归档会话带标记、能用复选框隐藏;时间范围变化后,每个会话只统计落在范围内的部分。
  • 分页:每页 40 组会话,量再大也不会一次渲染全部行。
  • 统一时间范围:顶部过滤器控制全局(全部 / 今天 / 近 24 小时 / 本周 / 近 7 天 / 本月 / 近 30 天), 下方每张卡片(热力图、趋势、成本、峰谷、模型、会话、工作区)都按同一段范围重算, 也可以自选 起始 / 结束 日期。
  • 小时粒度:范围缩到「今天」或「近 24 小时」,趋势图横轴自动切成小时,没活动的小时补零画出来, 折线不会把两段活动连成一段。
  • 数据导出:按天明细导出 CSV / JSON,也可以单独导出会话级 CSV(含工作区、父会话、成本列)。
  • 增量刷新:按会话的 revision 判断要不要重读,刷新时只解码真正变化的会话。
  • 节假日自动更新:任意年份运行时联网拉取并缓存,跨年不用等新版本。
  • 上下文操作:输入框下方 dock 里的「清空上下文」(橙)和「压缩上下文」(绿),也提供 /clear-context、/compact-context 与 /compact 命令。压缩可以在会话运行中用:先定好截断点 再让模型写摘要,压缩期间新产生的对话原样保留、接在摘要之后,检查点复用平台自带的 「上下文已压缩」标记展示条数与 token。/compact 的一次压缩会把命令行与标记折叠成一张合并卡片, 跟平台自带压缩一致。清空替换整个表层,因此要求会话空闲。
  • 提示词优化:常驻输入框工具栏的「优化提示词」按钮,把草稿交给可配置的优化模型改写,结果粘贴 回输入框,附件不动。可以让请求附带当前会话的上下文摘录,改写贴合正在进行的任务,指代「这个函数」 的提示词能改写成指名道姓的版本。指令、模型路由和上下文开关在「提示词优化」设置页配置。 模型直接返回提示词正文,不带代码块也不带块外建议,因此填入输入框的内容就是最终要发送的内容; 若你自己改写了指令并要求围栏,插件只会剥掉包住整段回答的那一层,块外文字会一并留下。
  • 问答功能:代替你回答 ask_user_question 的提问,让你不在时运行不会卡住。默认关闭;权限审批、 凭据密钥、不可逆操作、付费与发布类提问永不代答。指令、模型路由与等待上限在「问答功能」设置页配置。
  • 中英双语:跟随平台语言设置。

环境要求

  • DSH >= 0.2.1-rc.3(在 dsh.engines.dsh 中声明)。
  • 使用 Web UI 的 profile;插件注册到 sidebar.panellist 与 main 两个插槽。

安装

在「插件」页面安装,或通过 plugin manager 指向本包目录(含 package.json 的文件夹):

plugin_manager install_bundle target="<本目录的绝对路径>"

安装后侧边栏出现 Token 统计 入口,点击即可打开主面板。

卸载:在「插件」页面卸载 dsh-token-panorama 即可。

npm 包与下载量口径

本插件同时发布到公共 npm registry,包名 dsh-token-panorama。目录站(awesome-dsh-plugin)与 应用内市场可据此按包名安装并显示下载量;未发布到 npm 时才回退到 GitHub Release 的 tgz 附件。

  • 发布新版本:npm publish --access public。npm 要求开启两步验证,或使用勾选了 Bypass 2FA 的 granular access token。
  • 目录站会读取仓库 package.json 的 name,在 registry 上确认同名包,并要求该 npm 包的 repository 字段回指本 GitHub 仓库。这层映射自动从 registry 抓取,条目里无需、也不允许 手写 npm: 字段。
  • 市场显示的「下载量」是 npm 近 30 天(UTC 滚动窗口)下载数,来自 api.npmjs.org/downloads/point,由目录站每天夜间探测刷新。它不是「查看量 / 浏览量」: 目录与市场都不提供任何访问量字段。GitHub Release 附件的下载次数是另一套独立计数, 不会进入这个字段。
  • 每次修改都会迭代 package.json 的 version,并发布新版本,使 registry 的 latest 与目录里的 version 保持一致。

使用

  1. 在侧边栏点击 Token 统计。
  2. 用两个日期输入框或快捷按钮调整时间范围。
  3. 热力图可在 周 / 月 之间切换;趋势图可在 日 / 周 / 月 / 年 之间切换。
  4. 鼠标悬停趋势图任一数据点,查看该时间点的精确数值。
  5. 会话用量 表格默认只列主会话;点行首 ▶ 展开该会话,展开后能看到它名下所有子代理会话。 点表头(会话 / 消耗 / 调用 / 创建时间)切换排序,取消勾选 显示已归档 可只看仍在使用的会话 (该勾选状态会记住,下次打开沿用上次的选择),导出会话 CSV 落盘当前表格。
  6. 会话较多时用卡片底部的 上一页 / 下一页 翻页,每页 40 组。
  7. 点击 刷新 重新扫描,或点击 导出 保存按天明细的 CSV / JSON。
  8. 点击 常规设置 打开设置窗口,修改时区、货币、峰谷时段、节假日与价目表,保存后立即重新计价。

面板打开时会自动刷新。首次扫描后只解码发生变化的会话,历史数据量很大时也能很快加载。

计费配置

插件的全部计费参数都在 profile 的配置里,在面板右上角点「常规设置」就能打开设置窗口在线修改, 保存后立即重新计价,不用重启 DSH。

设置窗口按结构编辑配置,不是按字段名逐条渲染:模型价格是一张表、峰谷是可复用的方案、 节假日是勾选清单,这几样通用的键值编辑器都表达不了。窗口分七个标签页:

标签页 内容
模型与价格 每个模型一行,未命中输入 / 命中缓存输入 / 缓存写入 / 输出四个独立价格框,峰谷开关与方案下拉,最后一列固定是删除
峰谷方案 可复用的时段方案:名称、自动模式、若干「起止」窗口、空闲价比例
节假日 系统预封装的日历,勾选即生效
上下文 压缩指令、压缩模型路由、上下文占用、自动压缩与分段压缩开关
提示词优化 优化指令、模型路由,以及请求是否附带当前会话的上下文摘录
问答功能 代答指令、代答模型路由、等待上限,以及总开关
通用 计费时区与货币单位

窗口底部还有导出配置和导入配置。导出的 JSON 只含计费设置,不含任何会话数据,可以直接分享给别人; 导入只填表,确认无误后点保存才写进 profile。

模型列表默认只列日志里实际出现过的模型(按用量降序),打开窗口就能给正在花钱的模型定价, 不用先知道模型叫什么。还没定价的模型显示「未配置」和「添加价格」按钮,点一下就建行。

用量按 Provider/模型ID 归集,而不是只按模型 ID:会话日志在 assistant 消息的 source 里 同时记录了 provider 与 model,所以同一模型 ID 由不同 Provider 提供时,在模型分布里各占一行、 可以各算一份价格。Provider/模型ID 这一行单独配置了价格就用自己的;没配则沿用该模型 ID (裸模型名)的价格,再没有才走 defaultPrice——因此升级前写好的配置不用改就能继续用。 价格表里沿用来的行以只读显示「沿用 <模型>」,点「单独定价」即可从这些数字预填出一条 Provider/模型ID 的新价格(也可手动输入 Provider/模型 形式添加)。两者都没有时,面板会在 成本卡下面注明「某模型无定价,按默认价计算」,不会闷头按 0 算。

价格拆成四项填,因为供应商对同一段输入的处理并不等价:

列 含义 不单独计费时
未命中输入 首次送入、没命中前缀缓存的部分 填官方标价
命中缓存输入 命中前缀缓存、按折扣价读取的部分 填 0 表示不收取
缓存写入 把输入写入缓存的部分 填 0 表示不收取
输出 模型生成的内容 填官方标价

缓存这两项必须分开:写入是存进缓存,读取是从缓存取,单价通常差十倍以上。合成一列的话,正在预热 缓存的会话会算得偏便宜,稳定复用缓存的反而偏贵。缓存写入也不算进命中率的分母,它是写入,不是读取。

峰谷是独立配置,一个方案可以给多个模型复用:模型行的开关打开后选方案名就行。开关关着的模型 全天按标价(高峰价)计费,归入「高峰时段」,它实际付的就是这个价。方案改名时引用它的模型跟着 改;删掉方案会留下悬空引用,这时该模型仍按高峰价计费,行内提示「方案已删除,请重新选择」, 可以重选。

空闲价按比例算。方案里的「空闲价比例」是标价的百分比,默认 0.5 就是半价,所以价格表只维护一份, 改比例会把高峰和空闲两个时段一起重新计价。

自动模式

「自动模式」决定一段时段的生效日期,参考闹钟响铃规则:

模式 含义
每天 不限星期与节假日
法定工作日(智能跳过节假日) 周一至周五,且不在已勾选的节假日里
法定节假日(智能跳过工作日) 只在已勾选的节假日生效
周一至周五 只看星期,不管节假日
自定义 七个星期勾选框自由组合

时段窗口

每个方案可以有多条「起始 – 结束」窗口,24 小时制。多条窗口不是摆设:DeepSeek 的高峰是两个 不连续的区间(09:00-12:00 与 14:00-18:00),午休走空闲价。写成一条 09:00-18:00 的话,午休 那段会被算成高峰,高峰 token 从约 4.0 亿虚增到约 4.5 亿。

end 小于 start 时按跨零点处理,22:00-02:00 不需要拆成两条。

节假日

节假日日期在运行时联网拉取,缓存在 profile 下,跨年不用等新版本。 只补没有数据的年份:已发布的年份不再变,还没发布的年份(比如下一年)每天重试一次。 三个免密数据源按顺序尝试,全挂了就保留已有缓存。

插件内置了 2026 年的日期当种子,第一次运行、还没发出网络请求之前计价就是对的。 设置里显示已加载的年数,也有一个强制重新拉取的刷新按钮。默认勾选法定节假日那一组。

内置清单只是种子数据,不是权威来源:某一年一旦拉取成功,以网络副本为准。

上下文操作

输入框下方的 dock 里有两个按钮,和上下文用量环在同一行:左边橙色清空上下文,右边绿色压缩上下文。 它们同时也是斜杠命令 /clear-context 与 /compact-context,不用鼠标也能触发。

两者的差别在替换范围。清空取整个表层,因此要求会话空闲:改写期间追加的步骤会跟着它依赖的 历史一起被丢掉。压缩只取调用摘要之前就选定的一段,终点落在最后一个不切断 tool-call/result 配对的位置,所以会话运行中也能用,压缩期间写入的内容会原样重放在检查点之后。两种情况下 会话和日志都原样保留,事件还在磁盘上,只是表层不再显示被替换的部分,上下文窗口也就腾出来了。

  • 清空:写入一行占位说明。它不是摘要,下一条消息之前的内容都不再保留。
  • 压缩:直接调用模型写出摘要,再用它替换那段历史。默认沿用会话的 provider 与模型, 可在「上下文」标签页覆盖。这段历史按原样的消息重放给模型(同样的系统提示词、同样的 工具定义,指令放在最后),provider 的前缀缓存能覆盖整段历史,这次调用按缓存命中计价, 不用把历史重发一遍。全程不派子代理,没有子会话也没有属于自己的工具,不会顺手改动任何东西。

两者完成后,对话里会出现一条命令卡片,按钮下方不再给一份重复的提示。两个按钮的反馈文本和 统计口径不一样:清空报告替换前后的条数与 token,压缩还会多报写入摘要的字符数。它们走平台 原生的 command/run / command/done 事件,卡片可见、可展开,但不进会话表层,不会污染模型上下文。

压缩用的提示词在设置窗口的「上下文」标签页里可编辑,同一页还能指定压缩模型的 provider 与模型,留空即沿用会话的。默认提示词是一份中文的「工作状态存档」指令,要求写清目标、 决策及理由、被否决的方案、原样路径与签名、报错原文、精确数值和未完成事项,按八个章节组织, 并明确禁止提及压缩本身。

内置的三段默认提示词(压缩、优化、问答)共用同一套结构:# 角色定义、## 核心能力、 ## 核心红线、## 工作流程、## 交付格式。它们分属「上下文」「提示词优化」「问答功能」三个标签页, 但共用同一套骨架,改其中一段时其余两段照着对齐即可。默认值存放在 lib/contextops.js 的 DEFAULT_COMPACT_PROMPT / DEFAULT_OPTIMIZER_PROMPT 与 lib/ask.js 的 DEFAULT_ASK_PROMPT,test/prompts.test.mjs 会把这三条性质(同一套五标题结构、 自身只用半角标点、各自的专属条款)钉死,避免以后改写时漂移。

三者都遵守两条与调用点直接相关的约定:

  • 优化指令不要求代码块。改写结果会被原样填入输入框,而接收端只会剥掉包住整段回答的首尾围栏; 若提示词要求「代码块 + 块外建议」,那些建议文字会一并进入待发送的草稿。
  • 压缩指令里的标点规则只约束模型自己写的叙述。被逐字复现的原文(引号内内容、用户原话、 报错信息、代码、配置值)保持其原始标点,不得替换——这与「逐字保真」是同一件事。 分段压缩时,输入如带「第 N/M 段」或「合并」说明,一律以分段说明为准。

同一页还有三块与「窗口还剩多少」有关的内容:

  • 上下文占用:显示当前会话按「系统提示词 + 工具定义 + 对话消息」三项算出的真实总占用, 以及所选模型的输入上下文上限、占用比例与三项分项。
  • 自动压缩开关与触发阈值(默认 75%):决定本插件在每一步开始前自动压缩的时机。 同一会话两次压缩之间至少间隔一分钟,避免刚压完仍超阈值时每一步都再付一次摘要。 触发挂在与平台引擎同一个 agent/pre-step 事件上,但由本插件执行,不写任何平台配置。 某个 profile 完全可能禁用平台引擎(dsh-compaction-basic 可以被整行关掉,preset 内嵌 的行本来也改不到),那样开关存进去了也没人生效。判定用的是上面那三项 真实总和,不是平台面板顶部按 provider usage 锚定的那个数字,后者在长会话里可以显示 112K,而同一份请求实际带着 2.3M。
  • 超出上限时分段压缩:决定历史大于摘要模型窗口时怎么办。关闭时丢弃最早的部分,只把 最近能装下的记录交给模型,并用显式标记写明丢了多少条。开启时按上限切成多段,并行各写 一份摘要,再由最后一次请求整合成一份替换整段历史,不丢历史,也不会有哪次请求越过窗口。 长对话压缩时模型无响应或返回空,原因就在这里。
  • 压缩前会先量一次体积。历史若已超过摘要模型窗口的 2/3 且没开分段,就退回到「头尾摘录」: 开头保留目标与约束,结尾保留正在进行的事,中间以显式标记省略。被压缩的那一段伸进正在 运行的轮次也没关系,交给模型的就是这些消息本身,摘要正好覆盖检查点要替换的内容。
  • 摘要被输出上限截断时是重试,不是接受。截断的检查点会用一份说到一半就停的摘要替换真实历史,所以 第一次尝试沿用会话当前发出的输出预算,之后每次重试把预算翻倍,上限是 64000 tokens(平台自己为压缩 预留的输出量),历史、提示词与模型都不动。只有 max-tokens 会重试;适配器报错在第一次就抛出,不 为同一个错误付两次钱。所有档位都被截断时放弃这次压缩并点名截断原因,不会有半份摘要替换历史。
  • 压缩锁在调用摘要之前就打开,不是之后。第二次请求会直接答「已有压缩在进行中」, 不会为同一份摘要付两次钱,平台自己的引擎也会让路。

对已经清空过的会话再清一次是空操作,按成功返回:拿一个占位换另一个同样的占位不算错误。

问答功能

模型需要人做决定时会调用 ask_user_question 并停下等待。本插件可以代你回答这批问题,让运行不会因为 你不在而卡住。它默认关闭:开关关着时插件对每一批问题都原样放行,提问照旧弹到你面前。

机制用的是平台自己的:提问经由 user-questions/request 上的 cordis waterfall 发出,任何监听者都可以 作答,谁先返回一批答案就由谁生效。插件以 prepend 注册这一个监听者,因此会排在人机卡片之前被询问 (排在它后面的话卡片先弹出来,代答永远没有机会)。作答是一次直接的 llm.stream 调用,只带问题与指令, 不传工具:模型除了文本什么也做不了。

除了一次确定的回答,其他所有结果都会把问题交回链上:开关关着、问题落在禁区、没有可路由的模型、答案解析 不出来、选项不是问题里给过的、调用失败、等待超时。问题随后照常到你手上,所以这里出问题最坏是多看一次 卡片,不会让问题消失。

无论如何都不会代答的:权限与审批、计划评审(任何带 intent 的批次)、凭据与密钥、API Key 与验证码、 删除与一切不可逆操作、付费与购买、发布与部署。检查是对问题正文和每个选项做关键词匹配,刻意宁滥勿缺: 误判的代价是多看一张卡片,漏判的代价是模型替你做了一个绝不该由它做的决定。

设置窗口的问答功能标签页里有开关、代答模型读到的指令、它的 provider 与模型(留空沿用会话的),以及 等待上限。上限按秒计,与 ask_user_question 同一口径:-1 表示不限时,其余必须是 1 到 2147483 的整数。 这个范围来自平台本身,工具会拒绝的值这里也存不进去。

答案在你看得到的地方有标注:模型给出的答案末尾带着是哪个模型答的(由 <provider>/<model> 代答),写在 答案正文里,因为问题服务只搬运 {id, selected, custom} 三项,其余字段会被丢掉。这次调用的花费记在工具账 本的 ask-answer 名下,并在用量概览里以「代答 N」显示,与压缩、优化并列。

答案也不会写进会话记录:问答卡片显示答了什么,下一轮的内容是模型自己的产物,因此代答做过的决定不会以 「你说过」的形式混进之后的摘要。

校验

所有值在保存前由平台 schema 与插件自身各校验一次:非法时区、非法 HH:MM、负数价格、 不在 0–1 的开区间内的空闲价比例、未知的自动模式都会被拒绝,并指出是哪一项不合法。

升级

1.0 的配置结构(peakWindows 单表、hitPeak/missPeak/outPeak 六字段价格、日期数组 形式的节假日)会在读取时自动迁移:高峰价成为新的标价,启用了空闲价的模型自动挂到 standard 方案上,日期数组折回对应的日历键。迁移是只读的,磁盘上的旧配置不被改写, 直到你在窗口里点保存。

窗口内所有文案都在 client.js 的 ZH / EN 字典里,两种语言各 285 个键,键集完全一致。

保存走平台的 configEditor 服务:先做 schema 校验,再把整份配置写进 profile 的 cordis.patch.yml 并触发热重载。插件在保存前也会自己校验一遍,把错误定位到具体字段, 而不是抛一个 Loader 级的失败。若当前 profile 没有该服务或对应条目,窗口会退化为只读并说明原因。

说明:DeepSeek 的高峰规则字面是「周一至周五」,所以调休补班(周末上班)的日子仍按空闲价计算, 面板不会把补班日算成高峰。价格单位是「每百万 tokens」,与官方公告一致。

数据统计口径

  • 数据源:Host 的 sessionPersistence 服务列出全部会话及其不透明版本号 revision。版本号未变的会话直接 跳过;其余会话先只走一遍日志的 Zstandard 帧表(不解压),只解码上次扫描之后新增的帧——语料没变时 一个字节都不解压,需要重读时也只解码日志尾部而不是整段历史。
  • 计数:每条带 data.usage 的 assistant/message 事件计为一次调用。总量优先取 usage.totalTokens, 缺失时回退为 inputTokens + outputTokens + cacheReadTokens + cacheWriteTokens。
  • 范围:当前 profile 下的全部会话,包含子代理会话(header.origin === 'subagent')与已归档会话; 页脚分别统计主会话、子代理和归档数量。
  • 会话标题:从每个会话自己的 session/title 事件中取最后一条,不依赖可变的元数据。
  • 归档标记:读 workspaceRegistry.archivedSessionIds;该服务缺失时按「无归档」处理,不影响其他统计。
  • 工作区:取会话头事件(type: "session")里的 cwd;没有 cwd 的会话归到「(无工作区)」。
  • 父子关系:取会话头里的 parentSession。父会话不在本次统计内时,该子代理按顶层条目展示。
  • 时间桶:按事件时间戳所处的本地日历日归类;计费额外按小时划分,小时桶用配置时区换算。
  • 缓存:折叠结果写入 ~/.dsh/storages/dsh-token-panorama/usage-cache.json(CACHE_VERSION = 5), 通过临时文件 + 重命名原子写入。每条记录同时保存已折叠到的字节偏移与最大序号,下一轮可直接续读。
  • 投影种子:Host 挂载 sessionProjections 时,本插件注册自己的折叠单元(tokenPanoramaUsage), 由 Host 在事件提交时持续维护。投影行已经追平日志末尾的会话完全不读日志,直接采用该行。只有在状态版本、 时区、水位线和日志身份全部吻合时才采信;任何一项不吻合就退回读日志,所以种子只会省事,不会改变结果。 没有该服务时行为与原先一致。读不出来的日志按 revision 记住十分钟,不再每轮重复解码。
  • 准确性:总量严格等于底层 usage 记录之和,面板不做任何估算;会话行跟随所选时间范围, 各会话在该范围内的用量之和与热力图对应日期完全一致;成本按小时计价后汇入日、模型与会话三个维度, 三者的求和恒等于总量。

HTTP 接口

Host 在 /token-stats/api 注册前缀路由。请求必须通过平台的 Host / Origin 校验 (ctx.connection.requestRejection),且为 POST + JSON 体。

方法 请求体 说明
summary {} 返回当前快照,仅重新扫描发生变化的会话。
summary {"refresh": true} 不信任本插件的折叠结果并重建,仍会采用能通过校验的 Host 投影行。
refresh {} 等价于强制刷新。
config {} 返回当前配置、字段描述与可编辑状态;models 附 Host 实时模型目录(含各自上下文上限)。
saveConfig {"value": {...}} 校验并保存配置,返回保存后的配置与字段描述。自动压缩由本插件执行,不写任何平台配置,因此没有「是否同步成功」这一项。
holidays {} 强制重新拉取节假日数据,返回是否变化与按年目录。
clearContext {"sessionId": "..."} 把该会话的整个表层换成一条占位说明。
compactContext {"sessionId": "..."} 直接调用模型压缩该会话,并用摘要替换表层。
contextPressure {"sessionId": "..."} 量一次该会话:总 token、系统提示词/工具定义/对话消息三项分项、路由模型的上下文上限与占用比例。

响应结构:

{
  "ok": true,
  "value": {
    "generatedAt": 1793511000000,
    "lastScanAt": 1793510999000,
    "scan": null,
    "sessions": { "total": 0, "subagent": 0, "main": 0, "archived": 0 },
    "totals": {
      "input": 0,
      "output": 0,
      "cacheRead": 0,
      "cacheWrite": 0,
      "total": 0,
      "calls": 0
    },
    "days": [["2026-11-01", 0, 0, 0, 0, 0, 0, 0]],
    "models": [["deepseek-v4.1-flash", 0, 0, 0]],
    "cache": { "hits": 0, "misses": 0, "hitRate": 0 },
    "billing": {
      "currency": "CNY",
      "timeZone": "Asia/Shanghai",
      "cost": 0,
      "peakCost": 0,
      "offPeakCost": 0,
      "peakTokens": 0,
      "offPeakTokens": 0,
      "peakCalls": 0,
      "offPeakCalls": 0,
      "hitRate": 0,
      "hits": 0,
      "misses": 0,
      "priced": ["deepseek-v4.1-flash"],
      "unpriced": []
    },
    "sessionRows": [],
    "firstDay": "2026-10-30",
    "lastDay": "2026-11-01"
  }
}

days 每行是 [日期, 输入, 输出, 缓存读取, 缓存写入, 合计, 调用次数, 成本]; models 每行是 [来源键, 输入, 输出, 缓存读取, 缓存写入, 合计, 调用次数, 成本],来源键为 Provider/模型ID(旧日志没有 provider 时是裸模型名); sessionRows 每行是 [会话 id, 标题, 创建时间, 是否子代理(0/1), 是否已归档(0/1), 合计, 调用次数, 父会话 id, 按天明细, 成本, 工作区, 按小时明细, 用过的模型名],其中按天明细为 [日期, 输入, 输出, 缓存读取, 缓存写入, 合计, 调用次数, 成本],按小时明细为 [小时, 来源键, 输入, 输出, 缓存读取, 缓存写入, 合计, 调用次数, 成本, 是否高峰(0/1)],来源键同上 为 Provider/模型ID 或裸模型名。 归档状态取自 workspaceRegistry.archivedSessionIds,归档会话的日志保留在磁盘上, 因此照常出现在 sessionPersistence.list() 中。

按小时明细是会话级的最小事实单元,整张表的每个数字都能从它推出,前端按范围、按模型筛选会话时 不必回 Host 再问一次。高峰标志随行下发:只有 Host 知道峰谷时段与节假日日历,前端自行推算就得 复制同一套规则,两套规则迟早会漂移。

三个额外的按模型字段供前端做「只看某个模型」的联动,避免二次请求:

  • modelDays:[模型名, [按天明细…]],用于按时间范围重算该模型的每日曲线与热力图。
  • modelHours:[模型名, [按小时明细…]],范围缩到一天以内时用它画小时曲线。
  • modelBilling:[模型名, {cost, peakCost, offPeakCost, peakTokens, offPeakTokens, peakCalls, offPeakCalls, hits, misses}],用于重算该模型的成本、峰谷与命中率。

各类行统一为 14 列(带 key 的 days / hours / models 行为 15 列): [输入, 输出, 缓存读取, 缓存写入, 合计, 调用次数, 成本, 高峰输入, 高峰输出, 高峰读取, 高峰写入, 高峰合计, 高峰调用次数, 高峰成本]。高峰块与全量块同宽同序,所以任何一张卡只要求出 当前范围的行就能同时得到成本与峰谷占比,两者不会描述不同的时间切片。

三者的求和都与全局 totals、billing 完全一致。

包结构

package.json        manifest:exports、dsh.bundle.patch、dsh.client、engines
cordis.patch.yml    把本插件插入 profile patch
index.js            Host 半入口:Config 校验、HTTP 路由、插件生命周期
lib/time.js         时区换算、小时分桶、数值归一
lib/scan.js         把会话事件折叠成「小时 × 模型」档位
lib/schema.js       Config schema、默认价目表、字段描述
lib/billing.js      峰谷判定、计价、旧配置迁移
lib/holidays.js     节假日联网拉取、按年缓存、内置种子
lib/contextops.js   清空 / 压缩上下文的表面替换事务、真实三项测量、分段与整合、压缩与优化默认指令
lib/ask.js          问答代答:禁区筛查、答案校验、调用代答模型、默认代答指令
lib/store.js        增量缓存、帧级扫描与快照(逐日 / 逐模型聚合)
lib/frames.js       遍历日志的 Zstandard 帧表,只解码新增部分
lib/projection.js   交给 Host 持续维护的 tokenPanoramaUsage 投影单元
lib/http.js         请求体读取与 JSON 响应
client.js           Client 半:面板、热力图、趋势图、折叠会话树、工作区、导出
locale/en.json      插件元数据(英文)
locale/zh.json      插件元数据(中文)
icon.svg            插件图标(亦可通过 "./icon" 导出)
icon-prompt-optimize.svg  「优化提示词」按钮图标(同款图形内联在 client.js)

界面文案位于 client.js 的 ZH / EN 字典,通过 ctx.locale.register 注册;locale/*.json 只承载「插件」页面显示的标题与描述。

schemastery 由运行时从 profile 目录解析(见 schemaLibrary()),不写进 package.json 的 dependencies:本插件以 link: 方式安装,包自身的依赖不会被安装,声明了反而会导致加载失败。

说明与限制

  • 热力图、趋势与计费按配置的 timeZone 归类(默认 Asia/Shanghai,与 DeepSeek 的计费口径一致)。
  • 历史很长时热力图按周生成列,超出宽度横向滚动,而不是压缩到看不清。
  • 用量严格按记录的模型归类;早于用量记录功能的会话不贡献数据。
  • 价目表里没有的模型按 defaultPrice 计价,并在「预估成本」卡片上点名提示,不会静默套价。
  • 调休补班日(周末上班)按规则字面仍计空闲价;如需按补班计高峰,把峰谷方案改成「自定义」并勾上对应星期即可。
  • 本插件只读取会话持久化与归档列表,注册一条 HTTP 前缀路由,并提供一个 Config schema。
  • 上下文操作会改写会话表层(compaction/* 与一次表面替换),因此需要 commands、tokenMeter、 agents、llm 四个平台服务;平台缺其中任何一个时,这两个按钮与命令在该 profile 里不可用, 统计功能不受影响。日志里被替换的历史事件不会被删除。
  • 压缩必须先跑完摘要才能改写,因此一次压缩的耗时取决于会话长度与所选模型; 期间不会占住会话,可以继续对话,改写会在会话空闲时进行。