Files
Agent-Workbench/docs/REA-INTEGRATION.md
2026-10-30 05:39:00 +08:00

3.7 KiB

REA 内置研究切片

目的:把用户指定的发行工件接入同一项目与Task,取得可核验的原分析依据,供自有代理读出机制并独立开发。首批支持ASAR的JavaScript/Electron静态分析,以及EXE/DLL的PE导入表、静态资源。完整公开源码仍使用普通工程工具。

工件由用户在工作台登记绝对路径、名称和研究问题;登记绑定项目/会话/Task/Run及SHA256。模型只能选择已登记target_id和三项固定操作,不能通过目标文本更改启动命令、执行目标程序或登记任意外部路径。初次登记可创建研究Task,模型请求数保持零。

每次实际分析使用独立所属stdio连接,固定REA6.8.0、MCP2025-03-26、Node路径和入口文件身份。实际initialize、分页tools/list、选定工具schema、调用参数和响应分别保存。ASAR先取摘要,其parent_evidence_id必须在同连接导出的完整Bundle中指向原analyze_javascript_application记录;摘要不是原分析。PE返回的原记录同样导出并核对。

分析前后重新读取工件SHA256;完整Evidence的subject/normalized目标哈希必须匹配登记版本。原响应、完整Bundle、原Evidence、来源绑定、传输记录及关闭结果分别存为SHA256工件。超过单项8MiB的文档按Unicode边界分片,总接收范围64MiB;清单及每片归属、字节、全文哈希都要验证。

同Task同版本的完成结果默认复用,复用前核对当前文件和全部原证据,不再次调用生产者。未完成、停止、断线或校验失败的操作保留原状态,模型不能自动重新分析;用户从面板明确发起新分析时创建新记录。重启不重放分析,也不根据历史PID停止进程。进程关闭不确定或已派发但没有返回的分析记录为unknown,不能当成核验完成。

模型工具为list_research_targets、analyze_research_target、read_research_evidence,仅在当前Task有登记工件时发送。字段读取使用原Evidence的JSON Pointer与协议预算分页,完整源文档仍保留;读取字段不会再次连接REA。原限制、静态候选和运行未知必须随结论保留。

界面沿用工作台已有纸白与深青风格:paper #fcfdfc、surface #edf3f1、ink #1c2e32、teal #154b4a、line #dce7e2、utility blue #4664d9。正文与标题使用Segoe UI/Microsoft YaHei,身份和原字段使用Cascadia Code/Consolas。登记区与原结果区分栏;390px按阅读顺序堆叠。标志性元素是实际来源链:工件SHA → 已核对REA版本 → 原Evidence,只有核验完成才显示;它表达真实来源而非装饰性步骤。

验收分开登记:确定性契约/中断/来源测试、真实REA惰性工件分析、实际API持久与重启、桌面/390px交互,以及不可变发行内自带REA运行。机制研究完成不表示已经复制远端模型服务或交付所有外部引擎。

便携与源码发行均保留固定REA6.8.0的已安装生产依赖;runtime/REA-PACKAGE-LOCK.json保存原安装锁,runtime/REA-RUNTIME.json记录每个包的版本/许可/完整性元数据、缺失可选包和实际文件SHA256。原包与依赖许可证保留在runtime/node_modules及主许可目录。构建不运行REA setup、不写客户端配置、不隐式安装缺少的可选分析器;实际保证范围以发行内三项分析验收为准。

Windows导出路径按UTF-8预留240字节:普通Task输出留在会话数据目录,深数据目录改用宿主TEMP下AgentWorkbench-REA/原jobId。实际目录及归属随job持久保存;原输出保留,完整Evidence与Bundle仍封存至同一Task工件库,恢复不依赖重新运行生产者。不能满足路径范围时在启动REA前失败。