dsh-task-notice

dsh-task-notice

DeepSeek Harness 插件:代理任务完工通知 + 顶部提示横幅 + 按 Provider(Key)的 Token 消耗统计 + 价格编辑 + 使用分析。

0.3.14 更新:

• Token Plan 订阅计费过期感知:
  • 连续订阅:Token Plan Key 管理新增开关,开启后每个计费周期到期会自动按当前订阅信息开启下一轮;非连续订阅(默认)到期只保留订阅信息与周期窗口、不自动开新周期——手动点「续费」或过期后仍检测到该 Key 产生有效调用时才开新周期。
  • 套餐更改:重新输入订阅信息后保存,弹窗选择「覆盖本周期」(立即按新订阅费计算)或「下次续费生效」(记为 nextPlan,自动/手动续费时提升)。
  • 周期编辑器:从 Token Plan Key 管理进入独立页面,逐周期调整有效期(开始 / 结束时间)与订阅费,回本 / 累计金额 / 性价比实时重算;所有周期(含当前周期)可删除(当前周期删除后从现在起重开、旧窗口不归档)。取消勾选「Token Plan 订阅」可把生效中的计划标为未生效(没续费):按量计价、信息保留、一键恢复。
  • 订阅合并:同一个 Token Plan 换了 Key(Provider ID)时,把另一个 Key 的订阅与历史合并到保留的 Key;订阅数据以保留的 Key 为准,后续可再手动调整。
• 性价比改为累计口径:Token Plan Key = 累计消耗 tokens ÷ 累计订阅费(当前周期 + 上一轮 + 全部历史周期),不再只统计当前周期、不再显示「本周期 / 上一轮」;例:9.9/月用两个月共 800M tokens → 800M ÷ 19.8;第二个月换 49.9 档 → 按累计金额 9.9 + 49.8 = 59.8 计算。
• 修复使用分析页「按次调用回本提示」重复渲染两次,并把按次模型数据(perCallModels)真正透传到客户端(此前该区块永远显示「暂无」);「性价比计算」区块标题恢复。
• 性能(大账本):官方价目录建一次性索引 + 查询缓存、priceFor 按价格快照缓存、峰谷取档去掉 Date 分配、使用分析单条金额只算一次且不再复制全量账本、客户端派生数据 useMemo 化——2 万条账目的使用分析由约 8.5s 降到约 0.05–0.08s,5 万条约 0.12s。
• 使用分析外圈固定以官方价格金额为100%基准，显示实际消费与节省/超出比例；非订阅实际消费使用当前生效价格，订阅 Key（含免费订阅）按订阅费，官方金额始终按官方目录计算。

0.3.12 新增:

• 模型计价全部实时计算:Token Plan 的计费周期配置只保存周期窗口 + 订阅费,不再落盘任何 tokens / cost(旧配置里残留的金额字段读取时直接丢弃);上一轮 / 历史周期 / 待确认账本的金额一律在每次读取时按账本 × 当前价格现算——改价格后回本进度、上一轮与历史周期、每日费用、通知金额立即变化,不会出现旧金额。
• (Key · 模型)为条目口径:消耗聚合一律用账本自己的 Key 身份(调用路由 / Provider ID),取消「按模型归属目录改判 Key」的映射;饼图、每日费用表、性价比排名、按 Key·模型明细全部按 (Key · 模型) 成条,不同 Key 的同名模型、同一 Key 的不同模型都分开计算,不再混在一起。
• 图例配色互不相同:颜色按 (Key · 模型) 身份分配(超出 14 色调色板用黄金角 HSL 生成),任意条数下不会重复;同一张图内饼图分块、图例、每日堆叠色条、每日图例共用同一映射(同一条目跨日期同色),图例标签带上 Key 显示名。
• 精简 package.json 的 description 与 dshhub.summary(改为一段功能概述,不再堆叠历版说明)。

0.3.11 新增:

• 子代理聚合通知:子代理完成任务不再单独通知——子代理的消耗折算到根主会话名下(消耗账本同步归属,按窗口消耗统计随之合并);主代理与所有子代理都完成后才发送一条「任务完成」通知(多轮挂起 + 子代理用量合并,金额合并计算)。
• 任务失败通知:任务轮次以 error / max-tokens / blocked 结束时立即推送「任务失败」通知(新帧类型 fail,红色左边条,带本轮已消耗 tokens、金额与失败原因);用户主动中止(停止/打断)不打扰。
• 入口按钮改版:侧边栏左下角的插件入口与「设置」按钮同行两半——设置按钮占左半(原宽 50%),插件入口紧贴其右占右半;入口按钮尺寸与 设置 → 通用 的「任务通知与消耗」按钮一致(经 data-slot + :has() 结构选择器实现,不依赖宿主哈希类名;折叠窄轨不受影响)。
• 界面优化:Provider ID 管理的「所含模型」列每个模型单独一行(不再只显示前 6 个);删除 价格编辑 / Token Plan Key 管理 / 工具箱 的内联「保存」按钮,所有草稿统一由 0.3.8 的悬浮保存按钮与切换选项卡自动保存(工具箱二级页草稿并入该机制,返回不再丢弃草稿;峰谷规则页「返回(保存)」改为「返回」)。

0.3.10 新增:

• 窗口切换提醒的设置项移入小工具:「窗口切换提醒」小工具的全部设置(提醒开关 / 缓存输入阈值 / 最少完成任务轮数)统一在 顶部导航 → 工具箱 → 窗口切换提醒 的二级设置页进行;设置 → 插件配置 不再重复提供这些选项(配置字段与宿主判断逻辑不变)。

0.3.8 新增:

• 保存机制优化(设置页):设置页存在未保存的更改时,设置页内容区(卡片范围)左缘浮现大号圆形保存按钮(保存图标,随滚动跟随);点击按钮或切换顶部选项卡时自动保存全部未保存更改;带着更改直接退出设置页时弹出「是否保留更改」确认,10 秒未回复默认保留更改(自动保存)。设置选项卡的插件配置改为草稿模式——更改先落本地草稿、界面即时生效,经保存按钮 / 切换选项卡 / 退出确认统一写入,不再逐项立即保存;保存失败时草稿保留不丢数据。原有各处「保存」按钮保留不变。
• 默认价格目录按《大模型API定价对比(7).csv》刷新:与 CSV(7) 逐条核对,既有 216 条价格全部一致;补入 CSV(7) 新增的 9 条硅基流动代理平台条目(sf- 前缀键:DeepSeek-V4-Flash / DeepSeek-V4-Pro / GLM-5.2 / GLM-4.5-Air / Kimi-K2.7-Code / Kimi-K2.6 Pro / MiniMax-M2.5 / Step-3.5-Flash / Qwen2.5-7B及以下),V4-Flash-Vision 按 CSV(7) 空闲/高峰成对价重列(2026-09 降价:基础价 ¥1/¥4/缓存命中 ¥0.02,高峰 ¥2/¥8);目录总计 268 条。

0.3.7 新增:

• 显示名称(Provider ID + 模型名称):所有界面的名称优先取全局模型设置里的自定义显示名——Provider 显示名 = 该 Provider 的 displayName(如 scnet → 超算互联网、bitdance-ark → BitDance Ark MaaS),模型显示名 = 该 Provider 下该模型的 name(如 ark-code-latest → 「GLM-5.3-Flash」,deepseek-flash → 「DeepSeek-V4.1-Flash」);悬停始终可见原始模型 ID。全局模型设置未给显示名时回退官方价格目录显示名(厂商 + 模型名称),再回退模型 ID。

• 模型归属的 Provider ID 修复:「哪个模型属于哪个 Provider」以全局模型设置的模型清单为准(Provider ID 管理 / 价格编辑的 Provider ID 子卡片 / 消耗统计的显示名同源),账本观测只作补集;Provider 目录不再退化成「只记录调用过的模型」——启动抓取撞上服务注册竞态时自动重试,缓存过期或全局模型设置变更(llm-* 命名空间)时自动重扫。使用分析 / Token Plan 的消耗汇总严格按目录归属:每个 Provider ID 下方的模型自动来自全局模型设置,模型消耗先按目录判定归属的 Provider ID(命中即归到该 Provider 名下,运行时路由只作目录未收录时的兜底);模型品牌显示 = 目录里归属 Provider 的显示名——不再按模型名前缀绑定厂商,Provider ID 是用户自己设置的,一律读本地数据。

• 价格表大小写不敏感:价格计算查找价格表(models 段)时不再区分模型名大小写——自定义价保存的大小写与调用记录不同也命中同一条价格。

• 峰谷计价 v2:主体峰谷规则支持逐日生效日(每条规则可选 工作日 / 自定义(勾选星期)/ 每天)、自定义时区(UTC 偏移小时,默认 8 = UTC+8,生效星期与高峰小时都按它判定)与峰时价格方式(倍率 / 自定义——自定义直接填峰时价,留空字段按原价);规则仍为条件格式式,自上而下首个命中生效。

• 自定义价格倍率:勾选「自定义价格」后可选 自定义(逐字段价)/ 倍率——倍率模式下实际价 = 该模型默认价格 × 倍率(默认价 = 官方价,未收录回退全局默认价),页面只读展示计算结果;Provider ID 子卡片新增价格倍率(默认 1,对该 Provider 的最终价整体缩放)。

• 旧版本价格数据迁移:升级后第一次启动自动把旧峰谷规则 / 价格配置应用到新版本结构(独立脚本 lib/pricing-migrate.js,经 pricingVersion 标记只执行一次,幂等)。

• 性价比修复:Token Plan 的 Provider 下,性价比 = 该模型调用量 ÷ 加权后的使用金额 = 1 块钱可兑换的 tokens 数量(订阅费按各模型按模型价的金额占比摊薄)——修复旧版同计划所有模型性价比恒同、无法区分的问题。

• 完工通知:代理每完成一轮任务(或目标 goal 完成)时,在 Web 界面弹出通知,并经浏览器 Web Notifications API 发送 Windows 系统通知(桌面右下角横幅 + 操作中心;需页面授权,点击通知回到本页),展示本次任务消耗的 tokens(缓存输入 / 缓外输入 / 输出 / 合计)与金额。

• 顶部提示横幅(0.3.6):常驻 DeepSeek Harness 页面顶部居中(shell.overlay 帧级浮层,所有页面显示,可 × 关闭):① 通知权限横幅——系统通知开关开启但浏览器尚未授权时提示「开启权限获得完整能力体验」,点击横幅即自动执行索权动作,任何结局都立即可见(等待中横幅文字立即变为「正在请求授权」;授权成功自动开启系统通知并直发「系统通知已开启」系统通知回执;授权弹窗被关闭未选择时明确提示再次点击选择「允许」、被浏览器静默拦截时提示到地址栏站点设置修改;被拒绝时提示到地址栏站点权限中允许);② 模型价格横幅——当前使用的模型没有规定价格(未激活自定义、官方目录未收录、也没有 Provider 专属价)时提示设置价格,点击横幅直接弹出该模型的价格编辑弹窗(五个单价字段预填全局默认价,留空字段继续继承全局默认价),「保存并确定」即写入配置并立即生效,消耗统计 / 使用分析 / 完工通知金额马上按新价格计算。「当前使用的模型」= 最近一次完工帧携带的模型(实时)∪ 最近 7 天账本中最新使用且未定价的模型(刷新页面后仍能提示)。

• 操作提醒:对话需要你处理时同样提醒——代理发起权限请求(批准/拒绝)或提问(等待你回答)时,页内弹窗 + 系统通知(遵循系统通知开关与发送时机设置)。实现上只读观察官方 UI 的当前待处理交互(uiSession.sessionStatus,兼容旧版 pendingInteractions),不参与 approval/request、user-questions/request 的应答链,绝不干扰审批/提问对话框。

• 数据进制规则(0.3.2):所有数字展示(统计 / 分析 / 弹窗 / 价格)统一按「K M B T」进制——0-99,999 无单位;≥100,000 用 4 位数字 + 单位(千/百万/十亿/千亿),超出部分四舍五入,优先小单位(如 120,050 → 120.1K、980,920 → 980.9K、9999K 下一个是 10.00M);鼠标悬停在含单位的数据上会浮现精确值。此规则只作用于显示,后台程序仍用精确数据计算。

• Key 身份 = Provider ID(0.3.2):统计 / 分析 / Token Plan 里的「Key」指全局模型设置中的 Provider 路由(如 scnet / ten / deepseek-official),显示名用该 Provider 的 displayName(如 超算互联网 / DeepSeek),环境变量名(apiKeyEnv,如 SCNET_API_KEY / DEEPSEEK_API_KEY)只作辅助展示;旧账目 / 旧套餐的 key 标签自动迁移兼容。

• 消耗统计:每次模型调用结束后记录其 usage,并按调用实际使用的 Provider 归集。插件设置页支持 1 年 / 6 个月 / 3 个月 / 1 个月 / 15 天 / 1 周 / 24 小时 / 自定义 时间范围,查看所有 Provider(Key)的 tokens 消耗量(分「缓存输入 / 缓外输入 / 输出」),附带调用次数、按 Provider 的按模型明细与跨 Provider 的按模型消耗总览。

• 使用分析(顶部导航切换):在 设置 → 任务通知与消耗 页顶部通过导航栏切换到「使用分析」页,分析规定时间范围内各大模型的使用资金状况:① 消耗金额展示——模型消耗金额占比饼图(鼠标悬停饼图块查看该模型具体使用情况:调用次数、各类 tokens、金额与占比)+ 饼图下方各 Provider 消耗额度表;② Token Plan 回本提示——每个设置为 Token Plan 的 Provider 一张子卡片(显示名、名下每个模型的消耗金额、是否回本、每 Credit 对应 tokens、重置当前周期按钮;0.3.3 起重置需输入 4 位数字验证码 + 两次点击不同位置的确认按钮才执行,重置后可「撤回重置」——同样验证码 + 两次确认,撤回恢复周期边界并把重置期间产生的消耗并入当前周期);0.3.4 起每个计费周期有唯一 TID(插件内部身份,不向用户显示),回本只统计当前生效 TID,旧 TID 数据冻结并经卡片「历史」按钮展开查阅;模型调用返回 402/429(Token Plan 错误码) 时该 Provider 标记待确认并弹「需要重置 Token Plan 吗?」,未回应则下次正常调用弹「是否已续费?」,期间消耗计入临时账本(卡片待确认横幅:已续费 / 没续费,回应后并入原周期合并显示);③ 性价比计算——1 元(CNY)能兑换多少 tokens(消耗 Token 总数 ÷ 消耗金额),相同品牌的大模型放在一起比较,Token Plan 的 Provider 只用当前生效计费周期(当前 TID)的 tokens 与订阅费加权摊薄,周期尚无数据时用当前消耗 ÷ 金额并标注「正在统计」;④ 每日费用消耗表——微型日历中代表一天的正方形的填充颜色深度区分每天用量的多少,日历下方列出每个日期的各模型消耗金额(Token Plan 的模型按加权平均计算,加权平均严格限定同一 TID:订阅费 ÷ 该 TID 周期总 tokens × 当天 tokens,同一天同一 Provider 出现在不同 TID 时相加合并为同一 Provider 显示),每个日期的数据默认堆叠,表格一次显示最近 6 天,其余用鼠标滚轮滚动查看;每日记录每个模型行前有颜色图例(0.3.3,与堆叠色条一致),429/402 待确认的临时账本行标「待确认」(0.3.4)。

• 今日消耗(0.3.3,顶部导航第一位):在 设置 → 任务通知与消耗 页顶部导航栏第一个标签「今日消耗」,展示今天的模型消耗金额占比饼图、今日各模型 tokens 消耗量(缓存输入/缓外输入/输出/合计)与今天的消费情况(总 tokens / 调用次数 / 金额);数据按今日 00:00(本地)至现在的账本计算,金额按当前价格与峰谷档现算。饼图只有一个模型时显示完整 100% 圆环;下方附今日消耗明细——每次模型调用产生消耗的单条记录(时间 / 模型 / Provider / 各类 tokens / 金额,时间倒序)。

• 顶部导航(0.3.3 顺序):在 设置 → 任务通知与消耗 页顶部通过导航栏按「今日消耗 → 消耗统计 → 使用分析 → 价格编辑 → 设置」切换视图;导航栏 sticky 常驻页面顶部,往下翻阅时右侧出现「回到顶部」箭头按钮,点击平滑回到页面顶部;「设置」页含插件配置(全部开关、弹窗时长、保留天数等)、Token Plan Key 管理(0.3.2,取代原「价格编辑-Token订阅」)、Provider ID 管理(0.3.2)与清除记录数据(安全流程:滑条拖到底 → 输入随机 8 位验证码 → 连续两次确认,才清空全部消耗统计账本;价格/套餐/峰谷/Provider 目录配置保留)。

• 价格编辑(顶部导航切换):在 设置 → 任务通知与消耗 页顶部点击「价格编辑」导航切换。模型价格跨 Provider 合并——不同 Provider 使用同一模型的调用都按该模型的价格计费,同一模型只有一行价格;未激活自定义的模型默认按内置官方价格目录计费(DeepSeek / OpenAI / Anthropic / Gemini / Kimi / Qwen / GLM / MiniMax / Seed / ERNIE / 混元 等 80+ 模型,双币种,含 DeepSeek 峰谷档;默认价以《主流大模型API官方价格汇总.xlsx》2026-09 为基准),点击「激活自定义」解锁该模型的价格编辑(基础价 + 峰时/谷时子档),「添加模型」可手动加入未出现过的模型。首次启动 / 无数据时,Provider 目录里已配置的模型也会列出,可提前定价。点「保存价格」后立即生效:汇总卡片、按 Provider 表、按模型表与完工通知金额马上按新价格重算。旧账目按低谷价:0.1/0.2 版本记录的旧消耗没有峰谷语义,默认按低谷价计算金额,不会被按峰时价回溯计费。

• Token Plan Key 管理(0.3.2,设置页):管理所有 Key(Provider 目录 ∪ 消耗记录 ∪ 已有计划键)的 Token Plan 设置——勾选订阅、订阅费、套餐包含 Credit、套餐起效时间与有效期(默认按 31 天计算,也可选择每月 1 号(UTC+0)自动重置),并按统计金额与订阅费对比判断有没有回本(进度条 + 已回本/未回本)与「换算 1 Credit = ? Tokens」;每个 Key 都可删除原有的 Token plan 属性(删除后不再按订阅计费,消耗记录与金额保留)。周期到期自动归档为「上一轮」,使用分析页可手动重置当前周期(重置后之前的消耗不再计入现在的回本计算,不影响消耗总额统计)。

• Provider ID 管理(0.3.2,设置页):插件自维护 Provider 目录(Provider ID + 显示名 + 环境变量名 + 所含模型——显示名与所含模型取自全局模型设置,模型列显示「显示名(模型 ID)」),支持重置(重新抓取全局模型设置 + 账本观测并持久化)与手动删除失效 Provider ID(移出目录 + 删除其 Token Plan,重扫不再复活);首次启动 / 无数据时也会自动抓取已配置 Provider 的 ID / 显示名 / 所含模型,全局模型设置变更或目录退化(只剩账本观测)时自动重扫。

• 峰谷计价:实行峰谷计价的模型(如 DeepSeek)按每次调用的时刻取「峰时 / 谷时」价,窗口与生效日规则可配置(默认即 DeepSeek 官方规则);0.3.7 起主体峰谷规则支持逐日生效日(工作日/自定义/每天)、自定义时区(默认 UTC+8)与峰时价格方式(倍率/自定义,自定义留空字段按原价)。

安装

推荐:打包成 tarball 安装(Windows 下 dsh plugin add <路径> 会被 pnpm 变成 link: 依赖,而 junction 的真实路径会破坏 Node 的模块解析——tarball 安装可避免):

# 1. 在插件源码目录执行,产出 tarball(文件名形如 dsh-task-notice-<版本>.tgz)
pnpm pack

# 2. 安装:把 <tarball 路径> 替换为上一步产出的文件的实际路径
#    (路径含空格时请加引号;要装到非默认 profile 时加 --profile <profile 名>)
dsh plugin add <tarball 路径>

dsh plugin add 会先 pnpm add 安装依赖,再把声明了 dsh.bundle.patch 的包加入 dsh.profile.bundles 层栈。完成后重启 DSH(如 dsh web)生效——即使该 profile 的 patchReload 为 live,依赖变更也需要重启。

直接用 dsh plugin add <目录> 也可以安装,但要用完整功能请用上面的 tarball 方式。

卸载:

dsh plugin remove dsh-task-notice
# 装到了非默认 profile 时,加上对应参数,例如:
# dsh plugin --profile <profile 名> remove dsh-task-notice

使用

完工通知

• 每个顶层会话(非 subagent)完成一轮任务时,浏览器端收到通知帧后在 Web 界面右上角弹出 toast,并按配置经 Web Notifications API 发送 Windows 系统通知(桌面右下角横幅 + 操作中心);内容为本轮消耗(缓存输入 / 缓外输入 / 输出 / 合计)与金额。
• 目标(goal)完成时同样触发系统通知与网页弹窗,显示该目标自创建以来的总消耗。
• 代理发起权限请求或提问(等待你回答)时,也会触发同样的页内弹窗 + 系统通知提醒你处理(通过观察官方 UI 的待处理交互存储实现,不影响对话框本身)。
• 系统通知由浏览器 Web Notifications API发出:需先在插件设置页点击「授权并开启」(浏览器要求用户手势授权;GUI 需运行在 HTTPS 或 localhost 安全上下文)。开启后,Edge/Chrome 会调用 Windows Notification Platform API,把通知交给 Windows 操作中心统一管理与显示——桌面右下角弹出横幅、存入操作中心;点击通知浏览器自动聚焦回本页面。
• 发送时机可选:默认「仅页面后台时发送」(正在看本页时只显示页内弹窗,切走/最小化后才发系统通知);也可取消该选项,让每次完成都发系统通知。
• 网页弹窗自动消失(默认 15 秒,可配),也可手动关闭;页面隐藏期间弹窗挂起,回到页面后继续计时。

消耗统计

打开 设置(Settings)→ 任务通知与消耗,即可:

1. 选择时间范围:24小时 / 1周 / 15天 / 1个月 / 3个月 / 6个月 / 1年 / 自定义(自定义支持起止日期时间)。
2. 查看汇总卡片(总消耗、调用次数、缓存输入、缓外输入、输出、金额)。
3. 查看按 Provider(Key)的表:每个 Provider 一行(显示名 + Provider ID,环境变量名作辅助),列出调用次数、缓存输入、缓外输入、输出、金额与合计;展开可看按模型明细。
4. 查看按模型消耗总览:跨全部 Provider 按模型名聚合每个模型的调用次数与各类 tokens 消耗与金额——同一模型名无论出现在哪个 Provider / 提供商下都合并为一行(与价格编辑页「同一模型只有一行价格」、使用分析饼图口径一致);不同版本(不同模型名)各占一行,价格互不影响。

口径:缓存输入 = cacheReadTokens(命中缓存);缓外输入 = inputTokens(未命中缓存);输出 = outputTokens。消耗按每次模型调用的 provider 上报 usage 记账,并按该调用实际使用的 Provider(全局模型设置路由)归集(Key 身份 = Provider ID,0.3.2;环境变量名如 DEEPSEEK_API_KEY 只作辅助展示)。

使用分析

在 设置 → 任务通知与消耗 页顶部点击「使用分析」导航切换到使用分析视图,分析规定时间范围内各大模型的使用资金状况(时间范围:24小时 / 1周 / 15天 / 1个月 / 3个月 / 6个月 / 1年 / 自定义,与分析页共用一套查询):

1. 消耗金额展示:饼状图展示每条 (Key · 模型) 的消耗金额占比——不同 Key 的同名模型各占一块、颜色互不相同(0.3.12);鼠标悬停在某个饼图块上浮现该条目的具体使用情况(调用次数、缓存输入 / 缓外输入 / 输出 / 缓存写入 / 推理、金额与占比);饼状图下方用表格显示每一个 Provider(Key)的消耗额度(调用次数、tokens、金额)。所有金额每次读取时按当前价格实时现算,改价后立即变化。
2. Token Plan 回本提示:每个被设置为 Token Plan 的 Provider(Key)显示为一张独立的子卡片,卡片显示 Provider 显示名、名下每个模型的消耗金额(按当前计费周期)、是否回本(当前周期消耗金额 ≥ 订阅费)、每个 Credits 对应的 Tokens(当前周期 tokens ÷ 套餐 Credit)以及重置按钮。点「重置当前周期」把当前周期的消耗归档为上一轮、从现在开始新的周期——之前的消耗不再计入现在的回本计算,不影响消耗总额统计。0.3.4 起每个计费周期有唯一 TID(插件内部身份,不向用户显示),卡片只统计当前生效 TID,「历史」按钮可展开查阅全部已冻结周期(起止时间 / 订阅费 / tokens / 金额);检测到 402/429(Token Plan 错误码) 时卡片显示待确认横幅与临时账本(之后产生的消耗,回应前不参与回本),可点「已续费 / 没续费」回应——续费则重置周期(临时账本并入原周期冻结),未续费则仅清除待确认。
3. 性价比计算排名:将每一条 (Key · 模型) 拿出来一起排名比较(排名名 = Key 显示名 · 模型名称;不同 Key 的同名模型与同一 Key 的不同模型都是独立条目,不会混在一起),按 1 元(CNY)能兑换多少 tokens(消耗 Token 总数 ÷ 消耗金额)从高到低排序。Token Plan 额度分配使用基于各模型按模型价金额占比的对订阅费用的加权平均:每个模型的金额 = 订阅费 × 该模型金额 ÷ 周期总金额(订阅费按各模型按模型价的消耗金额占比摊薄);0.3.4 起只统计当前生效计费周期(当前 TID),不再优先用上一轮周期,周期尚无数据时标注「正在统计」并回退到展示范围的消耗按同一加权规则分配,保证所有条目都参与比较。
4. 每日费用消耗表:微型日历中代表一天的正方形的填充颜色深度区分每天用量的多少(颜色越深消耗越多,悬停查看当日金额与 tokens);日历下方显示每一个日期的各模型消耗金额(Token Plan 的模型按加权平均计算,且加权平均严格限定同一 TID:订阅费 ÷ 该 TID 周期总 tokens × 当天 tokens,并标注「加权」;同一天同一 Provider 出现在不同 TID 时,当天各 TID 数据相加合并为同一 Provider 显示),每个日期的数据默认堆叠(日期头 + 该日各模型行 + 堆叠色条);429/402 待确认的消耗按模型价原值展示并标「待确认」;表格部分一次只显示最近 6 天的记录,其余记录用鼠标滚轮滚动查看。

周期口径:Token Plan 的回本 / 性价比 / 每日加权摊薄按计费周期(当前 TID)计算,不受当前选中的展示时间范围影响;饼图与 Provider 额度表按展示范围统计。TID 为插件内部周期身份,不向用户显示。

价格编辑

在 设置 → 任务通知与消耗 页顶部点击「价格编辑」导航切换到价格编辑视图:

1. 选择币种(¥ / $)。
2. 设置全局默认价格(每 1M tokens:缓存输入 / 缓外输入 / 输出 / 缓存写入 / 推理)——作为未收录官方价且未自定义的模型的兜底单价。
3. 模型价格(跨 Provider 合并):页面列出全部 Provider 消耗记录中出现过的所有模型(0.3.2:首次启动 / 无数据时也列出 Provider 目录所含模型,可提前定价),同一模型只保留一行。每张模型卡片显示模型显示名(0.3.7:优先全局模型设置里该 Provider 下该模型的显示名,未配置则用官方目录的「厂商 + 模型名称」,悬停见原始模型 ID)与集体价格——未自定义显示官方价,勾选「自定义价格」解锁编辑;0.3.7 起勾选后可选 自定义(逐字段价)/ 倍率 方式,倍率模式输入倍率即可,实际价 = 该模型默认价格 × 倍率(默认价 = 官方价,未收录回退全局默认价),页面只读展示按当前倍率计算的实际单价。点击卡片展开 Provider ID 子卡片:「使用集体价格」开关(取消勾选编辑该 Provider 专属价,自动预填当前生效价)+ 0.3.7 新增价格倍率(默认 1,对该 Provider ID 使用此模型的最终价整体 × 倍率)。
4. 添加模型:在输入框输入模型名称后点「添加模型」,可手动加入未出现在消耗记录中的模型行(同样可激活后自定义价格;查重不区分大小写)。
5. Token Plan 设置已移至 设置 → Token Plan Key 管理(0.3.2):本页只编辑模型价格;保存时套餐保持现状、不会被清空。
6. 峰谷计价(全局默认窗口):开关、峰时段(UTC 小时)与「仅工作日」配置;默认即 DeepSeek 官方规则(北京时间周一至周五 9:00-12:00、14:00-18:00 为峰时,2026-08-16 16:00 UTC 前按基础价)。
7. 主体峰谷规则页(卡片 / 子卡片「设置」按钮进入;0.3.5 引入、0.3.7 重做):为「模型集体」或「模型 × Provider ID」配置峰谷规则——顶部为生效开关与自定义时区(UTC 偏移小时,支持 0.5 步进,默认 8 = UTC+8);每条规则含生效日(工作日 / 自定义(勾选星期)/ 每天)、高峰时段(如 1-4,6-10,按主体时区的小时)与峰时价格方式(倍率 / 自定义——自定义直接填五个峰时单价,留空字段按原价计费);规则自上而下逐条判定,首个命中调用时刻的规则生效,无命中按基础价(Provider 规则优先于集体规则,主体规则优先于官方目录内嵌峰谷档),退出本页即保存此页的一切更改;启用后对应卡片显示「峰谷」徽标与规则摘要。
8. 点「保存价格」后立即生效:汇总卡片、按 Provider 表、按模型表与完工通知标题里的金额马上按新价格重算(服务端按每次调用的时刻逐条取峰谷档)。

金额口径 = 各类 tokens × 对应单价 ÷ 1M,价格按「每 1M tokens」计;改价只影响展示与通知标题,不改动原始 usage 账本。

旧账目(0.1/0.2)默认按低谷价:旧版本记录的账目没有峰谷语义,插件对无版本标记的旧条目统一取低谷价(模型未配置峰谷档时即基础价),避免旧数据被按峰时价回溯计费;0.3 起记录的消耗(账目带 ver)按每次调用的时刻取峰/谷档。

内置官方价格目录与峰谷计价

• 默认价以《主流大模型API官方价格汇总.xlsx》(2026-09)为基准:目录中表格已收录的模型一律按表格取值——「输入价格」→ 缓存未命中输入(cacheOut)、「缓存命中价格」→ 缓存命中输入(cacheIn;表格未给出的海外模型按官方缓存折扣惯例补齐:OpenAI GPT-4.1 系列 25% / GPT-5.x 系列 10%、Anthropic 0.1×、Gemini 25%)、「输出价格」→ 输出(output);区间价(如 ¥8~10)取基础起步价;表格未收录的既有官方价条目(GPT-4o / o3 / Claude 4.x / Gemini 2.5 / kimi-k2 / qwen3-max / GLM-5.3 等)保留作为补充。
• 官方价默认生效:未激活自定义的模型自动按内置目录的官方价计费(按当前币种),无需手动填写;目录命中时页面显示官方价明细与来源。
• 币种与折算:表格「国内」厂商(DeepSeek / 阿里云 / 字节跳动 / 智谱 / 月之暗面 / 百度 / 腾讯 / MiniMax / 小米 / 零一万物 / 阶跃星辰 / 百川智能 / 科大讯飞)以人民币官方价入库;「海外」厂商(OpenAI / Anthropic / Google)以美元官方价入库;缺失一侧按固定汇率 1 USD = 7.2 CNY 折算。
• 峰谷计价(DeepSeek 等):目录中 DeepSeek 模型自带峰/谷两档官方价(工作日 9:00-12:00 / 14:00-18:00 价格翻倍,峰 = 2× 谷);统计与通知金额按每次调用的时刻逐条取档计费。
• deepseek-flash 与 deepseek-v4.1-flash 同价(0.3.6):目录为 deepseek-v4.1-flash 增加 deepseek-flash 别名,模型名 deepseek-flash 的调用按 deepseek-v4.1-flash 官方价计费(缓存命中 ¥0.02 / 缓外输入 ¥1 / 输出 ¥4,每 1M tokens)。
• 价格目录数据截至 2026-09,厂商可能调价;修改任意价格不会影响其他模型,历史金额随新价格即时重算。

插件配置

打开 设置 → 任务通知与消耗 页,在顶部导航切到「设置」视图即可调整:

清除记录数据(0.3.1):设置页底部可清除全部 Token 消耗统计账本。为防误操作,必须依次完成:① 拖动图形验证码滑块(按住滑块拖到最右端,松手后变绿锁定);② 输入随后出现的随机 8 位英文数字验证码(区分大小写,可点「换一个」);③ 连续点击两次「确认清除」。清除后「消耗统计」「使用分析」与完工通知金额全部归零并自动刷新,价格 / 套餐 / 峰谷配置不受影响。若宿主进程尚未重启(remote 无 clearUsage),面板会提示重启 DSH。

数据存储

• 账本:$DSH_HOME/storages/task-notice/usage.json(追加式,原子写,按保留天数裁剪;0.3.1 起每条账目带 ver 标记,旧账目按低谷价计费;0.3.1 修复 Key 归因后,启动时会按真实路由配置重算一次历史记录的归属;0.3.2 起 Key 身份 = Provider ID,账本旧 key 标签在读取侧自动迁移)。
• 配置覆盖:$DSH_HOME/storages/task-notice/config.json(由设置页写入,含价格、Token Plan(0.3.2 起以 Provider ID 为键;0.3.4 起每个周期含内部 TID、冻结历史 cycles、429/402 待确认 pending 与撤回快照 _undo)、峰谷配置与插件自维护的 Provider 目录(0.3.2,providers 段:list + removed 黑名单);0.3.7 起含顶层 pricingVersion 标记——价格配置结构版本,旧版本价格数据迁移(独立脚本)据此只在升级后第一次启动执行一次)。

开发

lib/
  index.js        宿主插件入口(name / apply;零顶层外部 import,依赖解析失败只停用本插件)
  store.js        消耗账本(usage.json,原子写、保留裁剪)
  accounting.js   llm/stream 瀑布捕获(usage 块 → 记账;流抛错时识别 402/429/QUOTA 等 Token Plan 错误码,0.3.4)
  fold.js         会话日志折叠(turn/end、goal/change → 通知帧)
  notify.js       通知枢纽(推送队列 + 流订阅)
  keys.js         provider → 凭证引用(API Key)解析(按真实路由配置:llm-* 命名空间 providers[route].apiKeyEnv)
  providers.js    Provider 目录(0.3.2):从全局模型设置抓取 Provider ID / 显示名 / 环境变量名 / 所含模型(0.3.7:模型条目带显示名 name,目录重扫判定,模型归属 Provider ID 判定 providerOfModel);Key 身份归一、旧 env 键 → Provider 迁移
  service.js      taskNotice RPC 服务(getHealth/getConfig/updateConfig/getUsageStats/getUsageAnalysis/resetPlanCycle/undoPlanCycle/renewPlanCycle/dismissPlanPending/clearUsage/subscribeNotifications/getPriceCatalog/getProviderDirectory/refreshProviderDirectory/deleteProviderId)
  typert.host.js  手动注册的 Typert 清单工厂(zod v4 编解码)
  pricing.js      价格计算(模型跨 Provider 合并 / 官方价默认 / 大小写不敏感查找 / 倍率模式与 Provider 倍率 / 旧账目低谷价 / 峰谷 v2 取档(生效日+时区+峰时价格方式) / 金额折算 / Token Plan 计费周期)
  pricing-migrate.js  0.3.7 旧版本价格配置迁移(独立脚本:升级首启自动把旧峰谷规则 / 倍率字段应用到 v2 结构,pricingVersion 标记只执行一次)
  pricing-catalog.js  内置官方价格目录(268 条,双币种 + 显示名,峰谷子档;默认价以《大模型API定价对比(7).csv》为基准,0.3.8 与该 CSV 逐条核对并补入新增的硅基流动条目)
  analysis.js     使用分析计算(模型聚合 / 消耗聚合严格按 Provider 目录归属 / 品牌读目录显示名(0.3.7)/ Token Plan 计费周期轮换与重置 / TID 周期身份与冻结历史 / 429/402 临时账本 / 性价比(0.3.7 修复:计划 Provider 按模型调用量 ÷ 加权金额)/ 每日同 TID 加权平均摊薄)
  client.js       浏览器端(顶部提示横幅(0.3.6:通知权限一键授权 / 未定价模型点击直弹价格编辑弹窗)+ 完工弹窗 + 今日消耗 + 消耗统计 + 使用分析(含 Token Plan 重置保护/撤回 + 429/402 提示弹窗/续费确认 + 历史周期 + 待确认横幅)+ 价格编辑(0.3.7:模型显示名 / 自定义-倍率方式 / Provider 价格倍率 / 峰谷规则 v2)+ 设置:插件配置 / Token Plan Key 管理 / Provider ID 管理 / 清除数据)
cordis.patch.yml  本包的 profile 层补丁(挂载一行)

依赖纪律:宿主入口零顶层外部 import(只 import Node 内建模块与自身模块);运行期可用的服务(session/settings/credentials/typert/loader/llm)一律经 ctx 访问。唯一的外部包 zod(Typert 编解码)只在 lib/typert.host.js 顶层 import,而该文件由 typert-loader 直接加载、不经宿主入口——即使依赖解析失败(如 Windows link: 安装的 junction realpath 陷阱),也只让本插件的 Typert 清单注册失败,DSH 照常启动。

License

MIT