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

快速上手

dsh-cost-meter

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-cost-meter

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

— 源: plugins.install

关键要点

• {{NEWAPI_API_KEY}} 从 DSH 凭据库或环境变量解析(仅请求头支持占位符,URL 需写死完整地址);
• 无限额度 token(unlimited_quota: true)没有 total_available,无法提取 remaining,查询会报「remaining is missing or not numeric」——请改用有限额度 token,或在中间层端点换算;
• 配置入口:设置 → 费用(额度标签)→「自定义 Provider 余额」展开配置;或直接改 storages/cost-meter/ledger.json 的 config.customBalance。
• 语言可选 简体中文 / English / 跟随浏览器(自动);
• 默认「跟随浏览器」:自动探测浏览器语言(zh* → 中文,其余 → 英文),并把探测结果写回配置,服务端消息(余额查询、价格同步等)与界面语言保持一致;

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

界面是中文还是英文？可以切换吗？

简体中文 / English / 跟随浏览器（自动）三种。默认跟随浏览器（zh* → 中文、其余 → 英文），探测结果不持久化。在 设置 → 费用 → 显示设置 → 界面语言 中切换，整套界面即时生效并自动保存；服务端返回的余额、价格同步提示同样按当前语言展示（README.md:48-55）。

安装后侧边栏没看到余额 / 显示异常怎么办？

余额依赖 DSH 模型设置里的 DeepSeek API Key；首次启动请在 设置 → 模型 配好 Key 或导出 DEEPSEEK_API_KEY。余额端点强制只发往官方域名 api.deepseek.com，baseURL 指向非官方域名时余额查询会被拒绝（不影响模型调用）。余额默认 5 分钟自动刷新，可在 设置 → 费用 → 余额 显示位置关闭（README.md:28 / lib/index.js:404-414）。

余额和 OpenCode Go 额度会自动消失 / 显示"未启用"？

Go 额度需 DSH 凭据库或环境变量 OPENCODE_GO_API_KEY，未配置会在设置页以中性提示告知，不会变红。打开 设置 → 费用 → OpenCode Go 面板后即可启用；未订阅可关闭"启用"开关。各家 Coding Plan 类似：在对应面板填 Key 或配置环境变量，关闭"启用"即停用（lib/index.js:285-302 / lib/coding-plans.js:21-52）。

如何把官方最新价同步进来？同步会覆盖我的自定义价格吗？

在 设置 → 费用 → 数据与同步 区域点 "从官方文档同步"，插件会抓取官方定价页解析后写入。只覆盖官方页面列出的同名模型条目，自定义模型条目不受影响；解析失败时同步会报错并保留原价格表，可手动编辑兜底（README.md:262-270 / lib/index.js:762-802）。

预算到 100% 会停止模型调用吗？

不会。预算与超支提示仅提醒，不阻止调用；≥80% 进度条变黄、≥100% 变红并在侧边栏底部预算图框显示超支徽章。需要硬性限制请自行在模型层处理（README.md:227）。

数据存哪里？怎么清除全部历史？

账本文件在 $DSH_HOME/storages/cost-meter/ledger.json，按 historyDays（默认 180 天）保留，每日最多 200 个会话明细；写入采用临时文件 + 原子重命名 + 2 秒防抖。清除：在 设置 → 费用 → 数据与同步 点 "清除全部历史"；也可手动删除 ledger.json（README.md:229-233 / lib/store.js:563-588）。

如何卸载？

卸载命令：dsh plugin --profile web remove dsh-cost-meter，重启 dsh web 即可。插件不引入额外后台进程、不改 host 文件；账本文件留在 $DSH_HOME/storages/cost-meter/ledger.json，需要时手动删除（README.md:202-205）。

安装 / 更新后页面没变化？

安装或更新插件后必须重启 dsh web，插件行、Typert 清单与客户端 bundle 均在启动时扫描；只刷新浏览器不会重新装载服务端插件（README.md:194-199）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.5
• Node: >=20
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则