用途:为渗透测试提供跨会话的项目黑板,状态落在已绑定项目的 SQLite 中,不依赖对话上下文,也不使用 .pentest/ 目录。系统自动注入仅含 fact_key 与 summary 的黑板索引,摘要不足时必须调用 get_project_fact,禁止凭摘要臆造细节。
主要能力:Fact 通过 upsert_project_fact 写入 project_facts,同 fact_key 覆盖更新,confidence 取 confirmed、tentative 或 deprecated;关系边写入 project_fact_edges,通过 upsert 的 links 表达结构化攻击图,finding、chain、exploit、poc 必须带 links;可交付漏洞用 record_vulnerability 记录,与 Fact 可各记一次,Fact 存复现上下文,漏洞为正式 finding。检索用 list_project_facts、search_project_facts,误报用 deprecate_project_fact 废弃、restore_project_fact 恢复,漏洞查重用 list_vulnerabilities、get_vulnerability。
使用方式:前置条件是当前对话已绑定项目,否则工具报错。fact_key 采用小写 category/slug 格式,环境类用 target、auth、infra、business,发现利用类用 finding、chain、exploit、poc,另可用 note。summary 一行须含什么、在哪、如何触发或验证;body 写完整可复现上下文,发现利用类须含入口、步骤、原始请求响应或命令、现象、证据及 related_vulnerability_id。更新时省略 body 会保留库中已有 body。links 省略表示保留已有边,传入则替换全部入边,常用 type 有 discovered_on、depends_on、leads_to、enables、exploits、contains、part_of、supports。
适用场景:单代理或 deep 模式边干边写;plan_execute 模式在步骤产出认知后立即落库,重规划前先检索;supervisor 模式由协调者汇总子代理的待落库条目写入,子代理无工具时在交付物末尾给出建议 fact_key、summary 与 body/POC 要点。
限制:未绑定项目时无法写黑板,只能在本轮保留证据摘要;不设 Bootstrap、Reason、Explore 磁盘状态机;凭据等敏感信息需注意脱敏与授权范围。其余收费、平台与效果信息暂未提供。