dsh-llm-provider：DeepSeek Harness 的模型供应商与额度管理插件

它是做什么的？

它是 DeepSeek Harness（DSH）的 LLM 供应商插件，把 DSH 的模型接入层换成一套自维护的 pi-ai 桥接实现。它替换了插件树中的四个条目——pi-ai 适配器、原生 DeepSeek 适配器、模型选择器和官方模型设置页，并在其上叠加了额度查询与供应商管理。这样做的核心好处是：上游 pi-ai 发布新模型后不必等待 DSH 发版，插件自己维护的副本就能先跟上。由 imchangchang 维护，采用 MIT 协议，界面文案目前为中文。

核心功能

• pi-ai 版本跟随上游：DSH 在构建时锁定 LLM SDK，本插件运行自维护的副本，新模型无需等待 DSH 发版即可使用。
• 额度查询：按供应商查询余额与用量窗口，结果同时喂给供应商卡片和模型选择器里的额度指示器。
• 模型选择器：保留官方「模型 / 推理强度」两级结构，并增加供应商过滤、额度指示、能力徽章和模型详情卡。
• 供应商设置页：支持添加、删除、测试和刷新供应商，写入与官方页面相同的设置段和凭据存储。
• 更新前双重校验：新版本必须同时通过注册表 tarball 完整性校验与兼容性检查，才会被标记为待更新。

怎么使用这个插件？

在 DSH 中启用后，新安装会显示一张没有密钥的 DeepSeek 卡片，因为内置的原生适配器条目已被禁用，插件在自己的配置里声明了 DeepSeek 路由。展开「模型服务」→「服务商」中的卡片，在「API 密钥」一栏填入密钥并保存，插件会立即执行一次额度查询；接入其他供应商则点「＋ 添加供应商」，选择预设、填写密钥与端点、通过测试后保存。密钥通过 DSH 自带的凭据服务按路由的 apiKeyEnv 存储，与官方技术栈读取的是同一份凭据，无需额外的插件配置文件。供应商来自 settings.yaml 中的路由配置，没有路由时额度面板为空；pi-ai 更新会在插件启动时后台触发一次（限流 6 小时），也可用供应商页面的「检查更新」按钮手动触发。

报错怎么排查？

• 新装后看不到密钥输入框：说明该路由尚未存储凭据，展开供应商卡片后「API 密钥」一行会变成输入框，保存即可。
• 额度面板为空：通常是 settings.yaml 里没有对应路由，按官方说明从设置页添加供应商即可。
• 自维护的 pi-ai 未安装：源码中缺少该目录会被视为「未安装」而非「不兼容」，插件会回退到 DSH 自带的 pi-ai，界面不会报错。
• 更新未生效：新版本需先通过 tarball 完整性校验与兼容性检查，未通过时不会替换现有实现。