插件
插件为 Agentty 带来什么、如何安装使用,以及其他应用如何通过链接把工作交给它。
插件把 Agentty 与其他应用连起来,并为终端增添工具。插件可以在终端旁放一个面板、在智能体窗格上方添加按钮、往命令面板里加条目,以及把文本作为提示词交给智能体——送到哪里始终由你来选。
想自己写一个?从插件快速开始开始。
插件页面#
从活动栏的拼图图标、视图 → 插件,或命令面板(⇧⌘P →“插件”)打开。
- 已安装 —— 你拥有的所有插件,以及它们添加了什么、能做什么。
- 可用 —— 随 Agentty 附带的插件。若其集成的应用已安装,会标记为推荐。
- 自己构建 —— 用 AI 创建插件,或从 Git 仓库、文件夹安装。
每个已安装的插件都有启用 / 禁用、打开面板、重启(改完代码后)、更新(内置版本有更新时)、日志(插件的输出,包括崩溃)、在访达中显示和卸载(按两次确认)。
插件在首次被使用时才启动,而不是随 Agentty 启动,因此闲置的插件不占用任何开销。
安装#
| 来源 | 方式 |
|---|---|
| 内置 | 在可用卡片上点安装 |
| Git 仓库 | 在自己构建下粘贴 https:// 地址 → 从 Git 安装 |
| 文件夹 | 从文件夹安装… 会复制到 ~/.agentty/plugins/ |
| 正在编辑的文件夹 | 链接开发文件夹… 直接在原地运行;卸载只会解除链接 |
你也可以自己把插件文件夹复制到 ~/.agentty/plugins/,然后点刷新。
安装前,卡片会列出该插件可以做的事:发送提示词、向终端输入、读取 AI 对话、查看工作区。插件以你的用户权限作为普通程序运行,因此只安装你信任的插件。机制说明见插件权限。
使用#
- 面板 —— 带面板的插件会在标签栏出现一个按钮。点击在终端旁打开面板,再点一次关闭。面板标题栏的 ↻ 会重启插件,齿轮打开插件页面。
- 终端上方的按钮 —— 插件命令可以出现在 Claude Code / Codex 窗格上方的状态栏和分屏窗格标题中,作用于该窗格。
- 命令面板 —— ⇧⌘P 的插件分组下列出所有插件命令。
“发送到…”对话框#
当插件或来自其他应用的链接发送提示词时,Agentty 会显示将要发送的内容并让你选择:
- Claude Code / Codex / 终端
- 新建工作区(可更改文件夹)、当前工作区的新标签页,或某个已打开的工作区——其中空闲的智能体会接收,否则会新开一个智能体标签页
- 立即发送,或取消勾选以便只输入文本而不按回车
终端永远只会被输入文本,Agentty 不会替你执行。在你点击发送之前什么都不会发出。
来自其他应用的链接#
其他应用可以通过 agentty:// 链接把工作交给 Agentty,例如 Cosmica 的“在 Agentty 中继续”。
| 链接 | 效果 |
|---|---|
agentty://plugin/<id>/<path>?key=value | 启动插件 <id> 并调用其 URL 处理器 |
agentty://prompt?text=…&title=…&agent=…&cwd=… | 用该文本打开发送到…(file= 可附带绝对路径的 .md / .txt) |
agentty://plugins/<id> | 打开插件页面并定位到该插件 |
若链接需要的内置插件尚未安装,Agentty 会提示安装并随后继续处理该链接。通过这种方式到达的提示词始终会经过发送到…。
链接在已安装的应用程序中生效。以开发方式启动的构建不会被操作系统注册为 agentty:// 的处理程序。
Cosmica#
Cosmica 是一款笔记应用。其插件随 Agentty 附带,若已安装 Cosmica 则标记为推荐。它只从 Cosmica 的设置中读取笔记文件夹和本地端口。
- 在 Cosmica 卡片上点插件 → 安装,然后从标签栏打开它的面板。
- 笔记 → 提示词 —— 搜索笔记,插入到当前聚焦的终端,或在你选择的位置继续。
- 从 Cosmica —— 右键点击笔记 → 在 Agentty 中继续。笔记会先保存,然后在 Agentty 中打开发送到…。
- 会话 → Cosmica —— 在聚焦 Claude Code 或 Codex 窗格时点保存 AI 摘要,智能体会把目标、所做的事、改动的文件、决策和下一步整理成摘要写入笔记的
Agentty/。保存对话记录则不询问 AI,直接保存原始对话。
正在忙的智能体不会被打扰,等这一轮结束后再试。Cosmica 运行时,笔记通过其本地 API 保存并立即建立索引;否则会写成文件,等 Cosmica 下次启动时纳入。
出问题时#
| 现象 | 处理 |
|---|---|
| “找不到 Node.js” | JavaScript 插件需要登录 shell 的 PATH 中有 Node.js 18 及以上 |
| 卡片显示插件因错误停止 | 打开卡片上的日志;改好代码后点重启 |
| 复制进来的插件没有出现 | 点刷新,并确认文件夹名与 agentty-plugin.json 中的 id 一致 |
| 链接点了没反应 | 请使用已安装的应用程序,并确认链接指定的插件已安装并启用 |
| 更新后行为异常 | 重启,或禁用并向作者反馈 |
文件位置#
| 路径 | 用途 |
|---|---|
~/.agentty/plugins/<id>/ | 插件本体 |
~/.agentty/plugins/state.json | 启用状态与开发链接指向 |
~/.agentty/plugin-data/<id>/ | 插件自己的设置与缓存 |
~/.agentty/plugins/.sdk/ | 开发者指南解压出的 SDK 与文档 |
~/.agentty/prompts/ | 以文件形式交给智能体的长提示词 |
卸载会移除插件,但其数据文件夹会保留到你自己删除为止。