Files
Agent-Workbench/docs/DESKTOP.md
2026-10-31 21:31:41 +08:00

4.1 KiB
Raw Permalink Blame History

Windows桌面与本机连接

当前1.16复用1.15的桌面宿主、客户端及执行内核,并已通过完整源码/便携/安装和保留状态升级。手机伴随端默认关闭,需在「手机连接」显式配对;见1.16验收和手机连接说明。1.15的原桌面验收保留在QA-1.15。

安装版默认为当前Windows用户安装在%LOCALAPPDATA%\Programs\AgentWorkbench;用户数据默认在%LOCALAPPDATA%\AgentWorkbench,已有或自定义数据目录以current.json登记为准。安装目录含原生AgentWorkbench.exe入口、current.json和独立versions程序目录。新版本写入新目录,核对完整文件清单、原执行宿主和活动后才激活;失败回退当前指针和根入口。卸载先结束所属空闲宿主,用户数据保留。

双击安装目录的AgentWorkbench.exe打开桌面。便携包双击Start-Desktop.cmd;Start-Workbench.cmd仍可打开浏览器界面。源码包使用随包Node24/npm构建,具体命令见源码开发;已有锁定npm缓存时可执行ci --offline --ignore-scripts,首次无缓存需要准备依赖。npm run desktop使用固定Electron运行目录。程序/data路径在首次自定义安装后按原登记复用,不能临时把另一份用户数据目录当原宿主。

普通关闭桌面窗口会退出该窗口,后台Node继续保留任务、模型连接和执行记录;重开核对实际用户、进程创建、安装输入、数据目录与签名挑战后复用所属宿主。同版本的其它目录也有独立身份,端口占用不自动当作本程序。需要结束执行时使用「退出执行宿主」,核对当前状态后等待所属工具、检查和原生引擎结束。已完成操作不会因重开窗口自动重放,未知结果仍需在原任务核对。

桌面提供原生项目目录选择、当前项目/文件定位和所属Task审查入口。文件入口核对已登记项目、实际路径和原SHA;不会把任意渲染页参数转为系统命令。六个固定preload方法运行在隔离窗口中,模型和客户端仍通过原Task/Run、文件审查与逐次命令审批执行。

本机已有DeepSeek Harness和Purge可从随包来源登记定位,安装到其它磁盘后仍核对实际版本与关键文件。查找依次使用明确填写的目录、专用环境设置、程序所在位置及已有登记;用户可以在引擎页填写当前绝对目录后重新检测。来源检测为只读操作,Purge提示实验默认关闭,登记内容不作为执行命令。

模型Key默认只存于执行宿主内存。新填写或本次确认导入时,可选「本机加密保存」:当前Windows用户的DPAPI密文与连接登记共同提交。临时连接在宿主重启后显示待配置;保存连接可关闭启动自动加载、删除本机保存,或单独清除内存。关闭连接调度与删除密文是不同操作,界面分别显示状态。旧内存连接不因安装升级自动持久化,公开配置/会话/报告无明文Key。

密文绑定当前用户、数据目录、连接及配置修订;来源变化、损坏或解密失败会显示不能加载并保留原保存块。不同Windows账号登录尚未实际验收,错误SID/entropy/损坏和自有凭据实际重启/HTTP认证已分别验证。不要手动复制密文到另一数据目录作为连接迁移。

运行中心巡检为只读操作,不发送模型请求或运行项目命令。报告核对实际宿主/来源、SQLite、磁盘、所属worker/driver/MCP、未知结果和工件范围。历史工件按原页/游标分段核对,最近50份正常不等于全部历史正常;报告保留本次检查数和未覆盖数。发现损坏或unknown后仍需按原Task/Run核对,巡检不会解除状态或重放工具。

真实手机接入按1.16方案实施一次性配对、设备权限、HTTPS与断线恢复。390px窄屏通过仅说明布局兼容,手机127.0.0.1指手机本身。真实推理/Purge收益、其它引擎、语音/视觉与通用电脑操控各有独立开发和验收门槛。