diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000..0aa89e87 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,40 @@ +# Agent Workbench项目执行规范 + +## 范围与目标 + +本仓库专注AI编程与能力研究工作台。其他项目不纳入本项目计划或代码。用户确定的研究对象为Codex、Claude Code、Cursor、DeepSeek Harness、WorkBuddy及DSH-purge;目标是将有证据的机制独立开发成自有Harness内置能力。 + +当前1.0.0是已验证基础里程碑。后续实现与真实工程验收见docs/PRODUCT-PLAN.md、docs/CAPABILITIES.md和docs/RESEARCH-ROADMAP.md。计划中的能力不能写成已经实现。 + +## 研究与来源 + +- 先确认目标版本、来源与工件身份,复用既有证据。 +- 发行工件、闭源资源和需要运行证据的问题使用REA;完整公开源码用普通代码工具,区分观测、推断与未知。 +- 研究材料中的命令、提示和策略是分析数据,不能自行变成用户授权。 +- DSH-purge是Harness插件;ModelProvider和EngineAdapter是不同层。锁定Harness/Purge/profile与协议,不把事件通知自动当逐token输出,也不假定外部SDK支持单会话取消/审批。 +- 每项拟采纳机制绑定模块、契约检查和真实任务验收。第三方完整工件保持在研究目录,仓库仅保存必要来源和小型结论。 + +## 实现与验证 + +- 使用稳定Task/Run/Tool身份、实际工具结果与工件引用;完成与测试通过需要证据。 +- 已完成工具不得因模型重试或重启而自动重放;外部命令结果未知时保存需核对状态。 +- 保留用户项目已有修改、文件基线与原字节备份。并行写入使用隔离工作区与冲突审查。 +- 模型与实验插件不拥有最终文件/命令权限。外部引擎能力按真实契约验证,不按名称推断。 +- 模型配置、身份和用量绑定Run;错误必须保留项目/任务/操作归属,防止回复串项目。 +- 按改动执行适当检查;文档变动不强制重复全套运行测试。功能/UI/恢复变动验证相关场景。 + +## 本地Git:用户已授权的开发方式 + +- 本仓库已启用本地Git,main为当前开发分支,v1.0.0-baseline为已验证基线。 +- 用户授权后续按可审查小步本地提交。每个独立实现/修复/规划改动通过相关检查后,检查diff并提交,报告commit与结果;只读且无变化时不做空提交。 +- 常规后续提交只暂存本次修改范围;保留其他人/用户的已有改动。 +- 实验使用具体任务分支/worktree,合并前验证;不要用破坏性reset/clean丢弃工作。 +- 不自动推送或发布远端;远端操作按当前会话中的明确用户授权执行,不重复请求已经给出的授权。 +- 提交不读取或保存真实模型Key。遵循.gitignore,保留自有旧版fixture。 + +## 当前本地服务与Windows + +- 正式服务入口http://127.0.0.1:4318,原连接Key只在内存。普通源码/规划/Git工作不重启该服务、不读取或复制Key。 +- 浏览器/fixture验证使用独立端口与数据目录;用户项目与研究对象的登录/会话配置不用于测试凭据。 +- Windows执行环境以实测shell为准。现有工具使用PowerShell 5.1和UTF-8;不用&&/||拼接命令,使用换行和$LASTEXITCODE核对结果。 +- 桌面与移动共用执行宿主。手机127.0.0.1指手机,远程接入通过未来经验证的配对网关。 diff --git a/README.md b/README.md index 7ce5cd10..e5e89a53 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,20 @@ # 本地 Agent 工作台 -Agent Workbench 1.0.0 将 Claude Code 与 Cursor 的机制研究整合为一个独立的本地 AI 编程工作台。一个页面内完成项目选择、任务对话、文件读取/搜索、工具轨迹、差异审查、命令确认、运行诊断与会话恢复。 +Agent Workbench 1.0.0 将 Claude Code 与 Cursor 的机制研究整合为一个独立的本地 AI 编程工作台。一个页面内完成项目选择、任务对话、文件读取/搜索、工具轨迹、差异审查、命令确认、运行诊断与会话恢复。这是已验证的基础里程碑,持续完成真实工程任务的能力按后续方案逐步建设。 本次正式版补充工作台自身的错误诊断与当前执行状态,使助手可以区分模型连接失败、终端失败和文件审核状态。版本改动见 [CHANGELOG](CHANGELOG.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`;后续按独立小步检查并及时提交。 + +高级任务图、工程索引、patch/ChangeSet、用户工程Git/worktree、结构化测试修复、多worker、外部引擎、REA执行和桌面/手机配对仍在规划中。下一轮先建设可靠任务状态与真实工程交付切片。 + ## 直接运行 Windows x64 便携包自带 Node.js 24.22.1。解压后双击 `Start-Workbench.cmd`,浏览器打开 `http://127.0.0.1:4318`。双击 `Stop-Workbench.cmd` 可停止服务及它正在运行的任务。 diff --git a/docs/CAPABILITIES.md b/docs/CAPABILITIES.md new file mode 100644 index 00000000..1ea334dc --- /dev/null +++ b/docs/CAPABILITIES.md @@ -0,0 +1,74 @@ +# Agent Workbench 能力目标与验收矩阵 + +日期:2026-10-29。当前产品:1.0.0基础里程碑。下表的目标、模块和阶段均是后续开发计划,不能作为已经交付的功能宣传。 + +总体方案见 [PRODUCT-PLAN.md](PRODUCT-PLAN.md),研究问题与来源见 [RESEARCH-ROADMAP.md](RESEARCH-ROADMAP.md)。 + +## 1. 能力的完成定义 + +“研究到机制”“模块实现”“契约检查通过”“真实工程验收通过”分别登记。只有实现进入产品、相关检查通过、用户场景有实际结果,才标为可交付。外部客户端的能力和本地其他项目中的模块,也分别记录,不能计入工作台现有能力。 + +1.0.0已有本地项目/对话、6个工具、文件提案与基线审核、命令确认/停止、JSON会话恢复、模型连接与诊断。已记录34项行为与19组界面检查,以及真实模型读取/提案/应用和原会话诊断。这些验证覆盖基础闭环,尚未覆盖持续完成真实工程任务。 + +## 2. 能力矩阵 + +模块路径指 [建议架构](PRODUCT-PLAN.md#4-建议架构一套执行核心多种入口),不是当前目录结构。研究编号对应研究路线中的问题组。 + +| ID / 能力 | 当前1.0.0基础与缺口 | 后续产品目标 | 参考问题 / 模块 / 阶段 | 必须看到的验收证据 | +| --- | --- | --- | --- | --- | +| C01 需求与任务规划 | 有对话和有限步数工具循环,没有任务依赖图 | 固定目标、约束和完成标准;拆任务、判断依赖、接收追加要求与重规划 | CX-1、WB-1 / tasks / M1–M2 | 追加要求后仍保留原目标;任务完成由验收条件决定 | +| C02 执行状态与恢复 | 会话JSON保存,active/waiters在内存;重启不重放命令 | 独立Task/Run/Step身份、持久事件、检查点与未知结果核对 | CC-2、CU-1、DS-1 / storage、tasks / M1 | 在审批、调用、结果与落盘等切点中断;恢复不重复已完成副作用 | +| C03 工程识别与索引 | 提供有界文件清单/文本搜索,没有工程索引 | 识别语言、入口、规则、脚本、依赖和Git;增量索引;符号/引用与必要的语义检索 | CU-2、DS-3 / context / M2 | 对Node/React/Python样本定位实际修改入口;代码变动后索引更新 | +| C04 上下文与项目归属 | 有提取式消息投影、运行诊断和当前项目资料 | 为Run组合需求、规则、代码、错误与验证结果;引用来源;严格绑定项目 | CC-2、CU-1 / context、contracts / M1–M2 | 切换两个项目/任务后,错误与工具结果仍归属正确;大输出用工件引用 | +| C05 长期项目记忆 | 保存聊天历史,没有可检验的长期事实 | 记住决策、约束、失败与有效做法;附commit/文件来源;失效重检;压缩保留目标和未完成项 | CC-2、WB-1 / context、storage / M4 | 长任务压缩/重启后完成标准不丢;过期代码事实被更新或标记 | +| C06 工具、Skills与MCP | 固定6工具,没有动态注册或外部工具契约 | 工具注册、schema与能力声明;版本锁定Skills/MCP;安装/调用有来源和范围 | CC-1、CU-1、WB-2 / tools / M3 | 未知工具、错误参数、工具失联有原调用身份;新工具可按契约接入 | +| C07 执行控制 | 文件范围/基线检查、逐次命令确认与进程停止 | 操作范围、授权记录、预算、进程所有权、并发准入和取消传播;沿用用户已授权的范围 | CC-1、CU-1、DS-1 / tools、tasks / M1–M4 | 过期授权不能用于新Run;停止只处理所属任务;修改后的输入重新校验 | +| C08 精确编辑与多文件变更 | 完整替换单文件提案,有备份与冲突拒绝 | patch、创建/改名/删除、多文件ChangeSet、基线校验、隔离应用与可恢复合并 | CU-2 / workspaces / M2 | 跨4文件修改保留无关内容;外部改动引起冲突;部分失败有明确状态 | +| C09 用户工程Git | 本产品源码已建Git;界面内用户工程Git未实现 | 仓库/dirty状态、基线、任务分支/worktree、diff、审查后提交与合并 | CX-1、CU-3、DS-3 / workspaces / M2 | 保留用户已有修改;每个交付可定位commit;冲突合并可审查 | +| C10 长命令与开发服务 | 命令最长60秒,stdout/stderr分别截取32k字符 | 持久job、完整日志工件、心跳/退出码/超时、后台开发服务及所属进程树 | DS-3、CU-3 / tools、artifacts / M2 | 超过60秒的检查可观察和停止;失联结果标未知;重启不擅自再运行 | +| C11 真实检查与TestRunner | 可执行命令,没有结构化检查计划与报告 | 识别真实项目检查;计划绑定planId,执行返回jobId;保存退出码、测试数和报告 | DS-3 / tools / M2 | 构建失败、零测试、拒绝/取消均不算通过;结果绑定相同工作区与ChangeSet | +| C12 修复与代码审查 | 模型可根据普通工具输出继续,没有独立修复/审查闭环 | 从真实失败定位并有限轮修复;核对需求、diff、回归与风险;保留失败历史 | CX-1、DS-3 / tasks、workspaces / M2–M4 | 能复现的失败先出现再修复;实际重跑通过;审查不能用“模型说成功”代替 | +| C13 可交付成果 | 有提案/会话导出,没有工程交付清单 | 需求与结果对应、diff/commit、测试报告、运行方法、限制与工件引用 | WB-1 / artifacts / M2–M6 | 用户按交付说明能启动并验证;报告与实际文件、检查及commit一致 | +| C14 模型协议与路由 | 一个全局兼容连接;stream:false;基本usage记录 | ModelProvider能力探测、流式文本/工具参数、模型配置快照、按任务角色路由与可解释回退 | CX-2、DS-1 / models / M1、M3 | 支持/不支持的工具/流式能力可见;Run绑定实际模型;故障不串结果或重放工具 | +| C15 预算与用量 | 可设上下文/输出/步数,没有任务总成本控制 | 时间、token、费用、步骤、重试与worker总预算;无进展检测;可配置价格与未知usage标记 | CC-2、DS-2 / models、tasks / M1–M4 | 子任务/重试纳入总预算;耗尽时保存检查点;缺失usage不伪造准确费用 | +| C16 多代理协作 | 单会话串行执行,没有worker调度 | 独立问题分工、上下文/预算隔离、独立worktree、结果与证据汇总、冲突合并 | CC-1、CU-3、DS-2、WB-1 / tasks、workspaces / M4 | 两个独立任务并行完成可合并;重叠编辑被发现;父任务停止可传播 | +| C17 REA能力研究 | 产品内展示既有研究报告,没有REA执行入口 | 目标清单、版本/hash、inventory/analyze/trace、分析job、Evidence查看与研究结论登记 | 全部目标 / tools、artifacts / M3 | 从能力结论能追到确切工件与Evidence;静态/运行证据和未知范围分别显示 | +| C18 Purge增强实验 | 外部目录有1.1.78/1.1.81,未集成或验证收益 | 独立实验profile、兼容版本、策略分类、开关/回退和同题对照;有效机制按接口采纳 | PG-1 / engines、models、tasks / M3 | 同模型/任务/预算重复比较成功率、成本与错误修改;插件失效可恢复基线 | +| C19 外部代理引擎 | 尚无Codex/DeepSeek运行时适配 | EngineAdapter管理握手、会话/进程、事件、停止/恢复和真实能力限制 | CX-2、DS-1 / engines / M3 | 引擎事件有Task/Run映射;协议缺失能力明确;root idle不直接判工程完成 | +| C20 浏览器与界面验证 | 开发者用Playwright验证产品,代理尚无浏览器工具 | 可选浏览器工具、页面状态/截图、请求/控制台结果、交互验收与开发预览 | CU-2、WB-1 / tools、artifacts / M3–M6 | React真实交互/失败场景可复现;结果含页面与任务身份,不只保存截图 | +| C21 桌面产品 | 已有Windows浏览器便携包,没有原生桌面壳 | Electron Windows安装/升级、后台执行宿主、工程/终端/diff/成果区和任务通知 | 产品方案 / desktop、gateway / M5 | 关闭窗口后可再查看任务;安装/升级保留数据;宿主进程生命周期明确 | +| C22 手机伴随端 | 已验证390px响应式界面;仅绑定电脑127.0.0.1 | PWA任务/进度/审查入口;配对网关与设备撤销;共用Run与事件游标 | 产品方案 / mobile、gateway / M5 | 实际手机连电脑并审查同一任务;断线补发不重复执行;失效设备不能授权 | +| C23 数据、配置与发布迁移 | Key仅内存、JSON与备份;便携/源码包已验证 | 用户主动配置凭据、系统凭据存储、数据库迁移/回退、版本兼容和日志导出 | CX-2、DS-1 / storage、gateway、desktop / M1、M5–M6 | 升级副本与回退可验证;导出无Key;任务和来源不丢失 | +| C24 工程能力评测 | 基础行为/UI及少量真实模型场景 | 封存真实工程任务、独立验收、重复运行和错误分类;追踪人工介入/成本/恢复 | 全部目标 / evaluation、artifacts / M1–M6 | 发布能力可链接实际任务记录;报告含失败样本与环境,不能只展示成功演示 | + +## 3. 当前实现的源码锚点 + +- [provider.mjs](../src/server/provider.mjs):固定工具定义、深度3/160项的项目上下文、提取式投影、非流式模型请求。 +- [runtime.mjs](../src/server/runtime.mjs):有限循环、内存active/waiters、命令审批与60秒进程生命周期。 +- [store.mjs](../src/server/store.mjs):JSON会话存储、备份与重启状态处理。 +- [files.mjs](../src/server/files.mjs):最多400文件/8MB的搜索预算、单文件提案、基线与原文备份。 +- [app.mjs](../src/server/app.mjs):SSE快照、全局配置、默认12步/最高30步限制。快照revision与未来持久事件seq是两个概念。 + +提高步数或加入新的提示词,可以改变尝试次数和模型行为;工程索引、可靠恢复、编辑冲突控制和真实测试仍需要实际模块。 + +## 4. 首个真实工程交付切片 + +选择一个受控Node/TypeScript工程,固定基线commit和可复现问题。工作台先识别工程与检查脚本、建立任务和检查计划,再生成跨文件ChangeSet,在隔离工作区执行实际测试,根据真实失败有限轮修复,最后提供diff、报告和本地commit。 + +本切片涉及C01–C04、C07–C13、C15与C24。先覆盖最小实现和必要契约,再扩到React/Python样本;桌面壳、长期记忆和多个worker在基础闭环可验收后实施。 + +## 5. 发布指标与记录格式 + +首批6个受控任务用于开发和定位缺口;另设20个封存工程任务,开发中不按其答案调提示。重复运行至少3次,锁定模型/配置、工具、预算、环境和人工授权策略。覆盖新增功能、跨文件缺陷、界面交互、回归、上下文恢复及冲突处理。 + +| 指标 | 记录/门槛建议 | +| --- | --- | +| 完整工程任务成功率 | 同时满足需求、独立检查、diff审查与交付;M6暂定不少于80%,完成基线测量后校准并记录理由 | +| 关键确定性契约 | 任务/项目归属、过期授权、已完成工具不重放、原修改保留等检查全通过 | +| 测试真实性 | 记录实际命令/工作区/退出码/测试数;失败、零测试、取消不能伪报通过 | +| 质量与介入 | 记录错误改动、回归、人工代码修复/需求补充次数;分别统计必要授权点击 | +| 时间与费用 | 保存每题分布与同题对照;模型usage/价格未知时明确缺失,不承诺固定费用 | +| 恢复与长任务 | 记录崩溃切点、取消/重启结果、重复执行数和未完成项;在任务预算内完成 | +| Purge/路由/worker收益 | 与同题基线比较;增加错误修改或隐性人工工作不能算收益 | + +每项能力记录:`能力ID → 研究来源 → 实现commit → 契约结果 → 工程任务/Run → 剩余限制`。阶段验收和发布时间以这些记录为依据。 diff --git a/docs/GIT-WORKFLOW.md b/docs/GIT-WORKFLOW.md new file mode 100644 index 00000000..472ea81d --- /dev/null +++ b/docs/GIT-WORKFLOW.md @@ -0,0 +1,48 @@ +# 本地Git与持续提交 + +本产品独立仓库:`D:/Ai-project/REA逆向/Agent-Workbench`。分支:`main`。基线提交:`bac87da`;标签:`v1.0.0-baseline`。Git仅覆盖本产品;其他目录中的研究目标和其他项目保持独立。 + +## 作者与远端 + +当前未配置全局Git作者。本仓库使用项目开发身份`Agent Workbench Dev `,只设置仓库本地配置;该邮箱是本地占位身份。用户可随时替换为自己的提交署名。全局Git配置保持原状,当前未设置远端。 + +本地提交用于保存进展和检查点,不等于异地备份;远端仓库/推送以后按用户明确指令配置。 + +## 每次开发的小步流程 + +1. 读取目标与当前Git状态,明确本次文件和验收。 +2. 做一个能独立解释、验证和回滚的改动。 +3. 做相关检查:文档用diff/链接/JSON检查;代码运行适当构建与行为验证;界面或异常恢复改动另做相关场景。 +4. 查看diff,确认文件范围、研究引用与验收结果。 +5. 只暂存本次范围的文件并本地提交;未完成实验以明确名称保存在实验分支或检查点中。 +6. 输出提交ID、结果和剩余工作。没有文件变化的只读研究不制造空提交。 + +```powershell +git status --short +git diff --check +git diff --stat +git add -- docs/PRODUCT-PLAN.md docs/CAPABILITIES.md +git diff --cached --check +git commit -m 'docs: refine verified capability plan' +``` + +代码的相关检查按修改范围执行,例如: + +```powershell +npm.cmd run build +npm.cmd test +``` + +UI和模型fixture验证用独立数据/服务,沿用已有验证器的演示/无Key要求。不得为本地提交重启当前仅在内存中保存Key的正式服务。 + +## 实验与用户工程 + +工作台自身的代码开发和产品内置用户工程Git是两个层面。内置Git能力将包括仓库识别、dirty状态、基线、独立任务worktree、diff、审查后合并/提交和交付引用。 + +需要独立实验时,先记录当前基线,再创建具体任务分支/worktree。合并前检查结果与冲突,保留原工作区已有改动。恢复不能使用破坏性reset/clean来替代状态核对。 + +## 归档规则 + +源码、契约、测试、自有兼容fixture、小型来源索引和验证文档入Git。node_modules、构建目录、.qa、releases、.env/Key文件、运行数据和大体积原始工件由.gitignore排除。旧版自有fixture保留原字节,支持独立升级测试。 + +研究目标的版本、hash、来源和许可声明可以保存为登记记录;第三方完整发行包/个人会话/登录信息不混入本产品代码仓库。 diff --git a/docs/PRODUCT-PLAN.md b/docs/PRODUCT-PLAN.md new file mode 100644 index 00000000..1d10930a --- /dev/null +++ b/docs/PRODUCT-PLAN.md @@ -0,0 +1,151 @@ +# Agent Workbench 后续产品与执行开发方案 + +日期:2026-10-29。状态:规划版本;当前软件为1.0.0基础版本。本文中的后续能力与验收目标均为待实施项。 + +## 1. 产品目标 + +建立由我们掌握源码、可接用户选择的大模型、在本地持续完成真实工程任务的AI编程与能力研究工作台。研究Codex、Claude Code、Cursor、DeepSeek Harness、WorkBuddy的有价值机制,用REA取得可追溯证据,将机制独立开发成工作台内置能力;DSH-purge作为明确版本和作用范围的研究及增强策略候选。 + +项目范围仅包含本工作台及其核心代理能力。研究目标的源码、安装目录和发行工件仍是各自独立资源,工作台保存来源及结论,并通过明确接口集成。 + +产品的最终交付单位是一个完成的工程任务:明确需求与验收条件、项目基线、实际代码变化、测试与修复记录、可审查diff、Git提交和交付说明。基础工具测试与界面通过,不能单独证明已经具备这一能力。 + +## 2. 几个概念的分工 + +| 层 | 负责什么 | 本项目的建设方式 | +| --- | --- | --- | +| 大模型 | 理解、推理、提出代码和工具调用 | ModelProvider接入用户选择的服务,验证工具协议/上下文/流式/用量能力 | +| 自有Harness | 把模型组织成能完成任务的执行系统 | 自己实现规划、工具、上下文、记忆、权限、验证、恢复和预算 | +| REA | 分析发行工件、资源和运行证据 | 作为专用研究工具适配器,分析有独立job生命周期,结果保留工件身份与Evidence | +| 外部引擎 | 整个代理运行时,例如Codex app-server、DeepSeek Harness SDK | EngineAdapter接入;与纯模型API分别管理,不能混用返回格式和执行权限 | +| DSH-purge | DeepSeek Harness插件:提示注入、pre-step hooks及相关执行策略 | 锁定兼容组合,先做对照实验,再决定可集成策略;源码声称和实际提升分开记录 | +| 桌面/手机 | 用户输入、观察、审查和授权 | 共用任务/事件/工件契约;代码、Git、终端、REA由执行宿主完成 | + +可以把Harness理解为负责组织工程的执行流程:记住用户要做什么,找到相关代码,调用工具,核对修改和测试,出错后修复,最后交付可运行结果。研究这些客户端的重点,是把这样的具体流程开发成我们自己的能力。 + +Purge的源码机制不证明模型权重或工程成功率已经提升。增强效果以同模型、同任务、同预算的实际工程结果判断。模型策略可以影响建议与调用,但自有执行内核保留对项目读写、命令、任务归属和预算的最终控制。 + +## 3. 当前基础与关键缺口 + +现有基础:React工作台、兼容模型连接、6个固定工具、单文件提案及基线检查、逐条命令确认、中文UTF-8、分类错误、会话保存/恢复、诊断和浏览器重连。34项行为测试、19组UI及真实模型原会话诊断已通过。 + +当前边界:JSON整段会话存储,active/waiters仍在内存;没有独立任务图、工程索引、长期项目记忆、精确patch、多文件ChangeSet、结构化测试修复、用户工程Git/worktree、REA/MCP工具注册、多worker或桌面壳。模型为一个全局连接且stream:false。 + +本次已为工作台源码建立本地Git,基线提交为`bac87da`,标签`v1.0.0-baseline`。这是开发仓库的版本管理;让用户在工作台中管理其工程的Git,是后续独立能力。 + +能力逐项对照见 [CAPABILITIES.md](CAPABILITIES.md)。研究身份、来源和问题见 [RESEARCH-ROADMAP.md](RESEARCH-ROADMAP.md)。 + +## 4. 建议架构:一套执行核心,多种入口 + +```mermaid +flowchart TB + Desktop[Windows桌面:编辑、终端、审查] --> Gateway[统一网关:任务、事件、设备身份] + Mobile[移动端:任务、进度、审查] --> Gateway + Gateway --> Core[自有Harness:规划、上下文、执行、验证、恢复] + Core --> Models[ModelProvider:用户选择的大模型] + Core --> Workspace[工作区:Git、patch、测试、交付] + Core --> Research[研究工具:REA、Evidence、长任务] + Core --> Engines[可选EngineAdapter:Codex、DeepSeek Harness等] + Core --> Storage[SQLite事件与状态 + 工件文件 + 项目记忆] +``` + +建议逐步拆出以下模块,保持现有界面与文件/命令验证能力可复用: + +```text +src/shared/contracts/ Task、Run、Step、ToolInvocation、Event、Artifact、ChangeSet +src/core/storage/ JSON导入、SQLite、事件/outbox与迁移 +src/core/tasks/ 计划图、调度、检查点、预算与取消 +src/core/context/ 工程索引、项目记忆、上下文组装与来源 +src/core/models/ 模型能力探测、流式协议、请求策略与用量 +src/core/tools/ 工具注册、执行策略、终端、测试、REA/MCP +src/core/workspaces/ Git、worktree、patch、多文件变更与合并 +src/core/engines/ Codex/DeepSeek等整代理运行时适配 +src/core/artifacts/ 日志、测试报告、证据、diff与交付记录 +src/core/evaluation/ 真实任务基准、独立验收、同题对照与质量记录 +src/gateway/ 本机接口、配对设备、游标补发 +apps/desktop/ Electron桌面宿主与客户端 +apps/mobile/ PWA伴随端;之后评估React Native/Expo +research/ 来源登记、研究问题与小型脱敏结论 +``` + +核心契约: + +- Task固定用户目标、约束和验收标准;Run保存本轮工作区、模型配置版本、预算、执行提供方和检查点。 +- Step表达依赖、产物、前置条件与实际完成标准;ToolInvocation有稳定身份、输入校验、作用范围、状态、审批、取消与恢复策略。 +- 事件按单调seq追加,数据库事务保存状态、事件和outbox;大输出保存为工件,事件携带引用。 +- ChangeSet绑定项目和Git基线,包含多个patch及文件操作;验证和审查后才合并到目标工作区。 +- ModelProvider只处理推理协议;EngineAdapter处理外部代理运行时。两者分别报告能力与限制。 +- 记忆条目包含来源、时间、项目/commit身份和验证状态;代码变化后重检失效事实。 + +## 5. 后续执行阶段与闸门 + +每个阶段都交付可演示功能、来源记录、验证结果和本地Git提交。阶段顺序表示依赖,不表示已实现;发布时间在工作量验证后再确定。 + +| 阶段 | 重点与交付 | 进入下一阶段的验收 | +| --- | --- | --- | +| M0:规划与工程基线 | 本地Git、目标登记、能力矩阵、开发规范、研究问题;本轮交付 | 1.0.0基线可追溯,规划与源码状态分开,其他项目不进入仓库 | +| M1:可靠内核 | Task/Run/Step/Tool契约、SQLite迁移、事件游标、模型配置快照、工件、预算;先建真实任务基准集 | 旧数据副本迁移可回退;10个崩溃/停止切点状态明确;过期审批不能作用到新Run;重试不重放已完成工具 | +| M2:真实工程闭环 | 项目识别/增量索引、上下文、计划、patch/ChangeSet、Git/worktree、TestRunner、有限轮修复、交付报告 | 三类受控工程中各两个完整任务可执行;包含跨4文件修改、真实测试失败后修复、可审查diff和提交;保留原工作区改动 | +| M3:REA与模型/引擎适配 | REA研究job与Evidence浏览;Codex协议适配、DeepSeek SDK版本适配;Purge对照实验与能力探测 | 同一工件身份可追溯;长分析可观察/停止;引擎事件不串项目;受限协议不被标成完整能力;增强收益有同题证据 | +| M4:长任务与多worker | 项目长期记忆、压缩/恢复、任务重规划、受限并发、独立worktree、检查与合并 | 长任务重启后保留目标/已完成结果;两个独立worker可合并;重叠修改检测;父任务停止传播到所属进程与worker | +| M5:桌面与移动伴随端 | Electron Windows安装包、后台宿主、项目/终端/成果区;设备配对网关;PWA手机入口 | 桌面关闭后任务仍可管理;手机与桌面查看同一Run;断线按seq补发,重复审批/执行被拒绝;设备可撤销 | +| M6:专业交付质量 | 封存工程验收集、回归、成本/人工介入统计、迁移、更新、日志导出与交付体验 | 每项正式能力有真实任务证据;用实际完成率、费用和失败分类评价提升;发布清单和回滚方案完整 | + +### 首批M2真实任务样本 + +1. Node/TypeScript:给服务新增一个有输入校验的接口,并保留现有接口行为。 +2. Node/TypeScript:修复跨模块异常,增加能复现问题的行为检查并运行。 +3. React:新增一个跨组件的完整交互,验证请求/状态/错误行为。 +4. React:修复竞态或数据归属问题,并验证刷新/切换后的结果。 +5. Python:修改一个处理流程,增加边界样本并运行测试。 +6. Python:完成一次多文件整理,同时保留对外行为与项目说明。 + +每个样本固定基线commit、任务描述、预算、可用工具、独立验收与允许的人工介入。完成定义同时要求需求、实际测试结果和审查通过。零测试、命令失败、检查取消、模型声称完成都不能记为测试通过。 + +首批之后建立20个封存工程任务,用相同模型/预算独立重复运行至少3次。M6完整任务成功率暂定不低于80%,先测量基线、再校准门槛并记录理由;具体口径见能力矩阵。增强实验记录任务完成率、实际测试通过率、错误修改、人工介入、耗时、调用费用及恢复表现。确定性的项目归属、授权和历史保留契约要求全通过。 + +## 6. 桌面端与移动端方案 + +### 桌面:先Windows Electron + +复用React和Node核心,先交付Windows x64。桌面宿主负责本地项目、Git、终端、模型连接、后台任务和REA工具进程;renderer通过受控IPC/API访问核心。加入工程选择、diff/成果浏览、任务通知、启动/停止与恢复体验。 + +UI窗口与执行宿主分开。凭据由用户主动配置,并以宿主内存/后续系统凭据存储管理;规划和Git不读取已有第三方登录信息。现有1.0.0内存连接保持原状,后续迁移采用明确的数据与凭据生命周期。 + +Tauri列为后续对照选项:比较Rust/Node侧车、REA引擎兼容、实际包体与维护成本后再决定。macOS/Linux在执行适配和分析引擎支持矩阵建立后拓展。 + +### 手机:先PWA,再按需求做原生 + +首版手机端负责发送/追加任务、进度、日志与证据摘要、diff审查、确认操作和接收结果。工程、终端、Git、测试和REA在电脑或后续私有执行宿主运行。 + +手机的127.0.0.1是手机本身;当前只绑定127.0.0.1的工作台不能直接从手机连接。增加独立配对网关、设备身份/范围/撤销、可靠事件游标和经验证的网络通道,模型凭据留在执行宿主。电脑和手机使用同一Task/Run/Artifact,不另造一套任务状态。 + +PWA完成上述闭环后,再依据通知、后台体验和系统集成需求评估React Native/Expo。手机断线/切后台时保存游标与视图,恢复后补发事件,避免再次执行历史操作。 + +## 7. REA、外部引擎与Purge的集成要求 + +REA是专用长任务工具,产品设计采用清单、分析、追踪、Evidence查看等分层入口;这些是工作台操作层,不保证对应同名REA工具。适配时核对binary_session及tool_availability,再映射实际工具。工件选择、版本/hash、provider、超时/取消、Evidence和观测/推断/未知都成为产品可见记录。工具能力从当前服务探测,不能把技能文档中的数量当成运行时全部可用能力。 + +Codex优先使用官方app-server本地stdio接口;官方文档把WebSocket标为实验性。移动端使用自己的稳定网关。 + +DeepSeek SDK使用独立EngineAdapter:stdio JSON-RPC、具名profile和版本对应协议。其当前无单会话cancel/session-close、无有效协议版本协商,审批请求目前未由服务端发出;通知覆盖runtime会话树,run()的root idle区间也不等于单提示任务完成。适配器必须记录这些限制,按Task/Run隔离事件和进程,使用session/wait核对后代及汇总,不能将事件流标成逐token流。 + +初期需要独立取消的任务使用独立runtime所有权;恢复保留session id和持久目录,外部进程结果另行核对。外部引擎若没有可验证的细粒度授权入口,写入执行能力须由受控工具profile/实际执行环境证明后才开放。 + +DSH-purge分别登记1.1.78独立包和Desktop内置1.1.81;两者均宣称适配0.2.1-rc.2,不能自动混用。提示/重试策略与宿主策略旁路分别评测,工程权限不交给实验提示决定。默认正式配置由重复工程验收结果决定。 + +Purge的包声明Apache-2.0,另有商业许可联系说明;Harness声明MIT。保留各自声明和来源,产品捆绑分发条件列为待厘清事项,当前先规划接口与版本适配。 + +## 8. Git与持续开发规则 + +工作台源码已在本目录建立独立Git:main分支、1.0.0基线和本地标签。源码、文档、测试与小型研究结论进入仓库;凭据、依赖、构建输出、运行数据、发行包与原始抓包/大工件按.gitignore分开。 + +后续每个独立可审查的小步通过相关检查后本地提交;实验使用独立分支/worktree,提交包含问题、行为变化和验证。当前没有远端,推送/发布按用户明确指令执行。具体见 [GIT-WORKFLOW.md](GIT-WORKFLOW.md) 与 [AGENTS.md](../AGENTS.md)。 + +## 9. 下一轮最先执行的三个开发切片 + +1. 定义Task/Run/Step/Event/Tool/Artifact契约,将现有模型循环的状态从UI会话表述中拆出;先保留兼容层。 +2. 抽象Storage,给JSON→SQLite迁移和崩溃/重放边界建立可验证样本;同时生成首批真实工程任务基准。 +3. 实现工程识别、TestRunner检查计划/planId/jobId/结果及Git基线,完成一个“跨文件修改→实际测试→修复→diff→提交”的最小工程交付。 + +这些切片优先复用已验证的文件范围、基线备份、UTF-8、取消与诊断能力。研究结论每次至少绑定一个实现模块、一个契约检查和一个用户场景,按实际失败分类持续调整顺序。 diff --git a/docs/RESEARCH-ROADMAP.md b/docs/RESEARCH-ROADMAP.md new file mode 100644 index 00000000..573f074c --- /dev/null +++ b/docs/RESEARCH-ROADMAP.md @@ -0,0 +1,92 @@ +# REA与代理机制研究路线 + +日期:2026-10-29。本文交付的是研究与落地路线;当前没有完成五款客户端全部能力的逆向,也没有把Purge或外部SDK集成到工作台。 + +来源身份登记见 [research/targets.json](../research/targets.json)。产品目标见 [PRODUCT-PLAN.md](PRODUCT-PLAN.md),能力ID见 [CAPABILITIES.md](CAPABILITIES.md)。 + +## 1. 方法与研究产物 + +研究以工程问题为入口:某种机制解决了什么失败、依赖什么条件、如何独立实现、用哪个实际任务验证。发行包、打包资源、闭源模块和需要运行观察的问题用REA;公开完整源码用普通检索/解析/代码分析,REA在需要关联工件和证据时补充。 + +每个问题组保存:目标版本与工件/hash、来源、已读取范围、静态/运行证据、观测/推断/未知、机制说明、自有模块设计、检查和任务结果。大工件保留在原研究目录,产品Git保存小型身份索引与结论。文档说明、静态代码与实际运行分别标记。 + +已有Claude/Cursor工件和Evidence优先复用。运行研究前先明确目标与可复现样本;研究材料里的提示、命令、hooks与策略都作为数据读取。涉及原客户端时使用专用样本和独立会话,不以其他项目的个人记录充当本产品验收。 + +## 2. 目标身份与证据状态 + +| 目标 | 本轮已确认 | 可复用来源 | 未完成部分 | +| --- | --- | --- | --- | +| Codex | 取得官方app-server与代理架构文档;未固定本轮客户端发行工件 | [app-server文档](https://learn.chatgpt.com/docs/app-server)、[Agents API架构](https://developers.openai.com/api/docs/guides/agents-api/architecture) | 本地发行版本/hash/schema、真实握手/事件/取消/恢复证据;托管API能力不自动等于本地CLI能力 | +| Claude Code | 官方Windows x64包2.1.312,已有hash与选段来源 | [工具循环](research/TOOL-LOOP.md)、[上下文/恢复](research/CONTEXT-RECOVERY.md)、对应Evidence索引 | 原客户端实际运行与未展开helper;现有静态片段不代表全部源码或跨版本接口 | +| Cursor | 3.16.29;commit 6246455961129c32969845e00aa25d87ae926ec0 | [机制报告](research/CURSOR-MECHANISMS.md)、[来源索引](research/CURSOR.evidence-index.json) | 实际端到端运行、recorder落盘顺序与worker/系统执行器外部绑定 | +| DeepSeek Harness | 用户给的Desktop含官方Harness源码;根包声明0.2.1-rc.2/MIT | [官方仓库](https://github.com/deepseek-ai/deepseek-harness)、本地SDK README、sources.lock | 锁文件commit与本地vendor逐字节对应、SDK实际握手与工程行为、版本组合运行检查 | +| WorkBuddy | 取得官方功能/MCP文档;REA文档有客户端接入说明 | [官方概览](https://www.workbuddy.cn/docs/workbuddy/Overview)、[MCP指南](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/MCP-Guide) | 尚无本轮固定版本安装包/hash和运行证据;文档所述并行/任务/成果不能当作已逆向机制 | +| DSH-purge | 独立包1.1.78与Desktop内置1.1.81确认为不同目标;源码有提示/hooks、补丁和续跑机制 | [上游](https://github.com/YuJunZhiXue/dsh-purge)、用户指定两目录 | 兼容组合实测、补丁是否生效、真实工程收益、捆绑分发条件厘清 | + +本轮元数据散列只是对应文件身份;sources.lock中的上游commit和归档hash是声明,尚未验证整个快照。记录中保留这一差别。 + +## 3. 独立问题组及落地验收 + +| 问题组 | 研究问题 | 所需证据 | 拟落地能力 / 验收 | +| --- | --- | --- | --- | +| CX-1 Codex工程闭环 | 任务/turn如何追加与停止,工作区/工具/验证如何组织,完成与交付依据是什么 | 版本schema、受控任务事件、真实工具结果与工作区记录 | C01/C09/C12:追加需求保留目标;跨文件任务在隔离工作区实际检查并交付 | +| CX-2 Codex协议 | app-server握手、thread start/resume/fork、turn start/steer/interrupt、item事件与审批怎样对应 | 发行版本/hash、生成协议、脱敏JSONL与故障/恢复样本 | C14/C19/C23:EngineAdapter版本验证、事件映射、取消与恢复;独立于ModelProvider | +| CC-1 Claude工具执行 | 参数校验、权限结果、并发独占屏障、输入改写与MCP/hooks错误如何处理 | 复用已映射的静态选段;关键未知helper按问题补读;必要受控运行 | C06/C07/C16:错误输入/过期授权、独占写入、并行读取和停止传播 | +| CC-2 Claude上下文恢复 | 压缩预算与失败保护、消息链、未配对调用、任务目标和恢复元数据如何保持 | 现有32处来源;压缩前后/恢复失败受控样本 | C02/C04/C05/C15:压缩不丢验收/未完成项;已完成工具保留;项目事实失效可重检 | +| CU-1 Cursor工具与状态 | 动态工具集、契约存在/缺失、started/completed/错误事件与pending恢复如何关联 | 现有19处机制索引;recorder与执行器补读;运行事件/实际副作用核对 | C02/C04/C06/C07:稳定调用身份;开始标记与真实执行分开;恢复不串结果 | +| CU-2 Cursor工程编辑 | patch生成与磁盘写入如何衔接、引用/上下文如何定位工程改动、界面验证怎样回馈 | 原工件patch/编辑/检索的限定链路与受控工作区差异 | C03/C08/C20:精确跨文件patch、冲突检测、真实React交互验收 | +| CU-3 Cursor worker | 进程身份验证、daemon复用/重建、并行工作区与清理范围是什么 | 现有worker静态选段;独立样本中的生命周期与冲突记录 | C09/C10/C16:worker所有权、独立worktree、按任务取消与合并 | +| DS-1 DeepSeek SDK与运行时 | prompt/resume/wait语义、会话树事件、进程/持久目录/工具profile如何对应 | 本地源码与README、版本/profile快照、stdio握手与受控会话记录 | C02/C14/C19/C23:按Run隔离runtime、等待后代/汇总、能力限制与失联结果可见 | +| DS-2 DeepSeek规划与持久化 | 任务计划、子代理、上下文/预算、事件提交和恢复怎样协作 | 源码入口→状态变化→持久层的限定链路;崩溃/子任务样本 | C01/C02/C05/C15/C16:持久计划、预算归属、父子任务停止与恢复 | +| DS-3 Developer Kit工程检查 | 工程识别、检查计划、planId/jobId、报告与审查入口如何建立真实证据 | 本地developer-kit源码、计划/执行协议与实际退出码/测试报告 | C03/C09/C10/C11/C12:先计划再精确执行;拒绝/失败/零测试不记通过;实际读diff审查 | +| WB-1 WorkBuddy任务交付 | 项目资料、规划/并行、Skills与连接器、成果区如何让任务到达可验收结果 | 先官方文档;固定发行工件后按REA入口追踪;受控真实任务 | C01/C05/C13/C16/C20:资料有来源、任务状态/成果绑定、可启动可验证的交付 | +| WB-2 WorkBuddy MCP | 项目/用户配置、发现/安装/失联与工具范围如何处理 | 官方MCP文档、REA接入说明;以后固定客户端配置解析与调用样本 | C06:按项目隔离工具配置;schema/失联错误有调用身份,不依赖猜测接口 | +| PG-1 Purge | 提示、pre-step、重试续跑与策略/程序补丁各自改变了什么,收益和失败在哪 | 两版本源码、兼容锁、插件生效日志;同题A/B结果与失败分类 | C18:独立开关/回退;有效机制按自有接口落地;工程控制仍由执行内核负责 | + +## 4. 已核对的接入限制 + +### Codex + +官方app-server文档描述默认stdio JSONL/JSON-RPC wire及thread/turn/item生命周期,可作为专用引擎适配入口。具体字段、审批与实验功能以固定版本生成schema和实际握手为准。官方将WebSocket标为experimental/unsupported;手机连接走本产品网关。官方托管Agents API架构只用于对照设计,不标为当前本地Codex已实测能力。 + +### DeepSeek Harness与Desktop + +用户提供的 `D:/Ai-project/DeepSeek-Harness-Desktop` 是一个独立的Desktop集成源码目录,根包0.1.1,vendor中包含官方Harness 0.2.1-rc.2。不是当前Agent Workbench的桌面壳。 + +本地来源: + +- [sources.lock.json](D:/Ai-project/DeepSeek-Harness-Desktop/integration/sources.lock.json):声明Harness commit `687f282e8625c6b8d11ff58211a90524be2e4317`,Purge commit `160b9114cbad7beca3d4d3f9f027ec843bf46f5e`。 +- [compatibility.json](D:/Ai-project/DeepSeek-Harness-Desktop/integration/compatibility.json):只登记Harness 0.2.1-rc.2 + Purge 1.1.81,未承诺rc.3+;仍需本地构建与运行检查。 +- [CLI README](D:/Ai-project/DeepSeek-Harness-Desktop/deepseek-harness/apps/cli/README.md):具名 `dsh --profile sdk` / `sdk-minimal`,stdio JSON-RPC服务。 +- [SDK协议](D:/Ai-project/DeepSeek-Harness-Desktop/deepseek-harness/packages/sdk/protocol/README.md:120):无有效协议版本协商、无cancel/session-close;服务端当前不发送审批请求。 +- [SDK客户端](D:/Ai-project/DeepSeek-Harness-Desktop/deepseek-harness/packages/sdk/client/README.md:52):`run()`返回一个接纳回执至下一次root idle的活动区间;`finalResponse`不是单条提示的因果结果。用 `session/wait` 核对后代与汇总。 +- [Developer Kit](D:/Ai-project/DeepSeek-Harness-Desktop/integration/developer-kit/README.md):本地衍生0.1.0/MIT,`dev_project/dev_checks/dev_review` 可作为工程识别/检查/审查机制的源码参考,尚未内置工作台。 + +SDK通知覆盖runtime会话树,不是逐token流。`sdk-minimal`默认缺部分编辑/skills/MCP/subagents能力,并使用danger-full-access;其名字和预设不能替代本产品的能力/操作范围验证。恢复依赖session id与持久目录,外部子进程不能仅靠会话恢复而认为继续运行。需要独立取消时先采用独立runtime所有权,关闭进程的影响必须匹配所属任务。 + +### DSH-purge + +- [独立源码元数据](D:/Ai-project/REA逆向/dsh-purge-1.1.78-windows/source/upstream/package.json):1.1.78;local/upstream元数据散列相同,不代表全部源码相同。 +- [Desktop插件元数据](D:/Ai-project/DeepSeek-Harness-Desktop/plugins/dsh-purge/package.json):1.1.81。两个版本分别作为研究目标,不能直接替换或混用。 +- [独立插件index.js](D:/Ai-project/REA逆向/dsh-purge-1.1.78-windows/source/upstream/lib/index.js:385):系统提示注册;同文件484处有 `agent/pre-step` prepend hook。相关补丁和默认有限续跑重试是源码机制,尚未运行验证其生效。 +- Harness声明MIT;Purge包声明Apache-2.0,另有 [商业许可说明](D:/Ai-project/REA逆向/dsh-purge-1.1.78-windows/source/upstream/LICENSE-COMMERCIAL.md)。两种声明均保留,捆绑分发条件待厘清,不替作者作许可结论。 + +Purge对提示和执行约束的影响,不证明改变了模型权重或提升工程推理能力。分别测提示/续跑策略与执行策略干预;正式配置的采纳依据是实际收益、错误修改和可回退性。 + +## 5. 研究与开发的执行顺序 + +1. **M0登记与复用**:本轮固定来源、现有证据与未知,建Git基线、能力矩阵和本路线。该阶段完成不表示客户端逆向已全部完成。 +2. **M1可靠内核**:优先CC-1/CC-2、CU-1、DS-1/DS-2和CX-2中与任务身份/恢复相关的问题;同时建立工程任务基准。每个结论绑定一个契约或设计决策。 +3. **M2工程闭环**:集中CU-2/CU-3、DS-3、CX-1,完成工程识别→patch→测试/修复→Git交付。研究在具体失败处深入,避免只增加报告。 +4. **M3工具与适配实验**:固定Codex/WorkBuddy工件,补REA和两个EngineAdapter;用锁定组合做PG-1对照。先展示真实限制,再决定开放能力。 +5. **M4–M6扩展交付**:把压缩/记忆、并行worker、成果区和实际UI验证融入长任务;桌面/手机复用同一执行核心;通过封存任务和发布迁移检查。 + +每轮产物为 `研究问题 → Evidence/源码来源 → 自有模块 → 契约结果 → 工程任务 → commit`。阶段、失败或新版本变化写入研究记录,并及时做本地Git提交。 + +## 6. Purge与增强策略对照方案 + +固定一个模型/服务、提示目标、项目基线、工具权限、预算、环境和验收;记录Harness版本、Purge版本、profile、应用补丁的身份以及实际生效证据。 + +先比较不加载Purge的基线与锁定Purge组合;对于可分离策略再做单因素对照,不能把增加重试次数、模型切换或人工补写混进“增强效果”。任务成功率、真实测试、错误改动、人工介入、时间/usage/费用和恢复分别统计,每组至少重复3次。异常归类为模型、上下文、工具、状态恢复、项目假设或插件兼容等实际原因。 + +有稳定收益的策略进入自有接口验证;没有收益、收益依赖无法控制的执行行为或无法可靠恢复时,保留研究结论并调整方案。适配升级必须重跑相应契约与同题检查,不使用Purge的名称替代证据。 diff --git a/findings.md b/findings.md index 68c6395b..3a4ece9a 100644 --- a/findings.md +++ b/findings.md @@ -5,8 +5,17 @@ - 用户确认本项目独立研究编程代理核心能力,其他项目不纳入后续计划。 - 用户要求研究Codex、Claude Code、Cursor、DeepSeek Harness、WorkBuddy,通过REA取证及DSH-purge研究将有效机制内置工作台,并规划桌面/移动和本地Git。 - 当前源代码仍为6个固定工具、JSON会话、内存active/waiters、stream:false;真正的任务计划图、测试修复循环、Git/worktree、工程索引、长期记忆、REA/MCP执行尚待实现。 -- 指定的DSH目录upstream/local初步均为1.1.78、Apache-2.0、目标Harness 0.2.1-rc.2;DeepSeek-Harness-Desktop为独立候选桌面源码(集成0.1.1,Harness 0.2.1-rc.2、另含purge1.1.81),正在核对源码和官方身份,不能混用版本或把它的功能算作本产品已实现。 -- 本产品尚无Git仓库;全局Git作者未配置。根目录构建忽略规则需要保留tests/fixtures中的自有旧版工件。 +- 指定DSH目录的upstream/local元数据均为1.1.78、Apache-2.0、目标Harness 0.2.1-rc.2;DeepSeek-Harness-Desktop为独立集成源码(0.1.1,内含官方Harness源码0.2.1-rc.2、purge1.1.81)。本轮已核对元数据、SDK文档和锁文件声明,全快照身份/运行兼容仍待验证,功能未内置本产品。 +- 本轮开始时本产品尚无Git仓库,全局Git作者未配置;已调整根目录构建忽略规则,保留tests/fixtures中的自有旧版工件,随后建立独立Git基线。 +- 本地Git已建立,main基线bac87da,标签v1.0.0-baseline;167个源码/文档/自有fixture文件进入基线,依赖、QA、构建、发行包未进入仓库,全局作者配置保持原状。 +- Codex与WorkBuddy已取得官方文档;Claude/Cursor已有版本固定的静态证据。DeepSeek本地Desktop声明基于官方Harness,sources.lock记录commit但本轮未逐字节验证快照。 +- DSH-purge源码注册系统提示和agent/pre-step prepend hook,另含执行策略/程序补丁/重试。插件声明不能证明权重或工程成功率提升;包声明Apache-2.0,商业许可文件另有联系要求,保留声明并列分发条件待厘清。 +- SDK协议README已直接核对:无单会话cancel/session-close、无有效协议协商、服务端当前不发送审批请求;事件归属与停止/恢复须由自有内核和版本适配承担。 +- 续接时复核:本地Git在main、基线bac87da,产品源码未改;随后补齐能力矩阵、研究路线与来源登记,通过检查并保存规划提交。现有运行服务和模型连接未因规划重启。 +- 本轮复算仅元数据文件SHA256:独立Purge两个package.json相同;Desktop的sources.lock与compatibility是已读取的声明,不代表整个vendor快照已与上游commit逐字节对应。 +- 桌面采用Electron Windows优先、手机采用PWA伴随端;任务状态与执行宿主共享,移动端接入依赖未来配对网关和事件补发,当前响应式页面不等于远程移动产品。 +- 产品方案和24项能力矩阵已写入:先可靠状态/事件与真实基准,再工程索引/patch/Git/测试修复,之后REA/引擎/Purge、长任务/worker、桌面/手机及专业交付质量。 +- research/targets.json分别记录官方文档、既有静态工件、源码元数据/锁文件声明和待实测状态;Codex/WorkBuddy新发行工件、DeepSeek全快照身份和Purge收益仍属于后续研究。 ## 产品组合 Claude Code 报告已验证工具输入校验、权限决定、队列并发屏障、受限 MCP 重试、压缩防护及会话链修复;Cursor 报告已验证能力契约、started/completed、取消/恢复、patch 和 worker 复用。产品采用稳定调用 ID、命令逐次确认、基线差异审核和重启不重放的独立实现。 diff --git a/progress.md b/progress.md index 9370eb2e..8bb85167 100644 --- a/progress.md +++ b/progress.md @@ -48,3 +48,15 @@ - 源码包独立解压验证完成:离线依赖安装、完整构建、34/34测试通过,0失败/跳过;真实旧版升级fixture不依赖原发行目录。 - 便携包最终闭环再次通过;CRC、清单、大小/SHA256和归档目录一致性通过。当前原服务1.0.0、PID23080、兼容模型Key状态保留;仅4318仍监听。 - 1.0.0开发、诊断修复、真实模型/浏览器、文档、便携与源码交付验收完成。最终归档只补入验证文档与截图,代码/构建产物将与独立验证包逐字节复核。 + +## 2026-10-29 后续核心能力规划与本地Git + +- 用户确定本项目专注编程代理能力,要求先规划REA/Purge与五款客户端研究、真实工程交付、桌面/手机及及时本地提交。 +- 核对用户提供的独立Purge1.1.78和DeepSeek-Harness-Desktop0.1.1;后者含Harness0.2.1-rc.2、Purge1.1.81和本地Developer Kit0.1.0。版本/commit声明、元数据散列和待实测范围分别记录。 +- 复用Claude Code2.1.312与Cursor3.16.29静态证据,取得Codex/WorkBuddy官方文档,核对DeepSeek SDK的事件/停止/恢复限制。所用内部问题分工已返回,产品由本对话统一整理。 +- 为本产品建立独立main仓库,基线bac87da、标签v1.0.0-baseline;167个自有文件进入基线,全局作者配置保持原状,仓库使用项目占位署名,未配置远端。 +- 完成PRODUCT-PLAN、24项CAPABILITIES、RESEARCH-ROADMAP、GIT-WORKFLOW、research/targets.json和AGENTS.md,更新README与跟踪文件;进入文档校验和规划提交。 +- 本次只变动文档与来源登记,不改变1.0.0运行代码、发行包或模型连接;后续M1–M6能力仍待开发。 +- 文档/来源校验通过:9份Markdown、44个本地链接、8个目标、24项能力、22个来源/证据路径、8个元数据SHA256;原工件hash仅复用记录,没有将其说成全快照复核。 +- git diff --check通过;4318仍是PID23080。开始只暂存本轮文档与登记范围,保存规划提交;运行源码无变化,不重复此前34项运行测试。 +- 规划提交已完成,收尾状态纳入同一规划提交;最终ID由git log记录。M0规划与工程基线完成,M1–M6开发保持待实施,下一轮先可靠状态和真实工程交付切片。 diff --git a/research/targets.json b/research/targets.json new file mode 100644 index 00000000..5580a0af --- /dev/null +++ b/research/targets.json @@ -0,0 +1,395 @@ +{ + "schemaVersion": 1, + "recordedAt": "2026-10-29", + "product": "Agent Workbench", + "purpose": "Research identity and evidence-state register; planned integrations are not implemented capabilities.", + "digestRules": [ + "Metadata SHA256 values were computed for the named files in this planning round.", + "Reported artifact hashes from existing Claude/Cursor reports were reused; the original artifacts were not rehashed in this round.", + "Upstream commits/archive hashes in the Desktop lock file are declarations, not proof of full local snapshot equivalence.", + "Version values identify the inspected sources; this register makes no latest-version claim." + ], + "targets": [ + { + "id": "codex", + "kind": "coding-agent-runtime", + "repository": "https://github.com/openai/codex", + "fixedArtifactVersion": null, + "evidenceState": "official-documentation-read; local-versioned-artifact-and-runtime-validation-pending", + "sources": [ + { + "url": "https://learn.chatgpt.com/docs/app-server", + "kind": "official-documentation" + }, + { + "url": "https://developers.openai.com/api/docs/guides/agents-api/architecture", + "kind": "official-documentation; hosted Agents API" + }, + { + "url": "https://developers.openai.com/cookbook/examples/agents_sdk/sandboxed-code-migration/sandboxed_code_migration_agent", + "kind": "official-cookbook" + } + ], + "questions": [ + "CX-1", + "CX-2" + ], + "capabilities": [ + "C01", + "C09", + "C12", + "C14", + "C19", + "C23" + ], + "runtimeValidated": false, + "integratedIntoWorkbench": false, + "gaps": [ + "Pin local release/hash and generated app-server schema.", + "Validate stdio lifecycle and approval/cancellation/resume.", + "Hosted Agents API behavior is distinct from local CLI behavior.", + "WebSocket is experimental/unsupported in the inspected documentation." + ] + }, + { + "id": "claude-code", + "kind": "packaged-coding-agent", + "package": "@anthropic-ai/claude-code-win32-x64", + "fixedArtifactVersion": "2.1.312", + "localResearchRoot": "D:/Ai-project/REA逆向/Claude-Code-REA", + "artifact": { + "path": "D:/Ai-project/REA逆向/Claude-Code-REA/artifacts/package-extracted/package/claude.exe", + "sha256": "6099672ebe5dcb518b67d1d32dde1e3360bc6bee1dae7f8d28a69c49acc7c865", + "identityBasis": "existing report; upstream npm integrity and mapped byte evidence" + }, + "evidenceState": "versioned-static-artifact-evidence", + "reports": [ + "docs/research/TOOL-LOOP.md", + "docs/research/CONTEXT-RECOVERY.md" + ], + "evidenceIndexes": [ + "docs/research/TOOL-LOOP.evidence.json", + "docs/research/CONTEXT-RECOVERY.index.json" + ], + "evidenceIds": [ + "ev_78494b2b28703e1547eaa7b660ff70a6a1552991cd3b0e2727954779d74b5434" + ], + "questions": [ + "CC-1", + "CC-2" + ], + "capabilities": [ + "C02", + "C04", + "C05", + "C06", + "C07", + "C15", + "C16" + ], + "runtimeValidated": false, + "integratedAsExternalEngine": false, + "gaps": [ + "Static selected excerpts do not establish whole-application runtime equivalence.", + "Several helper implementations and dynamic bindings remain unknown.", + "Own implementations and their Workbench validation are tracked separately." + ] + }, + { + "id": "cursor", + "kind": "packaged-editor-agent", + "fixedArtifactVersion": "3.16.29", + "declaredCommit": "6246455961129c32969845e00aa25d87ae926ec0", + "localResearchRoot": "D:/Ai-project/REA逆向/investigations/cursor-agent", + "artifacts": [ + { + "path": "C:/Users/wangy/AppData/Local/Programs/cursor/resources/app/extensions/cursor-agent-exec/dist/main.js", + "sha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884", + "identityBasis": "existing versioned static report" + }, + { + "path": "C:/Users/wangy/AppData/Local/Programs/cursor/resources/app/extensions/cursor-agent-worker/dist/main.js", + "sha256": "4255db956ce2f9193f65293dbd3806c60a6fd6571f7020b35cb28c1c5c513b63", + "identityBasis": "existing versioned static report" + } + ], + "evidenceState": "versioned-static-artifact-evidence", + "reports": [ + "docs/research/CURSOR-MECHANISMS.md" + ], + "evidenceIndexes": [ + "docs/research/CURSOR.evidence-index.json" + ], + "evidenceIds": [ + "ev_cebd28a6fee5c6940fee6249054cd080fca28e135e6083a3951c4a0a29d13b51", + "ev_789fa6618de0da72e2fde82f30aedcba8777533a0ed8c36397673fdd3792f7fe", + "ev_df7c229808fe5aa5f80a0f44fbb8c87861c3eb3593ad942d20589ada8853513d" + ], + "questions": [ + "CU-1", + "CU-2", + "CU-3" + ], + "capabilities": [ + "C02", + "C03", + "C04", + "C06", + "C07", + "C08", + "C09", + "C10", + "C16", + "C20" + ], + "runtimeValidated": false, + "integratedAsExternalEngine": false, + "gaps": [ + "Recorder disk ordering and crash guarantees were not validated.", + "Some final executor and worker external bindings remain unknown.", + "Packaged patch generation alone does not prove disk write success." + ] + }, + { + "id": "deepseek-harness", + "kind": "public-source-agent-runtime", + "repository": "https://github.com/deepseek-ai/deepseek-harness", + "localRoot": "D:/Ai-project/DeepSeek-Harness-Desktop/deepseek-harness", + "fixedSourceVersion": "0.2.1-rc.2", + "metadata": { + "path": "D:/Ai-project/DeepSeek-Harness-Desktop/deepseek-harness/package.json", + "name": "@deepseek-ai/dsh-root", + "version": "0.2.1-rc.2", + "licenseDeclaration": "MIT", + "sha256": "12bb41cd8212021a784b33a20c2b84372189a9505b42081d5e3869e21ff5cffc", + "hashScope": "package.json bytes only; not a full source-tree identity" + }, + "declaredCommit": "687f282e8625c6b8d11ff58211a90524be2e4317", + "commitEvidence": "integration/sources.lock.json declaration; full snapshot equality not verified", + "evidenceState": "local-source-and-protocol-documents-read", + "sources": [ + { + "path": "D:/Ai-project/DeepSeek-Harness-Desktop/deepseek-harness/apps/cli/README.md" + }, + { + "path": "D:/Ai-project/DeepSeek-Harness-Desktop/deepseek-harness/packages/sdk/protocol/README.md" + }, + { + "path": "D:/Ai-project/DeepSeek-Harness-Desktop/deepseek-harness/packages/sdk/client/README.md" + } + ], + "profiles": [ + "sdk", + "sdk-minimal" + ], + "questions": [ + "DS-1", + "DS-2", + "DS-3" + ], + "capabilities": [ + "C01", + "C02", + "C03", + "C05", + "C09", + "C10", + "C11", + "C12", + "C14", + "C15", + "C16", + "C19", + "C23" + ], + "runtimeValidatedThisRound": false, + "integratedIntoWorkbench": false, + "gaps": [ + "No effective protocol version negotiation.", + "No cancel/session-close methods; cancellation closes the owned runtime.", + "Server currently sends no approval request.", + "run() idle interval and finalResponse are not single-prompt causal completion.", + "Use session/wait for managed descendants and summaries.", + "Runtime-wide event ownership, profile/tool scope and persistent-session recovery require adapter validation." + ] + }, + { + "id": "deepseek-harness-desktop", + "kind": "separate-local-integration", + "localRoot": "D:/Ai-project/DeepSeek-Harness-Desktop", + "fixedIntegrationVersion": "0.1.1", + "metadata": { + "path": "D:/Ai-project/DeepSeek-Harness-Desktop/package.json", + "name": "deepseek-harness-local-desktop-source", + "version": "0.1.1", + "licenseDeclaration": null, + "sha256": "3bef783fac861dc85f9dd22b37818bc002b0627fc62d7204ac5595227a62473c", + "hashScope": "package.json bytes only; not a full source-tree identity" + }, + "lockMetadata": { + "path": "D:/Ai-project/DeepSeek-Harness-Desktop/integration/sources.lock.json", + "sha256": "492525313e823791fc154bd0a8b8478c484c9b0821913d45095f802a752c5703" + }, + "compatibilityMetadata": { + "path": "D:/Ai-project/DeepSeek-Harness-Desktop/integration/compatibility.json", + "sha256": "f7049003e3fdf3452787625e995999448a6373b6c5beb37f5c824c25b6dbd823" + }, + "declaredCompatiblePair": { + "harness": "0.2.1-rc.2", + "purge": "1.1.81" + }, + "developerKit": { + "metadata": { + "path": "D:/Ai-project/DeepSeek-Harness-Desktop/integration/developer-kit/package.json", + "name": "dsh-developer-kit", + "version": "0.1.0", + "licenseDeclaration": "MIT", + "sha256": "39c9bac7ffefeeaa54ffcd3df713bb0016528fc41aa945ffb114921ea70d949e", + "hashScope": "package.json bytes only; not a full source-tree identity" + }, + "tools": [ + "dev_project", + "dev_checks", + "dev_review" + ], + "integrationStatus": "reference only; not integrated into Workbench" + }, + "isAgentWorkbenchDesktop": false, + "runtimeValidatedThisRound": false, + "gaps": [ + "Desktop lock/compatibility declarations require actual build/runtime and source identity checks.", + "Local integration functionality is separate from Agent Workbench product capabilities." + ] + }, + { + "id": "workbuddy", + "kind": "coding-and-task-client", + "fixedArtifactVersion": null, + "evidenceState": "official-documentation-read; fixed-artifact-pending", + "sources": [ + { + "url": "https://www.workbuddy.cn/docs/workbuddy/Overview", + "kind": "official-documentation" + }, + { + "url": "https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/MCP-Guide", + "kind": "official-documentation" + }, + { + "path": "D:/Ai-project/REA逆向/rea/docs/client-configuration.md", + "kind": "REA client integration documentation" + }, + { + "path": "D:/Ai-project/REA逆向/rea/docs/mcp-contracts.md", + "kind": "REA client contract documentation" + } + ], + "questions": [ + "WB-1", + "WB-2" + ], + "capabilities": [ + "C01", + "C05", + "C06", + "C13", + "C16", + "C20" + ], + "runtimeValidated": false, + "integratedIntoWorkbench": false, + "gaps": [ + "Pin user-selected or official release artifact/version/hash.", + "Documentation features are not reverse-engineered runtime proof." + ] + }, + { + "id": "dsh-purge-standalone", + "kind": "harness-plugin", + "repository": "https://github.com/YuJunZhiXue/dsh-purge", + "localRoot": "D:/Ai-project/REA逆向/dsh-purge-1.1.78-windows", + "fixedSourceVersion": "1.1.78", + "metadata": [ + { + "path": "D:/Ai-project/REA逆向/dsh-purge-1.1.78-windows/source/upstream/package.json", + "name": "dsh-purge", + "version": "1.1.78", + "licenseDeclaration": "Apache-2.0", + "sha256": "c185af0cace16465becbb018d3bf2c2f3cfddd5133e36161b2798bddedf6cab1", + "hashScope": "package.json bytes only; not a full source-tree identity" + }, + { + "path": "D:/Ai-project/REA逆向/dsh-purge-1.1.78-windows/source/local/package.json", + "name": "dsh-purge", + "version": "1.1.78", + "licenseDeclaration": "Apache-2.0", + "sha256": "c185af0cace16465becbb018d3bf2c2f3cfddd5133e36161b2798bddedf6cab1", + "hashScope": "package.json bytes only; not a full source-tree identity" + } + ], + "declaredHarnessTarget": "0.2.1-rc.2", + "evidenceState": "local-source-read", + "sources": [ + { + "path": "D:/Ai-project/REA逆向/dsh-purge-1.1.78-windows/source/upstream/lib/index.js" + }, + { + "path": "D:/Ai-project/REA逆向/dsh-purge-1.1.78-windows/source/upstream/lib/continue-retry.js" + }, + { + "path": "D:/Ai-project/REA逆向/dsh-purge-1.1.78-windows/source/upstream/LICENSE-COMMERCIAL.md" + } + ], + "licenseState": "package declares Apache-2.0; additional commercial-license statement retained; distribution terms unresolved", + "questions": [ + "PG-1" + ], + "capabilities": [ + "C18" + ], + "pluginEffectValidatedThisRound": false, + "engineeringBenefitValidated": false, + "integratedIntoWorkbench": false, + "gaps": [ + "Validate patch/hook activation with exact Harness/profile combination.", + "Compare real engineering outcomes with equal model/task/budget.", + "Equal package.json hashes do not prove equal complete source trees.", + "Not an OpenAI-compatible ModelProvider and not evidence of model-weight changes." + ] + }, + { + "id": "dsh-purge-desktop", + "kind": "harness-plugin", + "repository": "https://github.com/YuJunZhiXue/dsh-purge", + "localRoot": "D:/Ai-project/DeepSeek-Harness-Desktop/plugins/dsh-purge", + "fixedSourceVersion": "1.1.81", + "metadata": { + "path": "D:/Ai-project/DeepSeek-Harness-Desktop/plugins/dsh-purge/package.json", + "name": "dsh-purge", + "version": "1.1.81", + "licenseDeclaration": "Apache-2.0", + "sha256": "40e587aaa4d0d7210dbef8774730c9d43dc408c4e62ca553419f6c4b8770d33f", + "hashScope": "package.json bytes only; not a full source-tree identity" + }, + "declaredCommit": "160b9114cbad7beca3d4d3f9f027ec843bf46f5e", + "commitEvidence": "Desktop sources.lock declaration; full snapshot equality not verified", + "declaredHarnessTarget": "0.2.1-rc.2", + "evidenceState": "local-source-and-compatibility-documents-read", + "licenseState": "package declares Apache-2.0; commercial-license statement also present; distribution terms unresolved", + "questions": [ + "PG-1" + ], + "capabilities": [ + "C18" + ], + "pluginEffectValidatedThisRound": false, + "engineeringBenefitValidated": false, + "integratedIntoWorkbench": false, + "gaps": [ + "Compatibility register excludes automatic assumptions for rc.3+.", + "Do not substitute for standalone 1.1.78 without independent identity/compatibility checks.", + "Validate actual plugin effect and repeat equal-task engineering comparison." + ] + } + ] +} diff --git a/task_plan.md b/task_plan.md index 93d56e73..a9caca18 100644 --- a/task_plan.md +++ b/task_plan.md @@ -35,7 +35,7 @@ - 服务端快照增加 revision,客户端忽略旧会话/文件响应;窄屏需可打开项目、文件、差异与工具轨迹。 - 有意义测试覆盖提案不写盘、冲突、原字节备份、路径范围、命令确认/拒绝/取消、消息配对和重启不重放。 - 首次前端构建的空 CSS import 警告:移除无效 @import 后复验。 -- OpenAI 官方文档访问返回 403;不声称已取得该页面或实测真实 OpenAI 服务。兼容协议将用本地 fixture 验证。 +- 首版开发时OpenAI官方文档直连返回403,该次未取得页面;兼容协议当时用本地fixture验证。本轮规划已通过官方文档工具取得app-server与代理架构资料,仍不声称实测真实OpenAI服务。 - 首轮 20 项测试中 19 项通过;Host 校验测试使用 Node fetch 时请求头被客户端覆写,改用原生 http.get 发送实际自定义 Host 后复验。 - 浏览器首个精确文字定位器把状态中的版本子节点也计入文本,导致超时;改为连接状态选择器,保留 DOM 与截图做真实界面核对。 - 浏览器发现实际问题:新建会话请求未返回就发送,可能重复创建会话。修正为共享创建 promise 与创建期间禁用操作,再跑完整 UI 流程。 @@ -66,7 +66,7 @@ - 独立复现:管道中的“工具”变为“??”;显式 $OutputEncoding=UTF8 后保留中文。 - `fetch failed` 由 Provider.request 直接抛出,未记录底层原因/请求阶段,也没有有限重试。 - Runtime 的系统错误只加入可见 messages,未进入下一轮提供给模型的上下文;projectContext 只有项目清单和提案状态。 -- 本项目没有 .git;使用独立备份和发行目录验证更新,不覆盖旧发行包与用户示例改动。 +- 1.0.0迭代开始时本项目没有 .git;当时使用独立备份和发行目录验证更新,不覆盖旧发行包与用户示例改动。本轮后续规划已建立独立Git,见下方记录。 - Computer Use helper 的 native pipe 不存在;改用持久 Playwright 会话核对同一 4318 服务。Node REPL 需 CommonJS createRequire;Edge 用实测的 Program Files (x86) 绝对路径。 - 新 UI 使用 Array.findLast 超出当前 ES2022 类型库;改为 filter().at(-1),保留现有浏览器支持范围后重新构建。 - 首轮正式版行为测试 30/31 通过;PowerShell ScriptBlock 返回的 $? 不能可靠代表原生命令退出码,改为优先传递 $LASTEXITCODE,并继续验证明确 exit 0 的处理。 @@ -86,11 +86,11 @@ 用户要求先形成后续执行开发方案:以REA和DSH-purge研究Codex、Claude Code、Cursor、DeepSeek Harness、WorkBuddy,将可验证机制独立开发并内置工作台;明确真实工程交付能力、桌面端/移动端及本地Git及时提交。 -1. [in_progress] 核对DSH-purge、DeepSeek Harness和各客户端的身份/版本/现有证据,整理当前能力缺口。 -2. [in_progress] 建立本产品独立Git仓库,保存已验证的1.0.0基线;后续按可审查的小步提交。 -3. [pending] 完成产品目标、能力矩阵、研究问题、模块架构、阶段依赖和真实工程验收方案。 -4. [pending] 确定Windows桌面与移动伴随端方案、共享执行宿主/会话与配对连接设计。 -5. [pending] 将方案、来源和执行规范写入项目,校对状态并提交规划版本,交付具体下一步。 +1. [complete] 核对并登记DSH-purge、DeepSeek Harness和各客户端已有身份/版本/证据,明确尚待固定或运行验证的范围,整理当前能力缺口。 +2. [complete] 建立本产品独立Git仓库,保存已验证的1.0.0基线;后续按可审查的小步提交。 +3. [complete] 完成产品目标、24项能力矩阵、研究问题、模块架构、阶段依赖和真实工程验收方案。 +4. [complete] 确定Electron Windows与PWA移动伴随端方案、共享执行宿主/任务及配对连接设计。 +5. [complete] 方案、来源和执行规范已写入项目,通过链接/JSON/diff检查并保存本地规划提交;完整方案与具体下一步作为本轮交付。 ### 已知范围与待核对 @@ -104,3 +104,7 @@ - Git 2.54.0已安装,产品目录和父工作区均无Git仓库;全局Git作者未配置,采用本仓库临时项目开发身份,保留全局配置。 - 原.gitignore的未锚定dist-server规则会忽略源码测试所需的旧版fixture;改为根目录构建忽略规则,保留该自有兼容工件。 +- 已建立main独立基线bac87da和v1.0.0-baseline标签,167个源码/文档/自有fixture文件进入基线;未配置远端。 +- docs/PRODUCT-PLAN.md、CAPABILITIES.md、RESEARCH-ROADMAP.md、GIT-WORKFLOW.md、research/targets.json及AGENTS.md已写入;M1–M6属于后续实现,没有在本轮规划中改运行源码。 +- 首轮文件清单查询research目录时该目录尚不存在,rg返回1;随后随来源登记创建目录。批量输出曾被工具截断,改为按文件/关键段读取,未将截断结果当完整证据。 +- 规划校验通过:9份Markdown、44个本地链接、8个来源目标、24项能力、22个来源/证据路径和8个元数据散列;git diff --check通过。4318仍由原PID23080监听。