夜雨聆风学习资料网

ARTICLE · 1398732

OpenCode 桌面端插件:查询 GLM Coding Plan 额度

OpenCode 桌面端插件:查询 GLM Coding Plan 额度

每次想看一眼 GLM 套餐用了多少,都得开浏览器、登控制台、翻半天菜单——用着用着就成了负担。现在把它做成 OpenCode 桌面端侧边栏里的一个页签,抬头就能看,省事太多。之前写过一篇《一段提示词做出 A 股行情插件》,这次照同样的打法再来一遍。

梳理需求

GLM Coding Plan 的额度是个黑盒。网页控制台要登录、要翻菜单,而真正干活的时候,你盯的是 OpenCode 的窗口。

于是需求很朴素:在桌面端右侧的侧边栏,多一个「GLM 额度」页签。点开能看到:套餐档位、5 小时窗口和周期额度的使用情况、是不是已经限额了、今天和最近 7 天 / 30 天到底用了多少 token、调了多少次、哪个模型吃掉的。

顺带两个入口:侧边栏「+」菜单能一键打开,标题栏常驻一个小徽标,悬停显示「GLM 已用 25%」。

整理提示词

还是那套打法——不写代码,只写需求。下面这段话可以直接抄:

# GLM 额度面板 · 复刻提示词帮我在 OpenCode 桌面端做一个 GLM 额度插件:1. 插件是一个 npm 包,导出 ./gui-experimental(先用本地目录加载),   server 半部只声明插件 id;2. 桌面端:会话右侧侧边栏(Panel, region: "side")挂「GLM 额度」页签,   内容用卡片分组;3. 内容分四块:   - 套餐额度:每个额度窗口一条进度条(5 小时 / 周 / 月),     明确标注「已用 x%」和「可用 x%」、重置倒计时;     已用 ≥80% 变黄、≥95% 变红、100% 打「已限额」标记;   - 今天:当日累计 token、调用次数、逐小时趋势图;   - 最近 7 天 / 最近 30 天:同样三样,另加按模型分解;   - 趋势图要有坐标轴刻度:纵轴峰值/中值/0,横轴日期或小时,     刻度不能被柱子盖住;4. 数据链路:插件 main 进程(Plugin.define 的 main)直接请求   open.bigmodel.cn 的 /api/monitor/usage/quota/limit 和   /api/monitor/usage/model-usage;Key 从 auth.json 的   zhipuai-coding-plan 读,options 和环境变量可覆盖;   窗口通过 Ipc 取数,90 秒节流、5 分钟自动刷新;5. 入口:侧边栏「+」菜单启动项 + 标题栏徽标(悬停显示已用百分比,   点击打开面板);6. 中文优先(i18n 中英双语,跟随系统语言),请求失败只提示不崩,   代码按文件说明职责,方便验收。写之前先读:- https://opencode.ai/docs/plugins/- https://opencode.ai/docs/build/plugins/gui

为什么这么写?几处关键:

  • 位置点名到具体。 桌面端的挂载点写清楚是 Panel, region: "side",这是官方 GUI 插件 SDK 里的侧边栏页签;不确定点位名,说「会话右侧侧边栏」它也找得对。

  • 语义写明白。 进度条旁边到底写「已用」还是「可用」,差一个词就是两种含义——这类歧义不写清楚,出来的东西一定被返工。

  • 刻度是验收项。 「纵轴峰值/中值/0、不能被柱子盖住」——不写这句,八成给你一根没有刻度的光秃秃的柱子,量级全靠猜。

  • 数据链路指定进程。 桌面端渲染进程是沙箱环境,跨域请求会被拦;把请求收口到 main 进程(Node 环境、无 CORS),再用 Ipc 喂给窗口,是这套 SDK 的正路。

效果实拍

标题栏徽标常驻,悬停显示百分比,点击直达面板;侧边栏「+」菜单里也有一个启动项。

侧边栏多出「GLM 额度」页签,四张卡从上到下:套餐额度、今天、最近 7 天、最近 30 天。

今天的趋势图按 24 小时铺开,凌晨只有一个桶,就只占全天的 1/24——不会出现「一根柱子撑满全图」的错觉。纵轴刻度独立在左侧栏位,柱子再高也不会盖住数字。

插件原理

一条分工原则:窗口只负责画,主进程只负责拿数。

  • server 半部只有一个作用:声明插件 id,让桌面端认领这份 GUI;
  • main 进程(Plugin.define 的 main)读 auth.json 里的智谱 Key,请求 bigmodel 的两个接口,做 90 秒节流缓存;
  • 窗口(setup)注册 Panel、菜单项、标题栏徽标,通过 Ipc 契约向 main 要数据,5 分钟自动刷新;
  • options 把 apiKey、baseUrl、organization、project、planType 拎出来——新版积分制套餐要补组织/项目上下文,改配置就行,不用动代码。

界面和数据的耦合被砍断了:想换数据源,只改 main 那一个文件;想换样式,窗口部分随便改。

一张图看完链路:

注意事项

插件会跟着你每次开界面跑。界面这块值得专门让 agent 按清单过一遍——下面这段是「页面优化」的提示词,可以直接用:

优化一下这个额度面板的界面,别改功能:1. 视觉层次:卡片间距、圆角、分隔线是否统一?标题/数值/辅助文字   三档字号拉开;颜色全部用宿主主题变量(--v2-*),亮色和暗色   模式各看一遍;2. 图表:纵轴保留峰值/中值/0 三档刻度,刻度不能压在柱子上;   横轴刻度在窄面板下收敛到 3~4 个,别挤成一排;悬停给出具体数值;3. 窄宽度:把侧栏拖到最窄,检查卡片、图表、模型行有没有溢出或   换行错位;所有数字用等宽字体(tabular-nums)右对齐;4. 状态齐全:加载中、无数据、请求失败、没配 Key 四种状态各截一张,   都要有明确文案和降级提示,不能白屏;5. 语义准确:进度条旁边只写「已用 x%」,不要裸数字;已限额要有   醒目标记;重置时间用倒计时而不是具体时间戳;6. 交互细节:刷新按钮点下去有 loading 态;自动刷新的定时器在插件   卸载/重载时清理干净;Ipc 异常不影响面板本身。先列问题清单,再逐项改,改完给我改前改后的截图。

另外四件事记一下:

  • 版本:GUI 插件 SDK 标着 experimental,接口随桌面端版本变;这个插件对着 2.3.2 写的,升级桌面端后先跑一遍验收。
  • 接口:bigmodel 的用量接口没有公开文档承诺,结构变了插件只能跟着调;失败提示做了兜底,但数据口径以官网控制台为准。
  • Key:插件只读本机 auth.json,不联想、不上传;面板里也永远不显示 Key 本身。
  • 范围:只支持智谱官方的 GLM Coding Plan 套餐(个人版 / 团队版)。第三方中转、兼容层或非官方计费渠道没有对应的用量接口,装了只会提示请求失败。

总结

这个插件的主要过程是:描述需求、让 OpenCode 实现,再根据截图和数据逐项验收。额度查询只是一个具体例子,关键是把数据来源、界面状态和验收条件写清楚。


最近文章:

用 WorkBuddy 整理考勤:统计之外,怎么找出漏打卡?

WorkBuddy 介绍:套餐、积分与办公能力

OpenCode Browse 教程:自动整理A股行情数据

OpenCode Browse 实现原理:让 AI 操作你的真实浏览器


关注我,阅读更多内容

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料