插件

插件为 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 对话、查看工作区。

关于 → 运行方式还会说明它属于截然不同的哪一种:

WebAssemblyAgentty 自己运行这个模块。它没有自己的文件、进程和网络,不管怎么写都只能碰到这些权限允许的东西。
程序(node、python、可执行文件)以你的身份运行,拥有和你启动的任何东西一样的访问权限。权限管的是它经由 Agentty 做的事,程序本身没人管。
Important

程序型插件,只在你信任作者时才安装。市场里的全是前一种,这正是从一份列表里安装二进制文件仍然可靠的原因。

完整的机制见插件权限。

插件市场#

插件 → 市场展示 Agentty-Marketplace 提供的列表。插件通过 pull request 添加,收录的只有源码公开的 WebAssembly 模块。Agentty 自己的插件也在那里,条件完全一样——应用里没有内置任何插件。

安装一个插件时:

  1. Agentty 通过 HTTPS 读取列表,并在这里重新检查每一条——id、文案、权限、模块来自哪个主机。没通过的条目会被排除在列表之外,而不是照样显示。
  2. 卡片会展示它是什么、源码在哪、许可证、模块大小和校验和,以及它能做什么。
  3. 按下安装后,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 会提示安装并随后继续处理该链接。通过这种方式到达的提示词始终会经过发送到…。

Note

链接在已安装的应用程序中生效。以开发方式启动的构建不会被操作系统注册为 agentty:// 的处理程序。

Cosmica#

Cosmica 是一款笔记应用。其插件随 Agentty 附带,若已安装 Cosmica 则标记为推荐。它只从 Cosmica 的设置中读取笔记文件夹和本地端口。

  1. 在 Cosmica 卡片上点插件 → 安装,然后从标签栏打开它的面板。
  2. 保存此会话(面板顶部)—— 在聚焦 Claude Code 或 Codex 窗格时点保存到 Cosmica,智能体会把目标、所做的事、改动的文件、决策和下一步整理成摘要,写入下方选中的文件夹。文件夹列表来自你的 Cosmica 笔记,默认选中 Agentty,首次保存时自动创建;+ 新建文件夹可以再建一个。仅对话记录则不询问 AI,直接保存原始对话。
  3. 从笔记继续 —— 点击笔记即可在新标签页中继续工作。Agentty 保存的摘要会在当初写它的文件夹、用当初的智能体重新打开;其他笔记使用当前聚焦窗格的文件夹和智能体。先只显示最近的几篇(其余点显示更多),搜索覆盖全部笔记。行上的按钮可插入到当前聚焦的终端,或用**在其他位置继续…**选择位置。
  4. 从 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/以文件形式交给智能体的长提示词

卸载会移除插件,但其数据文件夹会保留到你自己删除为止。

接下来#