前言¶
在 DeepSeek Harness（DSH）里配置多个 Provider 之后，有几个问题会反复出现：Provider 当前是否可用，往往要等一次请求失败才知道；账户余额或套餐配额需要另开控制台页面查看；本地一段时间内 token 消耗了多少、都花在哪些模型上，缺少一个统一的视图。
dsh-llm-guardian 针对的就是这几件事。它把健康检查、配额控制、用量查询和本地统计集中到 DSH 的设置页，同时不在插件设置中保存 API 密钥。下面介绍它能做什么、怎么安装、用的时候要注意什么。
这是什么¶
dsh-llm-guardian 是 ice-kele 维护的 DeepSeek Harness 社区插件，许可证为 MIT。一句话定位：为 DSH 提供 Provider 健康状况、配额、账户用量与本地模型用量统计。
DSH 的理念是「一切皆插件」，这个项目就按普通可组合插件的方式实现，不使用 Electron 专属 API。作者也希望它未来能进入插件市场，并通过仓库的 dsh-plugin topic 保持生态发现的机器可读性。
核心功能¶
以下能力均来自 README 与 package.json，按用途分成四块。
Provider 健康检查与本地配额¶
- 支持周期性和按需的 Provider 健康检查；健康检查调用所配置 Provider 的模型发现端点。
- 本地 token 计数，达到配置的配额后可选阻止请求。
按 Provider 的用量查询¶
- 按 Provider 范围的账户或套餐用量查询，带显式的超时与刷新控制。
- 内置两个查询适配器：DeepSeek 余额查询和 Z.AI Coding Plan 配额查询。
本地用量仪表盘¶
- 可选的本地用量仪表盘，支持 7/30/90 天视图、汇总指标、活动热力图、响应式每日 token 图表和模型占比，图表悬停可查看详细数值。
- 支持按模型过滤，统计基于 DSH 会话日志本地计算，插件不会上传。
设置页集成与安全约束¶
- 为每个已配置的 Provider 卡片（Settings → Models）添加健康测试操作、模型用量操作和紧凑状态摘要。
- 对自定义用量查询提供密钥脱敏、响应大小限制和同源限制。
安装与启用¶
安装命令：
dsh plugin add github:ice-kele/dsh-llm-guardian
安装后重启 DeepSeek Harness 或 DSH Desktop，Provider 控件会出现在 Settings → Models 下。
环境要求：package.json 要求 Node >= 22.19.0；对 @deepseek-ai/dsh-* 系列（0.1.1-rc.2）的 peer 依赖均标记为 optional。
兼容性说明：插件优先使用 settings.models.provider.action 与 settings.models.provider.summary 两个类型化插槽；对尚未暴露这些插槽的当前 DSH 版本，内置了 DOM 兼容适配器。上游插槽补丁单独跟踪，扩展点可用后即可移除该适配器。
典型用法¶
安装并重启之后，可以先做这几件事：
1、打开 Settings → Models，在每个已配置的 Provider 卡片上执行健康测试，查看模型用量和紧凑状态摘要。
2、需要查余额或配额时，使用内置适配器查询 DeepSeek 余额或 Z.AI Coding Plan 配额，超时与刷新均为显式控制。
3、打开本地用量仪表盘，切换 7/30/90 天视图，按模型过滤，查看汇总指标、活动热力图、每日 token 趋势和模型占比。
4、配置本地配额后，token 计数达到阈值时可让插件阻止后续请求。
想参与开发的话，流程是先 npm install，再做 npm run check，最后 npm pack --dry-run：
npm install
npm run check
npm pack --dry-run
隐私与网络行为¶
这一部分值得单独列出，方便安装前评估：
- API 密钥通过 DSH 凭据服务解析，插件不会在插件设置中持久化 API 密钥。
- 健康检查调用所配置 Provider 的模型发现端点。
- 用量查询仅限 Provider 同源的 HTTPS 端点；本地 Provider 允许回环（loopback）HTTP。
- 本地计数器与查询结果存储在
llm-guardian设置命名空间。 - 仪表盘统计由 DSH 会话日志本地计算，插件不会上传。
适用场景与注意¶
适合的场景：同时配置多个 Provider、需要定期确认可用性的用户；想在不离开 DSH 的前提下查询 DeepSeek 余额或 Z.AI Coding Plan 配额的用户；以及想在本地统计 token 用量、不希望数据离开本机的用户。
注意事项：
1、插件以当前 dsh 进程的权限运行。安装前建议先检查仓库源码与许可证（MIT），确认可接受再安装。
2、用量查询有同源限制，仅访问 Provider 同源的 HTTPS 端点，仅本地 Provider 例外允许回环 HTTP。
3、当前部分 DSH 版本尚未暴露 settings.models.provider.action 与 settings.models.provider.summary 插槽，插件此时依赖 DOM 兼容适配器工作；待上游插槽合入后，这一点会随之改善。
经过上面的步骤，健康检查、配额控制和用量统计就可以在 DSH 内完成闭环。
结尾¶
dsh-llm-guardian 的价值在于把原本分散的信息——Provider 健康状况、账户或套餐用量、本地 token 统计——收进 DSH 的设置页，同时密钥不经插件持久化、统计数据不出本机。仓库地址：https://github.com/ice-kele/dsh-llm-guardian。
