Agent Client Protocol

在 Tylina 中连接 ACP AgentConnect an ACP Agent to Tylina

Tylina 会发现受支持的本机 Agent,也允许你配置任意兼容 ACP 的 stdio 可执行程序。只有你明确选择后,Tylina 才会启动 Agent。Tylina can discover supported local Agents and connect any compatible ACP stdio executable. Tylina never starts an Agent until you explicitly select it.

选择,而不是隐式启动Choose, don’t implicitly launch

  1. 打开 Agent 面板并选择“新建会话”。Open the Agent panel and choose New conversation.
  2. 从内置、本机发现或已配置的连接中明确选择一个 Agent。Explicitly select an included, detected, or configured Agent.
  3. 若没有合适选项,打开“设置 → Agent 与 AI”。If none is suitable, open Settings → Agent & AI.
“测试连接”只执行 ACP initialize 握手,不创建 session,也不发送 prompt。认证由所选 Agent 自己管理。Test connection performs only the ACP initialize handshake. It creates no session and sends no prompt. Authentication remains owned by the selected Agent.

配置自定义 ACP 连接Configure a custom ACP connection

填写显示名称、可执行文件,并把每个参数分别加入参数列表。不要粘贴一整条 shell command;Tylina 不通过 shell 解析命令。Enter a display name, the executable and each argument separately. Do not paste one shell command; Tylina does not parse connection commands through a shell.

可执行文件Executableopencode
参数 1Argument 1acp

若图形应用的 PATH 与终端不同,可填写可执行文件的绝对路径。保存后先使用“测试连接”。If the graphical app has a different PATH from your terminal, use the executable’s absolute path. Test the connection before starting a conversation.

常见启动方式Common launch vectors

Kimi Codekimiacp
OpenCodeopencodeacp
Claude Code adapterclaude-agent-acp无参数No arguments

更多实现与安装说明请查看For more implementations and installation instructions, see the ACP Agent RegistryACP Agent Registry.

错误、重新发送与重连Errors, resend, and reconnect

ACP 没有专用的 retry 或 regenerate 方法。若单轮 prompt 因暂时性错误失败,Tylina 会保留当前 session,并允许把最后一次请求作为新的 session/prompt 重新发送。ACP has no dedicated retry or regenerate method. If one prompt turn fails transiently, Tylina keeps the current session and can resend the last request as a new session/prompt.

只有 Agent 进程退出或连接中断时才需要“重连”。如果重试后仍失败,请检查 Agent 自己的认证、配额与日志。Reconnect is reserved for an Agent process exit or lost connection. If resending still fails, inspect the Agent’s authentication, quota, and logs.