本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-usage-plugin

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @feiyang666/dsh-usage-plugin

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 用量日历：按月查看每日用量热力图（按消耗或调用数着色），悬停查看详情（含高峰 / 空闲消耗拆分）、点击某天查看当日调用明细与高峰/空闲消耗统计，附本月每日统计表（高峰消耗 / 空闲消耗 / 总消耗分列）与月度汇总。
• 缓存命中列表：最新记录排在最前，支持 今天 / 近7天 / 近30天 / 全部 快捷筛选与自定义起止日期区间，汇总行与表尾合计区分高峰消耗 / 空闲消耗 / 总费用合计；列表分页渲染（每页 100 条），记录量大也不卡顿。
• 价格表：DeepSeek 官方 API 价格表，展示基础价与峰谷价（高峰/空闲）单价表，高峰价与空闲价分列展示，支持在面板内直接编辑价格并持久化（数据目录 pricing.json），也可一键恢复默认。
• 剩余余额查询：用当前配置的 DEEPSEEK_API_KEY 查询 DeepSeek 账户余额。
• 导出：CSV / JSON / PNG 长图（按最新在前展示，最多含最近 2000 条，超出会提示；PNG 报告含高峰 / 空闲消耗分列统计），可导出到任意目录（原生目录选择器），导出后自动打开所在目录。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装好后看不到「用量与消耗」和「剩余余额查询」两个 Tab 怎么办？

通常是 cordis.patch.yml 里插件行的 inject 列表缺失或服务未就绪。日志看数据根旁的 dsh-usage-boot.log，确认 patch 文件里 fs / webServer / subprocess / credentials / settings / sandboxPolicy / agents 都被列出，再重启 DSH（参见 README.zh.md:256-258）。

数据存在哪里？切换工作区会不会丢失？

自 v1.9.2 起数据固定写到专用目录，v1.9.4 改为宿主进程 node:fs 直接写、不再受 workspace-write 沙箱约束；默认 Windows 写到 %LOCALAPPDATA%\dsh-usage-plugin\dsh-usage\，macOS/Linux 写到 ~/dsh-usage-data/dsh-usage/，可用环境变量 DSH_USAGE_DATA_DIR 覆盖。切换工作区不会丢失，旧的散落记录会在首次启动时按 time 去重合并进来（lib/index.js:398-413 / CHANGELOG.md:39-49）。

怎么查 DeepSeek / SiliconFlow / DigitalOcean 余额？

在「剩余余额查询」Tab 点对应服务商再点「查询余额」即可。DeepSeek 用设置里的 DEEPSEEK_API_KEY，SiliconFlow 复用「设置 → 模型」中名为 siliconflow 的提供商所引用的 API Key，DigitalOcean 需要在面板内保存 dop_v1_ 开头的账户级 Personal Access Token（lib/index.js:778-850, lib/balance.js:1-41）。

提示「'PersistEnable' 持久化未启用」是什么情况？

所有候选数据根（环境变量、AppData、用户主目录下的 dsh-usage-data）都无法写入，插件才会回退到工作区并显示该提示，属于极少见情况，多因权限或磁盘满引起（lib/index.js:407-411 / README.zh.md:243）。

能导出哪些格式？导出后会自动打开目录吗？

支持 CSV、JSON、和 PNG 长图（最多最近 2000 条），可选择默认目录或用原生文件夹选择器指定导出目录（macOS 调 osascript，Linux 调 zenity/kdialog，Windows 调 PowerShell FolderBrowserDialog），导出后自动调用 open / xdg-open / explorer.exe 打开所在目录（lib/index.js:892-958）。

能否从其它设备或旧版本迁移历史记录？

可以选 CSV 或 JSON 文件导入，按 time 字段去重合并；首次安装本插件时也会自动从 %USERPROFILE%\dsh-usage、.dsh/dsh-usage 以及旧工作区下的记录合并到新固定目录（lib/index.js:1068-1110 / 365-389）。

峰谷价格怎么生效？

自北京时间 2026-08-17 00:00 起按峰谷价（高峰 9:00-12:00 / 14:00-18:00、空闲其它时段）计算，之前仍按基础价；面板「价格表」Tab 可在线编辑并持久化到 pricing.json，点「恢复默认」一键还原（lib/index.js:80-82 / 985-1019）。

如何卸载？

推荐 dsh plugin --profile web remove @feiyang666/dsh-usage-plugin 一条命令；手工安装的请从 cordis.patch.yml 删掉 usage-plugin 行再 pnpm remove / npm uninstall。数据目录不会被卸载动作删除，可手动清理（README.zh.md:182-190）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明（依赖 @deepseek-ai/cordis ^4.0.1，请使用支持该 Cordis 版本的 DSH）
• Node: >=18
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则