ADD-ONS / 扩展插件

插件

让 Gerdr 长成你要的样子:侧栏放上额度和花费,按住说话还能免提听回复,Slack 里直接批 agent 的命令……商店里点一下就装,不用重启。想要的没有?跟 agent 说,它给你写一个,保存就生效。

在 Gerdr 的设置里,插件叫「扩展」。

这些文档,其实可以不看

帮我在这台电脑上装好 Gerdr(https://github.com/gerdr-dev/gerdr):看它 README 的安装说明,挑适合我系统的安装包下载、装好并打开。Claude Code 或 Codex 没装、没登录的话也帮我装上,登录那一步告诉我怎么做。

装好后直接问它:换成深色主题装上额度条插件给这个项目做一个周报面板
从商店装

设置 → 扩展 → 商店,点「安装」。默认商店是 gerdr-dev/gerdr-addon,任何 GitHub 仓库都能加成商店。

让 agent 装

直接说「把额度条装上」。agent 用 gerdr addon install usage-meter,改设置、开关、更新也一样。

让 agent 写一个

说清楚你想要什么,agent 写进 ~/.gerdr/addons/,保存即生效。见下面。

商店里有什么

点截图可以放大。

01

看住用量

额度、花费、缓存,不用再去别处查
额度条

侧栏底部一直显示 Claude Code / Codex 的额度:5 小时和本周用了多少,点开看全部额度和重置时间。

源码
今日

侧栏里显示今天 agent 跑完了几个任务、花了多少钱,点开看最近 7 天的柱状图;Gerdr Agent 的 token 按你设的价格表换算。

源码
缓存时钟

提示缓存快过期了:最新一轮的时间旁边出现黄色的「缓存 N 分钟后过期」,过期了变红;支持按订阅(60 分钟)或 API(5 分钟)自定缓存时长。

源码
02

用着更顺手

少打几个字、少切几次窗口
语音

按住 🎤(电脑上按住右 Option / 右 Alt)说话,边说边进输入框,支持豆包、硅基流动 / OpenAI 兼容识别与结合上下文纠错;点喇叭听回复(豆包、小米 MiMo、Azure、硅基流动等),长按开免提排队自动朗读。

源码
常用短语

输入框底栏一个 ⚡,一点就填「继续」「先提交一下」这类常说的话;右键还能把选中的文字引用到输入框。

源码
复制 tab

prefix+a / prefix+i 把当前 tab 复制到后面 / 前面:同一个目录、同一种 agent,开一个新会话。

源码
跑完了通知我

看不见的会话跑完了、或者在等你批准时,弹一条系统通知。

源码
会话标题:每 5 句重起

示例插件:自己定会话标题怎么起,每 5 句话重新概括一次,标题前带上 agent。

源码
03

换个样子

主题色

把强调色(用户气泡、按钮、链接、焦点框)换成你挑的颜色,深色主题自动调整。

源码
像素 Clawd

7 个像素小螃蟹素材:可以当运行中的动画(干活时走路、摆弄道具,等你确认时挥爪子),也能当角色头像或插件按钮图标。

源码
04

连上外面

不在电脑前,也能收到、能回
在聊天里审批

agent 等你审批或回答问题、你又不在电脑前时,私信发到你的 Slack、飞书……回一个数字,它就接着跑。

源码
Slack

发给你的 Slack bot 的私信和 @ 它的消息变成 Gerdr 事件,附件自动下载,回复以 bot 身份发出。适合当给 agent 下命令的入口。

源码
Slack 私聊(我的账号)

别人发给你本人的 Slack 私聊(及可选 @ 消息)变成事件,回复以你本人身份发出;不用建 app,用桌面端登录。

源码
GitLab MR

盯住你在等的 MR:评论、流水线、冲突、能不能合、合并了没有。agent 交了 MR 就用 gerdr wait 去等,有动静自动接着干。

源码
05

Mac

合盖不休眠

左边窄条上一个按钮,点一下 Mac 合上盖子也不睡,agent 照跑;图标可选(支持动态素材扩展),电量低自动放手,Gerdr 重启不断。

源码

自己写一个

最省事的写法是让 agent 写。在 Gerdr 里跟任何一个 agent 说你想要什么,比如:

写个插件:tab 名前面加上这个会话今天花了多少钱,超过 5 美元标红。

它知道插件怎么写(Gerdr 自带开发手册和完整的类型定义),写好放进 ~/.gerdr/addons/,界面马上就变了,不用装 node、不用打包、不用重启。不满意接着说。

插件能做的事

  • 画界面:侧栏、格子标题、输入框底栏的按钮、右键菜单、每轮下面那行时间。
  • 改名字:tab 名、格子标题、工作空间名、会话标题。
  • 命令和快捷键:加到命令面板,绑一个键。
  • 听事件、做动作:一轮跑完、等你回答、新会话、切焦点时做点什么,比如弹通知。
  • 设置项:声明一下,「设置 → 扩展」里自动出表单。
  • 主题色:覆盖 Gerdr 的颜色,关掉插件自动还原。
  • 后台进程:Gerdr 帮你起、挂了重启,比如一直连着 Slack、蓝牙手环。

想自己动手,一个插件就是一个文件夹:

~/.gerdr/addons/hello/
  addon.json    名字、版本、说明、图标、截图
  index.ts      代码
  README.md     商店里「说明」展开显示
export default defineAddon({
  setup(g) {
    g.paneTitle((pane, { label }) => "AI · " + label)
    g.command({
      id: "hello", title: "Say hello", key: "prefix+y",
      run: () => g.notify("hello"),
    })
  },
})

发布:把文件夹放进一个 GitHub 仓库,那个仓库就是一个商店,别人在商店页填 owner/repo 就能装。也欢迎直接给 gerdr-addon 提 PR。

完整的 API 和例子:插件开发手册(装了 Gerdr 的电脑上也有一份:~/.gerdr/addons/GUIDE.md)。

插件和面板的区别:插件改的是 Gerdr 本身(每个项目都生效);面板是某个项目里的一个小应用,有自己的页面和助手。面板见使用说明 · 自定义面板。

Render diagnostics