前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在 Web 端使用智谱 Coding Plan 时,频繁查看 Token 窗口、MCP 工具配额以及模型调用用量通常需要依赖外部监控面板或手动切换页面。dsh-zhipu-coding-plan 旨在解决这一割裂感,将智谱 Coding Plan 的关键指标直接嵌入 DSH Web 的对话视图面板中,让额度管理更加直观。
核心功能¶
该插件在 DSH Web 中提供以下维度的数据展示:
- Token 窗口:展示 5 小时 / 每周 Token 额度进度条与重置倒计时。当占用率达到一定阈值时,进度条会自动变色以示警示。
- MCP 工具额度:显示本月工具额度的已用总量、总量及剩余次数,并提供联网搜索、网页读取、Zread 等分项明细。
- 模型用量:查看近 24 小时 / 7 天内的模型调用次数和 Token 总量,以及按模型占比的统计排行。
- Key 页内配置:支持在面板内直接保存智谱 API Key,保存前会自动进行校验。
- 错误可读:对 Key 无效、限流、断网等错误进行分类提示。即使明细接口异常,主面板的额度展示也不会受到影响。
安装与启用¶
在终端中执行官方安装命令:
dsh plugin --profile web add dsh-zhipu-coding-plan
安装完成后,请重启 DSH Web。
重启后,界面选项卡中会出现「额度 / Quota」选项卡。它位于对话、轨迹和统计选项卡旁边,无需离开当前对话即可查看额度信息。
使用说明¶
- 保存 Key:首次打开额度面板时,可以在页面内直接保存智谱 API Key。
- Key 解析逻辑:插件会按照优先级解析 Key:启动环境变量
ZHIPU_API_KEY→ DSH 凭据存储 → 启动目录.env。 - 动态更新:插件每次查询都会重新解析 Key,因此更换 Key 无需重启 DSH Web。
注意事项¶
- 套餐限制:本插件仅支持智谱个人版套餐。若使用其他平台的 Key(如 DeepSeek),面板会明确提示为无效,不会误报数据。
- 隐私安全:Key 只保存在本机 DSH 凭据存储(
~/.dsh/.credentials.yaml)或环境变量中,面板界面中永不显示 Key 值。 - 数据来源:额度查询直连智谱官方监控接口(
open.bigmodel.cn),无第三方中转。 - 运行环境:需要 Node.js
^22.19.0或>=24.0.0。 - 数据精度:Token 窗口接口不返回绝对值,面板如实呈现接口返回的百分比。
生态背景¶
DSH 是 DeepSeek 官方维护的插件化框架,社区目录与 DeepSeek / 幻方无官方从属关系。本插件由社区维护,许可证为 MIT。
链接¶
- 插件目录:https://www.skillhub.cn/plugins/tsja2001/dsh-zhipu-coding-plan
- 源代码:https://github.com/tsja2001/dsh-zhipu-coding-plan