dsh-liao-usage

DSH PLUGIN通知与集成

仓库 oliblue-evan/dsh-liao-usage

通知与集成 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

DSH 用量与余额:会话用量、按每笔实际发生时刻与模型计价的费用(峰谷/档位)、账户余额;账号登录无需 API Key。

一句话选型结论

按资料字段整理

dsh-liao-usage 是通知与集成类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类通知与集成 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-10-18 创建于 2026-09-29
README 29.6 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:oliblue-evan/dsh-liao-usage
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

通知与集成
字段来自项目仓库与公开索引,中文说明由本站标注

适用场景

通知

上游标签

cordis-plugindeepseek-harnessdeepseek-harness-desktopdeepseek-harness-plugindeepseek-harness-pluginsdshdsh-plugindsh-plugins

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在通知与集成场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-liao-usage当前 L5 · 运行验证通过 低风险 0 未标注 有
treg L3 · 安装规范通过 低风险 4,976 未标注 无
dsh-purge 未做沙盒验证 未标注 3,412 未标注 有
dsh-im L5 · 运行验证通过 低风险 1,837 0.1.7-rc.2 等 10 个 有
dsh-aurabot-qq 未做沙盒验证 未标注 633 未标注 有
dsh-dafeiyu L5 · 运行验证通过 低风险 425 0.1.7-rc.2 等 10 个 有

仓库档案

通知与集成
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方oliblue-evan仓库 dsh-liao-usage · 默认分支 main
分类通知与集成notify
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言未标注仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-09-29 · 2026-10-18最后推送 2026-10-18
本站收录2026-10-30首次进入本站目录的时间

README 全文

29.6 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-liao-usage 🧮

> English quick start — A DSH plugin that shows session token usage, reference costs using DeepSeek rates at each request time and model tier (peak/off-peak, per model tier), and your
> account balance in one pill below the composer. It needs no API key when you are
> signed in to a DeepSeek account (it reads the account balance through the harness's own
> account remote, falling back to DEEPSEEK_API_KEY). It is a single-file client bundle
> with a dependency-free host half, and ships 71 assertions (npm test). MIT licensed.
> Install: plugin_manager(action: "install_bundle", target: "github:oliblue-evan/dsh-liao-usage"), then
> reload the page.

DeepSeek 用量与余额:输入框下方一枚徽标,实时显示本会话的 token 用量、按峰谷与
模型档位换算的人民币费用,以及账户余额。点开是四桶明细与计价口径。

> 和同类插件最不一样的一点:查余额不需要 API Key。
> 已登录 DeepSeek 账号的用户走宿主自己的账号授权(ctx.remote.account.getBalance),
> 密钥全程不出现;只有「没登录、只有 API Key」的用户才回落到宿主路由。
> 据我看到的同类插件,真实余额普遍要求你自行配置 API Key。

金额说明

费用是参考估算,余额是接口返回值。 本插件按 DeepSeek 价表、每笔事件时间和模型档位换算;第三方渠道及自定义模型也沿用这套规则,无法代表对应渠道的真实账单。下文的「逐笔实际发生额」指按事件时刻累计的参考结果,而不是渠道已结算金额。

1.2.0:设置与显示体验

  • 设置分成「底部胶囊」与「展开后的明细」,用卡片明确各开关作用范围。
  • 两组设置都有即时示例,示例数据明确标注,不查询账号或改动会话。
  • 一键恢复默认显示设置,不触碰用量、历史计价或账号授权。
  • 折叠帮助解释参考费用、真实余额与缓存节省;修正关闭时段图标的说明。
  • 设置或胶囊独立重挂载时修复缺失样式,热更新后也保持正常显示。
  • 71 项测试通过,并在本机 DSH 验证设置和真实用量弹层。

1.1.0:弹层与余额查询修复

  • 打开时在首次绘制前定位浮框;余额返回、内容增高、滚动与视口变化时重新定位。过高内容可在框内滚动。
  • 提供关闭按钮;Esc 关闭并返回胶囊焦点,外部点击关闭,内部刷新不会误关。
  • 余额请求去重并共享 60 秒缓存;手动刷新绕过缓存。账号和 API Key 路径均有超时边界。
  • 查询失败仍显示重试入口;已有余额在刷新失败后保留,并标注「显示上次余额」,不会把网络错误误报为未配置密钥。
  • 优先显示人民币余额,其它币种单独列出;仅显示余额但余额不可用时仍保留费用入口。
  • 补充会话 token 总量,明确区分当前参考单价与按历史用量累计的金额;兼容原有显示偏好与按模型统计。
  • 费用统一标为「参考费用」并加 ≈;账户余额仍为接口返回值。
  • 开发依赖仅用于界面回归测试,插件运行时仍无额外依赖。新增用例验证首帧定位、反复开关、动态尺寸、关闭焦点、失败重试、请求去重、超时与宿主缓存。

截图

插件页 —— 标题、简介与图标按官方约定提供(package.json 的 icon + locale/*.json 的
meta.title / meta.description),栏目位置由 plugins.bundle.config 槽位决定:

弹层与胶囊 —— 输入框下方那枚胶囊,点开是明细、计价口径、峰谷倒计时与今日时段轴:

> 两张截图里的金额、余额、token 数均为示例值(真实数值已做打码处理);第二张底部显示
> 「按当前价估算」是宿主投影尚未加载时的降级提示,属预期行为,见下文「金额口径」。

🧮 108.0k tok · ¥0.05 · 余 ¥123.45

它和别家有什么不同

写之前把 GitHub 上同类插件翻了一遍(dsh-token-billing、
DSH-TOKEN-feiyong、
dsh-balance-stats、
dsh-plugin-balance、
dsh-deepseek-balance、
dsh-usage-balance 等)。
这批里功能最全的 dsh-token-billing 做得非常猛(仪表盘、预算、按路由计价、CSV 导出、
206 项测试),但它的兼容范围写的是 dsh <0.2.0,而本机是 0.2.0-rc.2,装不上。
本插件借了它的几个关键思路,但刻意做小:

同类插件常见做法 本插件
token 用量来源 自己监听 session/event 折叠 + 持久化账本 读 DSH 自带的 tokenUsage 投影(宿主已折叠好的响应式数据)
轮询 定时轮询宿主接口 零轮询:用量随投影自动更新;余额只在挂载时取一次
历史/今日统计 700+ 行账本 + 启动全量扫盘 不做(见下方"已知取舍")
余额 有的用 PowerShell 调接口 账号优先:走你已登录的授权;只有 API Key 的用户自动兜底
体积 数 MB 起 约 30 KB,无构建步骤

价格表与时间线:本插件内置的价目与 dsh-token-billing 的内置表逐位一致 ——
flash 空闲 0.02/1/4、高峰 0.04/2/8;pro 空闲 0.15/4.5/13.5、高峰 0.3/9/27;
生效时刻也一致(2026-08-17 00:00 北京时间峰谷起点、2026-09-10 12:00 flash 调价)。
两个独立实现互相印证,这表可以信;官方再调价时改 client.js 顶部即可。

余额从哪来(账号登录不需要 API Key)

主路径 —— 已登录的账号授权。 DSH 的账号平台自带 getBalance:它用保存的授权 token
(x-dsh-auth-token 头)请求 platform.deepseek.com,并投影出 normal_wallets / bonus_wallets
的币种与余额。官方「设置 → 账号」页读的就是这条链路,本插件复用同一条:

ctx.remote.account.getBalance({
version: '0.2.0-rc.2',
locale: <当前语言>,
timezoneOffsetSeconds: -new Date().getTimezoneOffset() * 60,
})

返回 { status:'ready', value: 充值钱包[], bonusWallets: 赠金钱包[] }。授权 token 全程留在
宿主进程,浏览器只拿到余额数字;未登录时返回 null。

兜底路径 —— 只有 API Key 的用户。 账号返回 null 时回落到宿主路由
(credentials.resolve('DEEPSEEK_API_KEY') + 宿主 fetch 官方 /user/balance,
60 秒缓存、密钥不下发浏览器、错误按 sk- 脱敏)。

两条路径在面板里都标注来源(账号 / API Key),都拿不到就如实说明原因,不编数字。

金额口径(这一节最重要)

显示的费用有两种来源,面板底部会写明当前用的是哪一种,绝不让估算冒充账单:

来源 何时使用 含义
实际发生额 宿主 usagePillCost 投影可用时(正常情况) 每笔用量按它自己那一刻的峰谷、它当时那个模型计价后累加
按当前价估算 宿主投影不可用时(宿主未重启、投影被禁用) 用累计四桶 × 此刻的价 × 此刻的时段反推,会在面板里标明「按当前价估算」
— 连 tokenUsage 都拿不到 显示破折号,而不是 ¥0(¥0 会被读成"免费")

为什么不能只靠累计四桶算:浏览器读到的 tokenUsage 投影只有累计值,没有"这一笔是什么时候、
什么模型花的"。用累计 × 当前价 × 当前时刻会犯两个错:

  • 跨过峰谷边界后,历史花费被追溯改写 —— 高峰时段烧的那部分,到了空闲时段再看就按便宜价算了;
  • 会话中途换模型后,整段历史按新档位计价 —— pro 的未命中价是 flash 的 4.5 倍。

所以宿主注册了一个 usagePillCost 会话投影(lib/cost-projection.js + lib/cost-fold.js),
折叠每条 assistant/message / assistant/attempt:模型取自它前面那条 request/header,
时刻取事件自身的 time。折叠口径与官方 tokenUsage 投影一致(同一 turn+step 后到替换先到),
并且 llm/retry-started 之后的重试累加(那是另一次真实计费调用)。

费用 = 未缓存输入×miss + 缓存读×hit + 缓存写×miss + 输出×out   (单位:元 / 百万 token)
  • 峰谷:高峰 = 北京时间周一至周五 09:00–12:00、14:00–18:00(左闭右开),
    高峰期单价 ×2;周末与中国法定节假日整天按空闲计价(官方按 UTC 判工作日,
    所以调休补班的周六仍算周末)。
  • 档位:模型名含 flash 走 flash 价,其余走 pro 价;面板里显示真实模型 id,
    识别不到时会明说「未识别到模型 · 按 pro 档计」,而不是给一句确信的档位。
  • 价格政策时间线:按用量发生的时刻取段,历史回看不被新规追溯改写。
  • 「缓存已省」= 命中的 token 若按未命中价计要多花的钱(按当前价算,面板里注明)。

换过模型之后:按模型分开显示

totals 是跨模型累加的。会话中途换过模型之后,"本会话花费 ¥9.37"里混着几档价,
而单价列显示的却是当前模型的价 —— 两者一相除得到的 token 数是错的,也没法跨模型比价。

所以投影额外维护一份 byModel(键 = 模型 id),面板在换过模型时多出一块:

按模型
deepseek-v4-pro     ¥36.30
qfmodel             ¥18.15
deepseek-v4-flash   ¥10.04

三条规则:

  • 只有一个模型时整块不显示 —— 与上面的合计完全重复,只会让面板变长;
  • 按金额降序(贵在前),0 金额的模型丢掉;
  • 单价列此时在 tooltip 里注明「单价是当前模型的价;上面的金额是全部模型累计的」。

回退口径要注意:同一 turn+step 的替换要按当初那个模型回退,不能按"当前模型" ——
重试时换了模型的话,按当前模型扣会把别的桶扣成负数。所以样本自身记了归属模型
(sample.model),这条有专门的测试。

> 面板顶部的合计始终是全部模型之和,分模型块只是把它拆开看;两者恒等,有测试钉住。

为什么「缓存写入」对 DeepSeek 永远是 0

因为 DeepSeek 没有这个概念。 它的上下文缓存是服务端自动完成的:把前缀写进缓存
不额外收费、也从不回报,API 只给 prompt_cache_hit_tokens / prompt_cache_miss_tokens。
harness 的 TokenUsage 是provider 无关的,里面那个 cacheWriteTokens 取自
provider 适配器这一行:

const cacheWriteTokens = rawUsage.prompt_tokens_details?.cache_write_tokens || 0;

cache_write_tokens 是 OpenAI / Anthropic 那套显式缓存的字段(手动打 cache 断点、
按更高价买一次"写入"),DeepSeek 不返回它。

所以面板不写死"隐藏这一行",而是按数据判定:某个桶的 token 与金额都为 0 就隐藏
(client.js 的 visibleRows)。将来遇到真会回报缓存写入的 provider,那一行会自动回来。
四个桶全为 0 时显示「本会话暂无用量」,而不是留四行 ¥0。

界面

视觉与宿主原生弹层一致:结构与样式抄自 DSH 自带的会话统计弹层
(@deepseek-ai/dsh-client-ui-chat 的 StatsPills.module.css 与 stat-dialog.module.css),
类名用 um 前缀(避免与页面上其它插件冲突),只引用 --dsw-* token。

  • 徽标:[🌙] ¥5.00 · 余 ¥123.45 —— 三段各说一件事,没有冗余:
  • 前置图标即时段:☀ 太阳=高峰(琥珀)、🌙 月亮=空闲(绿)。峰谷状态一眼可见,
    不必再占一段文字。
  • 当前花费:宿主自带的统计胶囊只报 token,不报钱。
  • 账户余额:界面上其它地方都没有的数字。
    token 用量刻意不放在徽标上(宿主的统计胶囊已经显示了,重复没意义),它只出现在面板里。
    样式与旁边宿主的统计胶囊同一套(无边框透明胶囊、label-tertiary、hover 上底色);
    余额尚未取到时该段自动消失,徽标退化成 [🌙] ¥5.00,不占空位。
  • 面板(createPortal 挂 body + position:fixed,不会被输入框容器裁掉;
    上方放不下自动翻到下方,滚动/缩放跟随,点外面或 Esc 收起)。
    版式沿用宿主统计弹层的 dt/dd 两列(不另造三列表 —— 中间那列空档会把视线拉散,
    还带出表格的厚重感),四组用细分隔线隔开:
    1. 概览:账户余额 ¥123.45(含赠送 ¥20.00) + 一枚自绘的 ⟳ 刷新;
    缓存已省 ¥88.00(用 success 色,这是好消息)
    2. 本会话花费(标题带单位 元 / 百万 tokens):四行 缓存命中 / 未命中 / 写入 / 输出,
    每行是 金额 @单价 —— 单价贴在它自己那行(¥4.00 @¥0.02),既不用三列表,
    也不会像脚注那样被忽略;精确 token 数进 tooltip(正文放 200,000,000 tok 只会抢视线)
    3. 时段:一行说清「现在什么价、还能用多久」:空闲 · deepseek-flash · 10:34:31 后切换
    (倒计时部分自带 1 秒刷新;高峰时才追加 · 高峰 ×2,空闲时不显示 ×1 这种噪声);
    下面接今日时段轴
  • 只在异常时才解释:金额口径只有在「宿主投影不可用、金额是按当前价估算」时才占一行;
    正常(逐笔实际计价)时口径说明只进总额的 tooltip。
  • 中英文走 Client locale 服务;金额一分钱以上给两位小数(¥0.85 而不是 ¥0.8496),
    不足一分才用 4 位(避免显示成 ¥0)。
  • 计时很克制:倒计时单独成组件、只有它每秒刷新;面板其余部分 30 秒对齐一次峰谷;
    页面在后台暂停。

> 时段判定、价目表、时段轴原先在独立的 peak-valley 插件里,现已合并进本插件,
> 后者已删除 —— 一枚胶囊说清用量、费用、余额、当前时段与今日时段轴。

文件

文件 作用
package.json bundle 清单(dsh.bundle.patch + dsh.client)
cordis.patch.yml 组合层,插入一行 usage-pill
index.js 宿主半边:注册 usagePillCost 投影 + 条件注册余额路由(同源校验、60 秒缓存、密钥脱敏)
lib/pricing.js 宿主计价内核(价目表、峰谷判定、桶映射、单笔计价、事件取用量)
lib/cost-fold.js 投影的纯折叠逻辑(可被普通 node 进程单测)
lib/schema.js 自带的最小结构校验器,替代 zod(原因见下)
lib/cost-projection.js 投影接线层(schema + ctx.sessionProjections.register)
client.js 全部界面:读投影、余额双链路、徽标与弹层
locale/en.json、locale/zh-CN.json 插件页的标题与介绍(dsh-app-boot 的 readPluginMeta 读这个目录)
assets/icon.svg 插件图标(package.json 的 icon,相对路径、≤256 KiB)
test/*.test.mjs 71 项断言(npm test)

无构建步骤,client.js 就是产物本身。 这也不是偷懒 —— 宿主把各插件的 bundle
拼接成一个 combo 脚本、以传统脚本执行(window.__ModuleLoader__ 处于 queue 模式,
只登记工厂函数),所以客户端半边必须是单文件,写 ES 相对 import 并不成立。
代价是文件较长,因此用「文件头目录 + #region 纯逻辑 标记」替代拆文件,
并由 test/structure.test.mjs 钉住这份约定。

插件页的介绍与图标

宿主插件页读 package.json + locale/,机制在 dsh-app-boot 的 readPluginMeta:

  • 标题与介绍来自 locale/<语言>.json 的 { meta: { title, description } },
    多语言字典合并成 { en, 'zh-cn', … } 并按当前语言取用;缺字段回退到 package.json。
  • locale/en.json 是必需的:dictionariesOf 只在它存在时才扫描同目录其它语言文件。
  • 图标是 package.json 的 icon:相对路径、SVG/PNG/JPEG/WebP、≤ 256 KiB、须留在包内。

这几个文件都按契约备齐了,并对解析链路做过两次实测:纯 Node 与
Electron 自带 Node(ELECTRON_RUN_AS_NODE,node 24.18.1,即宿主运行时)——
ModuleLoader.fromInternal() 可用、resolveSync('dsh-liao-usage/locale/en.json', …)
正确解析到本包,把 readPluginMeta 原样搬出来跑,输出是正确的双语标题/描述/图标。

> 两个坑,都记在这里
>
> 1. exports 会把元数据挡在门外:原先只开 . 与 ./client。Node 的 ESM 解析器
> 在有 exports 时不会自动暴露 package.json,未声明的子路径一律
> ERR_PACKAGE_PATH_NOT_EXPORTED;而 readPluginMeta 用的正是 Node 的解析器,
> 并把"不可解析"当作"资源缺失"→ 元数据整体 undefined,且不报任何错。
> 现在补上了 ./package.json、./locale/*.json、./assets/*,由
> test/packaging.test.mjs 钉死(含 iconOf 的全部规则)。
> 2. plugin_manager 工具看不到 meta:它的 execute 里显式把 meta 解构丢弃
> (({ meta: _meta, ...row }) => …),所以用 list_bundles 无法判断宿主有没有
> 算出元数据 —— 我曾据此误判成"平台限制",是错的。

标题与简介只由宿主渲染一份。 元数据正常时,插件页头部显示
用量与余额 + 简介 + 图标。

> 中途为了在元数据不可用时也有介绍,我曾在设置卡顶部自己再渲染一份;等
> exports 修好、元数据恢复后,那段就变成同一句话连着出现两次,已删除。
> 教训:兜底内容要带"元数据可用时自动让位"的条件,否则修复真因之后它会变成新的问题。

设置

设置卡注册在 plugins.bundle.config(key 用包名),渲染在本 bundle 的插件页上、
描述与组件列表之间
—— 这是槽位文档给 bundle 配置指定的位置,官方 voice-input bundle
用的就是它。(plugins.item 是"一个官方命名空间一个伴侣包"的设置页,不是 bundle 该用的。)

卡片的开关照抄官方 @deepseek-ai/dsh-client-ui-primitives 的 Switch:它用的是
` + 一个圆钮span,尺寸 36×20、padding 2px、圆钮 16 + 位移 16, 关态轨道--dsw-alias-border-l3、开态--dsw-alias-brand-primary,圆钮用--dsw-alias-switch-thumb/--dsw-alias-label-primary-foreground`。

> 第一版我用的是 ` +appearance:none,结果被宿主 >input[type=checkbox]的全局样式盖掉(元素+属性选择器特异性 0,1,1 > 类选择器 0,1,0), > 变成"白底白钮、看不出开关状态"。官方的做法既避开了这个坑,role="switch"也才是 > 开关应有的无障碍角色。test/structure.test.mjs` 现在按官方这套数值与角色做断言。

五个开关,全部只影响展示:

开关 默认 效果
徽标显示时段图标 开 关闭后不显示太阳/月亮图标
徽标显示参考费用 开 —
徽标显示账户余额 开 取不到余额时该段本就自动消失
隐藏没有用量的项目 开 明细中省略 token 用量为零的项目
显示「缓存已省」 开 —

设置分组提供即时示例(非真实余额),「恢复默认」只重置五个显示开关。三段全关,或只开余额但查询不可用时,参考费用段兜底,保持详情入口可见。

为什么设置存在浏览器本地(localStorage)而不是宿主:这些都是展示偏好,不是宿主状态,
没必要走宿主;也因此宿主半边缺席时设置照常可用。值会逐项按默认值兜底、未知键丢弃
(normalizeSettings),所以旧版本残留或被手改坏的存储在下次读取时自愈。

为什么不给宿主声明 Config:官方那套 export const Config = z.object({...}) 里的 z
来自 @deepseek-ai/schemastery,而 link: 安装的插件解析不到裸模块名(见下一节)。
而且能进设置表单的是原生 schemastery schema(isNativeConfigSchema 要求
Symbol.for('schemastery') 等形状),自己糊一个只会变成 unsupported 状态。
所以本插件用同一个小节里的 slot 自持设置卡,宿主侧保持零依赖。

为什么宿主半边不带任何第三方依赖

宿主插件的裸模块名按插件的真实路径解析,而本插件是 link: 安装的
(真实路径在工作区),profile 的 autoInstallPeers 又是关闭的 —— 一旦某个裸模块
解析不到,import 会在模块加载期抛出,整个宿主半边起不来(不是降级,是硬失败)。

我最初在这里引入了 zod(沿用了社区插件的做法),后来才发现这个风险。
现在宿主半边只用相对路径 import,schema 由自带的 lib/schema.js 提供 ——
查过 @deepseek-ai/dsh-session-projection 的实现,框架对 schema 的全部要求
只是 .parse(value):不合法抛错、合法返回值。test/no-bare-imports.test.mjs 把这条钉死。

两个维护点

集中在 client.js 顶部:

  1. CN_STATUTORY_HOLIDAYS —— 2026 年的法定节假日表(依据国办发明电〔2025〕7 号),按年扩表。
  2. PRICE_SCHEDULES —— 按生效时刻分档的价目表,官方调价时追加一条 { from: Date.UTC(...), ... }。

开发提示:改客户端代码为什么"看不到效果"

先确认宿主实际发出去的那份 bundle,而不是磁盘上的源码。 我在这里栽过三次:
改完 client.js、重启、刷新,页面纹丝不动 —— 因为 profile 里那份是物理副本。

# 1) profile 里是符号链接还是物理副本?(link: 安装也可能被物化成副本)
ls -la ~/.dsh/profiles//node_modules/dsh-liao-usage

# 2) 拿权威的 bundle 地址(graph 里有每个客户端条目的 id 与 rev)
curl -s -N --max-time 4 http://127.0.0.1:19387/plugins/events

# 3) 抓下来断言语义特征(比"看起来好像好了"可靠)
curl -s "http://127.0.0.1:19387/plugins//client.js&rev="

经验:物理副本会让你的每一次编辑都石沉大海,连重启都没用(宿主只会重新读那份副本)。
换成指向工作区的符号链接后,宿主会在下一次轮询里自己重读,不必重启。

> 宿主半边(index.js)与客户端 bundle(client.js)是两套读取路径:前者在启动时
> 由 ESM 加载、改完必须重启;后者由 dsh-client-modules 组合并提供,文件一变换个 rev
> 就会推给页面。两者的"旧版本"可以同时存在 —— 调试时先分清是哪一半没生效。

已知取舍(有意不做)

  • 不做"今日/本月/累计"跨会话统计。那需要一份持久化账本 + 启动时补扫历史会话
    (同类插件的做法,也是原鲸鱼娘插件 700 行 usage-ledger.js 的原因),
    在会话历史大起来之后是持续的成本。本插件只做当前会话的精确用量 ——
    这部分数据宿主已经算好了,拿来即用、零维护。
  • 不做预算、导出、多 provider 路由计价。这些是完整计费产品的范围,不是一枚徽标该背的。
  • 不做流式期间的字符估算。宿主投影给的就是确切值,不需要估。

隐私与数据披露

同样的内容以机器可读形式声明在 package.json 的 disclosure 字段(DSH 插件市场 §9 披露契约)。

项 声明
云端依赖 是 —— 只有余额查询会出网:https://api.deepseek.com/user/balance
完全离线可用 是 —— 不联网时用量、费用、峰谷、时段轴全部照常,只有余额那一段消失
凭据 DEEPSEEK_API_KEY 仅作兜底(已登录账号的用户用不到)。插件不存储它,由宿主凭据服务持有(~/.dsh/.credentials.yaml,权限 0600),只在宿主进程内使用、不下发浏览器、错误信息按 sk- 脱敏
权限 网络(仅上述端点)、凭据读取(仅上述键名)。不写任何文件、不读其它环境变量
数据留存 无 —— 插件自身不在服务端或本地留存任何数据(费用投影由宿主框架按会话缓存,属 DSH 自身机制)
遥测 / 统计 无
法域 PIPL(CN)

安装 / 卸载

三条路径任选(下面已填成本仓库地址):

① GitHub(推荐,随仓库更新)
plugin_manager(action: "install_bundle", target: "github:oliblue-evan/dsh-liao-usage")
或在 profile 目录执行:dsh plugin --profile  add github:oliblue-evan/dsh-liao-usage

② 本地克隆(开发时)
plugin_manager(action: "install_bundle", target: "<克隆下来的目录绝对路径>")

③ 卸载
plugin_manager(action: "remove_bundle", target: "dsh-liao-usage")

安装后刷新页面即可;若插件页的标题/简介没显示,说明宿主侧的包元数据快照是旧的,
整页刷新(Cmd+R)一次即可(客户端 bundle 走热更新,与包元数据的取数时机不同步)。

> 本插件零运行时依赖(宿主半边只用相对路径 import),所以 ① 的 GitHub 安装不需要
> 在工作区另跑 pnpm install。

验证

npm test(= node --test test/*.test.mjs)跑 71 项断言,覆盖纯逻辑、宿主路由与真实 React 弹层行为:

文件 断言 覆盖
pricing.test.mjs 6 峰谷窗口(左闭右开)、周末与节假日、三段价格政策、桶映射、缓存写入按未命中价、事件取用量
cost-fold.test.mjs 7 按事件自身时刻计价、按当时模型计价(中途换档不改写历史)、同一 turn+step 后到替换先到、llm/retry-started 之后累加、写入单列、无路由记未计价、视图四位小数
projection.test.mjs 4 不重启也能验证宿主半边:注册契约(key 命名空间 / stateVersion 合法 / schema 与 view 齐备)、状态始终能过自己的 schema(含 checkpoint 的 JSON 往返)、视图字段与数值、无关事件返回原引用
schema.test.mjs 4 自带校验器:合法放行、非法一律抛错、严格对象拒绝未声明字段、报错带字段路径
client-math.test.mjs 8 组 时段轴与下次切换(跨周末、跨整个国庆)、档位取价与四桶计价、格式化边界、余额按币种分组不跨币种相加、空桶不占位、设置归一化逐项兜底
structure.test.mjs 6 client.js 的 #region 纯逻辑 标记唯一、区块内确有测试依赖的符号、区块内无 React/DOM、文件头保留单文件理由、样式必须插件级注入(不能塞在某个槽位的组件树里)、开关样式必须带 !important
packaging.test.mjs 3 打包契约:exports 暴露元数据子路径、locale/en.json 存在且字段非空、图标满足 iconOf 的全部规则
no-bare-imports.test.mjs 3 宿主半边不得出现裸模块名(含动态 import()),且不再引用 zod
client-ui.test.mjs 9 React 首帧定位、反复开关与尺寸变化、内外点击与 Esc 焦点、失败重试、缓存去重、超时取消、余额入口兜底与多币种
balance-route.test.mjs 2 同源与 POST 限制、自动缓存、手动刷新、并发去重与实例隔离
pricing-parity.test.mjs 3 防漂移门禁:宿主 lib/pricing.js 与客户端内嵌的价目表/节假日表/高峰窗口逐字段一致

另外:

  • node --check 全部文件通过。
  • 安装后 live 校验:宿主行挂载、conversation.composer.dock 出现 usage-pill 占位者、
    plugins.bundle.config 出现 dsh-liao-usage 占位者、
    余额路由的同源校验与 POST 语义(同源 200 / 跨站 403 / GET 405)。
  • 宿主半边已实测通过(重启 DSH 后核对 ~/.dsh/storages/session_projcache/ 的落盘投影):
    usagePillCost 与官方 tokenUsage 的 seq 同步,且金额与官方 token 桶逐个对账一致 ——
桶 官方累计 token × 空闲 flash 单价 投影金额
缓存命中 200,000,000 ¥0.02/M 4.00000000
缓存未命中 1,000,000 ¥1/M 1.00000000
输出 500,000 ¥4/M 2.00000000
合计 — — 7.00000000

两个独立来源(逐笔折叠 vs 官方累计桶)对到小数点后最后一位,且 pricedRequests: 500、
unpricedRequests: 0(说明 request/header 的路由跟踪没有漏请求)。
- 仍未验证:插件页的标题/简介是否出现(取决于宿主页面数据是否已重新加载 ——
客户端 bundle 是热更新的,与宿主包元数据的取数时机不同步),以及开关的实际视觉效果。

协作说明

本插件由 李敖(oliblue) 与 DeepSeek(deepseek-flash) 协作完成:需求、设计取舍与逐轮验收由作者负责,
代码实现、排查与测试由模型完成;版权归人类作者所有(见 LICENSE)。

> 之所以把这段署名放在 README 而不是 LICENSE 里:GitHub 的许可证识别要求 MIT 正文保持原样,
> 在版权行后插入额外段落会让它被识别成 "Other",别人就看不出版本可 MIT 复用。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
dsh-liao-usage 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:oliblue-evan/dsh-liao-usage` 即可。

dsh-liao-usage 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-liao-usage 安全吗?

低风险。

dsh-liao-usage 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-liao-usage 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

通知与集成
按星标排序,可作替代方案

treg

treg

Treg 是面向 Agent 工具的 OpenRouter,聚合 60 个提供商的 2896 个端点,按调用计费,统一令牌访问,无需注册各供

L3 · 安装规范通过 4,976 星

dsh-purge

dsh-purge

dsh-purge Community · DeepSeek Harness 社区维护版:宿主兼容、状态诊断、提示词管理、更新与本机备份回滚

未标注验证等级 3,412 星

dsh-im

dsh-im

将IM机器人接入DeepSeek Harness,支持飞书、微信、钉钉等九种渠道,通过扫码或凭据配置,统一管理多机器人连接。

L5 · 运行验证通过 1,837 星

dsh-aurabot-qq

dsh-aurabot-qq

让 DeepSeek Harness 里的 AI 以「大肥鱼」人格住进 QQ,通过 OneBot v11 网关聊天、发表情语音、写空间日记并

未标注验证等级 633 星

dsh-dafeiyu

dsh-dafeiyu

DSH 大肥鱼是一款由 DeepSeek Harness 真实工作状态驱动的桌面伴侣插件,以始终置顶的透明窗口实时展示 Agent 的思考、

L5 · 运行验证通过 425 星

dsh-trading

dsh-trading

L3 · 安装规范通过 235 星

oliblue-evan 的其它插件

6 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。