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

22 lines
4.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Windows桌面与本机连接
当前1.16复用1.15的桌面宿主、客户端及执行内核,并已通过完整源码/便携/安装和保留状态升级。手机伴随端默认关闭,需在「手机连接」显式配对;见[1.16验收](QA-1.16.md)和[手机连接说明](IPHONE-COMPANION.md)。1.15的原桌面验收保留在[QA-1.15](QA-1.15.md)。
安装版默认为当前Windows用户安装在`%LOCALAPPDATA%\Programs\AgentWorkbench`;用户数据默认在`%LOCALAPPDATA%\AgentWorkbench`,已有或自定义数据目录以`current.json`登记为准。安装目录含原生`AgentWorkbench.exe`入口、`current.json`和独立`versions`程序目录。新版本写入新目录,核对完整文件清单、原执行宿主和活动后才激活;失败回退当前指针和根入口。卸载先结束所属空闲宿主,用户数据保留。
双击安装目录的`AgentWorkbench.exe`打开桌面。便携包双击`Start-Desktop.cmd`;`Start-Workbench.cmd`仍可打开浏览器界面。源码包使用随包Node24/npm构建,具体命令见[源码开发](../README.md#源码开发);已有锁定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方案](PLAN-1.16.md)实施一次性配对、设备权限、HTTPS与断线恢复。390px窄屏通过仅说明布局兼容,手机`127.0.0.1`指手机本身。真实推理/Purge收益、其它引擎、语音/视觉与通用电脑操控各有独立开发和验收门槛。