chore: baseline Agent Workbench 1.0.0

This commit is contained in:
Agent Workbench Dev
2026-10-29 11:23:43 +08:00
commit bac87da23e
167 changed files with 30172 additions and 0 deletions
+33
View File
@@ -0,0 +1,33 @@
# 独立产品架构
产品使用本地 Node 服务和 React 工作台。客户端负责项目选择、对话、工具轨迹、差异审核与设置;服务端负责模型连接、工具调用、会话存储和恢复。
## 一次任务
用户消息进入会话后,执行器构造上下文并调用兼容模型服务。模型返回工具调用时,执行器按调用 ID 记录 started 与结果。项目读取和检索直接完成;文件改动先生成带原文 SHA256 的提案;终端命令进入确认状态。结果以 tool_call_id 关联回模型,直到得到最终答复或达到步数限制。
## 改动与权限
提案只保存建议,不修改项目。用户应用改动时重新检查当前文件是否仍与基线一致,原文保存在应用数据目录后再原子替换。读取、检索、提案与应用路径限制在所选项目内,并解析 junction/symlink 的真实位置。
终端命令每次确认后以当前 Windows 用户权限执行;工作目录为所选项目,但这不是操作系统沙箱。界面显示完整命令。停止任务会中止工作台启动的进程树。
## 持久化与恢复
状态与工具事件保存在独立应用数据目录。状态使用临时文件原子替换,并保留备份。服务重启后把仍在运行或等待确认的任务标为暂停;未完成 tool_call 按 ID 写入中断结果以保持消息契约。已开始命令的实际结果未知时明确标记,不自动重放终端或应用文件改动。
## 上下文
完整会话仍保留在磁盘。模型请求使用有预算的投影:以完整 user/assistant/tool 组为单位保留近期内容,较早内容形成有长度限制的本地提要。计数为估算,服务返回的 usage 另外记录。该机制是本产品的独立提取式实现,不声称与 Claude Code 的模型摘要等价。
## 模型与凭据
支持 OpenAI 兼容的 Chat Completions 工具契约,服务 URL 和模型由用户配置。API Key 仅在服务内存或专用环境变量中使用,不写入会话、导出或配置文件。默认离线演示明确标记,不连接第三方账户。
## 工作台诊断与模型错误
每轮系统上下文加入工作台保存的最新执行快照。inspect_session只读取当前会话的错误来源、近期工具、提案状态与终端环境;项目内容和历史工具输出按数据处理。最新审核状态独立于历史助手的措辞。旧fetch failed明确归为模型请求失败,同时保留旧版未记录底层原因的限制。
模型请求记录请求阶段和尝试次数,分类认证、限额、服务、网络、DNS、证书、超时和协议错误。最多三次请求,退避受Retry-After和总时长约束。重试只作用于当前模型请求,已完成工具不再执行;用户停止会取消请求与退避。模型响应验证可以使用临时参数,不改变当前连接。
## 本地原进程升级
1.0.0升级模块保留现有store/provider/runtime及HTTP服务对象,通过实例原型和请求处理器切换实现。升级前核对本地PID与工件路径并要求无活跃任务,升级后验证配置/项目/会话;Key仍在原provider对象中。原版工件作为源码内置fixture支持独立迁移测试。
## 验证
使用独立测试项目与本地兼容 API 测试服务验证工具循环、审批、差异冲突、停止和重启恢复。浏览器测试覆盖真实本地界面。真实大模型的效果与用户服务连通性单独记录。
+25
View File
@@ -0,0 +1,25 @@
# 真实模型连接验证
2026-10-29 08:32(Asia/Shanghai),工作台已使用用户配置的 `gpt-6.1-sol` 完成真实工具调用验证。
当前连接采用兼容模式,沿用用户保存的服务地址 `https://api.apikey.fan`。模型列表中存在所选模型,实际任务约 12 秒完成。
## 已核对的流程
1. 在独立测试目录生成随机 token 和数字 21,任务提示不包含 token 的值。
2. 模型调用 `read_file` 读取 `facts.txt`,取得实际内容。
3. 模型调用 `propose_file` 生成 `MODEL-RESULT.md`;提案包含正确 token 和计算结果 42。
4. 核对审核前文件未写入,然后通过工作台应用提案。
5. 读取实际落盘内容,确认与提案一致;会话状态为已完成。
此次使用已配置的真实模型服务。测试只提供合成数据,没有读取用户项目,也没有运行终端命令。验证脚本通过本地服务使用当前内存配置,没有读取或记录 API Key。
结构化记录保存在 `live-model-validation.json`。这是所选兼容服务的实测结果;最初交付的 fixture 测试记录仍保留在 `VALIDATION.md`。
## 1.0.0原会话诊断验证
2026-10-29,正式服务在原PID23080中升级为1.0.0,继续使用同一个内存连接、gpt-6.1-sol及用户保存的根地址。
在原会话569c9457-d399-46e6-b53e-4b1fdbb02109询问“fetch failed跟项目修改有关吗,两份文件现在是什么状态”。模型先调用inspect_session,再只读核对src/catalog.js与tests/catalog.test.mjs,22秒完成。实际回答明确:历史错误发生在工作台请求模型服务时,旧版未保存底层原因,两项改动当前均已应用;没有要求用户再提供已有工作台日志。
核对完整历史前缀、提案状态和文件SHA256保持一致;没有项目搜索、新提案或终端命令。此后本轮外部终端也在原项目验证4项测试全部通过。结构化证据见 [live-session-validation.json](live-session-validation.json) 和 [upgrade-live-validation.json](upgrade-live-validation.json)。全程通过本地服务沿用内存配置,没有访问或记录API Key。
+31
View File
@@ -0,0 +1,31 @@
# Agent Workbench 1.0.0 验收清单
## 用户可见行为
| 要验证的行为 | 功能检查 | 界面检查与证据 |
| --- | --- | --- |
| 问“刚才的 fetch failed 怎么回事”时依据工作台记录回答 | 同一会话先制造接口失败,再提问;上下文携带来源、请求阶段、尝试次数与已完成工具 | 对话显示模型连接错误和恢复入口,不把错误当作项目搜索结果 |
| 临时模型网络失败有限重试 | 受控接口断开一次后恢复;命令执行次数仍为一次 | 重试状态可见,成功后状态恢复 |
| 永久接口错误与取消 | 验证 401/429/503、连接失败和中途停止 | 中文错误标题、可操作建议、取消后不继续请求 |
| 中文脚本和命令确认 | UTF-8 中文经 PowerShell 管道进入 Node;确认/拒绝/取消 | 命令详情显示 shell、工作目录、理由和实际输出 |
| 待审查改动闭环 | 预览、逐个应用/拒绝、冲突防护,审批前文件不变 | 待审查计数和审核入口清楚,继续按钮含义与状态一致 |
| 项目与工作台信息区分 | 检查当前项目路径与会话诊断工具;不根据项目无 fetch 推断接口失败 | 示例项目明确标识,当前项目和运行状态可查 |
| 旧会话和旧错误 | 用 0.1.0 数据载入、保留执行记录,推导旧 fetch failed 的来源 | 新版显示旧错误的解释,历史完整保留 |
| 完整工作流 | 打开项目→发任务→读文件→提案→审核→命令→导出→恢复 | 桌面和窄屏,顶部、输入框、审批/审核入口在视口内 |
| 本地升级 | 保留进程中的模型连接及现有项目/会话,版本和静态资源切换 | 4318 新版页面,重新加载后新状态可见 |
## 异常探索
1. 工具已经成功,下一次模型请求失败;重试只请求模型,保持工具调用与结果配对。
2. 待审核时反复点击继续;明确引导审核,避免无意义再次读取和请求。
3. 读取大输出、网络返回非 JSON、语法错误时的文字和视口可读性。
## 当前验收结果
构建通过,34项行为测试、10组基础界面和9组异常专项全部通过,零失败/跳过,页面异常与请求失败为零。示例的4项搜索测试通过。
上表前8项已有服务端与实际Edge界面证据,包含401/429/503、中文命令、运行/审核屏障、旧会话和手机状态。结构化结果及已核对截图见[验收记录](VALIDATION.md)。
独立便携启动、同服务复用、随附Node命令和停止已通过;4318正式升级保留PID23080和内存连接。用户真实gpt-6.1-sol在原会话的只读诊断22秒完成,正确使用错误来源与两项applied状态,原消息和文件哈希保留。
便携与源码ZIP的CRC、路径、清单及文件散列核对通过。源码包独立解压、离线安装依赖、完整构建和34项行为测试通过,包含内置旧版升级fixture。正式服务保留运行,4319测试服务和临时调试端口已关闭。
+68
View File
@@ -0,0 +1,68 @@
# 统一机制报告:从 Claude Code 与 Cursor 到本地 Agent 工作台
Claude Code 的工具循环、上下文与恢复机制,以及 Cursor 的工具契约、执行记录与文本改动机制,已集中到同一个独立产品:Agent Workbench。本产品使用自己的 React/Node 代码,把项目、任务对话、工具结果、终端确认与文件差异放在一个工作台中。
## 研究身份与方法
| 目标 | 固定版本 | 工件依据 | 深入核对范围 |
| --- | --- | --- | --- |
| Claude Code | 2.1.312,Windows x64 | 官方 npm 包;SHA512 integrity 校验;EXE SHA256 `6099672ebe5dcb518b67d1d32dde1e3360bc6bee1dae7f8d28a69c49acc7c865` | Bun 模块表指针/编码/范围验证,2,581 个 JS/入口模块;工具循环 27 个选段、上下文与恢复 32 个位置 |
| Cursor | 3.16.29 | 本机分发代码;commit `6246455961129c32969845e00aa25d87ae926ec0`;执行器与 worker 原文件散列 | 19 个关键位置、9 个精确 AST 切片 |
研究采用 REA 静态分析与人工 AST/原字节核对。Claude 工具循环的五份摘录解析成功,所有选段均与 EXE 载体字节一致。原 Bun 虚拟绝对 imports 和部分动态绑定仍未自动解析;自动关系图中的 partial/ambiguous 与人工核对的位置在各报告中分别说明。
没有运行 Claude Code/Cursor,没有读取它们的个人会话或凭据。报告支持所选客户端代码的局部机制,不能证明原版全部运行行为、远端服务或完整源码的恢复。
## 两边互补的机制
| 问题 | Claude Code 静态证据 | Cursor 静态证据 | 本产品 1.0.0 的独立实现 |
| --- | --- | --- | --- |
| 工具身份与输入 | 调用 ID 关联结果;schema 校验;权限改写后再次校验 | 当前工具名映射;缺失工具生成原 ID 错误结果 | 六种固定工具,含本机会话诊断;输入校验;拒绝重复调用 ID;错误结果按 ID 配对 |
| 执行与权限 | 非 allow 分支可早于主要调用返回;权限不是所有模式下都要求人工确认 | 执行包装与 MCP hooks 有条件分支 | 文件读取/搜索直接完成;每条终端命令独立确认,并绑定会话、运行、完整命令与工作目录 |
| 并发 | 只有新项与全部执行项均声明安全时才并发;独占队列形成屏障 | 工具集与执行契约决定可执行范围 | 按返回顺序串行执行;模型请求有限重试,已完成工具不重放 |
| 修改文件 | 工具调用与其结果分别处理 | `cte.apply_patch` 构造文本与引用,本方法自身没有写盘 | 完整文本提案与差异;审核前不写项目;应用时核对 SHA256 基线并备份原字节 |
| 上下文整理 | 预算、有效摘要校验、hooks、连续失败保护与快速回填保护 | 研究未完整追踪其上下文压缩服务 | 保留完整磁盘历史;请求使用提取式投影;保留近期用户指令及工具 ID 配对;记录估算与服务 usage |
| 中断与恢复 | UUID/parentUuid 构链、残缺记录和未完成调用识别 | 重建当前工具集;恢复执行契约可选,缺失时回退当前集合 | 重启把执行/等待项标为暂停或中断;保留提案;补齐未完成调用结果;继续任务时重新请求终端确认 |
| 前端重连 | 本研究未证明全部跨进程持久性 | worker 身份、安装/spec 校验及本地连接复用 | 浏览器与本地任务服务分离;关闭页面不自动停止服务;SSE 与 revision 同步当前会话 |
## 一次真实的产品流程
```mermaid
flowchart LR
Task[项目任务] --> Model[兼容模型服务]
Model --> Tools[校验工具调用]
Tools --> Read[读取与搜索]
Tools --> Proposal[文件提案]
Proposal --> Review[查看差异]
Review --> Baseline[核对文件基线]
Baseline --> Apply[备份并写入]
Tools --> Ask[确认完整命令]
Ask --> Command[在本机执行]
Read --> Result[按调用 ID 保存结果]
Command --> Result
Result --> Model
```
提案的“已保存”表示建议保存在会话里。只有“已应用”才表示项目文件已经写入。调用进入执行阶段,也不能单凭这个标记证明系统副作用发生;中断后应查看实际文件与输出。
默认离线演示是固定脚本,依次调用真实项目列表、文件读取、提案和 `node --version`,用于体验整个流程。它不进行模型推理。连接支持 Chat Completions 工具契约的服务后,工具调用由所选模型产生。
## 已验证的产品行为
- 34项行为测试通过:工具循环、命令确认/拒绝/取消、提案/冲突、原字节备份、路径、Key不落盘、崩溃恢复,以及会话诊断、中文管道、分类请求错误/重试和原进程升级。
- 10组基础UI、9组异常UI及可运行包验收结果见 [VALIDATION.md](VALIDATION.md)。
- 用户真实gpt-6.1-sol已通过文件读取/提案/应用,并在1.0.0原会话通过inspect_session解释历史错误与当前applied状态;受控fixture结果分别记录。
## 当前本地版边界
当前版本包含本地项目与会话、文本工具、完整内容提案、逐次命令确认、历史与恢复、模型设置、分类错误与诊断、会话/建议导出和研究报告。MCP动态注册、并发调度、语义检索、多文件事务、模型生成摘要和原生桌面壳仍是后续设计空间。
终端工作目录是所选项目,命令确认后以当前系统用户权限运行,最长 60 秒;它不是操作系统沙箱。读取/搜索/提案/应用则在服务端校验项目范围和真实链接位置。
## 详细报告与来源
- [Claude Code:工具循环、权限与结果](research/TOOL-LOOP.md),索引 `research/TOOL-LOOP.evidence.json`。
- [Claude Code:上下文压缩与会话恢复](research/CONTEXT-RECOVERY.md),索引 `research/CONTEXT-RECOVERY.index.json`。
- [Cursor:工具执行与恢复](research/CURSOR-MECHANISMS.md),索引 `research/CURSOR.evidence-index.json`。
完整 REA Evidence 和研究工件仍保留在原工作区的 `Claude-Code-REA` 与 `investigations/cursor-agent`。产品发行包包含这些报告和小索引,不包含第三方客户端原二进制、完整提取源码或大体积分析切片。
+26
View File
@@ -0,0 +1,26 @@
# 从 0.1.0 升级到 1.0.0
升级脚本在原Node进程中替换工作台实现,保留现有内存连接对象、项目和会话。它不会读取、打印、导出或复制API Key。普通停止后重启会丢失仅在内存中的Key,需要重新填写。
## 升级条件
使用已完成构建的1.0.0便携包,保留原0.1.0发行目录。工作台中的任务和命令审批均已结束,当前本地9229端口可用。脚本只接受127.0.0.1上的0.1.0工作台,先核对进程PID和原发行路径,再迁移对象。升级后校验配置、项目、会话和PID,并关闭本次开启的调试端口。
## 执行
在解压后的1.0.0便携目录打开PowerShell。下面的旧发行路径替换为本机真实路径,数据目录沿用当前启动配置。
```powershell
$awOldRoot = 'D:\Ai-project\REA逆向\Agent-Workbench\releases\Agent-Workbench-0.1.0-win-x64'
$awNewRoot = (Get-Location).Path
$awServiceInfo = Get-Content -LiteralPath (Join-Path $env:LOCALAPPDATA 'AgentWorkbench\service-info.json') -Encoding UTF8 -Raw | ConvertFrom-Json
& (Join-Path $awNewRoot 'runtime\node.exe') (Join-Path $awNewRoot 'scripts\upgrade-running.mjs') --url http://127.0.0.1:4318 --pid $awServiceInfo.pid --current-root $awOldRoot --new-root $awNewRoot
```
成功后访问 `http://127.0.0.1:4318/?release=1.0.0`,界面显示v1.0.0。运行诊断可核对模型名称、凭据是否已配置和文件审核状态。已有项目路径继续指向原项目,不移动用户文件。
`service-info.json`保留原启动目录,并增加当前实现目录`runtimeRoot`与版本。再次运行启动器会复用当前本地服务;以后需要重启时,从1.0.0目录启动。
## 验证范围
独立旧版进程测试已验证同PID升级、文件及提案保留、合成内存Key的升级后认证和调试端口关闭。正式用户连接与原会话的升级验证单独记录在 [验收记录](VALIDATION.md)。
+72
View File
@@ -0,0 +1,72 @@
# Agent Workbench 1.0.0 验收记录
验收日期:2026-10-29(Asia/Shanghai)。环境:Windows x64,Node.js 24.22.1,npm 11.19.1,Microsoft Edge 156.0.4314.42。自动化验证使用独立项目和数据目录,正式用户会话验证单独记录。
## 构建与行为
TypeScript、Vite与esbuild构建通过。34项行为测试全部通过,零失败、零跳过。主要覆盖:
- 真实本地HTTP工具循环、稳定调用ID、输入校验、上下文投影和保存/恢复配对。
- 提案审核前不写盘、基线冲突、原字节备份、项目路径和外部junction处理。
- 命令确认、拒绝、取消、进程树停止、UTF-8分块与中文PowerShell到Node管道。
- 可读的PowerShell 5.1解析错误及原生命令退出码。
- 工具完成后模型请求失败、有限重试、耗尽后恢复;确认后的计数命令仍只执行一次。
- 401错误脱敏且不重试,429按服务Retry-After等待后恢复,503临时失败、非JSON及过大响应。
- 本地诊断使用真实错误和当前applied状态,旧fetch failed推导明确标记缺少底层连接原因。
- 真实旧版进程的原进程升级,保留PID、文件、会话和合成内存连接,后续认证成功并关闭调试端口。
新版本自带示例同步用户已应用的多关键词搜索改进,4项示例测试通过。原用户项目留在其原路径。
## 基础浏览器
独立测试地址 `http://127.0.0.1:4319`,1440/780/390 px下10组流程全部通过,页面异常和请求失败均为零。覆盖打开项目与文件、命令确认/拒绝、差异应用、手动提案、快速切换项目/文件/会话、延迟旧响应、刷新/导出、手机抽屉、研究报告与模型设置的兼容接口循环。
结构化记录:[ui-validation.json](ui-validation.json)。截图已目视核对顶部、输入框、差异颜色和操作位置。
- [桌面工作台](screenshots/desktop-ready.png)
- [差异审核](screenshots/desktop-diff-review.png)
- [中文命令确认](screenshots/command-approval.png)
- [手机对话](screenshots/mobile-conversation.png)
- [手机文件](screenshots/mobile-file.png)
- [统一研究报告](screenshots/research-overview.png)
## 异常专项浏览器
9组全部通过,页面异常和请求失败均为零。测试以受控HTTP模型服务产生真实API响应:
1. 验证临时模型响应,再保存连接;验证时已有配置保持不变。
2. 项目读取成功后连续HTTP 503,展示分类错误、三次请求和运行诊断。
3. 手动重试保留原工具结果,不重复用户回合或项目读取。
4. 用户追问错误,模型通过inspect_session取得本地记录,回复显示Markdown且不搜索项目fetch。
5. 运行中不能应用文件,待审查显示审核入口,应用后内容一致。
6. 用户确认中文PowerShell管道,Node输出保留中文。
7. HTTP 401只请求一次;390 px的错误与诊断按钮可用。
8. 停止退避后不发第二次请求,任务已暂停,诊断显示最近请求已停止。
9. 临时HTTP故障在有限请求内自动恢复。
结构化记录:[diagnostics-ui-validation.json](diagnostics-ui-validation.json)。
- [模型请求错误](screenshots/formal-model-error.png)
- [运行诊断](screenshots/formal-diagnostics.png)
- [依据记录回答](screenshots/formal-diagnostic-answer.png)
- [手机错误](screenshots/formal-mobile-error.png)
- [手机诊断](screenshots/formal-mobile-diagnostics.png)
- [停止后的诊断](screenshots/formal-stopped-diagnostics.png)
## 便携包与正式升级
Windows x64便携包已通过独立启动、同PID复用、命令确认、随附Node.js 24.22.1执行、示例/静态页面/四份报告和优雅停止。测试端口4320,使用独立数据目录,PATH移除系统Node/npm。记录见 [release-validation.json](release-validation.json);最终文件数量和SHA256以各发行目录的MANIFEST.json为准,ZIP散列见releases/latest.json。
便携与源码ZIP均已通过CRC、路径、清单完整性、文件大小/SHA256、ZIP SHA256及归档与发行目录逐文件比对。源码ZIP独立解压后,离线安装锁定依赖、TypeScript/Vite/两份服务端构建和34项行为测试全部通过,包含源码内置的旧版升级fixture。记录见 [source-package-validation.json](source-package-validation.json)。
正式4318已从0.1.0升级到1.0.0,保留PID23080、2个项目、3个会话和原内存模型连接。原项目仍位于原路径,两个文件状态均为applied。升级脚本没有读取、导出或复制Key,完成后关闭本次启用的本地调试端口。记录见 [upgrade-live-validation.json](upgrade-live-validation.json)。
## 实际配置模型
用户的gpt-6.1-sol连接已在0.1.0完成真实read_file、propose_file与审核应用,见[模型连接实测](MODEL-CONNECTION.md)。1.0.0进一步在原会话提出自然错误问题,真实模型在22秒内先inspect_session,再只读核对点名的两个文件;正确说明历史fetch failed来自模型请求、旧版缺少底层原因和两个applied状态。
验收确认没有项目搜索、新提案或终端命令;原消息前缀、提案状态及两个文件的SHA256保持一致。完整结果和原回答见 [live-session-validation.json](live-session-validation.json),[实际页面](screenshots/deployed-desktop.png)及[当前模型与会话诊断](screenshots/live-formal-diagnostics.png)已核对。当前原项目的4项测试也在本轮外部终端通过;该外部验证独立于工作台自身历史事件。
首轮真实验证的脚本过严地拒绝合理的点名文件读取,修正只读范围后完整通过。此脚本问题没有改变项目文件,原会话保留全部记录。
第三方客户端机制报告依据静态发行工件,不代表执行了原版Claude Code/Cursor或验证了它们的远端服务。
+13
View File
@@ -0,0 +1,13 @@
{
"ready": true,
"url": "http://127.0.0.1:4318",
"version": "1.0.0",
"mode": "compatible",
"model": "gpt-6.1-sol",
"hasKey": true,
"pid": 23080,
"appRoot": "D:\\Ai-project\\REA逆向\\Agent-Workbench\\releases\\Agent-Workbench-1.0.0-win-x64",
"originalAppRoot": "D:\\Ai-project\\REA逆向\\Agent-Workbench\\releases\\Agent-Workbench-0.1.0-win-x64",
"dataRoot": "C:\\Users\\wangy\\AppData\\Local\\AgentWorkbench",
"upgradedAt": "2026-10-29T02:24:14.084Z"
}
+20
View File
@@ -0,0 +1,20 @@
{
"success": true,
"version": "1.0.0",
"url": "http://127.0.0.1:4319",
"date": "2026-10-29T02:13:55.989Z",
"passed": [
"model response validation checks the tentative connection before saving",
"a model failure after successful tools shows source, attempts and local runtime diagnosis",
"explicit retry preserves the completed tool result without replaying the task",
"an error question receives the actual session diagnosis and formatted answer",
"review state exposes the review action and prevents application during a running request",
"approved Unicode commands execute in the declared shell and retain Chinese output",
"authentication errors do not retry and error/diagnostic controls fit a 390 px viewport",
"stop cancels pending retry and clears running model state",
"a transient service failure recovers within the bounded retry policy"
],
"pageErrors": [],
"requestFailures": [],
"modelValidation": "controlled local HTTP fixture; actual configured model is verified separately"
}
+34
View File
@@ -0,0 +1,34 @@
{
"success": true,
"testedAt": "2026-10-29T00:32:17.697Z",
"endpoint": "https://api.apikey.fan",
"model": "gpt-6.1-sol",
"projectRoot": "D:\\Ai-project\\REA逆向\\Agent-Workbench\\.qa\\live-model-cf2f2be4-e1a1-4a25-89d4-3ba7cec243dd\\模型连接验证",
"projectId": "9333ee4d-3876-4e1a-beba-c355676a70f1",
"sessionId": "0c9601a4-cc20-476c-aa28-ea010c222f70",
"status": "completed",
"elapsedSeconds": 12,
"usage": {
"prompt_tokens": 972,
"completion_tokens": 62,
"total_tokens": 1034
},
"tools": [
{
"tool": "read_file",
"phase": "completed"
},
{
"tool": "propose_file",
"phase": "completed"
}
],
"evidence": [
"真实配置的模型服务响应",
"read_file 读取随机合成数据",
"propose_file 使用读取结果",
"审核前不写盘",
"核对提案后应用成功"
],
"credentialsHandling": "验证脚本使用服务内存中的连接配置,没有读取或记录 API Key"
}
+60
View File
@@ -0,0 +1,60 @@
{
"success": true,
"version": "1.0.0",
"testedAt": "2026-10-29T02:27:44.017Z",
"url": "http://127.0.0.1:4318",
"pid": 23080,
"sessionId": "569c9457-d399-46e6-b53e-4b1fdbb02109",
"projectRoot": "D:\\Ai-project\\REA逆向\\Agent-Workbench\\releases\\Agent-Workbench-0.1.0-win-x64\\examples\\starter-project",
"model": "gpt-6.1-sol",
"endpoint": "https://api.apikey.fan",
"elapsedSeconds": 22,
"status": "completed",
"tools": [
{
"tool": "inspect_session",
"phase": "completed"
},
{
"tool": "read_file",
"phase": "completed"
},
{
"tool": "read_file",
"phase": "completed"
}
],
"fileStates": [
{
"path": "src/catalog.js",
"status": "applied"
},
{
"path": "tests/catalog.test.mjs",
"status": "applied"
}
],
"answer": "已重新核对工作台记录和两个文件,**本次仅做只读诊断,没有修改文件、提出新改动或运行终端命令。**\n\n### `fetch failed` 到底是什么?\n工作台明确记录,这次错误发生在**工作台请求模型服务**时:\n- 来源:`model_connection`\n- 阶段:`model_request`\n- 类型:网络连接失败\n\n因此,**它不是 `src/catalog.js` 或测试代码产生的错误,也不是应用项目改动失败。** 它可能中断助手回复,但当前记录确认,两项文件改动都已应用。\n\n旧版日志未保存底层连接原因,无法确定具体是 DNS、代理、连接中断还是服务端故障。该报错被标记为**历史错误**,不代表现在仍在失败。此前仅通过搜索项目中的 `fetch` 来判断来源不够严谨,应以这次工作台记录为准。\n\n### 两个文件现在的状态\n\n| 文件 | 当前状态 | 实际内容 |\n|---|---|---|\n| `src/catalog.js` | **applied,已应用** | 已支持多关键词搜索:按空白拆词、忽略大小写、所有词匹配同一条目、词序不限 |\n| `tests/catalog.test.mjs` | **applied,已应用** | 已包含 4 项测试,覆盖标题与标签、多关键词、AND 条件、空查询等行为 |\n\n两份文件均与上次读取一致。之前“测试提案仍待审查”的说法已经过时。\n\n**验证状态另算:**历史记录显示原有 1 项测试及临时多关键词断言通过,但没有足够记录确认当前完整的 4 项测试已运行通过;本次没有执行测试。",
"preservedHistory": {
"messageCount": 19,
"sha256": "7d4feb4f18d6b2195ae7b5f2208097b06598e62fd35fb5b15b876dcc1f750c44"
},
"files": [
{
"path": "src/catalog.js",
"sha256": "4cc12126e0e86c0909ce066a26bf095a6f425f3dbebc70ac3edd65a56906a3d7"
},
{
"path": "tests/catalog.test.mjs",
"sha256": "af478ecb0eabc3d5d2c6738339db66913575bc62eefeae24013d30edf3547f58"
}
],
"evidence": [
"Actual configured model inspected the original session",
"Historical fetch failure attributed to the model request",
"Current applied states used; optional reads limited to the two named applied files",
"No project searches, new proposals or terminal commands",
"Original messages and file hashes preserved"
],
"credentialsHandling": "The script used the existing in-memory connection through the local service; no API Key was accessed or recorded."
}
+21
View File
@@ -0,0 +1,21 @@
{
"success": true,
"date": "2026-10-29T02:33:49.220Z",
"appRoot": "D:\\Ai-project\\REA逆向\\Agent-Workbench\\releases\\Agent-Workbench-1.0.0-win-x64",
"version": "1.0.0",
"nodeVersion": "v24.22.1",
"verifiedFiles": 128,
"url": "http://127.0.0.1:4320",
"reusedPid": 2600,
"steps": [
"manifest hashes",
"bundled Node launch",
"same-service reuse",
"packaged example and static page",
"explicit command consent",
"actual bundled Node version",
"report availability",
"graceful stop"
],
"realModel": false
}
File diff suppressed because it is too large Load Diff
+111
View File
@@ -0,0 +1,111 @@
# Claude Code 2.1.312:上下文压缩与会话恢复
本次研究核对了当前 Windows 官方发行物中两条客户端机制。压缩不是简单地截掉旧消息:它有预算判断、摘要生成、钩子、状态返回、边界记录和失败保护。恢复也不是重读一段聊天文本:它按消息身份重建链,恢复工作状态,并识别没有对应结果的工具调用。
这些结论是**已读取的静态代码条件与调用表达式**,没有执行 Claude Code,没有访问用户会话,也没有观察真实模型服务。函数名称属于这个构建,不能当作跨版本稳定接口。
## 工件与方法
- 官方包:`@anthropic-ai/claude-code-win32-x64@2.1.312`。
- EXE:298,690,208 字节;SHA256 `6099672ebe5dcb518b67d1d32dde1e3360bc6bee1dae7f8d28a69c49acc7c865`。
- 主体证据文件:`recovered/modules/chunk-9hk5qx04.js`,SHA256 `c958226d1a62d226947f5795ba4d8de70fd3673ca9fb7b80bd50f29bde8923df`。本文件的原始内容散列与 UTF-8 派生散列一致,因此索引还给出了可直接复核的 EXE 字节范围。
- 名称适配导出:`chunk-cgy8y2q9.js` 导出 `buildConversationChain`、`recordTranscript`、`loadTranscriptFromFile`、`loadTranscriptFile`、`restoreSessionMetadata`、`adoptResumedSessionFileAsync` 等可读名称,对应主体中的混淆符号。
- 用 Babel 只解析相关分块,读取函数、方法、分支、返回值和调用位置;没有把字符串命中当作行为证明。
- 用 REA 对原分块局部选择和 32 个有来源映射的函数/方法摘录做惰性语法与关系分析。摘录仅为静态分析加入声明、导出和一个部分 class 包装;不会运行它们,也不宣称包装是原始源码。
每个函数的 UTF-16 字符区间、UTF-8 字节区间、行号、原始工件范围和片段散列在 `CONTEXT-RECOVERY.index.json`。完整本地 REA 记录在 `CONTEXT-RECOVERY.evidence-bundle.json`。
## 压缩链路
客户端入口协调函数 `WFr` 调用预算判断 `dlr`,随后选择普通摘要路径 `BFr` 或反应式路径。其返回值是明确的状态对象,不仅是成功或失败布尔值。
| 返回状态 | 读取到的条件或含义 |
| --- | --- |
| `not_needed` | 禁用压缩,或当前预算/触发判断未要求压缩 |
| `compacted` | 返回有效的压缩结果及阈值来源等元数据 |
| `hook_blocked` | 钩子拒绝或阻止这次压缩 |
| `failed` | 压缩失败,记录连续失败数和原因 |
| `failure_breaker_open` | 本会话连续失败已到保护上限,跳过后续尝试 |
| `rapid_refill_breaker_tripped` | 压缩后过快再次填满上下文,达到保护上限 |
`dlr` 读取消息预算、模型事实、所选窗口和使用量调整,返回预算级别是否为 `compact` 或 `blocked`。它还排除了某些查询来源、禁用状态及配置情形。因此不能把“消息数超过某个数字”当作这里的触发规则。
预算助手 `JQ` 从所选窗口扣除受上限约束的模型输出预算。`DQ` 默认再预留 13,000 token;有效的测试百分比覆盖也受这个预留限制。`ike` 能读取 `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` 等覆盖配置。这里的 13,000 是这个客户端构建中的常量,**不建议直接抄成我们自己的所有模型的固定预算**。
`BFr` 的普通摘要路径按以下代码顺序执行:
1. 拒绝空会话,进入 `compacting` 状态,调用 `pre_compact` 钩子并合并自定义指令。
2. 通过 `Hrn` 取得摘要响应;若响应显示请求过长,允许有限次数删减输入头部后重试。
3. 拒绝没有有效文本的摘要和 API 错误消息。这是读取到的响应校验,具体远端请求与模型行为没有观察。
4. 读取并清理文件读取状态,重新生成需要保留的附件等内容;创建 `DK` 的 `compact_boundary` 以及 `isCompactSummary` 消息。
5. 为边界记录压缩前后 token、耗时、已发现工具等元数据,调用 `post_compact` 钩子,返回边界、摘要、附件和钩子结果。
6. `finally` 无论结果如何都会结束压缩进度,并发出成功或失败的 SDK 状态。
`zrn` 的连续失败计数达到 `Krn=3` 时记录熔断。`SVo` 在上次已压缩且 `turnCounter<3` 时增加快速回填计数;`DDr` 在此计数达到 3 时返回 `trip`。这两种保护对应不同问题:摘要持续失败,以及摘要即使成功却很快再次填满。
源码还出现闲置预计算、较大模型和反应式路径。它们的调用条件已经定位,但本报告没有把这些外部辅助函数完整还原。钩子、文件读取状态等副作用也说明不能把整个原版压缩过程宣称为一个已经验证的原子事务。
## 持久化链路
`recordTranscript` 的构建内符号 `eC` 从会话存储读取已记录 UUID,跳过重复消息,再调用 `NAt.insertMessageChain` 写入新消息。`NAt.recordInTurn` 把 session 与 turn 的组合用于批处理串行入口。
`NAt.insertMessageChain` 对每条记录生成 `parentUuid`、会话身份、版本、分支等字段,并调用 `appendEntry`。普通记录继续消息链;压缩边界将物理 `parentUuid` 置为 `null`,同时保留旧链的 `logicalParentUuid`。
它还有一个特别有用的顺序:遇到压缩边界后设置 `compactAwaitingSummary`;后续用户/助手行写入后,才调用 `requestCompact` 进行日志整理。这体现了“先落下新的可恢复内容,再处理旧历史”的客户端设计意图。**没有实机证明文件系统崩溃时的完整持久性,也没有证明所有存储后端都相同。**
`flushSessionStorage` 的构建内符号 `Wu` 调用 `NAt.flush`。这个方法等待正在进行的 drain、排空写入队列、等待 `pendingWriteCount` 归零,再释放保留的重播记录;存在 `storeFence` 时抛出错误。它不等价于已证明所有写入都经过 `fsync`。
## 恢复链路
已核对的客户端链路为:
```text
loadTranscriptFromFile (I7e)
→ loadTranscriptFile (Jre)
→ buildConversationChain (TBt)
→ 返回消息、工作树/成本等会话状态
→ restoreSessionMetadata (CK)
→ adoptResumedSessionFileAsync (PCe),重新绑定后续写入
```
`I7e` 对 JSONL 与旧 JSON 形式采用不同读取路径。JSONL 结果中有消息 Map、有效 leaf UUID、摘要与会话元数据等。它选择有效叶节点,再调用 `TBt` 构链;无消息、无有效链、错误 JSON 或错误结构会有明确错误。旧 JSON 读取还设有 256 MiB 限制。
`TBt` 沿 `parentUuid` 向前走,使用 Set 检测重复 UUID。发现循环会停止并返回部分链;找不到父节点时会调用时间顺序回退助手,然后逆转链并补齐相关内容。这是静态容错条件,不代表任何损坏会话都能完整恢复。
`Jre` 对较大的 JSONL 可以跳过压缩前历史,仍保留必要的附属账本与元数据。它同时支持存储 backend 分支和文件分支;权限不可读、缺失与错误等结果被分别处理。源码还记录尾部缺少换行的 `tornTail` 状态。写入前 `NAt.sealTornTailSync` 能补上换行,避免残缺尾部与新行直接连在一起;本报告没有验证坏行修复或断电恢复。
`CK` 恢复标题、模式、权限模式、工作树、工具使用记录与其他会话元数据。`PCe` 设置本会话写入文件、接收恢复来源,再重新附加会话元数据;失败会记入 writer health。
`findUnresolvedToolUsesInTranscript` 的构建内符号 `IBt` 将 `tool_use.id` 与后续 `tool_result.tool_use_id` 配对,返回还没有结果的调用。这个函数证明存在未完成调用的识别;**它本身不能证明原版恢复时一律重试或一律不重试。**
## REA 的证据与限制
| 记录 | 实际支持与限制 |
| --- | --- |
| `ev_37df041a5f415dc11054ea3f138cd1dafdb1a62fc5eb56c0d27c36d112f831f8` | 原分块中精确选择 3 个文件;语法全部解析,1 个文件关系分析达到保留上限;2577 文件未分析 |
| `ev_2b539340ae6abd762b77fb797bd6aed16c21199f00d2845b53ae864638e9e501` | 32 个函数/方法的有来源摘录;2 个 JS 文件语法完整,7,427 AST 节点;没有节点/关系省略,但外部全局、动态调用和部分 class 状态仍未知 |
| `ev_af11084f350178aa3a8e4d480b661ef6d05124f882c82a5f2ff10a1377e0fa7f` | `compacted` 字面量种子的反向关系查询没有取得已保留种子,结果 partial;不能据此断言状态不存在 |
| `ev_211eeb035f0a11a4f739dfd378b4a12a79bfcfce2cdb749bf87f09002117d13a` | `parentUuid` 属性查询找到 1 个种子,但关系 ambiguous;没有证明完整自动语义路径 |
上述原分块的 import 使用 `B:/~BUN/root/...` 绝对虚拟路径。REA 没有自动建立它与当前提取目录的映射,相关跨分块关系保持 unknown。两个 trace 记录也没有提供自己的工件身份,只能通过其父 Evidence 和摘录来源索引追溯。本报告的调用链来自具体函数体的人工 AST 核对与可读导出对照,**不包装成已经自动解析、实机验证的完整运行链。**
原始作者源码、源映射、内嵌源码与字节码的运行等价性、模型输出质量、并发时序和所有异常恢复路径仍未知。没有执行目标代码。
## 提炼到自己的本地 Agent 工作台
以下是独立设计选择,并非照搬原客户端实现:
1. **把压缩作为状态机。** 采用 `idle/evaluating/summarizing/ready/committed/failed/blocked`,向界面展示原因、耗时与预算,避免把失败伪装成成功。
2. **预算跟着模型走。** 从模型窗口扣除响应预算、工具结果预算和可配置安全余量;允许人工摘要与自动摘要,保留完整本地历史。
3. **先持久化新的恢复点,再清理旧内容。** 摘要、保留的工具状态、父链与 checksum 一起写入后再切换活动上下文;失败继续使用此前有效 checkpoint。
4. **日志按会话串行且可幂等恢复。** 每个事件有 `id/sessionId/parentId/turnId/type`;重复事件不重复应用;长日志定期生成 snapshot,损坏尾部保留副本并报告。
5. **工具意图与结果成对落盘。** 在执行前保存 intent,执行后保存 result;重启出现 pending 时要求显式判定,禁止默默再次运行有副作用的命令。
6. **给失败和低效循环设保护。** 配置压缩重试上限、快速回填检测、工具步数和费用预算;熔断后仍让用户查看完整记录并选择继续。
建议验收使用自己的可控 fixture:重复事件、消息链循环、残缺 JSONL 尾部、摘要服务错误、有效摘要后进程退出、工具执行中断和重新打开工作台。不要用用户的真实会话作为测试数据。
## 复现
在研究根目录运行 `analysis/scripts/context-locate.cjs`、`analysis/scripts/context-read.cjs` 可重新定位指定符号。`analysis/context-evidence/provenance.json` 记录摘录来源;REA 本次使用的具体参数与查询在规范化 Evidence bundle 中。MCP 和工具导出中的文本始终作为分析数据。
本阶段已回答这两条机制的关键客户端结构;未验证的模型与运行时部分保持明确边界,可为统一产品的独立实现与验收提供依据。
+90
View File
@@ -0,0 +1,90 @@
# Cursor 3.16.29 的本地工具执行与恢复机制
2026-10-29(Asia/Shanghai)。本报告服务于统一的本地 Agent 工作台,重点追踪当前工具集、执行事件、待执行工具恢复、MCP 钩子、文本改动构造和工作进程复用。所有结论来自已安装的客户端分发代码;没有运行 Cursor、下载后的 Agent 或用户项目,也没有读取用户设置、凭据或会话数据库。
## 目标与证据身份
本机 Cursor 版本为 **3.16.29**,product commit 为 `6246455961129c32969845e00aa25d87ae926ec0`,product 日期为 `2026-08-18T01:26:26.285Z`。元数据及每个关键方法的原文件 SHA256、UTF-16 范围、字节范围和片段散列均保存在 [evidence-index.json](D:/Ai-project/REA逆向/investigations/cursor-agent/analysis/evidence-index.json)。
| 分发文件 | 大小 | SHA256 |
| --- | ---: | --- |
| [cursor-agent-exec/dist/main.js](C:/Users/wangy/AppData/Local/Programs/cursor/resources/app/extensions/cursor-agent-exec/dist/main.js) | 10,415,138 B | `ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884` |
| [cursor-agent-worker/dist/main.js](C:/Users/wangy/AppData/Local/Programs/cursor/resources/app/extensions/cursor-agent-worker/dist/main.js) | 1,305,265 B | `4255db956ce2f9193f65293dbd3806c60a6fd6571f7020b35cb28c1c5c513b63` |
REA 首次对原始 worker 的 `package.json` 和 `dist/main.js` 做静态分析,成功解析语法,但语义保留触及节点/unknown 上限。随后从原文件 AST 中选取 **9 个精确代码切片**,按分发代码的位置保存映射并分别分析;9 个切片都无语法解析失败。切片没有执行,外部绑定、封闭作用域和动态对象关系仍保留为未知。
原始 worker 的 REA parent Evidence 为 `ev_cebd28a6fee5c6940fee6249054cd080fca28e135e6083a3951c4a0a29d13b51`;7 个主要切片为 `ev_789fa6618de0da72e2fde82f30aedcba8777533a0ed8c36397673fdd3792f7fe`;分发器和 patch 切片为 `ev_df7c229808fe5aa5f80a0f44fbb8c87861c3eb3593ad942d20589ada8853513d`。完整记录在本地 [REA-CURSOR-EVIDENCE.json](D:/Ai-project/REA逆向/investigations/cursor-agent/analysis/REA-CURSOR-EVIDENCE.json)。该文件约 63 MB,包含分析记录;证据包的顶层 `unknowns: 0` 是独立残余未知登记数,不能解释成内部语义没有未知。
## 可核验的执行与恢复链
下面是已观察的源码调用与参数关系。已继续读取 `xJ` 原函数(617595–623947),确认它调用具体工具的 `execute` 并转换异常;具体工具实例及最终系统执行器的外部绑定未完整解析,因此这条链是静态代码机制,不能称为实际端到端运行验证。
```mermaid
flowchart LR
Resume["X5:取出待执行消息"] --> Context["当前工具集与可选执行契约"]
Context --> Dispatch["a1:按工具名分发"]
Dispatch --> Adapter["xJ:调用工具 execute 并转换异常"]
Dispatch -. "传入交互记录器" .-> Events["AL:started / completed / 结果记录"]
Adapter --> Result["role=tool 结果消息"]
Result --> Append["追加提示消息,继续 runTurnLoop"]
```
表中范围是原 `main.js` 的 **UTF-16 代码单元偏移,起点含、终点不含**,不是文件行号。对应字节范围由索引脚本根据同一文件计算。
| 机制 | 原源码位置 | 已观察的关键行为 |
| --- | --- | --- |
| 当前工具上下文 | `M4.buildToolExecutionContext`,1676093–1678229 | 要求 stateHandler.mode 已设置;按资源、会话、MCP、仓库、模式、文件锁等生成工具;建立工具名映射、权限指令和 AL 交互记录器。 |
| 请求分发 | `a1`,1509098–1514586;`M4.executeToolCall`,1681136–1681532;`xJ`,617595–623947 | 在工具映射中解析名字;不存在时返回带 toolCallId 的 `role: tool` 错误结果;xJ 调用工具 execute,区分取消、后端不可达、超时、参数错误、拒绝等错误分类。 |
| 执行生命周期 | `AL.executeToolCall`,639604–641562 | 先记录时间并发送 started;绑定 abortSignal;执行回调后给结果附完成时间,发送 completed,再写入 toolCallRecorder。 |
| 待执行工具恢复 | `X5.executePendingToolCalls`,1759140–1762063 | 从 stateHandler 取原始 pending messages;要求最后 turn 是 Agent turn、最后消息是 assistant;生成当前工具集,处理契约后执行工具,把结果追加到提示消息。 |
| MCP 钩子 | `Ie.execute`,3056776–3062194 | 执行 preToolUse、beforeMCPExecution;明确处理 deny;允许钩子调整输入;执行后发送 afterMCPExecution、postToolUse 或 postToolUseFailure。 |
| 文本 patch | `cte.apply_patch`,2032889–2033584 | 按 orig_index 排序 chunks,组合保留行和插入行,产生 newLines 与带上下文的 citations。该方法本身没有磁盘写入。 |
| 工作进程复用 | worker 的 `nde`,1294925–1302681 | 检查身份、安装和 worker spec;复用现有 daemon 前请求 worker ID;失配或不可达时进入重建分支;持久化 pid/install/spec 文件与日志路径。 |
| 健康与清理 | worker 的 `Vle`,1292832–1293973;`Ile`,1289442–1290330 | 经本地 pipe/socket 请求 worker ID,验证 HTTP 状态与返回 JSON;清理逻辑按 workspace/owner 范围收集 worker 名称。 |
### 执行记录保留了部分参数和时间状态
`AL` 保存 latestToolCallsById、参数需保留的 callId 集合和开始时间。`applyDeltaToLatestToolCall`(635010–635335)只对相应 editToolCall 追加 streamContentDelta;`emitToolCallError`(638641–639241)可把保存的参数合回错误结果,然后发送 completed 与记录。这表明 UI 状态、流式参数和最终结果被分别处理。
这里观察到的是 recorder 方法调用。recorder 的完整磁盘实现、崩溃时落盘顺序、跨进程事务与 exactly-once 保证尚未验证。
### 恢复时的契约不是强制存在
`X5` 会读取 `providerOptions.cursor.pendingToolExecutionContracts`。有契约时,恢复逻辑筛选 allowedToolNames / admittedEffectiveToolNames,对已找到的契约和工具调用 `v1` 验证,失败时生成拒绝结果。**缺失契约时会回退当前静态工具集**。因此可以提炼“恢复应重建当前能力”的思想,不能据此声称原版每次恢复都重新向用户授权或始终禁止旧写操作重放。
REA 对 `executePendingToolCalls` 属性的 callers 查询返回了两个种子匹配,状态为 ambiguous、coverage 为 partial,Evidence 为 `ev_9869e34990c183da28cafa47f75a72bb843018002e1fad4c1144285d11de5f71`。本报告的局部调用关系同时依据具体源码位置,没有把这个歧义查询描述为完整语义追踪。
### MCP 钩子也有明确的条件分支
`smartModeApprovalOnly` 会直接调用 innerExecutor。普通分支中 preToolUse 的 deny 会返回 permissionDenied;preToolUse 抛错是否拒绝取决于 hasFailClosedHooksForStep。随后 beforeMCPExecution 的 deny 也有拒绝分支。postToolUse 可以调整返回内容。这是可配置的执行包装机制;本局部分析没有验证系统沙箱或所有工具的授权执行。
### Worker 身份与当前工作区绑定
`nde` 复用进程时同时比较 CLI installId、worker spec、worker ID 和本地 API 可达性。源码有 Windows named pipe 与其他平台 socket 分支,并把用户/工作区相关的稳定标识交给 worker;`Ile` 清理时使用 ownerHash 元数据筛选。进程启动使用 windowsHide,记录退出事件与 pid/install 文件清理。这为“前端关闭后继续执行、前端重新连接已有工作进程”提供了客户端机制依据,但我们没有实际运行它。
## 提炼为自己的产品:六条独立设计原则
以下是工作台的建议设计,**不是从 Cursor 还原的产品源码或已验证的原版行为**。
1. **每次执行冻结一份工具能力表。** Tool registry 明确记录工具名、输入 schema、只读/写入性质、版本和当前权限;恢复时重新生成能力表并比较执行契约。
2. **把执行事件与聊天文本分开存储。** 同一 toolCallId 关联 queued、started、output、completed、failed、interrupted 事件,附起止时间;重连 UI 从事件流重建状态。
3. **恢复策略按操作类型区分。** 可重新运行只读查询;写文件或执行命令留下 pending/interrupted 状态与效果记录,由明确策略决定继续。不要把所有 pending 工具默认为可安全重放。
4. **先形成可审核的改动,再写文件。** 独立设计 Proposal 保存目标路径、基准文件散列、改动与 diff;应用前验证基准,应用后记录结果。基准散列与审核流程是我们的设计选择;已分析的 cte 方法只构造文本与引用范围。
5. **执行包装层提供统一前后事件。** 授权、参数验证、钩子、取消、结果转换和审计采用明确顺序;错误策略在设置中有确定语义,避免把失败后的“继续执行”当作隐含默认。
6. **UI 与任务进程可独立重连。** 用 workspace + owner 的工作进程身份、握手与健康检查连接已有执行器,单独持久化会话与事件;重启 UI 不应重复启动同一个任务。
首版可以采用 `Session → Turn → ToolCall → Event → Proposal` 五种独立数据对象。工作进程有明确协议:connect、start、cancel、readEvents、resume;恢复记录保存最近持久化事件和未完成调用,继续任务前重新核对当前项目与工具契约。
## 范围与未决项
已回答当前工具上下文、事件记录、待执行工具恢复、MCP 包装分支、纯文本 patch 和 worker 复用的局部实现。文件写入的最终适配器、会话数据库格式、回滚事务、用户交互 UI、远端模型调度与权限分类服务未完成端到端追踪。本报告没有断言恢复完整原源码,也没有把静态解析当作系统行为实测。
本地分析切片与完整 Evidence 用于研究定位;统一产品应引用结论和证据索引,并独立编写实现,发行包无需包含这些第三方代码切片。
## 复现资料
- `inspect-component.cjs`:从相同分发文件生成 AST 方法/位置索引及有限关键词定位。
- `extract-slices.cjs`:抽取选定 AST 范围,记录原工件散列、字节位置和必要声明包装。
- `build-evidence-index.cjs`:验证原文件未改变,计算关键方法字节范围及散列。
- `slices/slice-manifest.json` 与 `additional-slices/slice-manifest.json`:原范围到分析切片的映射。
- REA 使用 `analyze_javascript_application`、`detail: summary`、精确 `source_paths` 分析;完整 Evidence 已导出。
+448
View File
@@ -0,0 +1,448 @@
{
"schemaVersion": 1,
"date": "2026-10-29",
"timezone": "Asia/Shanghai",
"target": {
"product": "Cursor",
"version": "3.16.29",
"commit": "6246455961129c32969845e00aa25d87ae926ec0",
"productDate": "2026-08-18T01:26:26.285Z",
"productMetadataSha256": "7ad1aef6fca090c30e501d1db67ad4e1802ccac5710e895c61486f8525ae8565",
"packageMetadataSha256": "18dec6aef8d3997f4091e8f617b3b369ae82ee1b8aaa62b417e921c0a6e3ce61"
},
"sources": [
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"bytes": 10415138
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-worker\\dist\\main.js",
"sha256": "4255db956ce2f9193f65293dbd3806c60a6fd6571f7020b35cb28c1c5c513b63",
"bytes": 1305265
}
],
"rea": [
{
"role": "original-worker-artifact",
"parentEvidenceId": "ev_cebd28a6fee5c6940fee6249054cd080fca28e135e6083a3951c4a0a29d13b51",
"summaryEvidenceId": "ev_6f3959da3f4ac890b9a8a2478917d874099964ca5c7e78a355f0ec6ffd900de7",
"syntaxSources": 1,
"parseFailures": 0,
"semanticCoverage": "partial, retention capped"
},
{
"role": "seven-exact-source-slices",
"parentEvidenceId": "ev_789fa6618de0da72e2fde82f30aedcba8777533a0ed8c36397673fdd3792f7fe",
"summaryEvidenceId": "ev_56ecbd01cad5d328c1a870a3e8d27f4cd60e278baad8d31964c2a0f378a0338c",
"syntaxSources": 7,
"parseFailures": 0,
"semanticCoverage": "unknown/partial, external bindings unresolved"
},
{
"role": "dispatcher-and-patch-slices",
"parentEvidenceId": "ev_df7c229808fe5aa5f80a0f44fbb8c87861c3eb3593ad942d20589ada8853513d",
"summaryEvidenceId": "ev_7273722f04f439978b06cbff6fe2c4a656e5f5e3808fd6607985c1ec24f05631",
"syntaxSources": 2,
"parseFailures": 0,
"semanticCoverage": "unknown/partial, external bindings unresolved"
},
{
"role": "resume-property-caller-query",
"evidenceId": "ev_9869e34990c183da28cafa47f75a72bb843018002e1fad4c1144285d11de5f71",
"status": "ambiguous",
"seedMatches": 2,
"coverage": "partial"
}
],
"bundle": {
"path": "D:\\Ai-project\\REA逆向\\investigations\\cursor-agent\\analysis\\REA-CURSOR-EVIDENCE.json",
"bytes": 63324984,
"sha256": "004322b5fddffa8b81fb8a98eb7b495b357674a92647f3c886dcf0a7cf6b31f1"
},
"derivationManifests": [
"slices/slice-manifest.json",
"additional-slices/slice-manifest.json"
],
"claims": [
{
"id": "CUR-01",
"title": "Current tool context and dispatch",
"classification": "observed-static-syntax",
"locations": [
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": "M4",
"name": "buildToolExecutionContext",
"nodeType": "ClassMethod",
"utf16Range": {
"start": 1676093,
"endExclusive": 1678229
},
"byteRange": {
"start": 1676938,
"endExclusive": 1679074
},
"sourceLine": 2,
"sourceRangeSha256": "83323867ee991a683c3a5124e04e0410a5a89fd9fa44b38b1f9d86d6171e2ac7"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": "M4",
"name": "executeToolCall",
"nodeType": "ClassMethod",
"utf16Range": {
"start": 1681136,
"endExclusive": 1681532
},
"byteRange": {
"start": 1681981,
"endExclusive": 1682377
},
"sourceLine": 2,
"sourceRangeSha256": "dcfe7eb175bd61568396ac80d339d3c3934d14b58d54cc42d5b4c9316637a4e2"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": null,
"name": "a1",
"nodeType": "FunctionDeclaration",
"utf16Range": {
"start": 1509098,
"endExclusive": 1514586
},
"byteRange": {
"start": 1509929,
"endExclusive": 1515417
},
"sourceLine": 2,
"sourceRangeSha256": "72e6ce49a23bd77aea4a062e191906e792ab0c411a2482f7a4a7291c4eda071e"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": null,
"name": "xJ",
"nodeType": "FunctionDeclaration",
"utf16Range": {
"start": 617595,
"endExclusive": 623947
},
"byteRange": {
"start": 617757,
"endExclusive": 624111
},
"sourceLine": 2,
"sourceRangeSha256": "467e28338b612cb16ad099eba518e945cca60c61546b6110aff00e1958c8fc1a"
}
],
"runtimeObserved": false
},
{
"id": "CUR-02",
"title": "Tool event lifecycle and partial argument preservation",
"classification": "observed-static-syntax",
"locations": [
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": "AL",
"name": "executeToolCall",
"nodeType": "ClassMethod",
"utf16Range": {
"start": 639604,
"endExclusive": 641562
},
"byteRange": {
"start": 639768,
"endExclusive": 641726
},
"sourceLine": 2,
"sourceRangeSha256": "89aaa482b76b39e3a456507731df4e920e365d78bd48611469655d3bcab5b9d9"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": "AL",
"name": "recordPendingToolCall",
"nodeType": "ClassMethod",
"utf16Range": {
"start": 638236,
"endExclusive": 638489
},
"byteRange": {
"start": 638400,
"endExclusive": 638653
},
"sourceLine": 2,
"sourceRangeSha256": "575f5b6ffd57294283550a298c88a5779f8a94f224880eb2491a206a41506858"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": "AL",
"name": "applyDeltaToLatestToolCall",
"nodeType": "ClassMethod",
"utf16Range": {
"start": 635010,
"endExclusive": 635335
},
"byteRange": {
"start": 635174,
"endExclusive": 635499
},
"sourceLine": 2,
"sourceRangeSha256": "360c06591d1844c4e9e6e254a5fe267c16d1b7f5c847fde11c7e32a98836df4c"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": "AL",
"name": "emitToolCallError",
"nodeType": "ClassMethod",
"utf16Range": {
"start": 638641,
"endExclusive": 639241
},
"byteRange": {
"start": 638805,
"endExclusive": 639405
},
"sourceLine": 2,
"sourceRangeSha256": "3c414359c52aa1d5e9870c33473f8cec47813733ec97d0253f1f15ea824647ac"
}
],
"runtimeObserved": false
},
{
"id": "CUR-03",
"title": "Resume pending tools with optional execution contracts",
"classification": "observed-static-syntax",
"locations": [
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": "X5",
"name": "executePendingToolCalls",
"nodeType": "ClassMethod",
"utf16Range": {
"start": 1759140,
"endExclusive": 1762063
},
"byteRange": {
"start": 1759999,
"endExclusive": 1762922
},
"sourceLine": 2,
"sourceRangeSha256": "ad05b7640ef261ec5e59f67afc6d33febaf1fc5cc1c3c015fcc23b718bc5615c"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": "X5",
"name": "handle",
"nodeType": "ClassMethod",
"utf16Range": {
"start": 1762063,
"endExclusive": 1762846
},
"byteRange": {
"start": 1762922,
"endExclusive": 1763705
},
"sourceLine": 2,
"sourceRangeSha256": "e26f23010e90c5f41adb6aec93c45b3002ca19d664f1b4d35362c822f8ea27ac"
}
],
"runtimeObserved": false
},
{
"id": "CUR-04",
"title": "MCP hooks, denial and configurable failure handling",
"classification": "observed-static-syntax",
"locations": [
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": "Ie",
"name": "execute",
"nodeType": "ClassMethod",
"utf16Range": {
"start": 3056776,
"endExclusive": 3062194
},
"byteRange": {
"start": 3057884,
"endExclusive": 3063302
},
"sourceLine": 2,
"sourceRangeSha256": "f476afb90aab75cf3277715bbad84bf349465ee08fc838ad708e9bd68242ee55"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": "Ie",
"name": "firePostToolUse",
"nodeType": "ClassMethod",
"utf16Range": {
"start": 3062194,
"endExclusive": 3062646
},
"byteRange": {
"start": 3063302,
"endExclusive": 3063754
},
"sourceLine": 2,
"sourceRangeSha256": "11877b595ff5837e4c56fc918e02c685e743f6d84b5a407500fa8c80b7a00004"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": "Ie",
"name": "firePostToolUseFailureAsync",
"nodeType": "ClassMethod",
"utf16Range": {
"start": 3062646,
"endExclusive": 3063147
},
"byteRange": {
"start": 3063754,
"endExclusive": 3064255
},
"sourceLine": 2,
"sourceRangeSha256": "b64bb02d6e9f9ab539a56735b527f8f6a5a495e9203bfc0913466ed00317a051"
}
],
"runtimeObserved": false
},
{
"id": "CUR-05",
"title": "Pure text patch construction and citation ranges",
"classification": "observed-static-syntax",
"locations": [
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-exec\\dist\\main.js",
"sourceSha256": "ff3295964b51bc1d6446818d13660e26cca6b34ee183de6283505926b9885884",
"owner": "cte",
"name": "apply_patch",
"nodeType": "ClassMethod",
"utf16Range": {
"start": 2032889,
"endExclusive": 2033584
},
"byteRange": {
"start": 2033847,
"endExclusive": 2034542
},
"sourceLine": 2,
"sourceRangeSha256": "f95417fc9f8fe736699157edc0017d8d889c8b48ef5949a0adfbd9744d843cff"
}
],
"runtimeObserved": false
},
{
"id": "CUR-06",
"title": "Worker reuse, health and owner-scoped shutdown",
"classification": "observed-static-syntax",
"locations": [
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-worker\\dist\\main.js",
"sourceSha256": "4255db956ce2f9193f65293dbd3806c60a6fd6571f7020b35cb28c1c5c513b63",
"owner": null,
"name": "nde",
"nodeType": "FunctionDeclaration",
"utf16Range": {
"start": 1294925,
"endExclusive": 1302681
},
"byteRange": {
"start": 1294925,
"endExclusive": 1302681
},
"sourceLine": 1,
"sourceRangeSha256": "a7daa62760d922f54c6d25f3cc5928cf9d6689c6eb32e85c201839b37bfc7fe4"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-worker\\dist\\main.js",
"sourceSha256": "4255db956ce2f9193f65293dbd3806c60a6fd6571f7020b35cb28c1c5c513b63",
"owner": null,
"name": "Vle",
"nodeType": "FunctionDeclaration",
"utf16Range": {
"start": 1292832,
"endExclusive": 1293973
},
"byteRange": {
"start": 1292832,
"endExclusive": 1293973
},
"sourceLine": 1,
"sourceRangeSha256": "00abd98f58c5156dcf7c17a2bcf7901d4f0f8fe85399c539a9da4da452086345"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-worker\\dist\\main.js",
"sourceSha256": "4255db956ce2f9193f65293dbd3806c60a6fd6571f7020b35cb28c1c5c513b63",
"owner": null,
"name": "Ile",
"nodeType": "FunctionDeclaration",
"utf16Range": {
"start": 1289442,
"endExclusive": 1290330
},
"byteRange": {
"start": 1289442,
"endExclusive": 1290330
},
"sourceLine": 1,
"sourceRangeSha256": "9c386a7daebf65e34b9e67b707595d0c89f7426e5e9411dffd419c5c5e3b1a38"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-worker\\dist\\main.js",
"sourceSha256": "4255db956ce2f9193f65293dbd3806c60a6fd6571f7020b35cb28c1c5c513b63",
"owner": null,
"name": "_le",
"nodeType": "FunctionDeclaration",
"utf16Range": {
"start": 1288785,
"endExclusive": 1288977
},
"byteRange": {
"start": 1288785,
"endExclusive": 1288977
},
"sourceLine": 1,
"sourceRangeSha256": "cf0e39450dbfeab8342e4011cb551ca48122ef0069bf2b374156f2b7a7861fd5"
},
{
"path": "C:\\Users\\wangy\\AppData\\Local\\Programs\\cursor\\resources\\app\\extensions\\cursor-agent-worker\\dist\\main.js",
"sourceSha256": "4255db956ce2f9193f65293dbd3806c60a6fd6571f7020b35cb28c1c5c513b63",
"owner": null,
"name": "kle",
"nodeType": "FunctionDeclaration",
"utf16Range": {
"start": 1288977,
"endExclusive": 1289220
},
"byteRange": {
"start": 1288977,
"endExclusive": 1289220
},
"sourceLine": 1,
"sourceRangeSha256": "1b970f14607d4fc3d106a95c37843e29df07058eca479b4542d6ec2c4fd2696a"
}
],
"runtimeObserved": false
}
],
"limitations": [
"No Cursor or downloaded agent process was executed.",
"No user settings, tokens, databases or workspace content were inspected.",
"Source slices retain exact original code with only a declared class-expression wrapper when needed. Enclosing imports and scopes remain unknown.",
"REA static syntax coverage is not runtime behavior or full semantic equivalence.",
"Pending execution contracts are optional in the observed source; legacy fallback uses current static tools.",
"Patch construction slice does not prove disk writes, file rollback, or durable conversation recovery."
]
}
File diff suppressed because it is too large Load Diff
+118
View File
@@ -0,0 +1,118 @@
# Claude Code 2.1.312:工具调度、权限与结果机制
本次已建立工具调用的局部机制:校验输入并分类并发,排队进入执行路径,取得权限决定,通过最后检查后调用工具,再用原始 ID 交付结果。可以提炼成我们自己的本地代理执行器。全部结论来自静态发行工件与复制原文,没有运行 Claude Code 或读取个人会话。
**工件与证据范围**
目标沿用已取得的官方 Windows x64 发行包。EXE 为 `D:\Ai-project\REA逆向\Claude-Code-REA\artifacts\package-extracted\package\claude.exe`,大小 298690208 字节,SHA256 为 `6099672ebe5dcb518b67d1d32dde1e3360bc6bee1dae7f8d28a69c49acc7c865`;本次重新计算散列一致。
Bun 模块表已提取 2,581 个 JavaScript/entry 模块。本次实际选读 5 个原始分块中的 27 个函数/方法,组装成 5 份惰性分析文件。所有选段都与 EXE 原始载体字节逐一核对一致,来源索引保存 UTF-16 范围、UTF-8 字节范围、原始 EXE 范围和散列。
函数原文被保留,const 绑定、注释、exports 和部分 Js 类壳为分析时补入的结构。它们不代表原作者的完整源码,也不建立原应用的运行等价性。原来的 `B:/~BUN/root/...` 虚拟绝对路径、遗漏的依赖与动态关系仍未解析。
| REA 引用 | Evidence ID | 支持范围 |
| --- | --- | --- |
| 主分析 | `ev_78494b2b28703e1547eaa7b660ff70a6a1552991cd3b0e2727954779d74b5434` | 五份惰性文件的完整静态分析记录 |
| 摘要 | `ev_ec39090d21bdfd4352635ed4831e8518aa4703a7ade7ef8b8c9b18e7b580071d` | 选择、解析、覆盖和未知项 |
| 文件事实 | `ev_fa12f2ad8dcb53e765a942233134ead88dd4aabc03b0d6e1479be59a62898835` | 原始观察 ID、源散列和 AST 来源位置 |
REA 解析了 5 个文件,共访问 24,566 个 AST 节点,零解析失败;语义保留未被预算截断。应用图仍是 partial,语义图是 unknown,保留 5,046 个语义未知记录。模块页里的 25 个节点含合成导出角色,不能当作 25 个原始应用模块。视图的 complete-within-view 只表示视图已完整返回。
**调度与结果(C01、C02、C06;T03–T14、T24–T26)**
Js 保留调用 ID、assistant 消息、queued/executing/completed/yielded 状态、进度、桥接事件和结果。getCompletedResults 只把 completed 转为 yielded,输出后移除对应进行中 ID。未知工具以及中断、对话结束和流式回退都有原 ID 的错误结果。
addTool 用 inputSchema.safeParse 的正常成功结果调用 isConcurrencySafe(parsedInput)。解析不成功或并发声明函数抛错时,分类为不适合并发;safeParse 自身的异常并未在这个片段内同样捕获。canExecuteTool 的条件为“没有工具执行”,或者“新工具与所有正在执行的工具都安全”。processQueue 遇到不能启动的非安全排队项就 break,构成独占屏障。
processQueue 虽然 await executeTool,后者只是保存内部异步 promise 后返回,所以不能据此把所有工具解释为串行执行。安全工具的上下文 layers 缓冲到没有工具执行时才应用;非安全工具完成时应用自己的层。层合并 helper 的冲突行为仍未展开。
discardAndAbortInFlight 区分已完成/已交付、排队和执行中调用,但 callStarted 只是生命周期标记。`markToolCallStarted` 位于原分块 UTF-16 3920135,受保护的 `e.call` 位于 3921163;两者之间还有协调器拒绝、参数和工作目录检查。该标记不能证明副作用已发生,completed 也可能对应中止后的合成错误。
ud 通过工具调用 ID 找到对应 assistant 消息。RSo 收集结果 ID,并过滤含任一未配对工具调用的整条 assistant 消息;它不会生成成功结果。ID 配对的语法观察是明确的,真实执行是否完成仍需运行和持久化证据。
**权限与执行(C03、C04;T15–T23)**
选定本地路径在 EU 查找与路由后,经 gYr 进入 bYr。bYr 包含输入转换、schema 校验、可选 validateInput 和 PreToolUse hooks,然后取得 oFr 返回的 decision/input。
bYr 的 `No.behavior !== "allow"` 分支创建原始 ID 的错误结果并 return,早于其主要工具调用。权限处理器改写 updatedInput 后还要重新做 schema 验证,失败也返回错误。oFr 的条件检查可以把 allow 降为 deny;NVr、JP、WKe 等 helper 的完整语义未解析,不能据这一小段概括全部授权模型。
hv 可返回已有决定,也可进入 SDe。$yr 同时出现先行 allow 直接返回、带条件的 dontAsk 拒绝、自动分类和回退提示路径。本报告只读取相关的有限分支,没有审完该大型策略函数。
yF 在先行决定是 allow/deny 时直接返回;其余路径可以调用配置的 MCP 权限提示工具,并竞速等待提示结果、中止或符合条件的 hook outcome。服务器不可用、中止或 schema-invalid 回复返回 deny;非预期文本结果结构会抛错。某些工具类型或用户交互要求还会拒绝提示工具给出的 allow。AV 根据 stdio、直接决定和配置提示工具选择路径。
因此,“所有工具都需要人点确认”不是本次观察到的通用规则。我们产品的终端人工确认、授权有效期和恢复策略需要作为独立设计实现。这里证明的是选定本地主要调用的静态前置拒绝分支,远程执行器、hooks 的其他效果和全部模式没有端到端验证。
**MCP 恢复重试(C05;T27、G08)**
ct 的会话恢复分支只在 Mt < 1 时继续循环,因此最多追加一次恢复重试。它还要求以下一项成立:异常声明工具尚未执行(!mayHaveRun)、工具声明输入可并发、或者 MCP 的 idempotentHint 为 true。其他错误或重试耗尽走失败路径。
并发安全是这个客户端采用的条件,不能普遍等同幂等。BM 如何判断 mayHaveRun、远端如何恢复会话以及重复调用的真实影响未被运行验证。我们的实现应该把并发声明和幂等声明分成两项,并保留结果不确定的写操作。
**可以落入统一产品的六条独立设计原则**
| 原则 | 我们的实现契约 | 可检查结果 |
| --- | --- | --- |
| D01 把调用、启动标记和结果分开记录 | 每个逻辑调用使用稳定 call ID,重试另有 attempt ID;状态记录先于执行,完成结果持久化后才确认完成。预调用标记不能当作副作用提交证明。 | 拒绝、中止、未知工具和成功结果都能配对到原始调用;重启后不会把仅有启动标记的调用显示为成功。 |
| D02 在调度与执行前验证实际输入 | 模型输入、hooks 改写和授权者改写都经过 schema 验证;输入变化后重新评估权限和并发分类。这是我们增加的明确契约。 | 无效输入不会到达执行器;一个改写后的写操作不能继续沿用原读操作的并发分类。 |
| D03 用声明控制并发并保留独占屏障 | 工具显式声明是否适合并发;缺失、分类失败或异常采用独占执行。可并发组完成前阻挡独占写操作,独占队列项阻挡后续调用。 | 两个允许并发的读操作可同时运行;排在其后的独占写操作以及该写操作后的调用按屏障推进。 |
| D04 让授权决定与执行器使用同一份调用 | 保存授权来源、实际输入摘要和决定;执行器只接受仍有效的 allow。我们产品的终端人工确认策略属于独立设计,不能冒充 Claude Code 的通用行为。 | 未解决的 ask、deny、失效授权和不匹配输入不会到达主要工具调用。 |
| D05 中断后保留结果不确定 | 明确区分未启动、已完成和结果不确定的调用;对结果不确定的调用先核对已有结果及外部可观察状态,再决定恢复。 | 运行中崩溃或取消后,界面与日志显示可核对的不确定状态,并保留原调用 ID。 |
| D06 把恢复重试与幂等声明分开 | 恢复重试设次数上限;已知未执行或工具明确承诺幂等时可重试。并发安全和幂等使用不同字段,重试也重新检查授权。 | 可能已经执行的非幂等写操作不会因为网络恢复而自动再执行一次。 |
以上是原创产品设计提案,本次研究没有修改 Agent-Workbench 代码,也没有声明这些契约就是 Claude Code 的全部行为。
**来源定位**
下表的范围是原始派生分块内的半开 UTF-16 区间;T 编号在 `TOOL-LOOP.evidence.json` 中继续连接到 EXE 字节范围、散列、REA 源观察和生成切片位置。
| 选择 | 函数/方法 | 原始分块 | UTF-16 范围 |
| --- | --- | --- | --- |
| T01 | `Js.constructor` | `chunk-3vwg1wzf.js` | [57761,57856) |
| T02 | `Js.discard` | `chunk-3vwg1wzf.js` | [57856,57903) |
| T03 | `Js.discardAndAbortInFlight` | `chunk-3vwg1wzf.js` | [57903,58418) |
| T04 | `Js.addTool` | `chunk-3vwg1wzf.js` | [58575,59912) |
| T05 | `Js.canExecuteTool` | `chunk-3vwg1wzf.js` | [59912,60041) |
| T06 | `Js.processQueue` | `chunk-3vwg1wzf.js` | [60041,60252) |
| T07 | `Js.createSyntheticErrorMessage` | `chunk-3vwg1wzf.js` | [60252,61547) |
| T08 | `Js.getAbortReason` | `chunk-3vwg1wzf.js` | [61547,61729) |
| T09 | `Js.buildSameTurnToolUses` | `chunk-3vwg1wzf.js` | [62246,62559) |
| T10 | `Js.buildSameTurnErroredToolUseIds` | `chunk-3vwg1wzf.js` | [62559,62888) |
| T11 | `Js.executeTool` | `chunk-3vwg1wzf.js` | [62888,65821) |
| T12 | `Js.getCompletedResults` | `chunk-3vwg1wzf.js` | [65821,66402) |
| T13 | `Js.getRemainingResults` | `chunk-3vwg1wzf.js` | [66511,67084) |
| T14 | `Js.applyEndedRunLayers` | `chunk-3vwg1wzf.js` | [67084,67384) |
| T15 | `EU` | `chunk-9hk5qx04.js` | [3891097,3896902) |
| T16 | `gYr` | `chunk-9hk5qx04.js` | [3896902,3899334) |
| T17 | `bYr` | `chunk-9hk5qx04.js` | [3902063,3936718) |
| T18 | `oFr` | `chunk-9hk5qx04.js` | [3860602,3860892) |
| T19 | `hv` | `chunk-9hk5qx04.js` | [2927234,2927304) |
| T20 | `SDe` | `chunk-9hk5qx04.js` | [2927379,2927814) |
| T21 | `$yr` | `chunk-9hk5qx04.js` | [2928029,2967785) |
| T22 | `yF` | `chunk-qey7z5yq.js` | [823883,826935) |
| T23 | `AV` | `chunk-qey7z5yq.js` | [827368,828434) |
| T24 | `dd` | `chunk-gets36qn.js` | [32523,32832) |
| T25 | `ud` | `chunk-gets36qn.js` | [32832,33209) |
| T26 | `RSo` | `chunk-gets36qn.js` | [119632,119984) |
| T27 | `ct` | `chunk-d8k5k6qc.js` | [112235,114722) |
**问题覆盖和剩余未知**
| 问题 | 当前状态 | 边界 |
| --- | --- | --- |
| 生命周期、并发屏障、结果 ID 与取消分类 | 已回答选定静态路径 | 工具实现与运行副作用仍未知 |
| 主要工具调用前的输入验证和权限拒绝 | 本地路径已有明确分支 | 远程执行与 helper 关系只部分回答 |
| 权限模式、规则和 MCP 提示 | 部分回答 | 只读了大型策略中的有限相关分支 |
| 会话恢复重试上限与判定条件 | 已回答选定 ct 路径 | 服务端执行确定性及幂等真实性未知 |
| 原客户端完整运行行为与全程序等价重构 | 未验证 | 没有执行目标,完整跨模块关系未建立 |
本次定位与否定结论都限定在选定文件/函数。合成错误、AbortController 和启动标记提供调度层事实,不能推断外部动作已撤销、底层进程已结束或持久化结果已提交。
**交付文件**
- [证据索引](TOOL-LOOP.evidence.json):27 个完整选段、8 个关键语法锚点、结论和独立设计原则。
- [字节验证](TOOL-LOOP.verification.json):EXE 散列重验、27 处载体文本比较和生成位置。
- [REA 视图原记录](TOOL-LOOP.rea-receipts.json):本次返回的完整摘要与视图 Evidence。
- [完整 REA Bundle](TOOL-LOOP.evidence-bundle.json):26216217 字节,7 个记录;包含完整主图,供后续离线查询。
- [惰性切片来源](tool-evidence/provenance.json):原始字节与分析包装说明。
统一产品可收录报告与证据索引;完整分析图和第三方函数切片保留在研究目录。
Binary file not shown.

After

Width:  |  Height:  |  Size: 99 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 118 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 133 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 85 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 74 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 95 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 147 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 94 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 142 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 156 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 223 KiB

+20
View File
@@ -0,0 +1,20 @@
{
"success": true,
"version": "1.0.0",
"testedAt": "2026-10-29T02:38:42.473Z",
"extractedWorkspace": "D:\\Ai-project\\REA逆向\\Agent-Workbench\\.qa\\source-package-validation-802228e808ec4c20aeb25d09eab23353\\Agent-Workbench-1.0.0-source",
"testedSourceArchiveSha256": "74505f3af1adb3c758ed3a6348a7123526914f8ec0a03a5d224d8d4f30e3fbf9",
"dependencyInstall": "npm ci --offline --ignore-scripts --no-audit --no-fund",
"build": [
"TypeScript",
"Vite",
"server and upgrade esbuild bundles"
],
"behaviorTests": {
"passed": 34,
"failed": 0,
"skipped": 0
},
"includedLegacyFixture": true,
"scope": "Independent extracted source package; no user model connection or project used."
}
+27
View File
@@ -0,0 +1,27 @@
{
"success": true,
"url": "http://127.0.0.1:4319",
"browser": "Microsoft Edge 156.0.4314.42",
"date": "2026-10-29T02:12:37.836Z",
"projectRoot": "D:\\Ai-project\\REA逆向\\Agent-Workbench\\.qa\\ui-88c1fbd5-8746-4caa-a7da-94f0f00fc703\\ui-project",
"viewports": [
1440,
780,
390
],
"passed": [
"project selection and real file preview",
"real command consent, execution and stale snapshot rejection",
"diff review and verified file application",
"manual editor creates a reviewable proposal",
"file responses stay with the current selection",
"denial, session selection, reload, stale response rejection and export",
"project inventory responses cannot replace another project",
"780 and 390 px: project drawer, file, diff and trace controls, no page overflow",
"unified and detailed research reports render",
"model list, ephemeral key, compatible fixture tool loop and return to offline mode"
],
"pageErrors": [],
"requestFailures": [],
"modelValidation": "controlled local HTTP fixture; no real model"
}
+12
View File
@@ -0,0 +1,12 @@
{
"version": "1.0.0",
"pid": 23080,
"hasKey": true,
"projects": 2,
"sessions": 3,
"appDirectory": "D:\\Ai-project\\REA逆向\\Agent-Workbench\\releases\\Agent-Workbench-1.0.0-win-x64",
"verified": true,
"connectionPreserved": true,
"url": "http://127.0.0.1:4318",
"testedAt": "2026-10-29T02:24:14.243Z"
}