插件
插件为 Agentty 带来什么、从市场或自己的文件夹安装它们,以及在信任一个插件之前该看什么。
插件把 Agentty 与其他应用连起来,并为终端增添工具。插件可以在终端旁放一个面板、在智能体窗格上方添加按钮、往命令面板里加条目,以及把文本作为提示词交给智能体。这条提示词发往哪里,除非插件主动问你,否则由插件自己决定——所以卡片上的权限值得一读。
插件也是 Agentty 的发展方向:就像 FDE(前线部署工程师)为自己所在的现场打造东西一样,插件为每个团队、客户或场景打造合适的智能体,而 Agentty 在同一个一致的地方运行它们。参见简介。
想自己写一个?从插件快速开始开始。
智能体多样,环境唯一:FDE 方向#
FDE(Forward Deployed Engineer,前线部署工程师)走进工作真正发生的现场——客户的系统、账号和做事方式——在那里构建合适的智能体。这正是 Agentty 扩展的方向:用插件为不同环境、不同场景打造合适的智能体,而运行它们的环境统一在 Agentty 里。 无论构建多少种不同的智能体,它们都在同一个一致的环境中构建和运行。
| 用插件定制智能体 | 每个现场、每个团队、每种场景都有自己的智能体:要做的工作、面板、允许操作的网站,以及每一步交给哪个智能体和模型,都写进插件里(AgentOS 插件)。 |
| 统一在 Agentty 里运行 | 无论哪个智能体,都在同样的终端里,以同样的状态显示、同样的权限、同样的 发送到… 审批运行,不必为每个客户重新搭一套环境。 |
| 原样带到下一个现场 | 在一个环境里跑通的智能体,以插件的形式带到下一个环境,从文件夹或 Git 安装,就地调整,而不是从头再来。 |
插件页面#
从活动栏的拼图图标、视图 → 插件,或命令面板(⇧⌘P →“插件”)打开。
- 已安装 —— 你拥有的所有插件,以及它们添加了什么、能做什么。
- 市场 —— Agentty 提供的插件列表,包括它自己的。见下文。
- 可用 —— 随 Agentty 附带的插件。若其集成的应用已安装,会标记为推荐。
- 自己构建 —— 用 AI 创建插件,或从 Git 仓库、文件夹安装。
每个已安装的插件都有启用 / 禁用、打开面板、重启(改完代码后)、更新(内置版本有更新时)、日志(插件的输出,包括崩溃)、在访达中显示和卸载(按两次确认)。
插件在首次被使用时才启动,而不是随 Agentty 启动,因此闲置的插件不占用任何开销。
安装#
| 来源 | 方式 |
|---|---|
| 市场 | 在市场卡片上点安装 |
| 内置 | 在可用卡片上点安装 |
| Git 仓库 | 在自己构建下粘贴 https:// 地址 → 从 Git 安装 |
| 文件夹 | 从文件夹安装… 会复制到 ~/.agentty/plugins/ |
| 正在编辑的文件夹 | 链接开发文件夹… 直接在原地运行;卸载只会解除链接 |
你也可以自己把插件文件夹复制到 ~/.agentty/plugins/,然后点刷新。
你在信任什么#
安装前,卡片会在权限下用完整句子列出这个插件可以做的事:发送 HTTP 请求、启动智能体会话、向终端输入、读取 AI 对话、查看工作区。
关于 → 运行方式还会说明它属于截然不同的哪一种:
| WebAssembly | Agentty 自己运行这个模块。它没有自己的文件、进程和网络,不管怎么写都只能碰到这些权限允许的东西。 |
程序(node、python、可执行文件) | 以你的身份运行,拥有和你启动的任何东西一样的访问权限。权限管的是它经由 Agentty 做的事,程序本身没人管。 |
程序型插件,只在你信任作者时才安装。市场里的全是前一种,这正是从一份列表里安装二进制文件仍然可靠的原因。
完整的机制见插件权限。
插件市场#
插件 → 市场展示 Agentty-Marketplace 提供的列表。插件通过 pull request 添加,收录的只有源码公开的 WebAssembly 模块。Agentty 自己的插件也在那里,条件完全一样——应用里没有内置任何插件。
安装一个插件时:
- Agentty 通过 HTTPS 读取列表,并在这里重新检查每一条——id、文案、权限、模块来自哪个主机。没通过的条目会被排除在列表之外,而不是照样显示。
- 卡片会展示它是什么、源码在哪、许可证、模块大小和校验和,以及它能做什么。
- 按下安装后,Agentty 下载模块并与那个校验和比对。不一致之前,插件文件夹里不会进入任何东西。
条目里还写明了模块面向的插件协议版本。只懂旧版本的 Agentty 仍会把插件列出来,但会说需要更新 Agentty,而不是让你安装。
只给自己用的插件不必经过那份列表——从文件夹安装… 和从 Git 安装什么都收。
使用#
- 面板 —— 带面板的插件会出现一个按钮,位置由插件自己挑:终端上方的标签栏、左侧边缘的活动栏,或底部的状态栏。点击打开面板,再点一次关闭。面板标题栏的 ↻ 会重启插件,齿轮打开插件页面。
- 命令面板 —— ⇧⌘P 的插件分组下列出所有插件命令。
面板在哪里打开#
面板上的布局按钮可以改变它的打开方式,你的选择会被记住:
| 停靠 | 靠在终端旁边,终端让出位置 |
| 浮动 | 浮在窗口右侧边缘,其他东西不动 |
| 独立窗口 | 单独一个窗口,可移动、可调整大小 |
| 全屏 | 终端和页面所占的整个区域 |
停靠的面板不会大到把窗口其余部分挤扁:拖过可停靠的范围,它就变成浮动面板。
“发送到…”对话框#
当插件或来自其他应用的链接发送提示词时,Agentty 会显示将要发送的内容并让你选择:
- Claude Code / Codex / 终端
- 新建工作区(可更改文件夹)、当前工作区的新标签页,或某个已打开的工作区——其中空闲的智能体会接收,否则会新开一个智能体标签页
- 立即发送,或取消勾选以便只输入文本而不按回车
终端只会被输入文本——通过这条路发出的提示词不会替你按回车。在你点击发送之前什么都不会发出。
terminal.write 是另一回事:拿着这个权限的插件会往已打开的终端里输入并按下回车,在 shell 里也一样,那就是执行命令。它前面没有任何对话框,这也正是卡片把它单列出来的原因。
来自其他应用的链接#
其他应用可以通过 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 卡片上点插件 → 安装,然后从标签栏打开它的面板。
- 保存此会话(面板顶部)—— 在聚焦 Claude Code 或 Codex 窗格时点保存到 Cosmica,智能体会把目标、所做的事、改动的文件、决策和下一步整理成摘要,写入下方选中的文件夹。文件夹列表来自你的 Cosmica 笔记,默认选中
Agentty,首次保存时自动创建;+ 新建文件夹可以再建一个。仅对话记录则不询问 AI,直接保存原始对话。 - 从笔记继续 —— 点击笔记即可在新标签页中继续工作。Agentty 保存的摘要会在当初写它的文件夹、用当初的智能体重新打开;其他笔记使用当前聚焦窗格的文件夹和智能体。先只显示最近的几篇(其余点显示更多),搜索覆盖全部笔记。行上的按钮可插入到当前聚焦的终端,或用**在其他位置继续…**选择位置。
- 从 Cosmica —— 右键点击笔记 → 在 Agentty 中继续。笔记会以已输入的状态在新标签页中打开,阅读后按 Enter 开始。
仍在工作的智能体会把请求排队,这一轮结束后立即写摘要;正在等待你回答或批准的智能体不会被打扰。Cosmica 运行时,笔记通过其本地 API 保存并立即建立索引;否则会写成文件,等 Cosmica 下次启动时纳入。
出问题时#
| 现象 | 处理 |
|---|---|
| “找不到 Node.js” | JavaScript 插件需要登录 shell 的 PATH 中有 Node.js 18 及以上。WebAssembly 插件什么都不需要装 |
| 市场安装被拒绝 | 模块与列表里的校验和不一致。什么都没有写入,请告知插件作者 |
| 卡片提示需要更新 Agentty | 这个插件面向的插件协议版本是当前版本不认识的,请更新 Agentty |
| 卡片显示插件因错误停止 | 打开卡片上的日志;改好代码后点重启 |
| 复制进来的插件没有出现 | 点刷新,并确认文件夹名与 agentty-plugin.json 中的 id 一致 |
| 链接点了没反应 | 请使用已安装的应用程序,并确认链接指定的插件已安装并启用 |
| 更新后行为异常 | 重启,或禁用并向作者反馈 |
文件位置#
| 路径 | 用途 |
|---|---|
~/.agentty/plugins/<id>/ | 插件本体 |
~/.agentty/plugins/state.json | 启用状态与开发链接指向 |
~/.agentty/plugin-data/<id>/ | 插件自己的设置与缓存 |
~/.agentty/plugins/.sdk/ | 开发者指南解压出的 SDK 与文档 |
~/.agentty/prompts/ | 以文件形式交给智能体的长提示词 |
卸载会移除插件,但其数据文件夹会保留到你自己删除为止。
接下来#
- 插件快速开始 —— 几分钟写一个
- Rust 与 WebAssembly · Node.js SDK
- AgentOS 插件 —— 通过智能体推进工作的插件
- 清单参考 · 协议
- 权限 · 发布