ACP Agents

FylloCode 通过 Agent Client Protocol 接入不同 Coding Agent。设置中的 ACP Agents 页面位于 /settings/acp-agents，负责展示 registry 中可用的 Agent，并管理安装、更新和本地识别状态。

主要能力

• 查看支持 ACP 的 Agent 列表
• 搜索 Agent
• 安装和更新由 FylloCode 管理的 Agent
• 识别用户已经安装的 Agent
• 展示版本、许可证、作者和安装状态
• 按 FylloCode 语义标注 Agent 类型
• 配置不在 registry 中的自定义 Agent

页面提供「全部」「已安装」「自定义」三个筛选：前两者浏览 ACP Registry 中的 Agent，「自定义」是一个独立的 JSON 编辑区域。

Agent 类型

FylloCode 会把 ACP Agent 标注为三类：

类型	含义
native	原生 ACP agent，自带完整实现，无外部命令行工具依赖
adapter	独立适配层，自带完整实现，可与对应官方 CLI 共享配置或环境变量
bridge	桥接层，运行时通过本地命令行工具完成工作

详细判定标准见 ACP Agent 分类。

自定义 Agent

如果一个 Coding Agent 支持 ACP 但还没有进入 registry，可以在「自定义」tab 里手动登记，让它和 registry 里的 Agent 一样出现在 Agent 选择器中。

配置以 JSON 形式编辑，结构是一个 agent_servers 映射：

{
  "agent_servers": {
    "Kimi Code CLI": {
      "command": "~/.local/bin/kimi",
      "args": ["acp"],
      "env": {}
    }
  }
}

字段	说明
command	Agent 可执行文件路径，支持 ~ 展开和 PATH 查找（必填）
args	启动参数数组，例如 ["acp"]（可选）
env	额外环境变量，会合并到系统环境变量之上（可选）

保存后，配置写入本地的 custom-agents.json，不会同步到 registry，也不属于 FylloCode 管理安装/更新的范围——命令本身的安装和升级仍由用户自己维护。