SuperAPI AI 工具集

openhound-entity-panels

编程与开发

查看项目

更新于 10-29 17:14

技能介绍

用途:该技能面向 OpenHound 扩展维护者,用于更新 extension/schema.json,为每种节点类型和关系类型添加、迁移、审查或校验 BloodHound OpenGraph 实体面板定义。

主要能力:

  1. 节点面板:每个节点类型必须有位于第 1 位的 Description;第 2 位 Inbound Traversable <Platform> Relationships;第 3 位 Outbound Traversable <Platform> Relationships;之后为一个或多个节点特定 Cypher 调查面板。两个关系摘要面板为强制项,即使某方向无关系也要提供空状态,且查询须覆盖该方向全部直接可遍历关系。
  2. 关系面板:按源文档每个二级标题(##)拆分为一个面板,保持源顺序并以连续 position 排列;## General Information 或 ## General 映射为 general、标题 General、position 1;其余 H2 文本作为面板标题,并配以小写 URL 兼容语义键;面板正文移除 H2 行,保留 H3 及更深子节;不得创建 related_entities 项。
  3. 证据优先级:依次参考 extension/schema.json 中对应对象、descriptions/nodes 或 descriptions/edges 文件、extension/saved_searches 下相关 JSON、docs/graph 补充文档、类型声明与采集器代码、测试及其他 saved Cypher。描述文本作为规范散文来源;saved search 用于推导调查问题、路径形状、谓词、可选上下文和限制。
  4. 查询设计:每个调查项须有语义键和简洁非疑问式标题,仅含一条 Cypher,按精确标签和稳定 objectid 锚定选中节点(使用一次转义 %s 替换),仅用 schema 定义标识符,绑定并返回至少一个路径变量,操作分行,以 LIMIT 500 结尾;证据支持时可包含非遍历性描述关系,但不得称为攻击路径。
  5. 动态 Explore 面板:通过节点 .Properties.objectid 生成受保护链接,不得使用 .NodeID;规范化并转义 objectid,空值提供回退;完整查询在 b64enc 与 urlquery 之前构造;使用 /ui/explore 及 exploreSearchTab=cypher、searchType=cypher、cypherSearch 参数;成功状态只渲染一个 Markdown Explore 链接。部署前须用 panel-authoring.md 中的实体详情渲染探针验证目标是否支持模板执行,不可用时停止并报告无法验证,不得改用围栏查询回退。

使用方式:阅读 references/panel-authoring.md 了解面板编写,references/entity-agent-contract.md 了解仓库级迁移契约,GUIDE.md 了解安装、编排与运行时测试。仓库级流程包括:运行 entity_panel_tool.py inventory 清点扩展;创建含每类一个片段的临时运行目录;按契约每类派生一个实体代理;审查关系清单、调查目标、saved-search 证据与元数据;用 assemble 生成候选 schema(不直接覆盖源文件);通过常规编辑流程应用前完成校验。

验证:运行 entity_panel_tool.py validate、git diff --check 与 Test-SchemaConsistency.ps1,并在指定隔离环境运行仓库测试;须确认节点位置与强制摘要、关系覆盖、标题非疑问、查询锚定与 LIMIT、元数据一致性、关系 H2 映射与 related_entities 缺失等。还需证明水合内容无字面模板定界符或 template_error,解码生成链接并执行代表性查询;无运行时证据不得声称动态链接已验证。

适用场景:OpenHound 扩展仓库中实体面板的批量迁移、新增、审查与一致性校验。

限制:仅改动实体面板及直接相关的技能、测试或校验文件;不得重写源描述、更改图类型/ID/方向/可遍历性/采集器行为或发出属性;Markdown 仅用上传安全子集,禁止原始 HTML、注释、标签形占位符、代码围栏信息串、GFM 任务列表、对齐表格、不安全链接方案及起始序号大于 1 的有序列表;节点 Cypher 面板必须使用受保护动态 Explore 链接形式,不支持围栏 Cypher 查询。