# 插件 · Gerdr

> Gerdr 插件：额度条、今日花费、语音对话与朗读、常用短语、主题色、Slack / GitLab 接入、合盖不休眠……在商店里一键装；想要别的，让 agent 给你写一个，保存就生效。

ADD-ONS / 扩展插件

# 插件

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

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

这些文档，其实可以不看

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

复制这段话

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

从商店装

设置 → 扩展 → 商店，点「安装」。默认商店是 [gerdr-dev/gerdr-addon](https://github.com/gerdr-dev/gerdr-addon)，任何 GitHub 仓库都能加成商店。

让 agent 装

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

让 agent 写一个

说清楚你想要什么，agent 写进 `~/.gerdr/addons/`，保存即生效。见 [下面](#write)。

## 商店里有什么

点截图可以放大。

01

### 看住用量

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

![额度条](https://fsu.creght.com/site/2117042939526909952/1794577444562__usage_meter_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577443980__usage_meter_icon.svg)额度条

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

`gerdr addon install usage-meter` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/usage-meter)

![今日](https://fsu.creght.com/site/2117042939526909952/1794577442763__today_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577442195__today_icon.svg)今日

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

`gerdr addon install today` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/today)

![缓存时钟](https://fsu.creght.com/site/2117042939526909952/1794577432441__cache_clock_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577431737__cache_clock_icon.svg)缓存时钟

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

`gerdr addon install cache-clock` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/cache-clock)

02

### 用着更顺手

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

![](https://fsu.creght.com/site/2117042939526909952/1795317880716__voice_icon.svg)语音

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

`gerdr addon install voice` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/voice)

![常用短语](https://fsu.creght.com/site/2117042939526909952/1794577438022__quick_phrases_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577437357__quick_phrases_icon.svg)常用短语

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

`gerdr addon install quick-phrases` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/quick-phrases)

![复制 tab](https://fsu.creght.com/site/2117042939526909952/1794577434244__duplicate_tab_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577433600__duplicate_tab_icon.svg)复制 tab

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

`gerdr addon install duplicate-tab` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/duplicate-tab)

![](https://fsu.creght.com/site/2117042939526909952/1794577436789__notify_when_done_icon.svg)跑完了通知我

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

`gerdr addon install notify-when-done` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/notify-when-done)

![](https://fsu.creght.com/site/2117042939526909952/1794577439207__session_title_icon.svg)会话标题：每 5 句重起

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

`gerdr addon install session-title` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/session-title)

03

### 换个样子

![主题色](https://fsu.creght.com/site/2117042939526909952/1794577441436__theme_color_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577440858__theme_color_icon.svg)主题色

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

`gerdr addon install theme-color` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/theme-color)

![像素 Clawd](https://fsu.creght.com/site/2117042939526909952/1795317881413__clawd_loader_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577433001__clawd_loader_icon.svg)像素 Clawd

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

`gerdr addon install clawd-loader` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/clawd-loader)

04

### 连上外面

不在电脑前，也能收到、能回

![](https://fsu.creght.com/site/2117042939526909952/1794577438599__remote_answer_icon.svg)在聊天里审批

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

`gerdr addon install remote-answer` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/remote-answer)

![](https://fsu.creght.com/site/2117042939526909952/1794577439876__slack_me_icon.svg)Slack

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

`gerdr addon install slack` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/slack)

![](https://fsu.creght.com/site/2117042939526909952/1794577439876__slack_me_icon.svg)Slack 私聊（我的账号）

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

`gerdr addon install slack-me` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/slack-me)

![](https://fsu.creght.com/site/2117042939526909952/1794577434922__gitlab_icon.svg)GitLab MR

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

`gerdr addon install gitlab` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/gitlab)

05

### Mac

![合盖不休眠](https://fsu.creght.com/site/2117042939526909952/1794577436061__lid_awake_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577435494__lid_awake_icon.svg)合盖不休眠

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

`gerdr addon install lid-awake` [源码](https://github.com/gerdr-dev/gerdr-addon/tree/main/lid-awake)

## 自己写一个

**最省事的写法是让 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](https://github.com/gerdr-dev/gerdr-addon) 提 PR。

完整的 API 和例子： [插件开发手册](https://github.com/gerdr-dev/gerdr/blob/main/internal/addons/builtin/GUIDE.md)（装了 Gerdr 的电脑上也有一份： `~/.gerdr/addons/GUIDE.md`）。

插件和面板的区别：插件改的是 Gerdr 本身（每个项目都生效）；面板是某个项目里的一个小应用，有自己的页面和助手。面板见 [使用说明 · 自定义面板](/zh/docs.md#panels)。

> 全站页面清单：[/llms.txt](/llms.txt)
