插件

插件为 Agentty 带来什么、如何安装使用,以及其他应用如何通过链接把工作交给它。

插件把 Agentty 与其他应用连起来,并为终端增添工具。插件可以在终端旁放一个面板、在智能体窗格上方添加按钮、往命令面板里加条目,以及把文本作为提示词交给智能体——送到哪里始终由你来选。

想自己写一个?从插件快速开始开始。

插件页面#

从活动栏的拼图图标、视图 → 插件,或命令面板(⇧⌘P →“插件”)打开。

  • 已安装 —— 你拥有的所有插件,以及它们添加了什么、能做什么。
  • 可用 —— 随 Agentty 附带的插件。若其集成的应用已安装,会标记为推荐
  • 自己构建 —— 用 AI 创建插件,或从 Git 仓库、文件夹安装。

每个已安装的插件都有启用 / 禁用打开面板重启(改完代码后)、更新(内置版本有更新时)、日志(插件的输出,包括崩溃)、在访达中显示卸载(按两次确认)。

插件在首次被使用时才启动,而不是随 Agentty 启动,因此闲置的插件不占用任何开销。

安装#

来源方式
内置可用卡片上点安装
Git 仓库自己构建下粘贴 https:// 地址 → 从 Git 安装
文件夹从文件夹安装… 会复制到 ~/.agentty/plugins/
正在编辑的文件夹链接开发文件夹… 直接在原地运行;卸载只会解除链接

你也可以自己把插件文件夹复制到 ~/.agentty/plugins/,然后点刷新

Important

安装前,卡片会列出该插件可以做的事:发送提示词、向终端输入、读取 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 会提示安装并随后继续处理该链接。通过这种方式到达的提示词始终会经过发送到…

Note

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

Cosmica#

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

  1. 在 Cosmica 卡片上点插件 → 安装,然后从标签栏打开它的面板。
  2. 笔记 → 提示词 —— 搜索笔记,插入到当前聚焦的终端,或在你选择的位置继续。
  3. 从 Cosmica —— 右键点击笔记 → 在 Agentty 中继续。笔记会先保存,然后在 Agentty 中打开发送到…
  4. 会话 → 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/以文件形式交给智能体的长提示词

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

接下来#