{"_id":"@absons/dsh-deepseek-balance","name":"@absons/dsh-deepseek-balance","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.1":{"name":"@absons/dsh-deepseek-balance","version":"0.1.1","description":"DeepSeek 余额状态栏(dsh web bundle):状态栏实时显示余额/本回合/累计/今日消耗与缓存命中率,含充值入口、自动计价与账单校准","type":"module","main":"lib/index.js","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/Absons/dsh-pluging.git"},"exports":{".":"./lib/index.js","./client":"./lib/client.js","./package.json":"./package.json"},"dsh":{"client":{"inject":["@deepseek-ai/dsh-client-runtime","@deepseek-ai/dsh-client-connection","@deepseek-ai/dsh-api-remotes","@deepseek-ai/dsh-client-locale"],"platform":"web"},"bundle":{"patch":"cordis.patch.yml"}},"dependencies":{"@deepseek-ai/schemastery":"^3.18.1"},"peerDependencies":{"react":"^18.2.0","@deepseek-ai/cordis":"^4.0.1"},"peerDependenciesMeta":{"@deepseek-ai/cordis":{"optional":true}},"keywords":["deepseek","dsh","deepseek-harness","cordis","plugin","bundle","balance","statusbar","quota"],"license":"MIT","gitHead":"8bb51a886a1c5cf8940a0f5bff68b6399924d75a","_id":"@absons/dsh-deepseek-balance@0.1.1","bugs":{"url":"https://github.com/Absons/dsh-pluging/issues"},"homepage":"https://github.com/Absons/dsh-pluging#readme","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-nNWD7It7OsZv8A7D8D4FzDtS557DlEq+XGXlHH3qOaGmtdNUVW6tUlTuagRt5e68M8CBPRTNl3/qnpTnQFnj4Q==","shasum":"49fa6ac532d45620719daa21bae975b2f3b12cd2","tarball":"https://registry.npmjs.org/@absons/dsh-deepseek-balance/-/dsh-deepseek-balance-0.1.1.tgz","fileCount":8,"unpackedSize":92207,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIALlw0OQJ/BdD2tfVMirAKledRsI857lhqGU83e3C8iKAiEA7YOv/P6bM11m5q1o4VlT1RgVzP9Wb0K9qwWV0yCUyUY="}]},"_npmUser":{"name":"absons","email":"YX_9264@163.com"},"directories":{},"maintainers":[{"name":"absons","email":"YX_9264@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/dsh-deepseek-balance_0.1.1_1786885773394_0.8587993946475869"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-16T13:09:33.256Z","0.1.1":"2026-08-16T13:09:33.541Z","modified":"2026-08-16T13:09:33.719Z"},"maintainers":[{"name":"absons","email":"YX_9264@163.com"}],"description":"DeepSeek 余额状态栏(dsh web bundle):状态栏实时显示余额/本回合/累计/今日消耗与缓存命中率,含充值入口、自动计价与账单校准","homepage":"https://github.com/Absons/dsh-pluging#readme","keywords":["deepseek","dsh","deepseek-harness","cordis","plugin","bundle","balance","statusbar","quota"],"repository":{"type":"git","url":"git+https://github.com/Absons/dsh-pluging.git"},"bugs":{"url":"https://github.com/Absons/dsh-pluging/issues"},"license":"MIT","readme":"# DeepSeek 余额状态栏(@absons/dsh-deepseek-balance)\n\n一个面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)**Web GUI** 的可持久化 bundle 插件:在会话输入框下方的统计条位置实时显示 **DeepSeek API 账户余额、本次对话与本日消耗、缓存命中率**,并带充值入口、自动按模型计价与账单校准。\n\n安装后**刷新页面、重启 dsh 都不会丢失**,无需审批,随 profile 自动加载。\n\n## 功能\n\n- **状态栏**(`conversation.composer.dock`,输入框下方、token 统计条同一行):\n  - 账户余额总额 / 充值余额 / 赠送余额 / 可用状态 / 更新时间,一键 `⟳` 强制刷新\n  - **本回合消耗**(最近完成回合)与**会话累计消耗**\n  - **今日消耗**(跨全部会话汇总)\n  - **缓存命中率**\n  - **充值入口**:「充值 ↗」直达 DeepSeek 平台充值页(`TOP_UP_URL` 常量可改)\n- **自动计价**:从会话日志识别实际使用的模型(`deepseek-v4-flash` / `deepseek-chat` / `deepseek-reasoner` / `deepseek-v4-pro`),按内置官方价格表自动计算,无需手动选择;未知模型回退 flash 档\n- **账单校准**:填入平台「今日消费」金额后,插件自动按比例缩放全部金额,与平台账单完全对齐(平台调价也只需改这一个数字)\n- **设置页**(侧边栏 ⚙ →「DeepSeek 余额」):\n  - 显示项独立开关(总额/充值/赠送/可用状态/更新时间)\n  - 主题 DIY:6 个颜色选择器、背景色/透明、字号(10–20px)\n  - 刷新策略:对话完成时自动刷新(回合结束信号)+ 定时刷新(15s/30s/60s/5min/关闭)\n  - 手动价格覆盖 + 恢复自动\n  - 会话用量明细:回合数、输入(未命中)/缓存/输出 token、命中率、累计/最近回合/今日金额、调用次数\n\n> 注:设置项保存在浏览器会话内存中,刷新后恢复默认;消耗为估算,以平台账单为准。\n\n## 安装\n\n前置:DSH CLI + [pnpm](https://pnpm.io/installation)(`dsh plugin` 依赖 pnpm)。\n\n```sh\n# 本地路径安装(link 方式,改源码即生效)\ndsh plugin --profile web add D:\\dsh\\deepseek-balance-statusbar\n\n# 或从 npm 安装\n# dsh plugin --profile web add @absons/dsh-deepseek-balance\n```\n\n然后:\n\n1. 重启 dsh web:`dsh web`(bundle 层在启动时读取)\n2. 打开 http://127.0.0.1:3080 刷新页面\n3. 输入框下方出现余额状态栏\n\n**API 密钥**:复用 harness 的凭据(`Settings → Models` 里配置,存储于 `~/.dsh/.credentials.yaml`),或设置环境变量 `DEEPSEEK_API_KEY`。密钥只在本机使用,浏览器仅访问本地路由。\n\n## 配置(Host Config)\n\n在 profile 的 `cordis.patch.yml` 中对本插件行补 `config` 可覆盖默认值:\n\n| 字段 | 默认 | 说明 |\n| --- | --- | --- |\n| `apiKey` | `''` | 显式 API 密钥;留空走 `apiKeyRef` |\n| `apiKeyRef` | `DEEPSEEK_API_KEY` | credentials / 环境变量引用名 |\n| `baseUrl` | `https://api.deepseek.com` | DeepSeek API 基址 |\n| `refreshIntervalMs` | `300000` | 服务器拉取余额的间隔(ms) |\n| `timeoutMs` | `8000` | 余额请求超时(ms) |\n\n## 架构\n\n```\n┌─────────────┐  服务器定时拉取+缓存  ┌──────────────────────────┐\n│ DeepSeek API│◀───────────────────│ Host(lib/index.js)        │\n│ /user/balance│                   │ · 余额缓存(stale-while-error)│\n└─────────────┘                   │ · webServer 注册只读路由:   │\n                                  │   /deepseek-balance/balance │\n                                  │   /deepseek-balance/session-usage\n                                  │   /deepseek-balance/today-usage\n                                  └────────────┬────────────────┘\n                                               │ 浏览器 fetch(同源)\n                                  ┌────────────▼────────────────┐\n                                  │ Client(lib/client.js)        │\n                                  │ · 余额/今日:fetch 本地路由    │\n                                  │ · 本回合/累计/命中率:会话快照  │\n                                  │ · 自动计价/校准/主题/设置页    │\n                                  └──────────────────────────────┘\n```\n\n- **Host 半区**(`lib/index.js`):函数插件(`name` / `Config` / `apply`),直接使用 Node 全局 `fetch` 访问 DeepSeek,`ctx.webServer.register` 注册三个只读 JSON 路由;会话/今日用量读取 `sessionPersistence`(会话日志),60s 缓存\n- **Client 半区**(`lib/client.js`):浏览器 bundle(`window.__ModuleLoader__.load` 格式),`fetch` 读取本地路由;会话内用量从 `session.chat` 快照节点计算\n\n## 目录结构\n\n```\n@absons/dsh-deepseek-balance/\n├── lib/\n│   ├── index.js       # Host 半区(路由 + 余额缓存 + 用量统计)\n│   └── client.js      # Client 半区(状态栏 + 设置页)\n├── cordis.patch.yml   # bundle patch:挂载插件行\n├── src/               # 早期动态插件版源码(参考)\n├── package.json       # dsh.bundle + dsh.client 声明\n├── README.md\n└── LICENSE            # MIT\n```\n\n## 开发与卸载\n\n- 本插件以 `link:` 方式安装时,**直接修改本目录源码即生效**:内容类改动刷新页面即可,结构类改动(如 package.json)需重启 dsh web\n- 卸载:\n\n```sh\ndsh plugin --profile web remove @absons/dsh-deepseek-balance\n```\n\n## 许可\n\n[MIT](LICENSE)\n","readmeFilename":"README.md","_rev":"1-51a4139edb6ea5fa9cad2a666eae476d"}