前言¶
在 DeepSeek Harness（DSH）里接入 Z.AI 作为模型提供方后，Coding Plan 的用量和剩余配额通常要另开页面或查控制台。开发或调试智能体时，如果只想确认「当前 key 还能用多少」，多切一层界面会打断节奏。
dsh-zai-usage 是社区维护的 DSH 客户端插件，把 Z.AI coding-plan 配额面板挂进 Harness 侧栏，与你在 Harness 里配置 Z.AI 时使用的同一套凭证解析路径对齐，无需为插件单独写配置项。
这是什么¶
- 仓库： bosenok/dsh-zai-usage
- 维护者：bosenok
- 分类：客户端（
dsh.client.platform: web，前端由lib/client.js提供） - 定位：Z.AI coding-plan quota panel in the DSH sidebar（README 原文）
插件以 DSH bundle 形式打包：package.json 声明 dsh.bundle.patch，cordis.patch.yml 向当前 profile 插入 zai-usage 行。宿主侧通过 Harness 凭证服务解析 key；浏览器端只渲染配额快照，不接触密钥明文。
运行环境（来自 package.json）：dsh 版本需满足 >=0.2.1-rc.2 <0.3.0。
核心功能¶
下面介绍插件在资料中明确描述的能力。
- 侧栏配额面板：在 DSH 侧栏展示 Z.AI coding-plan 配额相关视图（具体图表与字段由客户端实现；构建链使用 Vue 3 与 ECharts，见仓库
devDependencies）。 - 凭证与 Z.AI 提供方共用：宿主声明
inject: ['credentials']，通过ctx.credentials.resolve('ZAI_API_KEY')解析，与 Z.AI provider 使用的 canonical seam 一致；无插件专属配置字段。 - 本地快照与排错：配额快照写入
~/.dsh/usage/zai-usage.json；未配置 key 时面板提示ZAI_API_KEY is not set in the credential store，且快照中的debug可反映解析状态（例如{"credsService":"ok","resolve":"value(49) source=file"}）。
安装与启用¶
插件以社区目录条目 skillhub.cn/plugins/bosenok/dsh-zai-usage 为索引；安装命令以 GitHub README 为准。
桌面应用：打开 Plugins，安装 github:bosenok/dsh-zai-usage（若仓库为 private，需先让本机具备 git 访问权限），再启用 bundle。
CLI（指定 profile）：
dsh plugin --profile <profile> add github:bosenok/dsh-zai-usage
本地目录：
dsh plugin --profile <profile> add file:/path/to/dsh-zai-usage
启用 bundle 后插件挂载到 Harness；热更新（HMR）可作用于运行中的应用，重启可确保客户端半部重新构建。
desktop profile 注意：README 说明，应用托管的 desktop profile 下，dsh plugin --profile desktop add 仅安装依赖并复制包，不会像普通 profile 那样自动启用 bundle。需在 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 中加入包名，或在 Plugins 页面启用。
密钥从哪里来¶
无需为 dsh-zai-usage 单独填写 API key。解析顺序与 Harness 凭证服务一致，常见来源包括：
- 配置 Z.AI provider 时写入的凭证存储（
~/.dsh/.credentials.yaml→refs） - 环境层：
~/.dsh/.env、继承的环境变量、项目根目录.env
缺失 key 时侧栏显示上述英文提示；可结合 ~/.dsh/usage/zai-usage.json 中的 debug 判断 credsService 与 resolve 状态。
典型用法¶
- 在 Harness 中按既有流程配置 Z.AI 提供方，确保
ZAI_API_KEY可被凭证服务解析。 - 按上一节命令安装并启用
dsh-zai-usagebundle。 - 打开 DSH 侧栏中的配额面板，查看当前 coding-plan 配额快照；若异常，先核对凭证与环境变量，再查看
zai-usage.json的debug字段。
仓库未提供额外 CLI 子命令；交互入口在桌面/ Web 客户端侧栏。
适用场景与注意¶
适合：已在 DSH 中使用 Z.AI Coding Plan，希望在同一界面内快速查看配额、减少跳转控制台的开发者。
权限与安全：插件在当前 dsh 进程权限下运行，可访问凭证服务与本地 ~/.dsh 下的用法快照；安装前建议阅读 源码 与 MIT 许可证。第三方打包代码见 THIRD_PARTY_NOTICES.md。
社区插件目录（SkillHub）与 DeepSeek / 幻方无官方从属关系，不等同于官方应用商店。
结尾¶
dsh-zai-usage 把 Z.AI coding-plan 配额收进 DSH 侧栏，并与 Z.AI 提供方共用 ZAI_API_KEY 解析路径。需要安装说明与实现细节时，可查阅目录页 https://www.skillhub.cn/plugins/bosenok/dsh-zai-usage 与 GitHub 仓库 https://github.com/bosenok/dsh-zai-usage。
