dsh-tokenrhythm-bill

Readme

# dsh-tokenrhythm-bill

**基元律动费用中心** —— DeepSeek Harness（DSH）插件，把[基元律动 tokenrhythm.studio](https://tokenrhythm.studio) 的模型清单、账户余额、用量、密钥管理与服务状态，集中到侧栏底部一个小面板里。

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

## 界面预览

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

![模型页签](image/模型.png)

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

![余额主卡](image/余额.png)

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

![设置页](image/设置.png)

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

![侧栏入口](image/入口.png)

## 功能一览

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

### 余额
- **账户余额主卡**：大字展示总余额（带千分位），右侧**限时额度** + **倒计时胶囊**（≤3 天转警示色）+ **限时占比条**（一眼看出多少是「会过期的钱」），有冻结金额时一并显示
- **当日使用**：调用次数、输入 / 输出 / 缓存 tokens、当日花费（本地 0 点起统计）
- **近 7 天花费柱状图**：悬停任一柱子浮出**当日各模型消费明细**（Top 6 + 其他）
- 每 60 秒自动刷新；临期或余额不足时顶部有预警条
- 主卡上方标注**数据归属账号**（显示平台用户名，数据按账号隔离，切换账号立即刷新）
- **侧栏入口常驻余额**：不打开面板也能在侧栏底部看到当前账号余额，切换账号随之更新；**悬停入口**浮出限时余额时间线（逐笔列出每笔限时额度和「N 天后失效」，无限时额度时不显示）；设置页可把胶囊切换为**总余额 / 限时总余额**二选一

### 状态
- **服务总览横幅**：整体状态文案对齐官方状态页（所有系统运行正常 / 部分服务性能下降 / 部分服务中断 / 重大服务中断）带呼吸状态点，今日可用性、平均首字延迟、未解决事故一目了然
- **厂商分组折叠面板**（对齐官方状态页）：顶部 **24小时 / 7天 / 90天** 视图切换（官方同款，默认 24h）；平台网关排最前，按 DeepSeek / GLM / Kimi / MiniMax / Qwen / Seed / 其他 分组；组头显示「组名 · N 个组件 · 摘要」，有问题的组自动展开，点击组头折叠；**组体照官方页**：每通道一行（状态点 + 模型名 + 上下文 · 价格元信息 + 首字延迟 + 所选区间可用率%），下方 90 天**逐日柱条**或 24h/7d **探测粒度格子**（72/84 桶重采样、flex 铺满**无滚动条**，悬停看「时间范围 · 最差状态 · 探测次数」）
- **最近事故**：自动检测的服务中断（原因 + 开始时间 + 持续时长 + 已恢复 / 未解决标记）
- 模型页签与状态页解耦：卡片胶囊只显示平台状态（在线 / 测试中），探测详情集中在「状态」页签
- 数据经 host 后端代理（2 分钟缓存 + 上游失败回退快照），浏览器不跨域直连，每 60 秒自动刷新

### 密钥
- 查看平台 API Key 列表（只显示掩码），匹配到本机完整密钥时可一键复制完整值
- 直接新建平台 API Key

### 设置（面板右上角 ⚙）
- **账号管理**：添加 / 一键切换 / 删除**多个**基元律动账号，密码保存在本机、随时可明文查看
- **入口胶囊余额**：侧栏入口胶囊显示「总余额」或「限时总余额」，点击即切换并记住选择
- **插件更新**：自动比对 npm 最新版本（24 小时缓存），有新版时状态转高亮并提供「复制更新命令」，只提醒不自动执行
- **备用粘贴**：网页会话 Cookie（`tr_session`）兜底登录（默认折叠，用的时候展开）

## 安装说明

任选以下一种方式安装，**安装后需重启 DSH**，侧栏底部才会出现入口。

**方式一：插件市场**（收录后可用）

在 DSH 插件市场搜索「基元律动费用中心」或 `dsh-tokenrhythm-bill`，一键安装。

**方式二：命令行 · npm 源**（推荐，秒级安装）

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

> 已装过旧版本？重复执行上述命令即可**更新**到最新版，然后重启 DSH。

## 首次配置

1. 点击侧栏底部「基元律动-费用中心」入口 → 右上角 ⚙
2. 添加基元律动**账号和密码**并登录（一次性；密码只保存在本机）
3. 回到「余额 / 模型 / 状态 / 密钥」页签即可使用（面板默认落在余额页），入口右侧会常驻显示当前账号总余额

> **平台登录接口不可用时**：浏览器登录 [tokenrhythm.studio](https://tokenrhythm.studio) → F12 → 应用 → Cookie → 复制 `tr_session` 的值，粘贴到「备用：粘贴网页会话 Cookie」框中保存（直接粘贴 `tr_session=sess_…` 整串也认）。Cookie 过期后余额页签会引导你回设置重新登录。

> **会话自动续期**：登录成功后 Cookie 保存在本机并自动复用；粘贴新 Cookie 即完成切换账号（自动识别身份）。会话过期时，若该账号已保存密码则**自动重登同一账号**并继续刚才的操作，全程无感；未保存密码的账号才会提示重新登录。

## 隐私说明

- 账号密码与会话 Cookie 只保存在**本机**，**永不下发浏览器**
- 界面中的 API Key / Cookie 一律显示掩码；完整值仅在你主动点击时才复制到剪贴板

## 常见问题

- **切换账号后图表变成 ¥0？** 余额、用量、趋势都按账号隔离——切到没用过的账号自然为空，切回原账号即恢复原数据。
- **余额显示「会话已过期」？** 到设置页重新登录，或重新粘贴 Cookie。