运行时客户端和 ACP IDE 连接
运行时客户端和 ACP 适配器使用与正常接口相同的 Core、对话、代理和批准。 连接 IDE 不会授予任何服务器文件系统或终端访问权限,并且不会使其成为受信任的管理员。 使用原始用户的有效连接,而不是带有人形标识符的机器密钥。
准备连接
选择您的 Core 来源、现有工作区和可供您使用的代理。 软件客户端首先协商支持的协议版本。 通过使用兼容软件来解决版本拒绝问题,而不是通过使用发明的功能重试。
公共Go客户端提供client.NewRuntime、Negotiate、CreateSession、Prompt和Observe。 在第一次提交之前,将其 ClientMessageID 保存在重新启动后仍然存在的位置。 超时或重新启动后,呼叫 Observe 进行相同的对话和消息。 这会读取原始请求而不是创建另一代。 不要将标识符与不同的文本重复使用。
创建对话是一个单独的操作。 如果其确认丢失,请在创建另一个对话之前检查对话列表:自动创建重试可以添加第二个对话。
使用ACP
ACP 适配器通过标准输入和输出交换消息。 配置 -core、-workspace、-agent、-cwd 以及 AIHUMMER_RUNTIME_TOKEN 中的有效用户令牌。 将令牌保留在共享项目和日志之外。 -cwd 值标记 IDE 项目; 它不会在服务器上安装计算机的目录。
该适配器支持 ACP1 和文本输入。 它不接受客户端提供的 MCP 服务器、新文件系统或终端权限、图像或音频。 单独的 Core 工具仍然受到其现有配置权限的限制。
每个对话都允许一个活动提示。 两个独立的对话可以独立进行。 加载对话会显示持久的消息和原始身份,而无需重新提交未完成的工作。
批准、取消和断开连接
工具批准通过允许一次或拒绝选择到达用户。 丢失、过期或格式错误的回复并不意味着同意。 Core 仍然验证该决定。
显式取消只针对一个正在进行的原始输入。取消一个对话不得影响另一个对话。关闭连接本身不能证明操作已取消;收到取消请求的确认,也不能证明所有相关操作均已结束、相关进程均已退出。客户端会区分最终结果、已接受的后台工作以及结果尚不确定的外部操作。
部分输出和传输 EOF 不会取代持久的最终结果。 当结果未知时恢复原始状态而不是再次发送操作。 外部长时间运行操作 有自己的原始标识符读回。