Knowledge Graph Builder

知识图谱构建与管理工具，支持从文本和 URL 解析信息、生成领域知识图谱，并导出为 HTML 文章。

功能特性

• 信息解析: 支持 URL 链接和文本内容的解析与获取
• 名词解释: 根据输入信息解释特定名词的详细含义
• 知识图谱扩展: 允许追加对解释内容的补充说明或关联信息
• 粒度控制: 根据用户需求调整解释信息的详细程度（基础/进阶/深入/专家/权威）
• 导入导出: 支持 JSON 格式文件保存，实现知识结构的备份与分享
• 多语言导出: 支持中英文 HTML 文章导出
• 知识关联图: 自动生成 Mermaid 可视化知识关联图

目录结构

knowledge-graph-builder/
├── SKILL.md              # Skill 入口与指南
├── README.md             # 项目说明文档
├── README_en.md          # English documentation
├── scripts/
│   ├── kg_manager.py     # 知识图谱管理脚本（导入/导出/查询）
│   └── export_article.py # 文章导出脚本（HTML/Markdown）
└── examples/
    ├── README.md         # 示例说明
    ├── README_en.md     # Example documentation
    ├── abrahamic_religions_kg.json    # 知识图谱数据
    ├── abrahamic_religions_zh.html     # 中文 HTML 示例
    ├── abrahamic_religions_en.html     # 英文 HTML 示例
    ├── abrahamic_religions_summary.md       # 中文总结文章
    └── abrahamic_religions_summary_en.md     # English summary

安装依赖

pip install markdown

使用方法

1. 知识图谱管理 (kg_manager.py)

# 创建空模板
python scripts/kg_manager.py --action create --file output.json

# 导出图谱
python scripts/kg_manager.py --action export --data '{"meta":{...},"nodes":[],"edges":[]}' --file output.json

# 导入图谱
python scripts/kg_manager.py --action import --file kg.json

# 追加节点
python scripts/kg_manager.py --action append_nodes --file kg.json --nodes '[{"id":"1","name":"概念名","definition":"定义","depth":1}]'

# 追加边
python scripts/kg_manager.py --action append_edges --file kg.json --edges '[{"source":"1","target":"2","relation":"属于"}]'

# 查询节点
python scripts/kg_manager.py --action query --file kg.json --name "关键词"

# 扩展节点
python scripts/kg_manager.py --action extend --file kg.json --name "节点名" --extension "补充说明"

# 查看图谱信息
python scripts/kg_manager.py --action info --file kg.json

2. 文章导出 (export_article.py)

# 导出中文 HTML
python scripts/export_article.py --input kg.json --output article.html --format html --lang zh

# 导出英文 HTML
python scripts/export_article.py --input kg.json --output article.html --format html --format html --lang en

# 导出 Markdown
python scripts/export_article.py --input kg.json --output article.md --format markdown

作为 Skill 使用

本项目同时是一个 Agent Skill，根目录的 SKILL.md 是 Skill 入口描述。

三种使用模式

1. 从信息构建知识图谱：提供 URL 或文本，自动解析并生成 JSON 图谱
2. 扩展现有知识图谱：追加节点、边、补充说明
3. 节点总结成文：将关联节点提炼为 Markdown / HTML 文章

调用方式

将本目录（或 SKILL.md）作为 Skill 挂载到支持的 Agent 平台（Qoder / Claude Code / Codex 等）， Agent 会根据 SKILL.md 中的 description 字段自动识别可调用场景。

详细参数、粒度控制、5 个完整示例请参见 SKILL.md。

知识图谱数据结构

{
  "meta": {
    "version": "1.0",
    "name": "知识图谱名称",
    "domain": "领域",
    "created": "创建时间",
    "modified": "修改时间"
  },
  "nodes": [
    {
      "id": "唯一标识",
      "name": "节点名称",
      "name_en": "English Name",
      "definition": "节点定义",
      "definition_en": "English Definition",
      "depth": 1,
      "tags": ["标签1", "标签2"],
      "tags_en": ["Tag1", "Tag2"],
      "related_nodes": ["关联节点ID"],
      "extensions": [{"content": "补充说明"}],
      "extensions_en": [{"content": "English extension"}]
    }
  ],
  "edges": [
    {
      "source": "源节点ID",
      "target": "目标节点ID",
      "relation": "关系描述",
      "relation_en": "Relation Description",
      "description": "关系说明"
    }
  ]
}

深度层级说明

depth	层级	说明
1	基础	入门级概念解释
2	进阶	深入一些的概念
3	深入	专家级概念理解
4	专家	高级专业内容
5	权威	学术级深度解析

输出 HTML 结构

第一部分：知识关联图
└── Mermaid 可视化图

第二部分：正文内容
└── 核心概念详解（按层级分组）
    ├── 名称、定义、标签
    └── 补充说明

示例

参见 examples/ 目录下的示例文件：

• 知识图谱数据: abrahamic_religions_kg.json
• 中文 HTML: abrahamic_religions_zh.html
• 英文 HTML: abrahamic_religions_en.html

License

MIT License