dsh-tokenrhythm-bill

dsh plugin --profile web add dsh-tokenrhythm-bill

dsh-tokenrhythm-bill

基元律动费用中心 —— DeepSeek Harness（DSH）插件，把基元律动 tokenrhythm.studio 的模型清单、账户余额、用量与密钥管理，集中到侧栏底部一个小面板里；另支持阶跃星辰（StepFun）Step Plan 与 ZCode 桌面端套餐额度的可选接入。

在 DSH 侧栏底部（设置按钮上方）点击「基元律动-费用中心」入口即可打开可拖拽面板；也可以直接按 Ctrl+J（macOS Cmd+J）呼出/收起。入口左侧是品牌标 + 名称，右侧常驻总余额胶囊（切号即刷、预警转琥珀色）；悬停入口可浮出限时余额时间线——逐笔列出每笔限时额度和「N 天后失效」（实时计算，无限时额度时不显示）；侧栏收起时只保留品牌图标。

界面预览

截图取自 v0.5.2（当时是三页签）。当前版本已扩展为 余额 / 用量 / 模型 / 状态 / 密钥 五个页签 + 标题位提供商切换器（基元律动｜阶跃｜ZCode），版式沿用同一套设计令牌，功能以正文为准。

模型页签 —— 分类筛选 + 卡片网格 + 状态联动

余额主卡 —— 账户余额 + 限时额度占比

设置页 —— 账号管理 + Cookie 兜底

侧栏入口 —— 品牌标 + 常驻总余额 + 预警点

功能一览

模型

• 顶部分类筛选：全部 / 文本 / 图像 / 音频 / 视频 / 向量（带计数，口径与平台模型列表页一致）
• 文本在前、图像在后，价格升序：图像模型按图片单价、文本模型按输入单价（有折扣取折扣价）；无价格的排组尾，同价内保持平台原序
• 卡片结构对齐平台模型页：名称 + 状态胶囊（在线 / 测试中）headline，模型 ID + 来源（无问芯穹 / DeepSeek / 百炼…）副行
• 规格 / 价格两栏：序列长度、支持模态（文本 / 图像 / 视频 / 音频 / 向量）、最大输出长度；输入 / 输出 / 缓存命中单价（折扣时划线标原价，¥x.xx/M）、图片单价
• 折扣模型：标题行最左带「折扣」徽章（实底绿渐变 + 白字，行内排布、不影响卡片布局），价格栏同时划线标原价；状态胶囊只显示平台状态（在线 = 绿点 / 测试中 = 琥珀点）——模型页签已无探测联动，探测详情看「状态」页签

余额

• 账户余额主卡：大字展示总余额（带千分位），右侧限时额度 + 倒计时胶囊（≤3 天转警示色）+ 限时占比条（一眼看出多少是「会过期的钱」），有冻结金额时一并显示
• 占比条是两段色（v0.5.22 定稿）：主题蓝＝非限时额度（余额里不会过期的那部分，条子的左段/底色），橙＝限时额度（会到期失效的那部分，落在最右端，justify-content:flex-end 推过去）。原先轨道是灰底、橙段在左，只看得出「限时占多少」；现在两段各自有语义、且限时贴着右端。限时额度恰为 0 时不画橙段（填充段带 2px 最小宽，留着会在纯蓝条右端挂一颗橙色小点）。橙色在本插件里专属「限时额度」这一语义：ZCode 页那张占比条走中性配方（灰轨道 + 主题蓝填充），不出现橙色
• 当日使用：调用次数、输入 / 输出 / 缓存 tokens 与命中率、当日花费（本地 0 点起统计）
• 资金明细（v0.5.8 新增）：把账户余额拆回来源逐笔列出——充值本金置顶，之后每笔赠送额度一行，含赠送多少 / 已用多少 / 还剩多少 / 何时到期，按到期早晚排序（临期的排最前）；已用完的（USED_UP）也保留，否则就说不清「这一路总共赠送过多少」。摘要行另给「累计赠送」「未到期」两个数
• 每 60 秒自动刷新；临期或余额不足时顶部有预警条
• 页首是一行（v0.5.27 定稿）：左边「● 数据账号：Ali」，右边「更新于 21:37:58」+ 刷新按钮，同一行、两端对齐。原来「数据账号」自己占一行、页脚另有一行「更新于 … · 每 60s 自动刷新 · 账号」——刷新间隔是实现细节、账号名重复，两者现在合成一行，时间从页脚挪到右上角。基元余额 / ZCode 用量两个页签共用同一个 pageTopBar + acctLine（ZCode 那页左侧文案是「ZCode 账号：…」）；ZCode 活动页没有时间与账号段，右上角就只有刷新按钮。时刻一律 24 小时制（自建 fmtClock/fmtClockDay）：浏览器本地化的时刻格式化会把 12 小时制随系统区域漏出来，英文区域下实测显示「9:37:58 PM」
• 主卡上方同一行标注数据归属账号（显示平台用户名，数据按账号隔离，切换账号立即刷新）
• 主卡上方标注数据归属账号（显示平台用户名，数据按账号隔离，切换账号立即刷新）
• 侧栏入口常驻余额：不打开面板也能在侧栏底部看到当前账号余额，切换账号随之更新；悬停入口浮出限时余额时间线（逐笔列出每笔限时额度和「N 天后失效」，无限时额度时不显示）；设置页可把胶囊切换为总余额 / 限时总余额二选一
• 更长周期（30 天）的用量看「用量」页签；本页不重复放 7 日柱状图与「最近调用」——那两块每次刷新都要翻几十页 call-logs，平台约每 3 个请求就 503 一次（阶跃账号卡展开区那组 7 日 Credit 柱条走的是阶跃自己的接口，与本页无关）

用量（v0.5.5 新增，0.5.6 / 0.5.8 优化）

• 近 30 天主卡：左边总花费（主值），右边调用次数 + 总 Tokens 并排（都是「用了多少」的量级口径，放一起才好对照）；下方 4 张指标卡做细化拆分：成功 / 失败、中止、输入 / 输出、缓存命中率
• 30 天热力日历：一格一天，格子底色随当日花费深浅变化（越贵越浓），金额直接摆在格子里；周末列表头与空格另有区分。标题行右上角有覆盖度角标（N / 30 天有调用 · 明细起 XXXX-XX-XX）——空格子占多数是常态，角标说清「空的是真空」而不是「没加载出来」。悬停有调用的格子才浮出当日明细（模型列表 + 各自金额 / 调用数、开源节省）——当天无调用的格子没有可看的东西，不弹浮层。浮层靠左/右边缘的格子自动贴边、第一行的翻到下方，不会被面板裁掉
• 按模型 / 客户端拆分：左右并排各占一半宽度（信息量相当、也常要对照着看，上下排会把面板撑到要滚两屏），各取花费前 6 名排行，带占比条
• 口径说明写死在界面上：日历只统计最近 30 天；平台没返回明细的日子画虚线框 + 「—」；两个上游接口的 30 天合计若出现分差会显式提示「以汇总为准」，不悄悄选一个
• 每 90 秒自动刷新，可手动刷新

状态（自定义检测，v0.5.7 起）

• 官方状态站 2026-09-14 起停更，原先基于它的「服务总览横幅 / 厂商分组折叠面板 / 24h·7d·90d 可用率视图」整块移除；状态页改为用你自己的 Key 实测
• 自定义检测卡：勾选要检测的 chat 类模型（图像 / 音频等本就不可探测，直接不列出），点「立即检测」对每个选中模型发一次真实 1-token 推理（约 ¥0.0004/模型，计入你的 API Key 账单）；也可选定时间隔（5 / 10 / 15 / 30 / 60 分钟）自动重测——只在面板打开期间跑，关面板即停
• 结果逐行给出：状态点（正常 / 降级 / 失败）+ 模型名 + 首字延迟；没测过的显示「未检测」，不伪装成正常；失败原因挂在行内 tooltip，完整错误不占版面
• 与模型页签的分工：模型卡上的胶囊只表示平台标注的在线 / 测试中；「此刻我的 Key 能不能打通这个模型」看这一页

密钥

• 查看平台 API Key 列表（只显示掩码），匹配到本机完整密钥时可一键复制完整值
• 直接新建平台 API Key
• 阶跃首页「密钥」页签里维护阶跃控制台的「接口密钥」：新建 / 复制完整值 / 删除（立即失效）；完整值只在创建时展示一次，列表只显示掩码，复制走本机 host 按需单取，不经过任何服务器

阶跃（StepFun）

• 提供商切换：面板标题右侧的 基元律动 | 阶跃 | ZCode 切换器切到阶跃（未配置阶跃账号时这一段不出现）
• 卡面配色（v0.5.20 修正）：账号卡改用与模型卡同一套 浅灰 soft 卡面 + 细描边 + 抬升投影，卡内「账户余额 / Credit 月池」两格反相为白。此前卡面用的是 layer-1 实底白，而面板底层是 layer-2（也是白）——同色之下整张卡只剩一根 4% 描边，用户直接反馈「没有颜色、看不出卡片边界」。未查询的 .dim 卡仍是虚线框 + 透明卡面，其两格回落 soft，保持原来的观感；「显示中」那一态保持原样式不动（用户指定）：accent 8% 叠在白卡面上 + 格面 soft + 左侧 3px accent 竖条
• 「账户」页签（v0.5.9 起账号 + 用量二合一）：把设置里配的全部阶跃账号各列一张卡，每张卡带该账号的账户余额与Credit 月池（百分比 + 内嵌进度条，档位走 52px 水印、到期与用量在 Credit 格次级行），Credit 格右上角另挂「↻ M/D 重置」——月池什么时候刷新剩余额度，悬停看完整时间与剩余天数。卡顶行从左到右是头像 · 用户名（昵称）+ 实名徽章 · 登录手机号 · 密码胶囊 · 显示 · 删除（v0.6.1 定稿的顺序）；密码胶囊挪到「显示」按钮前：默认打码（固定 6 个圆点，连长度都不透露），点一下才显明文，同一时刻只展开一个；没有保存密码的旧账号显示「未存密码」且不可点。每张卡可单独查询此账号 / 展开明细，卡上可直接删除账号（两段式确认）；账号增删都在这一页，设置页只留一个跳转入口——列表和增删同一屏，不再两处维护
• 头像 / 用户名（昵称）/ 实名状态（v0.6.1 新增）：账号卡左上角是头像——查到资料且平台给了头像时显示平台图（走宿主代理 /stepfun/avatar 取字节，不跨域直连 CDN，带桌面 UA 与防盗链头；加载失败自动隐藏破图、回落字母兜底），没查到资料或没有头像用昵称首字母兜底（连资料都没探明时显示「阶」字）。用户名（昵称）是主显示名，实名徽章紧跟其后：已实名（绿，平台返回码 2）/审核中（琥珀，返回码 1）/未实名与未知码（中性灰；认不出的返回码显示「状态 N」、语义写进 tooltip）——绝不硬编。资料来自 devcenter Dashboard/UserInfo 探测（缓存 15 分钟，与套餐/余额同批刷新）；没查到资料时头像/昵称/实名三项都不渲染，一次失败的探测也不顶掉已有资料
• 登录手机号在密码胶囊前（v0.6.1 调整）：查到昵称后，登录身份（掩码手机号/邮箱）从名字行挪到卡顶行、紧贴密码胶囊左侧——名字行收成一行（用户名 + 实名徽章），整卡矮一行；没查到资料时它仍是唯一显示名，回名字行顶主位，不留空卡
• 「显示」= 纯显示偏好：让侧栏胶囊、主卡和「接口密钥」页都跟着换成这个账号的数据。各账号会话分槽并存，不切换登录身份、不清缓存、不触发重登。页签标签直接带账号（密钥（138**0001））——增删密钥不可逆，归属不该藏在二级页面里，切了「显示」不进页签就知道这堆密钥是谁的；账号还没探明时退回纯「密钥」，页签文本统一次 nowrap + 省略号防长账号名撑爆两格布局。密钥页顶部原来还有一行归属标签（「「xxx」的密钥」+ 跟随说明），已按用户要求整块删除——归属信息由页签标签**承担，不必在同一屏写两遍
• 会话按账号分槽（键 = username 小写）：stepRpc 省略 username 时按 pickStepAccount 的口径兜底到活跃账号，所以 stepGetSess 的省略态也必须兜底到 activeAccount——多账号重构时这里漏了，而四个密钥 stepRpc 又恰好都没传 username，于是 ListAccessKeys 稳定报「无可用会话」（已修）。现在四个密钥调用（列表 / 取完整值 / 创建 / 删除）全都显式带 username，测试对每处调用逐一断言。显式传了 username 却没会话时不许兜底到活跃账号——那正是「查 B 回了 A 的结果」这类张冠李戴 bug 的温床
• 重置时间的取值与兜底：优先 subscriptionResetAt（订阅月池总表），缺失时降级到 type=1 桶的 nextResetAt。这个字段没有实测过（schema 注释标称秒级、与 expired_at 同口径），所以加了合理性窗口 [今天-1年, 今天+3年]——窗口外一律不显示，宁可不显示，也不显示一个公元 5 万年的错日期。剩余天数走日历日口径（0=今天、1=明天、负=已过），与限时额度到期天数一致；不用 ceil，否则「今晚就重置」会被算成「还剩 1 天」
• 密码不进列表响应：账

…(truncated)