Files
Agent-Workbench/README.md

163 lines
27 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.
# Orven · AI 开发工作台
**从想法,到运行。** 正式产品品牌为 **Orven(奥文,OR-ven)**。新版围绕项目任务、连续对话和按需展开的成果区重新组织 UI/UX,配套标识、产品文案与[品牌规范](docs/orven/BRAND.md)。本次源码与独立预览的验证情况见[Orven 改版记录](docs/orven/progress.md),正式安装状态仍以对应发行记录为准。
当前已交付版本为 **1.25.10**。[打开工作台](http://127.0.0.1:4318/?release=1.25.10)。工具箱可开启进展提醒,默认关闭;任务记录分别核对实际请求和后续工具进展。默认完整透传上下文与输出,模型连接统一在模型中心选择与编辑;文件自动应用并保留Git基线与回滚,操作权限持久保存。源码发布与程序发布独立,不包含用户项目、会话和Key。见[打包说明](docs/PACKAGING.md)和[本次验证](docs/QA-REMINDER-READBACK-D.md)。下方各版本数字为历史交付记录。
1.25.3 历史交付:[打开工作台](http://127.0.0.1:4318/?release=1.25.3)。模型中心可从上游获取型号目录,搜索、多选后手动指定或加入自动适配池;推理模式/强度按品牌与自定义兼容格式配套,能力元数据缺失时保留待确认。使用见[模型目录](docs/MODEL-CATALOG.md),验证与限制见[验收](docs/QA-MODEL-CATALOG-1.25.3.md)和[回顾](docs/RETROSPECTIVE-MODEL-CATALOG-1.25.3.md)。原进程、连接凭据及全部原数据保持;真实供应商兼容、自主工程交付和 Purge 收益仍待独立验证。以下为各版本历史记录。
1.22.0已本地上线:任务中准备Vite预览,桌面端右侧「浏览」查看真实页面并审批固定操作;原截图、动作和下载可核对,手机可观察同一原图。683项核心测试沿用C完整通过原轮、250组界面沿用B原轮,均已严格绑定输入;D独立重建及实际桌面、便携、安装/升级通过,原连接和全部历史保持。见[工作台](http://127.0.0.1:4318/?release=1.22.0)、[使用说明](docs/EMBEDDED-BROWSER.md)、[验收](docs/QA-1.22.md)、[回顾](docs/RETROSPECTIVE-1.22.md)和[发行身份](docs/embedded-browser-release-identity.json)。新iPhone与真实模型效果单列待验。以下为历史交付记录。
1.21.0已本地上线:任务记录可诊断工程环境,在管理的独立工作区核对并批准npm依赖准备,查看原日志、停止或核对中断结果,实际检查绑定依赖身份。独立源码666项、233组历史界面及安装/升级通过,原连接和全部历史保持。见[工作台](http://127.0.0.1:4318/?release=1.21.0)、[使用说明](docs/ENVIRONMENT-PREPARATION.md)、[验收](docs/QA-1.21.md)、[回顾](docs/RETROSPECTIVE-1.21.md)和[发行身份](docs/reproducible-env-release-identity.json)。
1.20.3已本地上线:上游错误详情/原文下载、原生参数配置和按原因处理429。见[工作台](http://127.0.0.1:4318/?release=1.20.3)、[验收](docs/QA-1.20.3.md)、[回顾](docs/RETROSPECTIVE-1.20.3.md)和[发行身份](docs/model-fidelity-release-identity.json)。内置浏览器已明确为[1.22阶段](docs/PLAN-1.22.md),当前已有静态工程页面验收。
上一维护版1.20.2修复固定60秒生成截止,新增模型中心「等待时限」;其部署历史及原连接/记录保持。见[工作台](http://127.0.0.1:4318/?release=1.20.2)、[验收](docs/QA-1.20.2.md)、[回顾](docs/RETROSPECTIVE-1.20.2.md)和[发行身份](docs/model-wait-release-identity.json)。历史失败仍按原记录显示,手动续接的新请求使用新时限,任务总预算仍优先。
1.20.1已修复任务目标丢失、审查后附加测试、完整无参工具报错、失败消费漏记和无进展循环,并修复暂停收尾及Windows退出竞态。独立626项、实际桌面/390px、安装/升级通过,原连接与全部历史保持。见[工作台](http://127.0.0.1:4318/?release=1.20.1)、[验收](docs/QA-1.20.1.md)、[回顾](docs/RETROSPECTIVE-1.20.1.md)和[发行身份](docs/task-control-release-identity.json)。1.21计划保留,真实模型自主工程复验单列。
1.20.0历史交付。「工程评测」可固定需求、来源和原检查,准备同源原版/候选,核对真实失败、改动与人工操作,再经父审查/检查/Git采纳。独立604项、210组历史界面、四类工程14节点及安装/升级/原生回看通过;原连接和全部历史保持。见[工作台](http://127.0.0.1:4318/?release=1.20.0)、[使用说明](docs/ENGINEERING-EVALUATIONS.md)、[验收](docs/QA-1.20.md)、[身份](docs/engineering-evals-release-identity.json)和[下一阶段](docs/PLAN-1.21.md)。固定响应验证执行链,真实模型自主完成率仍单独验收。
1.19.0历史交付项目解析缓存。工程「索引 → 解析缓存」可查看当前来源核对、真实复用/失效和容量,管理本机开关或仅清除本项目派生材料。独立590项、203组历史UI、三类实际工程、安装/升级、正式24页及原生回看通过;原连接和全部历史保持。跨实例Node/React有局部收益,冷/热/失效仍有来源核对开销,Python未得稳定收益。见[工作台](http://127.0.0.1:4318/?release=1.19.0)、[缓存](docs/PROJECT-CACHE.md)、[验收](docs/QA-1.19.md)、[身份](docs/project-cache-release-identity.json)和[后续方案](docs/PLAN-1.20.md)。
1.18.0历史交付工程截图、视觉选路与预算续接。可为工程任务添加PNG/JPEG截图,核对实际视觉选路及原图/发送副本;预算暂停会显示具体分解,预览确认后继续同一Task。独立源码576项、196组历史UI及截图Node/React/Python工程通过,原项目、会话和模型连接保持。见[工作台](http://127.0.0.1:4318/?release=1.18.0)、[截图与续接](docs/INPUT-ATTACHMENTS.md)、[验收](docs/QA-1.18.md)、[发行身份](docs/vision-inputs-release-identity.json)和[下一阶段](docs/PLAN-1.19.md)。
1.17.0历史交付模型协议、流式和能力路由。现在可配置Chat/Responses、流式连接和按能力筛选的模型池,直接核对原请求、拒绝原因、断流及停止结果。该版本的模型声明和实际检测分别显示;视觉输入由1.18补齐,语音仍为后续能力。见[工作台](http://127.0.0.1:4318/?release=1.17.0)、[验收](docs/QA-1.17.md)、[发行身份](docs/model-protocols-release-identity.json)和[下一阶段](docs/PLAN-1.18.md)。
Agent Workbench 将 Claude Code 与 Cursor 的机制研究整合为独立的本地 AI 编程工作台,并内置模型池、项目记忆、Skills/MCP、REA 工件研究、受控DeepSeek Harness工程引擎、实际页面验收和有依赖的执行计划。工程索引、精确补丁、多文件整批审查、Node/Python实际检查、浏览器交互、本地Git提交及交付报告可以在同一个Task中完成。
1.16.0历史交付手机伴随端。手机可查看同一Task/Run、核对原差异与报告、确认原审批及停止所属执行;断线恢复和设备撤销已通过真实iPhone验收。Windows安装、源码/便携独立验证及保留数据升级完成。iPhone 14 Pro Max/iOS 27.2为用户提供;用户确认信任、配对、原审批、差异/报告SHA、主屏幕、锁屏、切网恢复、停止及撤销,原宿主审计/进程/文件另行核对,无手机截图。见[本地工作台](http://127.0.0.1:4318/?release=1.16.0)、[实际验收](docs/QA-1.16.md)与[发行身份](docs/mobile-companion-release-identity.json)。
1.15.0历史交付Windows桌面应用、本机可选加密连接、后台任务/窗口分离、单实例、所属项目入口、可回退安装与分页巡检。495/495独立源码、23类179组历史UI、真实窗口7/原生UI9/三工程16节点、父8/8、9/9、10/10、同载荷安装/重启/卸载7组(隔离测试登记,正式产品安装器另行stage)、正式18页、1446条工件记录和1357个去重文件核对通过;当前2连接配置/1池、17项目/29全部会话/2567记录/4599事件,正式纠正升级前后每行/全导出/全部工件原字节保持(相对初始16项目,用户启动新增1个示例并将原列表顺移;体验期间另新增1个空白idle会话及对应1事件,全部原28会话/记录/工件保持);旧PID23172已在恢复检查前退出,用户体验时手动启动1.14/PID36552,随后保留这个进程/Provider升级;旧内存Key不可恢复,需在界面重新填写,9229关闭。双击安装目录AgentWorkbench.exe使用原项目和连接配置;见[本地工作台](http://127.0.0.1:4318/?release=1.15.0)、[实际验收](docs/QA-1.15.md)、[桌面说明](docs/DESKTOP.md)与[发行身份](docs/desktop-host-release-identity.json)。
1.14.0已正式本地交付固定版本的受控引擎与工具/模型桥,原生prompt、审批、预算、原结果和停止进入所属Task/Run;独立工作区成果由父工程审查、检查及Git交付。Purge两版本来源锁定的提示实验默认关闭。三个真实功能工程13节点、23类178组UI、独立源码445/445及最终源码/便携验收通过;原PID、模型连接和全部历史保持,部署后14页复验通过。1.14的发行身份与具体结果见[QA-1.14](docs/QA-1.14.md)。真实模型推理收益按原选择独立待验。
1.13.0已本地交付[隔离协作](docs/WORKERS.md):父目标与两个受限Git工作区、累计预算/停止恢复、当前成果核对、具体冲突和父工程审查/检查/Git交付。独立源码404/404、完整界面21类160组与三个真实功能工程通过,父Node8/8、React9/9、Python10/10及构建/编译/Git,React内置Edge两视口各10项断言。正式[本地工作台](http://127.0.0.1:4318/?release=1.13.0)已保持原进程/模型连接/全部历史升级,验收与部署见[QA-1.13](docs/QA-1.13.md)。
模型中心支持多连接、轮询/权重、故障冷却与请求账本,并可预览导入已验证的CCSwitch/工作台配置。项目记忆按来源复核后进入有界上下文;任务检查点保留全部要求和原工具结果;Skills按版本读取,MCP按实际契约和逐次确认执行。运行中心提供不发送模型请求的本地巡检,发行验收与限制见[1.12记录](docs/QA-1.12.md)。
任务记录中的「执行计划」固定步骤、依赖和通过条件,用原操作及当前文件核验。未完成或失效步骤会保留在同一Task,并阻止用模型文字或旧Git预览直接交付。模型可使用相同的计划与核验工具;原计划、通过/失败证明和交付报告均能查看。契约见[任务计划](docs/TASK-PLANS.md),桌面/390px、源码与实际模型结果分别见[1.11验收](docs/QA-1.11.md)。
1.10.1修复保留旧SQLite宿主升级后页面工件读取失败的问题。独立源码、发行与真实配置模型结果各自登记,当前状态见[1.10验收](docs/QA-1.10.md)。
1.10.0在任务记录中增加「页面验收」:封存构建目录、桌面或手机视口和检查步骤,审查后使用独立Edge实际填写、选择、点击与断言。原页面、请求、步骤和PNG截图绑定当前任务;失败原值保留,构建变化后重新检查。配置了页面验收的Task必须取得当前构建断言通过记录才能Git交付。使用范围见[页面验收契约](docs/BROWSER-CHECKS.md),发行与验收状态见[1.10记录](docs/QA-1.10.md)。
1.9.0新增「本地代理引擎」入口:填写已有DeepSeek Harness 0.2.1-rc.2目录、检测安装并核验启动/连接/停止,原记录保存在当前Task,可分页或完整下载。261项独立源码、108组完整界面、不可变发行及保留原Provider的正式升级已完成,见[1.9记录](docs/QA-1.9.md)。本切片不捆绑第三方Harness,不发送外部模型任务。
1.8.0已完成最终244项独立源码回归、98组界面与随包REA实际分析,正式本地服务保留原模型连接升级。真实配置模型在原Task完成四模块修复、14项测试/构建、整批审查和工作台Git交付,见[1.8交付记录](docs/QA-1.8.md)。外部代理引擎与总体自主工程完成率继续分别验证。
每次运行保留模型与预算、已完成工具和日志工件。多文件变更集封存同Task的原/新字节、Git基线与审查指纹,应用前核对整批文件;中断后显式核对或回退,保留外部修改。应用改动后可点击「继续检查与交付」,沿用原目标进行实际测试与修复。提交前查看实际文件、diff、署名和检查结果,确认后生成本地提交及可下载的JSON/Markdown报告。版本改动见 [CHANGELOG](CHANGELOG.md),编辑范围见[索引与补丁](docs/CODE-INDEX-AND-PATCHES.md)和[变更集恢复契约](docs/CHANGE-SETS.md)。
## 后续产品与能力建设
1.12包含模型中心/池路由、[项目记忆](docs/PROJECT-MEMORY.md)、[任务恢复检查点](docs/TASK-CHECKPOINTS.md)、[Skills](docs/SKILLS.md)和[项目MCP](docs/MCP.md)。记忆只在来源复核、脱敏且请求预算允许时使用;恢复检查点绑定完整要求和原结果,核对后显式续接同一任务。1.13两个受限worker与1.14受控引擎/提示实验均已完成发行;1.15桌面和本机加密完整发行已验收,具体结果以[QA-1.15](docs/QA-1.15.md)为准;1.16手机伴随端及1.17两协议/流式/能力路由均已交付;1.18工程截图、视觉选路与预算续接已完整本地交付;1.19来源核对的项目解析缓存已完整交付;1.20固定工程评测与受控候选采纳已完整交付;1.21工程环境与固定依赖准备已本地交付;下一[1.22工作台内置浏览器](docs/PLAN-1.22.md)仍为计划。
当前Git项目可以先预览已提交版本,再创建独立目录和分支;来源已有暂存、未提交及未跟踪文件保留在原项目。子工作区有自己的项目、会话和实际执行目录,创建中断后显式核对。模型准备Git交付预览后停止请求,确认这份预览后由内核完成提交和报告。具体范围见[独立工作区](docs/WORKSPACES.md)及[1.6验收](docs/QA-1.6.md)。
目标是自有Harness核心、用户选择的大模型、REA研究工具和可选外部代理引擎共同完成“需求→工程理解→代码变更→实际测试与修复→审查→Git交付”。研究对象为Codex、Claude Code、Cursor、DeepSeek Harness、WorkBuddy与DSH-purge;研究结论、独立实现和实际验收分别登记。Purge是Harness插件,其工程收益需要版本锁定和同题对照验证。
- [完整产品与执行方案](docs/PRODUCT-PLAN.md):M0–M6阶段、模块、真实任务和Electron/PWA分工。
- [24项能力与验收矩阵](docs/CAPABILITIES.md):当前基础、待开发目标、来源和完成证据。
- [研究路线](docs/RESEARCH-ROADMAP.md)与[目标来源登记](research/targets.json):版本、来源、SDK限制及未解决问题。
- [本地Git流程](docs/GIT-WORKFLOW.md)与[项目执行规范](AGENTS.md):源码仓库已建立,main基线`bac87da`、标签`v1.0.0-baseline`;后续按独立小步检查并及时提交。
1.6.2优先保留当前Task的实际代码与执行依据,再补近期历史;同版本较完整的读取优先于后来的小页,原工件引用可继续分页。发送视图的完整来源仍可核验,1.6.1历史视图按原版本保留。已应用前的旧代码和失效检查不计入当前依据。请求面板可查看实际发送内容、工作依据和完整原历史,具体范围与验收状态见[1.6.2记录](docs/QA-1.6.2.md)。沿用1–32文件的封存变更集与可恢复应用;部分执行会明确显示需核对。改名/删除、任务依赖图、语义引用、工作区合并/归档、多类工程检查器、外部引擎、REA执行及桌面/手机配对继续按后续阶段建设。
1.7.0在完整工具组过大时仍保留有原结果来源的最新状态反馈;相同工程状态连续三次未推进会保存并暂停。Python支持unittest、pytest与源码语法编译,保存实际解释器、输入、结构化统计和日志,检查结果进入既有Git/报告核对。混合项目可以在界面「选择检查范围」中选Python,再重新识别并确认新计划。Python需本机安装;pytest工程需在所选环境安装pytest。具体范围见[Python检查契约](docs/PYTHON-CHECKS.md)及[1.7验收](docs/QA-1.7.md)。
## 直接运行
Windows x64 1.20桌面/便携包自带Node.js 24.22.1、npm、Electron 45.2.0、REA 6.8.0、Playwright 1.64.1及锁定生产依赖。页面验收使用本机Microsoft Edge。安装版双击安装目录的AgentWorkbench.exe,便携版双击Start-Desktop.cmd打开桌面;Start-Workbench.cmd仍可打开浏览器入口http://127.0.0.1:4318。当前安装/发行状态见[QA-1.20](docs/QA-1.20.md)。
启动不需要安装 npm 依赖或管理员权限。窗口关闭后本地服务仍运行,任务与会话继续保存。再次打开相同地址即可查看记录。
1. 打开自带示例项目,或点击项目栏的「+」输入本机项目文件夹路径。
2. 输入任务并发送。默认「离线演示」使用固定脚本调用真实本地工具,不进行模型推理。
3. 终端请求会显示完整命令、用途和工作目录,确认后才运行。
4. 文件建议先成为提案。跨文件改动在「改动」面板选择「组合审查」,封存并查看整批差异,再确认应用全部文件;模型也可准备批次。独立提案仍可逐项审核,已封存提案通过批次处理。
5. 点击「模型连接」,选择兼容模型服务,填写接口根地址、模型和按需填写的 Key;可先「验证模型响应」,再保存连接。
6. 遇到请求失败,点击错误卡片的「查看运行诊断」。可在同一会话提问,助手通过本地 `inspect_session` 核对错误来源、近期工具和文件实际状态。
7. 点击「查看任务记录」查看目标、各轮运行、累计用量与工件。识别工程后可选择检查范围,核对npm脚本或Python执行环境,再确认执行;查看实际测试数量、日志和原统计依据。应用全部提案后,用「继续检查与交付」继续同一目标。
8. 检查通过后,在任务记录中「预览Git提交」,核对已审核路径、差异、署名和说明,再「确认创建本地提交」。工作台保留其他暂存与工作区改动,结果未知时提供「核对提交结果」;报告可直接查看和下载。Git需要本机安装,具体范围见[Git交付契约](docs/GIT-DELIVERY.md)。
9. 右侧「索引」按函数、类、路径或导入查找代码,结果可定位原文件行。文件在索引后变化时打开当前内容并提示刷新;Python声明候选与局部模块文件候选显示各自范围。长文件差异可直接「定位首处改动」。
10. 批次中断或部分失败时,在所属任务打开「审查变更集」,先核对实际文件,再按当前哈希回退或明确保留外部内容。结果待核对期间同项目的新运行、写入、检查与提交会暂停。
11. 任务记录中的「请求上下文」可查看当前或历史运行的实际发送内容、请求计划和分页完整历史。读取原记录不会执行工具;预算不足时保存同Task检查点,通过明确续接操作继续。
12. 点击顶部「REA 工件研究」,登记ASAR、EXE或DLL的本地绝对路径与研究问题。选择JavaScript/Electron、PE导入或资源分析后,可查看原字段、限制、连接记录和完整Evidence Bundle。完成的同版本结果先核验再复用;新版本需重新登记,未完成分析由用户明确重新发起。
13. Web工程构建完成后,在任务记录「页面验收」中选构建目录、页面路径和视口,添加填写、点击或断言并封存计划,核对后运行。步骤为空时先观察页面与实际元素,再准备有断言的新计划。可查看原步骤结果、分页JSON及原始PNG;构建或源码变化后准备新计划。
REA首批为静态分析,研究工件不会自动运行。原结果与项目、Task、Run和目标SHA256绑定,模型只能分析已登记工件。具体范围见[REA集成契约](docs/REA-INTEGRATION.md);Windows桌面与手机伴随端已交付,其他REA工具及引擎适配按后续契约推进。
## 模型连接
支持Chat Completions的tools/tool_calls/tool_call_id和Responses的实际工具Items/call_id,按连接协议请求/chat/completions或/responses。填写服务实际提供的接口根地址,例如Ollama http://127.0.0.1:11434/v1、vLLM http://127.0.0.1:8000/v1,工作台不强制添加/v1。可读取模型列表或直接填写名称;工具/流式/视觉能力按声明及明确范围的实际检测分别显示。1.18工程截图经PNG/JPEG校验及派生后发送,视觉任务在租约前排除不兼容模型;见[截图输入契约](docs/INPUT-ATTACHMENTS.md)。
模型网络故障、DNS、证书、超时、身份、限额和接口响应错误分别记录。可恢复请求最多尝试三次,尊重服务的 Retry-After,并限制总时长;401/403 和无效或过大的 JSON 不自动重试。停止任务会取消请求和退避。错误卡片的「重试模型请求」沿用已完成工具结果。
API Key默认只在执行宿主内存中使用。1.15可在「模型中心」对新填写或本次确认导入的连接选择本机加密保存,使用当前Windows用户的DPAPI密文,与连接登记同一SQLite事务提交;可关闭启动加载、删除本机保存或单独清除内存。临时连接重启后需重新填写。既有内存Key不会因升级自动写盘,公开配置、会话和导出不包含明文Key。格式导入只处理用户明确选定的来源,见[桌面与连接说明](docs/DESKTOP.md)。
接口契约已由本地 HTTP 测试服务及浏览器验证。用户随后配置的 `gpt-6.1-sol` 已通过真实读取、提案与应用验证,见[模型连接实测](docs/MODEL-CONNECTION.md)。
## 文件、命令与恢复
读取与搜索仅处理项目范围内的 UTF-8 文本,并限制文件体积/搜索数量,跳过依赖目录、链接与常见凭据文件。文件提案保留原文 SHA256;应用时发现外部改动会拒绝覆盖。原文备份保存在数据目录的 `backups` 下,保留原字节。
终端命令逐次确认,最长 60 秒,有输出上限,确认后以当前系统用户权限执行。项目工作目录不是操作系统沙箱。停止任务会中止工作台启动的进程树。
数据默认保存在 `%LOCALAPPDATA%\AgentWorkbench`。1.1.0将任务、运行、工具、检查与事件保存到`workbench.sqlite`;旧JSON在有备份的事务迁移后保留。大型结果和检查日志另存为SHA256校验工件。服务意外退出后保留提案和完成结果;结果未知的副作用需要核对,不自动重放。暂停后可「继续任务」;已应用的审核任务可「继续检查与交付」。
工程检查当前支持已识别的npm test/typecheck/check/lint/build脚本,计划绑定源码与Git快照。执行前展示脚本与npm生命周期钩子,实际job保留退出码、测试统计及日志。零测试、跳过、未识别日志、取消或源码过期均不记为任务验证通过。
Windows 终端使用 PowerShell 5.1,通过 UTF-8 stdin 传入经确认的完整脚本,同时设置输入、输出和 `$OutputEncoding`。多条命令用换行组织,不能使用 `&&` 或 `||`;原生命令的 `$LASTEXITCODE` 会成为执行结果。
完整历史保存在本地。模型请求按完整assistant/tool组选择近期内容,省略组保存为SHA256工件;任务目标、全部追加要求和最后用户消息完整保留。发送前持久保存实际JSON正文与请求计划,估算包含系统、工具定义、历史和输出预留。服务实际usage另行记录,估算不能当成准确费用;详见[上下文契约](docs/CONTEXT-PLANS.md)。
## 研究与验证
- [统一机制报告](docs/RESEARCH.md):原版静态证据与本产品实现逐项对照。
- [详细报告与证据索引](docs/research):Claude Code 工具循环、上下文/恢复,以及 Cursor 工具执行/编辑。
- [验收记录](docs/VALIDATION.md):逐版本保留实际结果、失败与部署身份。
- [本轮验收清单](docs/QA-1.5.1.md)、[封存四模块工程基准](benchmarks/node-delivery-v1/README.md)与[保留连接的升级说明](docs/UPGRADE.md)。
- [独立架构](docs/ARCHITECTURE.md)与[界面设计](DESIGN.md)。
原版研究没有执行 Claude Code/Cursor,报告不表示恢复了全部源码或验证了远端服务。完整分析工件保留在原研究工作区;本产品包不包含第三方客户端原二进制、完整提取源码或大体积代码切片。
## 源码开发
使用 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
npm.cmd run build
npm.cmd test
```
启动构建结果可运行 `npm.cmd start` 或双击启动脚本。前端开发使用 `npm.cmd run dev`,另开终端运行构建后的本地服务。
UI 验收先启动独立测试服务,依次运行基础、诊断、任务、Git交付和索引脚本;`node scripts/verify-change-sets-ui.mjs`及`node scripts/verify-context-ui.mjs`自行启动独立宿主。默认地址为 `http://127.0.0.1:4319`,索引脚本需用 `AGENT_WORKBENCH_URL` 明确指定独立端口。验证器使用本机Edge、离线演示和未配置Key的宿主,在 `.qa` 创建自有项目。真实模型批次样本使用 `node scripts/verify-live-delivery.mjs --batch`,具体证据见[验收记录](docs/VALIDATION.md)。
```powershell
$env:AGENT_WORKBENCH_DATA_DIR = Join-Path (Get-Location) '.qa\browser-data'
$env:AGENT_WORKBENCH_PORT = '4319'
npm.cmd start
```
端口默认 4318;`AGENT_WORKBENCH_PORT` 与 `AGENT_WORKBENCH_DATA_DIR` 可覆盖。不同服务实例应使用不同数据目录。
构建后运行 `npm.cmd run package` 生成便携和源码 ZIP。打包脚本优先使用相邻 `tools/node-v24.22.1-win-x64/node.exe`;也可指定 `AGENT_WORKBENCH_NODE_PATH`,须同时存在对应的 Node LICENSE。
第三方许可见 `THIRD_PARTY_NOTICES.txt` 与 `licenses/`。本工程原创代码的对外许可由项目持有人决定。