用两千字节审计智能体每轮操作
Ankita AI 在每轮任务结束后留存一份上限为 2,048 字节的审计记录,工具名和涉及的文件路径各最多记录 20 项。参数、命令和输出均省略,审计记录与会话日志并列保存。
AI 深度解读
Ankita AI 能在用户离开时改文件、跑命令。等用户回来,想知道「刚才到底改了什么」,却得翻几页对话。作者给每轮执行加了一张最多 2,048 字节的回执,默认最多记 20 个工具名、20 条文件路径,保留 0 个原始参数。
这个设计适合有工具调用能力的 AI 编程助手。它让项目页能直接展示每轮工作的线索,生成摘要也不需要再调一次模型。原文还点出了一个实际取舍:如果文件是被 shell 命令间接改掉的,这张回执就可能漏记。
每轮回执只留下工具名和文件路径
每轮开始时,src/core/agent.mjs 创建一份审计记录。普通工具调用和 MCP 工具调用分别经过 runToolCall 和 runMcpToolCall,两条入口都会用 noteToolUse 记录工具名。同一个工具调了五次也只占一个名额,超过上限的记录计入 dropped。工具名和路径的上限分别由 projectAuditMaxTools 和 projectAuditMaxFiles 控制,默认都是 20,硬上限都是 100。单条路径最多保留 200 个字符。
工具被调用和文件被改动是两件事。noteToolUse 在调用时记工具名,noteFileEffects 等结果回来才记文件影响。结果如果以 Error: 开头,这次调用就不会被当成一次成功的文件修改。原始参数、工具输出和命令文本都不写入回执。像 path 这样的字段可以用来提取路径,最后留下的是提取结果。
文件路径来自工具的语义
src/core/tool-effects.mjs 统一定义哪些工具会影响文件,桌面的工作区监听器也用这套规则。名单里有 write_file、edit_file、edit_lines、apply_patch、move_file、delete_file 和 restore_file。image_generate 和 image_download 也会把本轮标记为有变动,但不给生成产物记路径。
不同操作留下的线索也不同。move_file 记录源路径和目标路径。apply_patch 从 rename from、rename to 和 +++、--- 这些 diff 头部提取路径。其余文件操作取 path 字段。工作区内的文件记相对路径,工作区外的文件记绝对路径,路径会去重。这些记录来自工具及其返回结果,代码没有逐个核对磁盘上的文件是否真的发生了变化。
项目页用固定规则生成工作日志
轮次结束后,finishTurnAudit 把记录收尾。如果序列化后的 JSON 超过 AUDIT_MAX_BYTES 规定的 2,048 字节,就先删文件路径,再删工具名,每删一项都增加 dropped。能看到丢弃量很重要,否则读者很容易把剩下的几条路径当成完整清单。
sessions.mjs 把回执保存在对话日志的 entry.audit。如果回执标记了有变动,src/memory/project-maintenance.mjs 里的 maintainTurn 就给项目追加一行,写入结束原因、文件数和最多 5 条路径,例如 model_answer · 3 file(s) · src/a.js, src/b.js, docs/c.md。这一步消耗 0 次模型调用,记账出错也只通过返回值反映,当前轮次可以继续。PROJECT_WORK_CAPTURE=false 可以关闭审计,PROJECT_AUDIT_MAX_TOOLS 和 PROJECT_AUDIT_MAX_FILES 可以调整条数上限。
我的判断
我认同把这种回执用作项目页的索引。相比让模型回读整段对话再总结,固定规则能直接给出工具名和路径,输出边界也更明确。作者在 test/memory/turn-audit.test.mjs 里用 6 个测试覆盖了工具去重与限额、文件影响标记、相对路径去重、移动与补丁提取、字节上限和空审计的结构。原文没有对照数据来证明它比人工翻日志更快,也没量化实际漏报率。关于它能省多少排查时间,只能当作作者的使用经验。
最大的前提是,团队的大部分修改都经过能明确指出路径的工具。run_command 和 git 能改写文件,却未必把路径告诉审计层。虽然 WORKSPACE_EFFECT_TOOLS 会让桌面刷新文件树,项目日志依然拿不到本轮改写的路径。记录命令文本能提供排查线索,但命令本身也无法证明哪个文件最后变了,还可能把敏感参数留在持久记录里。如果团队常用命令批量生成或改写代码,轮次前后对比工作区更接近要回答的问题。代价是用户或其他进程同时写入时,单凭差异很难判断是谁改的。
能拿来做什么
- 给前端或 Node 项目的 AI 编程助手做执行历史时,可以从工具调用层收集去重后的工具名,再从专用写入工具提取路径,直接在项目页显示每轮回执。
- 让改代码的操作尽量经过
apply_patch、edit_file这类能提取路径的入口。对仍需经过run_command的操作,可以在界面上明确提示「文件影响未知」,避免空路径被读成没有改动。 - 给工作日志加体积上限时,用长路径测试 JSON 序列化后的实际字节数,并在展示层保留丢弃计数,让用户知道什么时候需要回查原始记录。