Files
Agent-Workbench/docs/ENGINE-INTEGRATION.md
T

2.9 KiB

外部引擎连接与归属

1.9–1.13的连接核验与1.14受控工程执行分别保存。连接检测仅检查启动、协议、会话归属与停止;1.14另外固定原工具/模型内核和自有叠加插件,禁用原生工程/终端工具,通过所属独立工作区、自有Runtime/Provider及工具账本执行prompt、提案、审批、检查和父审查/Git。原SDK仍缺少单会话cancel与反向审批,停止以所属进程树及原结果核对实现。实际范围、原失败和发行状态见1.14验收及执行方案。

以下保留原连接核验契约,不把零prompt探针当成工程执行结果。

启动契约

登记实际CLI、SDK server/protocol、cmdline、profile、Cordis入口及安装锁的路径和SHA256,包版本与SDK线协议身份分别保存。独立DSH_HOME、DSH_AGENTS_HOME和探针工作目录不引用Desktop登录状态;传入筛选后的操作系统运行环境及明确的无凭据测试身份。模型端点为所属进程的本地拒绝服务,任何意外请求均使核验失败。

首次立即initialize曾超时;带Cordis观测入口和1500ms延后的原入口分别成功。独立绝对路径overlay通过原CLI的appReady.onReady写出含nonce/PID的完成标记,不改写第三方入口或Cordis原型;工作台收到实际标记后才发送一次initialize。具体内部等待环仍未知,固定延时不作为产品就绪依据。

每次检查独占一个进程、SDK session与探针目录,绑定工作台Session/Project/Task/Run。核对serverInfo、实际cwd、不存在会话的wait/resume错误、缺少cancel方法的原错误以及shutdown结果。未知session通知保留为未归属事件,idle不改写Task完成状态。SDK不使用MCP取消通知,停止关闭该检查的所属进程;重启不重放,不根据历史PID停止进程。

输入契约、原协议结果、请求SHA256、就绪信号、安装前后身份、进程关闭和探针文件字节分别封存为当前Task工件。失败记录保留;重复启动必须由用户明确选择。只读模型工具读取已封存的连接记录,不能发起引擎prompt或变更其权限。

界面与验收

使用现有paper #fcfdfc、surface #edf3f1、ink #1c2e32、teal #154b4a、line #dce7e2、utility-blue #4664d9。标题与正文沿用Segoe UI/Microsoft YaHei,协议身份使用Cascadia Code/Consolas。桌面左侧为本地引擎与能力范围,右侧为所属检查记录;390px依次阅读。标志性信息为真实的“安装身份 → 启动完成 → 协议返回 → 进程结束”,每一状态来自原记录,不作为装饰步骤。

只把当前引擎能核验的范围显示为已就绪;prompt、细粒度审批、工程写入、其他客户端与Purge收益不由连接通过推断。契约夹具、实际SDK探针、HTTP持久/恢复、桌面/390px交互和不可变发行分别保存证据。