Files
Agent-Workbench/docs/WORKSPACES.md
2026-10-30 00:22:05 +08:00

22 lines
3.6 KiB
Markdown

# 独立开发工作区
1.6.0构建、192项完整行为/API/实际退出回归及72组界面通过。不可变发行、原进程升级与真实配置模型验收单独登记到[QA-1.6](QA-1.6.md)。
从当前Git项目封存已提交的HEAD、来源目录、命名分支、索引字节、可读取源码、其他引用和Git配置的散列。审查后创建宿主拥有的独立目录及新分支,打开为独立项目和会话。来源的未提交文件不会自动复制;依赖安装另行审查。工作区的Task、Run、模型上下文和报告标明实际执行目录、分支、起始提交与来源身份。
创建记录先于Git执行保存,包含宿主PID和实际Git子进程PID。成功后核对工作区登记、共同Git目录、HEAD、分支、索引条目和标记、所有检出文件的Git内容散列及来源快照。在登记项目/会话前后再次核对。重复请求使用保存的身份;完成项目允许在原分支上继续修改和提交。
创建中断标为结果待核对。显式核对只读取实际状态,完整一致时补齐项目/会话登记;外部目录、分支或内容变化会保留并说明差异。原执行进程仍在运行时不能结束核对。确认保留外部状态不宣称创建成功,不自动删除、重试、reset或合并。读取验证不会补建丢失的控制文件。已归档的子会话保持归档。
支持已有提交的普通命名分支,最多1000份已提交文件、单文件1MB、总计16MB,拒绝提交的链接、子模块、凭据/依赖/内部目录、Windows设备名和大小写冲突。当前不支持稀疏检出、独立worktree配置或外部Git配置包含。Git以参数数组执行,使用受限环境及空hooks目录,关闭fsmonitor和配置中所有clean/smudge/process/required过滤器,保留内置换行转换。创建不会执行项目代码或安装依赖。
物理目录使用工作区UUID的短散列标识,完整UUID继续作为持久身份,任务名称仍展示在界面与分支中。Windows创建前核对预测的Git管理目录不超过200个UTF-8字节;Git启动的内部路径缓冲仍有限制,core.longpaths不能解除。超限在发布新分支前拒绝并提示缩短来源目录,已有或待核对工作区不因此被删除、改名或自动修复。
工作区创建参与Runtime、工程检查、Git交付、文件批次和升级的活动检查。同仓库正在创建或结果待核对的记录需要先在所属会话处理。直接文件读取/编辑也核对物理Git身份。来源状态只在创建及创建恢复时要求完全一致,之后正常开发允许来源和子分支各自推进;本轮没有自动合并和工作区归档能力。
验收要求包含真实进程退出切点、外部改动、保留原索引/已有修改、hooks和过滤器无执行、子工作区批次到真实检查和Git报告,以及桌面和390px界面的创建/切换/恢复/迟到响应。证据随实际完成逐项登记。
已通过的真实HTTP契约用合成模型驱动子工作区的批次修复、3项失败→3项通过/build、Git审查和报告;确认后无新增请求,来源index/HEAD/已有改动保持。8个实际process.exit切点覆盖意图、Git启动/结束、核对及项目/会话登记。合成模型契约通过不代替真实配置模型的工程交付验收。
见[完整回归](workspaces-tests-validation.json)、[工作区界面](workspaces-ui-validation.json)及[全部界面](workspaces-all-ui-validation.json)。[桌面预览](screenshots/1.6-workspace-review-desktop.png)和[390px预览](screenshots/1.6-workspace-review-mobile.png)已目视核对。