SuperAPI AI 工具集

kb-visualize

通用与其它

查看项目

更新于 10-16 02:29

技能介绍

用途:把知识包(bundle)渲染成概念间的交互式力导向图,让人直观看到其形态——枢纽、聚类、孤立节点以及概念之间的连接方式。视图由确定性图模型驱动,可适配整包全景或围绕单个概念的子图。

主要能力:

  1. 抽取图模型:运行随附抽取器,默认目标为 knowledge/。抽取器是零依赖 Node 脚本(node >=18),<skill-dir> 为该技能目录(Claude Code 下为 ${CLAUDE_SKILL_DIR}):node "<skill-dir>/scripts/graph.mjs" <bundle-dir>。它输出 JSON,包含 nodes(id、显示元数据、status、generated、verified、派生的 trust_tier、stale_after、派生的 is_stale、结构化 sources、attestation 元数据、body、links、cited_by)、去重后的 types 与 edges;反向链接与边已由概念正文中的交叉链接算出。若请求限定某个概念或区域,则过滤为该节点及其邻居。渲染器必须消费本次抽取产生的模型,不得复用旧缓存 JSON。
  2. 按宿主能力选择输出形式:宿主能渲染交互 UI(如 Claude Desktop、Codex Desktop、MCP-Apps 宿主)时渲染为原生 UI,在对话中实时呈现;宿主仅支持文本/产物(如 Claude Code、终端)时,在包旁或作为产物写出单文件、无后端、仅用 CDN 库的自包含 HTML,并把路径给用户。不确定时默认输出 HTML。
  3. 渲染视图:须包含力导向图(每个概念一个节点,按类型着色,每条交叉链接一条有向边,可选布局切换如 cose/concentric/breadth-first/grid 更好);选中节点的详情面板(frontmatter:description、resource 链接、tags、生命周期/新鲜度、来源、trust tier,以及存在时的 Attested Computation 契约;以及渲染后的 markdown 正文,内部概念链接改为在视图内导航而非跟随文件路径);每个节点的“Cited by”列表(来自 cited_by 反向链接图);搜索框(匹配标题、id、tags)与类型过滤。HTML 形式可用 Cytoscape.js + marked(CDN)并将图模型以 JSON 字面量内联,使文件自包含且数据不出页面;节点数据均来自第一步模型,不要重复读取包。
  4. 校验与交付:对照新模型验证节点数与边数一致,且本轮新增或替代的概念都按 ID 出现。交付时:UI 形式给出实时视图;HTML 形式给出文件路径,并说明可放在包旁提交、作为产物分享或托管在任意静态文件服务器。该工具为只读消费者,从不修改知识包,故不写日志。

限制:资料未提供具体收费、价格、平台支持范围、性能指标与使用配额,暂未提供。