什么是Knowledge Graph
Knowledge Graph 是一个专为开发者设计的个人知识图谱技能工具，它将结构化知识以 JSON 格式持久化存储，并通过命令行脚本实现高效查询与管理。该工具的核心理念是主动构建和利用知识网络，而非被动响应查询——系统会在特定触发条件下自动激活，例如当对话中提及人物、概念或实体时，立即调用图谱进行上下文补充和关联推理。通过集成 AGENTS.md 文件（安装时自动注入），Knowledge Graph 能够为智能代理提供实时的知识摘要（KGML 格式），显著增强其理解深度与决策能力。整个架构设计简洁高效，支持跨平台运行（OpenClaw、Claude、Gemini），并具备完善的配置与扩展机制。 Knowledge Graph 采用模块化脚本体系，涵盖安装、查询、合并、可视化、配置等多个功能模块。用户可通过 `node scripts/install.mjs` 完成首次设置，系统将自动检测平台类型并修补相应的代理指令文件（如 CLAUDE.md）。所有基础操作均内置于 AGENTS.md 中，包括 `find`、`traverse`、`rels` 等命令，同时提供高级查询接口如按类型检索实体、统计图谱状态、追踪最近变更等。对于复杂文本的处理，工具引入‘深度启发式’评估机制，通过 `depth-check.mjs` 脚本对输入内容打分，据此决定提取层级：低复杂度文本仅需单层根节点，而高评分内容则需展开至四层以上，包含组织、事件、政策及跨关系分析，确保关键信息不被遗漏。
核心功能特点
- 主动式知识触发：在对话中自动识别提及的实体并即时调用知识图谱进行上下文增强
- 轻量级结构化存储：以 JSON 格式保存个人知识库，支持 CLI 脚本高效查询与遍历
- 智能深度评估：通过文本复杂度评分动态决定知识提取层级，避免浅层化处理复杂内容
- 可视化一键生成：内置离线 HTML 图谱渲染器，无需联网即可查看交互式知识网络
- 安全密钥管理：提供加密 vault 机制存储敏感信息，严格隔离读写权限防止泄露
适用场景
Knowledge Graph 特别适用于需要长期积累和系统化组织专业知识的场景，例如研究人员在处理大量论文、报告和技术文档时，可借助其自动提取命名实体、建立概念层级和交叉关系的能力，快速构建领域知识地图。开发者在调试复杂系统或学习新技术栈时，也能利用该工具记录关键操作步骤、故障排查流程和最佳实践，形成可复用、可追溯的‘程序性知识’条目，并通过标签（如 #howto、#mental-model）分类管理。团队协作环境中，成员可通过共享图谱摘要（KGML）同步项目背景与核心假设，减少沟通成本。此外，对于 AI 代理应用场景，Knowledge Graph 作为记忆增强组件，能够在多轮对话中持续更新和引用历史信息，使模型行为更具一致性和深度，尤其适合需要长期记忆和逻辑连贯性的任务流。