Knowledge Graph 用于解析 Markdown 文件,构建项目文档之间的连接地图,适合在写作或审阅前了解文档结构、查找相关内容,以及做链接维护。
主要能力:脚本 resources/graph.py 会从多种模式中提取关系,包括 Markdown 链接 text、Wikilinks [[entity-name]]、mermaid 代码块中的 graph/flowchart/关系线、YAML front matter 中的 arc、chapter、characters、location 等字段,以及跨文档出现的实体名称。输出内容包括:连通图(文件的外链与反向链接)、孤立文件、失效链接、缺失的反向链接、紧密连接的文档簇,以及实体提及映射。
使用方式:运行 uv run resources/graph.py [root_directory]。未指定目录时从当前工作目录搜索。脚本仅使用 Python 标准库,无需项目环境或第三方包。输出为纯文本,带清晰的分节标题,可直接阅读、管道传递或重定向到文件。如需了解匹配模式、扩展自定义链接约定或调试输出,可阅读 resources/graph.py 源码。
适用场景:项目文档导航、写作或审阅前的内容查找、知识库维护(孤立页面、失效链接、缺失反向链接)。
限制与解读:孤立文件不一定是问题,有些是入口文档(如 README、索引);缺失反向链接在期望双向导航的 wiki 和知识库中最重要;失效链接通常值得修复。关系图是调查的起点而非结论,孤立文件可能是有意独立,紧密连接的簇可能是维护良好的主题区域,也可能表示缺乏外部连接的循环引用。