Repository navigation
v0.9.10
移植 ARTEX 的统一报告实现:把同一缺陷的重复上报归并成漏洞文件夹,由报告 Agent 在读取
全部成员原始材料后生成一份统一报告;原始 finding 的报告、评级与证据始终保留。
新增
- Report Agent 的统一报告工具:新增
search_finding_duplicates、get_finding_record、
merge_finding_records、suggest_finding_merge、get_finding_case、
update_finding_case_report,默认绑定到 reporter。工具只在当前任务内操作;归并保留全部
原始记录,疑似分组 2–20 条提交人工确认而不是自动合并;已有案例会被 union 成同一个文件夹。 - 统一报告完整性校验:保存时必须包含有内容的概述、影响、前置条件、复现步骤、证据、
PoC、根因分析、修复建议,代码块必须闭合;评级依据必填,评级不得直接取成员最高等级。 - 案例版本与证据新鲜度:案例
version随任一成员 finding 修改或移出自动前进;统一报告
保存时 CAS 实际读取的version,report_version记录该版本。成员或原报告变化后旧版本写入
返回冲突并要求重新读取,不能只换 version 重试。案例详情、列表、「按漏洞」视图会显示
「统一报告未生成/已更新/待更新」。 - 统一报告导出:发现页导出新增「同一漏洞文件夹合并为一份统一报告」(默认勾选)与
「同时附原始子报告」。导出先展开完整案例并冻结成员证据,再合成为一条统一报告记录;
统一报告缺失或过期时明确标注,并附全部原始证据。Markdown 文件名、CSV 编号、JSON DTO
都标识案例与成员,zip 内统一报告仍复用已冻结的成员流量证据。 - Reporter 工作流提示:仅当 reporter 拥有案例工具时追加统一报告指引(合并须同根因、
疑似分组需具体共同点、版本冲突重新读取),worker 与关闭流量绑定的环境都不会收到该段。 - 数据层:
finding_case_version_changed触发器跟踪成员变化;MergeFindingCase支持
已有案例并集并遵守人工否决;SuggestFindingCase保存分组建议;FindingCaseID用于导出
展开;案例读取补齐成员原始报告。
边界
- 未移植 ARTEX 的「历史整理」评审运行(
finding_case_review_runs)与complete_finding_case_review;
统一报告由 reporter 在正常上报流程中生成,或由人工在案例对话框编辑。 - 统一报告是独立材料,不覆盖、不删除任何原始 finding 或报告;不改变探索/规划策略。
验证
- 新增回归:案例版本随成员修改/移出前进、旧版本保存冲突、空报告拒绝、完整章节校验、
案例并集与人工否决、Reporter 工具归并/建议/保存/跨任务拒绝、工具播种绑定、导出展开与
过期提示、原始子报告选项;Go 全仓测试与db/server/agent/reportrace 通过,go vet、
staticcheck、gofmt通过;前端tsc、59 个单测与静态构建通过。
探索流程切换为 ARTEX 实现
同一目标上 ARTEX 能完成、BLADE 默认 classic-hybrid 反复打转;本轮把 BLADE 的探索层直接
替换为 ARTEX 行为,而不是继续调参开关。
- planner 提示词:默认正文改为 ARTEX 的决策流程(硬底线、0 意图正当理由、
done/exhausted/blocked 复盘、开局只读探测 ≤3 次、深度优先、2–3 条不同机理路线、
TodoWrite 串行链、prove_goal 前量化核对)。移除混合骨架、槽位利用率、广度/台账/复盘/
收官/穷尽/升级阶梯/血缘/意图契约/摘要纪律等代码持有约束块;任务级自定义提示词仍优先。 - 调度:删除 anti-stall 补派与“连续 3 轮空转自动暂停”、supervisor 定时纠偏、
穷尽复核、goalless 遗留物收尾门;0 意图只按心跳/图变化继续等待,与 ARTEX 一致。 - 意图准入:
add_intent只保留 summary、parent 类型、资产可见范围与资产拦截校验;
删除 risk_area/kind/goal_id/uses_loot_ids/depends_on/requires/contract/幂等键/防打转/
队列上限/批量/开局粒度/收官提醒等门与回执。旧字段仍可解析但被忽略。 - 领取与完成:Frontier/Count/Claim 不再按 depends_on/requires 过滤,也不再按 owner
槽位亲和或同逻辑会话互斥拒绝;历史边与 payload 保留为只读数据。完成只由逐 goal
prove_goal(或 goalless frontier 抽干)驱动,无覆盖/深度/遗留物完成门。 - 设置面:设置页移除探索约束预设、队列倍数、收官审计与 supervisor 控件;旧的
profile/policy 数据保留但探索层不再读取。授权/资产拦截、guard、任务约束文本、写入栅栏、
租约/恢复身份、报告与证据功能保持不变。 - 迁移:启动时把 planner 当前正文切换为 ARTEX 默认(旧版本保留在提示词历史);已有
depends_on/requires 意图不再被阻塞,旧任务恢复后会按 ARTEX 顺序执行。
planner 探索入口补齐
- planner 补回 ARTEX 的三个探索入口:
report_finding(已确证漏洞可直接登记)、
add_task_scope、add_company_scope;老库通过一次性迁移补绑,执行类工具仍不回到 planner。 - 移除 planner 的 policy 提示段与穷尽复核反馈注入(探索层已无 policy/穷尽门);任务操作
constraintBlock保留。 - 未删除 BLADE 的战果、遗留物、痕迹、打法库、CVE、AD、opsec、长任务执行等能力;worker
工具面与写回保持原样。 - 前端同步删除探索策略/约束/审核员/收官审计/队列/穷尽复核相关控件与类型:系统设置「探索策略(全局默认)」、
任务创建策略覆盖、任务详情探索策略卡、穷尽复核展示及对应 API;授权范围、任务拦截规则、操作约束注入、
战果/遗留物/痕迹/打法库/CVE 等非探索 UI 保留。
主 agent 工具 schema 瘦身
- 新增
mainDeferredTools(22 项):足迹/遗留物补记与销账、CVE/打法/AD/opsec 查询、
重复漏洞合并、知识沉淀、凭据验证、出口切换等低频工具的 schema 不再随每轮对话发送,
需要时用SearchExtraTools取用。 - 报告核心写回保持常驻:
report_finding、record_fact、report_foothold、
report_credential、insert_assets,以及全部态势查询/意图/提示/目标工具。 - 工具实现与绑定不变;每轮约少 13,700 字符工具 schema。
worker 工具 schema 瘦身
- 新增
workerDeferredTools(18 项):足迹/遗留物销账、CVE/打法/AD/opsec 查询、
执行台账的检索/取消、出口切换、候选关闭等低频工具的 schema 不再随每轮 prompt 发送,
只把名字列进 deferred 块,需要时用SearchExtraTools取用。 - 高频写回与执行主路径保持常驻:
record_fact、report_finding、report_credential、
report_foothold、report_artifact、insert_assets、run/wait/get_execution等。 - 工具实现、绑定与 capability 不变;每轮约少 11,200 字符工具 schema。
- OAST 未配置、
loot_exec关闭时原有的运行期裁剪继续生效。
planner 工具面精简
- planner 默认绑定不再包含写回/动作类工具:
record_playbook、promote_knowledge、
merge_findings、rotate_egress、list_worker_traces。实现全部保留:前三者与
rotate_egress本就在主 agent/worker 上;record_playbook仍绑 playbook agent;
list_worker_traces保留在工具目录,可按需改绑。 - 只读知识查询继续留在规划层:
lookup_cves、lookup_playbooks、record_playbook_feedback、
ad_paths、opsec_notes,规划初期即可按资产/指纹查已有打法与 CVE。 drop_intent、link_intent_source、accept_artifact_risk、accept_footprint_risk、
list_footprints保留在 planner;worker 工具面不变。- planner 的 CVE 提示段改用只读版(不再教它调用 worker 的
cve_exploit);出口纪律按角色
区分 worker(可conclude_intent)与 planner/主 agent(只写回说明);态势提示中的
翻页工具改为search_all_worker_traces。 - 老库通过一次性迁移
planner_tools_slim_v1解绑上述 planner 默认绑定,不触碰其他 agent。
移除被拦退避纪律
- 删除
backoffDisciplineBlock(原始终注入 planner/worker 的「403/429/WAF 后如何退避、
最多重试几次、何时换方向」提示段)。被拦后的处置改由模型结合响应自行判断,不再由代码
规定重试次数与换向节奏。 - 出口代理纪律段保留(禁止绕过代理、出口不可用时的处置),它对应真实的 IP 泄露风险。
移除 P20 探索策略
- 删除
policy/包及意图层策略门、额度快照与拒绝留痕:add_intent只做参数、父节点、
资产范围与拦截校验,不再按内容或节奏拒绝意图。 - 删除策略端点
/api/settings/exploration-policy、/api/tasks/{id}/policy[/preview|/prune]
及server/policy_compile.go;任务创建/计划任务/LLM 任务接口不再接受exploration_policy。 - 任务结构、创建选项、DTO 与数据库读写移除
exploration_policy;tasks.exploration_policy
列保留在库中但不再读写,已有快照数据原样保留。 - planner/worker 不再解析或注入策略段;
policyResolver、policyBlock、SeedRedTeamPolicyDefault
与已无调用点的RecentPolicyRejects/LastIntentCreatedAt/CountIntents一并删除。 - 前端删除任务列表策略角标、
policy_*类型字段、policy_reject/policy_update标签与设置页
「探索策略额外禁止」空行;policy_blocked仅作为历史终态保留,当前代码不再写入。 - 命令门仍可由操作约束(P18)编译成任务级拦截规则;本次只移除探索策略这一来源与全部意图准入。
清理执行审核员与穷尽复核
- 删除运行时已无调用点的 supervisor(执行审核员)与穷尽复核实现、引擎字段/注入、设置字段与
/api/exploration/exhaustion-reviews路由;任务会话列表不再显示「审核 Supervisor」会话与相关活动标签。 - 保留 guard/拦截规则/人工审批(它们不是这两个审核),授权与任务约束不变。
验证
- 新增 ARTEX parity 回归:planner 提示/工具面无 BLADE 约束块;add_intent 最小 payload
直接成功且旧字段被忽略;Frontier/claim 忽略历史依赖与 requires;全仓go test -race、
go vet、staticcheck、gofmt;前端tsc、59 个单测与静态构建。