feat(intercept): 模型审查补充任务上下文与裁决说明 (#124)

审查模型改为接收版本化 JSON:任务描述/目标/操作约束、工作目录、Worker 意图、当前轮输入,以及按 tool_use_id 配对的近期工具执行记录;末尾是完整的 tool_name 与 arguments。

- 任务约束每次审查从数据库重新读取;读取失败或约束超预算转人工。
- 历史只保留唯一配对的执行事实,排除 Agent 自述、未完成请求与平台拒绝反馈。
- 裁决改为 JSON decision(allow/ask/deny) + comment,三种结果均须说明实际操作、成功后果与命中规则。
- 所有模型裁决(含自动放行)保存实际模型输入与 SHA-256 指纹,详情页可展开。
- 对话审批卡片支持展开完整请求、模型输入、裁决与执行结果。
- 修复父目录 lockfile 导致的 Turbopack 根目录误判。

官方默认拦截规则、工具范围与优先级不变。
This commit is contained in:
RuoJi6 authored and GitHub committed 2026-09-15 20:08:12 +08:00
1 parent 234bd8bf8e
commit c0d1aa6f37
26 files changed
+1159 -199

No files matched your search

+17 -3
View File
@@ -48,18 +48,32 @@ AI 自主渗透测试系统(Go 后端 + Next.js 前端)
## 审批记录详情
全局「审批记录」和任务内「拦截审批」支持点击行或展开按钮查看详情。展示结构参考
全局「审批记录」、任务内「拦截审批」及对话中的审批卡片均支持展开查看详情。展示结构参考
[AegisHook 的审批详情组件](https://github.com/RuoJi6/AegisHook/blob/main/web/src/components/CallDetail.vue),沿用 ARTEX 的组件和主题:
- 工具请求与审批裁决左右分栏,手机端上下排列;待审批记录可在详情中允许或拒绝。
- 展开上下文可查看当前轮输入、会话记录片段、模型或规则初判、执行输出、调用 ID 与参数/审查配置的 SHA-256 指纹。
- 展开上下文可查看当前轮输入、会话记录片段、模型或规则初判、执行输出,以及调用 ID、参数/审查配置/模型输入的 SHA-256 指纹。对话审批卡片按需加载完整请求,长参数可展开复制。
- 审批状态和执行结果分别保存。模型直接允许也会记录;重复提交已处理审批返回 HTTP 409。
- `GET /api/intercept/history/{id}` 按需读取详情,原列表接口不返回上下文和输出。数据库启动迁移自动补列;旧记录显示未记录,旧任务归档可正常恢复。
上下文是工具请求产生时保存的会话记录片段,最多 24 条、每条 8 KiB;当前轮输入最多 32 KiB,执行输出最多 64 KiB,截断会明确标注。
当前裁判模型仍只接收工具名称和参数,展示的会话上下文不代表模型已使用这些内容作出判断。
当前 Norma SDK 的审批钩子不包含调用 ID,因此仅在当前运行中能够唯一匹配工具请求事件时关联结果;相同参数的并发调用无法唯一匹配时,会显示未关联,避免错误归属。
### 上下文模型审查
参考 AegisHook 将任务约束、执行事实与当前调用分开的设计,模型现在接收版本化 JSON:任务描述、目标和操作约束,本机工作目录、Worker 意图、当前轮输入,以及配对的近期工具执行结果;末尾保留完整工具名和 JSON 参数(包括交互 Shell 的会话 ID)。
- 任务约束每次审查从数据库重新读取。自动发现的资产不视为新增授权;约束登记来源也不等同于逐条人工批准。任务上下文读取失败或约束超过 16,000 字节时转人工,避免遗漏禁止项后自动放行。
- 意图和当前轮输入只提供背景,不能要求模型改变裁决。历史仅保留按调用 ID 配对的执行事实,排除 Agent 自述、未执行请求和平台拒绝反馈;失败结果可能包含部分副作用。
- 审查历史最多保留 6 对,每对参数预览和结果各 2,000 字节;描述、目标、意图和当前轮输入各最多 4,000 字节,截断有明确标记。有限窗口不能用作全任务累计计数;当前调用参数不截断。
- 所有模型裁决(包括自动允许)的详情均保存实际提交模型的 JSON 及指纹。页面优先展示该快照中的当前轮输入、任务背景和配对工具记录,并可展开完整 JSON;较大的原始会话审计片段单独展示,不重复保存在自动允许记录中。旧版仅保留指纹的记录明确提示无法还原原文,不用当前数据补造历史。
- 模型输出 JSON 的 `decision`(allow / ask / deny)及 `comment`;三种裁决的说明均必须包含“实际操作、成功后的后果、命中规则”。缺少说明、重复字段或不完整 JSON 按已配置的模型失败策略处理,不伪造模型解释。
- 自定义审查策略保留,运行时统一追加输入信任边界和 JSON 输出协议,旧的单行输出要求由新协议替代。模型按当前操作的全部直接效果裁决,结合成功创建记录确认测试产物归属;写入报告只描述保存文本,不将正文记述的上传或命令当作本次执行行为。
官方默认规则、工具拦截范围和优先级不变:仅范围内且未命中规则的调用进入已启用的模型审查。模型未启用时沿用原行为;模型调用异常仍遵循用户配置的失败策略。
可选真实模型回归:将 `judge.base_url`、`judge.api_key`、`judge.model` 放入仓库外私有 JSON,通过 `ARTEX_REVIEW_LIVE_CONFIG=/path/to/private.json go test ./server -run '^TestLiveContextReview$' -v` 运行。该测试只提交合成审查输入,不执行其中的命令;数据库测试应另行配置隔离 PostgreSQL。
## 资产同步(ScopeSentry)
支持从 [ScopeSentry](https://github.com/Autumn-27/ScopeSentry) 直接同步资产数据,免去重复收集: