docs(desktop): freeze repaired inputs and clarify bundled source launch

This commit is contained in:
Agent Workbench Dev
2026-10-31 12:56:52 +08:00
parent d005344bdc
commit c93515ce0c
4 changed files with 2090 additions and 5 deletions
+13 -1
View File
@@ -97,7 +97,19 @@ Windows 终端使用 PowerShell 5.1,通过 UTF-8 stdin 传入经确认的完
## 源码开发
使用 Node.js 24;依赖版本由 `package-lock.json` 固定。 1.15源码包已包含固定Electron和Node运行依赖,离线安装用`npm.cmd ci --offline --ignore-scripts`,构建后`npm.cmd run desktop`;源码仓库首次开发需先取得固定Electron 45.2.0发行运行文件。
使用 Node.js 24;依赖版本由 `package-lock.json` 固定。1.15源码包包含固定Electron、Node及npm运行文件。解压后的Windows源码包可直接使用随包运行器,并用独立端口和数据目录启动开发窗口:
```powershell
$awbSourceRuntime = Join-Path ((Get-Location).Path) 'runtime'
$awbSourceNode = Join-Path $awbSourceRuntime 'node.exe'
$awbSourceNpm = Join-Path $awbSourceRuntime 'node_modules\npm\bin\npm-cli.js'
$env:Path = $awbSourceRuntime + [IO.Path]::PathSeparator + $env:Path
& $awbSourceNode $awbSourceNpm ci --ignore-scripts
& $awbSourceNode $awbSourceNpm run build
& $awbSourceNode $awbSourceNpm run desktop -- -Port 4319 -DataRoot .qa\desktop-data
```
已有锁定依赖下载缓存时,`ci`可加`--offline`;本轮独立源码离线回归使用本机已有npm缓存。首次无缓存需要联网准备锁定依赖。源码仓库首次开发需先取得固定Electron 45.2.0发行运行文件,再使用已核对的Node24:
```powershell
npm.cmd ci --ignore-scripts
+2 -2
View File
@@ -2,9 +2,9 @@
1.15复用现有工作台客户端和执行内核。A–E实际验收通过,最终发行/正式部署状态以[QA-1.15](QA-1.15.md)为准。
安装版默认为当前Windows用户安装在`%LOCALAPPDATA%\Programs\AgentWorkbench`;用户数据在`%LOCALAPPDATA%\AgentWorkbench`。安装目录含原生`AgentWorkbench.exe`入口、`current.json`和独立`versions`程序目录。新版本写入新目录,核对完整文件清单、原执行宿主和活动后才激活;失败回退当前指针和根入口。卸载先结束所属空闲宿主,用户数据保留。
安装版默认为当前Windows用户安装在`%LOCALAPPDATA%\Programs\AgentWorkbench`;用户数据默认在`%LOCALAPPDATA%\AgentWorkbench`,已有或自定义数据目录以`current.json`登记为准。安装目录含原生`AgentWorkbench.exe`入口、`current.json`和独立`versions`程序目录。新版本写入新目录,核对完整文件清单、原执行宿主和活动后才激活;失败回退当前指针和根入口。卸载先结束所属空闲宿主,用户数据保留。
双击安装目录的`AgentWorkbench.exe`打开桌面。便携包双击`Start-Desktop.cmd`;`Start-Workbench.cmd`仍可打开浏览器界面。源码包使用随包Node24、`npm ci --offline --ignore-scripts`和`npm run build`后,`npm run desktop`使用固定Electron运行目录。程序/data路径在首次自定义安装后按原登记复用,不能临时把另一份用户数据目录当原宿主。
双击安装目录的`AgentWorkbench.exe`打开桌面。便携包双击`Start-Desktop.cmd`;`Start-Workbench.cmd`仍可打开浏览器界面。源码包使用随包Node24/npm构建,具体命令见[源码开发](../README.md#源码开发);已有锁定npm缓存时可执行`ci --offline --ignore-scripts`,首次无缓存需要准备依赖。`npm run desktop`使用固定Electron运行目录。程序/data路径在首次自定义安装后按原登记复用,不能临时把另一份用户数据目录当原宿主。
普通关闭桌面窗口会退出该窗口,后台Node继续保留任务、模型连接和执行记录;重开核对实际用户、进程创建、安装输入、数据目录与签名挑战后复用所属宿主。同版本的其它目录也有独立身份,端口占用不自动当作本程序。需要结束执行时使用「退出执行宿主」,核对当前状态后等待所属工具、检查和原生引擎结束。已完成操作不会因重开窗口自动重放,未知结果仍需在原任务核对。
+2 -2
View File
@@ -28,11 +28,11 @@
## 模块落点
已实现src/desktop/main.mjs、preload.mjs、host-cli.mjs及宿主身份/窗口登记、本机加密连接;安装管理器、原生启动器和发行脚本已接入,分别以A–F实际验收结果判定交付。宿主复用src/server/runtime.mjs、store.mjs、provider.mjs及src/core的执行管理器。加密存储作为ModelHub/ConfigImporter的宿主适配层,连接选择、池租约和请求账本不换成另一套协议。
已实现src/desktop/main.mjs、preload.cjs及桌面宿主CLI、身份/窗口登记和本机加密连接;安装管理器、原生启动器和发行脚本已接入,分别以A–F实际验收结果判定交付。宿主复用src/server/runtime.mjs、store.mjs、provider.mjs及src/core的执行管理器。加密存储作为ModelHub/ConfigImporter的宿主适配层,连接选择、池租约和请求账本不换成另一套协议。
Start-Workbench.ps1已改为核对所属数据目录、实例、签名挑战和实际创建身份后复用端口。普通窗口关闭不会调用现有/api/shutdown;明确退出执行宿主才按当前活动/未知状态完成停止。默认运行仍使用本机loopback,手机网关在后续独立阶段开放。
现/api/operations只读巡检核对宿主、SQLite quick_check、最近50个工件和连接配置,不能把这项范围写成全库/全引擎巡检。桌面阶段同步补所属worker/原生driver/MCP及未知结果、来源、磁盘余量和分页旧工件核对,报告本次实际检查数量和未覆盖范围;读巡检不启动模型、项目命令或自动修复。
起点1.14的/api/operations只读巡检核对宿主、SQLite quick_check、最近50个工件和连接配置。D已补所属worker/原生driver/MCP及未知结果、来源、磁盘余量和分页旧工件核对,报告本次实际检查数量和未覆盖范围;最近一页正常仍不能当全部历史通过。只读巡检不启动模型、项目命令或自动修复。
## 外部能力与后续顺序
File diff suppressed because it is too large Load Diff