一个基于 DeepSeek Harness / Cordis 的动态插件：实时估算单次会话的累计花费，一旦超过 ¥1 就在界面顶部弹出横幅提醒，停留 5 秒后自动隐藏，并同步显示 DeepSeek 账户的充值余额。
在使用大模型 Agent（如 DeepSeek Harness）时，会话消耗的 token 费用是逐轮累积的，用户往往等到月底账单出来才发现超支。本项目提供一种低成本、零侵入的实时成本感知方案：
- 插件部署后无需任何配置，自动跟踪当前会话的 token 用量投影（Host 实时推送）；
- 按当前模型对应的单价（内置价格表）估算累计花费；
- 花费跨越预警线（默认 ¥1）的瞬间在界面顶部弹出横幅；
- 横幅 5 秒后自动消失，不打断工作流，可手动提前关闭；
- 顺带展示 DeepSeek 开放平台的账户余额，花费与余额一眼可见。
⚠️ 花费为估算值（系统不提供定价，由内置价格表折算），实际扣费以 DeepSeek 开放平台账单为准。
| 特性 | 说明 |
|---|---|
| 🚨 阈值触发横幅 | 花费从 ≤¥1 变为 >¥1 的瞬间，顶部滑入横幅提醒 |
| ⏱️ 5 秒自动隐藏 | 停留 5 秒自动消失，也可点 ✕ 提前关闭；再次跨线重新弹出 |
| 💰 账户余额显示 | 横幅内同时显示账户总额与充值金额（CNY） |
| 🔄 实时刷新 | 模型价格每 5s 刷新，余额每 30s 刷新 |
| 🔒 Key 安全 | API Key 只留在 Host 进程内（子进程 env），绝不下发浏览器 |
| 🎨 主题适配 | 使用 DSH 主题 CSS 变量，自动适配明暗主题 |
| 🧩 零侵入 | 注册到 shell.overlay 附加槽位，不替换任何现有 UI |
当会话花费超过 ¥1 时，界面顶部出现：
┌────────────────────────────────────────────────────────────┐
│ ⚠ 本会话累计花费 ¥1.23 │
│ 已超过 ¥1 预警线 · deepseek-v4-flash │
│ 账户余额 ¥39.64（充值 ¥39.64） [✕] │
└────────────────────────────────────────────────────────────┘
（5 秒后自动隐藏）
┌─ Client (浏览器) ─────────────────────────────────────────┐
│ shell.overlay 槽位注册横幅组件 │
│ · useSessions → 当前会话 projectionValues.tokenUsage │
│ （Host 实时推送的累计 token 用量投影） │
│ · 花费 = Σ(各桶 token / 1e6 × 单价) │
│ · host.call('cost/price') 每 5s 取当前模型单价 │
│ · host.call('cost/balance') 每 30s 取账户余额 │
└───────────────┬────────────────────────────────────────────┘
│ Package-private JSON RPC (host.call)
┌───────────────▼────────────────────────────────────────────┐
│ Host (DSH 进程) │
│ · cost/price: agentDefaultModel.currentSelection() │
│ → 内置价格表查价（未知模型回退默认价） │
│ · cost/balance: credentials.resolve('DEEPSEEK_API_KEY') │
│ → shell(curl) 请求 │
│ https://api.deepseek.com/user/balance │
└────────────────────────────────────────────────────────────┘
trea_18/
├── README.md # 项目介绍（本文件）
├── package.json # 项目元信息 + npm run check 语法校验
└── plugin/
├── host.js # 插件 Host 半区源码（code.host）
└── client.js # 插件 Client 半区源码（code.client）
本插件是 DSH 的动态 Cordis 插件，通过 Harness 界面的 cordis_define + cordis_run 部署：
cordis_define（kind: new）时：code.host←plugin/host.js的内容；code.client←plugin/client.js的内容；
cordis_run激活，并在界面批准 Client 包；- 生效：当前会话花费超过 ¥1 即弹出顶部横幅。
本地语法校验：
npm run check（无第三方依赖）。
代码顶部可直接调整的常量：
| 常量 | 默认值 | 说明 |
|---|---|---|
THRESHOLD |
1 |
花费预警阈值（元） |
AUTO_HIDE_MS |
5000 |
横幅停留时长（毫秒） |
PRICES |
deepseek-chat / reasoner 两档 | 每百万 token 单价（人民币），按模型 id 查表 |
DEFAULT_PRICE |
输入 ¥2 / 缓存命中 ¥0.5 / 输出 ¥8（每 M） | 未知模型回退价 |
- 花费为估算值：系统数据模型不提供定价，插件使用内置价格表折算；如需精确计价，请按 DeepSeek 官方最新价格调整
PRICES。 - 余额依赖 DeepSeek 提供方：
/user/balance仅对 DeepSeek 公共 API（api.deepseek.com）可用；接口不可用或网络异常时自动降级，横幅只保留花费提醒。 - API Key：通过
credentials.resolve('DEEPSEEK_API_KEY')解析，仅用于 Host 侧请求余额接口，不会写入浏览器、命令行或日志。
本项目未指定开源许可证，保留所有权利。