← 返回列表
需源码安装
DeepSeekAPI余额查询插件
暂不能直接安装（需源码编译或环境不满足）：仓库 package.json 标记 private，未发布到 npm，需从源码安装。 · 最近上游提交 2026/9/16 · 已提供中文文档
综合分
29.5
GitHub 分
29.5
用户评分
—
★ Stars
0
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add xiyi123465/dsh-usage-calendar仓库 package.json 标记 private，未发布到 npm，需从源码安装，改用 GitHub 源安装
信任档位：已验证本站已于 1 天前真实安装成功
- 是什么
- dsh 原生插件 · other
- 装得上吗
- 本站已真实安装成功（非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 10 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/25
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/20（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查需源码安装
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✓npm 包dsh-usage-calendar @ 0.1.4
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
仓库 package.json 标记 private，未发布到 npm，需从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/22 08:27:44
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-usage-calendar
DeepSeek Harness（dsh web）持久插件：侧边栏底部常驻显示 DeepSeek 账户余额，点击打开日历面板，按天查看 花费（估算）、token 用量、缓存命中率，点击日期查看分模型明细。profile-bundle 安装机制，重启后依然存在。
功能
- 💰 账户余额：通过 DeepSeek 官方 GET {baseURL}/user/balance 接口查询（Node fetch + Bearer 认证），1 秒缓存，界面每 1 秒自动刷新，可手动强制刷新
- 📅 日历视图：按天聚合本机全部会话的 token 用量——活动会话走内存日志，已存档会话走 ctx.sessionQuery（listSessions() + readSession()），因此历史日期同样完整；月度网格显示每天花费、tokens、缓存命中率，深浅色表示花费高低；点击日期查看分模型明细；支持月份切换与"今天"
- 🧮 花费估算（人民币 + 峰谷分时）：按 DeepSeek Flash 系列官方价目（闲时 缓存命中 0.02 / 未命中 1 / 输出 4 元每百万 token）逐条按调用时刻计价，工作日 09:00-12:00 与 14:00-18:00 自动 ×2；价目表可通过 config.pricing 覆盖
- 🎯 缓存命中率：cacheRead / (input + cacheRead + cacheWrite)（提示词侧）
- 🔒 本地统计：数据来源仅为本机会话事件日志（assistant/chunk usage 样本），不上传任何数据；接口仅接受本机回环请求
安装
方式 A：profile bundle（本机采用，与 dsh-usage-stats 相同）
1. 将本仓库放到 $DSH_HOME/vendor/dsh-usage-calendar
2. 编辑 $DSH_HOME/profiles/web/package.json：
- dependencies 增加 "dsh-usage-calendar": "file:../../vendor/dsh-usage-calendar"
- dsh.profile.bundles 增加 "dsh-usage-calendar"
3. 在 $DSH_HOME/profiles/web 执行 pnpm install
4. 重启 dsh web，浏览器硬刷新
方式 B：npx 安装器（分发用）
npx --yes github:xiyi123465/dsh-usage-calendar
安装器把包复制到 $DSH_HOME/profiles/node_modules/dsh-usage-calendar，并把补丁写入 $DSH_HOME/profiles/web/cordis.patch.yml。重启 dsh web 后生效。
选项：--check（校验安装）、--dry-run（预览）、--no-enable（只复制文件不改补丁）、--help。可用 DSH_HOME 环境变量覆盖安装目录。
方式 C：ZIP 离线安装（无需 npx / 网络）
1. 将 zip 解压到 $DSH_HOME/vendor/dsh-usage-calendar（Windows PowerShell）：
Expand-Archive .\dsh-usage-calendar-0.1.3.zip -DestinationPath $env:USERPROFILE\.dsh\vendor
2. 运行安装器并重启 dsh web：
node $env:USERPROFILE\.dsh\vendor\dsh-usage-calendar\scripts\install.mjs
配置
- API Key：读取 llm-deepseek 设置命名空间的 apiKeyEnv（默认 DEEPSEEK_API_KEY），通过凭据服务在请求时解析 —— web 端「模型」页写入的 key 即可直接使用，插件不存储密钥
- baseURL：默认 https://api.deepseek.com；使用兼容中转时可在 llm-deepseek 设置中指定
- 价目表：cordis.patch.yml 的 config.pricing（人民币 / 百万 token）：
pricing:
currency: CNY
peakMultiplier: 2 # 高峰时段倍率
peakWindows: # 分钟数：540=09:00，720=12:00，840=14:00，1080=18:00
- days: [1, 2, 3, 4, 5]
from: 540
to: 720
rules: # 按顺序匹配「provider/model」子串，最后一条 match: "" 兜底
- match: v4-pro # Pro 闲时价：0.15 / 4.5 / 13.5
hit: 0.15
miss: 4.5
out: 13.5
- match: "" # Flash 系列（含已下线的旧模型名）闲时价
hit: 0.02
miss: 1
out: 4
价目取自官方定价页 ：
deepseek-flash 与 deepseek-v4-pro 两档，空闲价为高峰的一半；旧模型名
deepseek-v4-flash / deepseek-v4-flash-vision-exp 由 V4.1-Flash 服务，按 Flash 计费。
官方调价后改这里即可（无需改代码）；界面显示的花费为估算值，已标注"按官方价目估算（含峰谷）"
开发
pnpm check # 语法检查（node --check 全部文件）
pnpm smoke # 冒烟测试：合成事件折叠 + 桩服务启动 + 余额处理器
冒烟测试请将 DSH_HOME 指向临时目录，避免写入真实用量缓存：
$env:DSH_HOME = "$env:TEMP\dsh-smoke"; node scripts/smoke-host.mjs
与 dsh-usage-stats 的关系
两个插件互不依赖、可并存。dsh-usage-stats 提供热力图与多供应商余额；本插件提供余额 + 日历形式的花费/token/缓存命中率视图。