知识图谱工具(免费版)

知识图谱工具(免费版)

概述

知识图谱工具(免费版)为个人用户提供轻量级的嵌入式知识图谱能力。图谱以 JSON 文件存储,通过命令行脚本进行查询与维护,并在每次会话开始时生成一份紧凑的 KGML 摘要注入上下文,让 Agent 始终拥有结构化的长期记忆. 本版本聚焦单 Agent、单用户的本地知识管理,适合个人知识库、学习笔记结构化与会话记忆持久化。如需加密保险库、可视化、多Agent协作与内存导入等进阶能力,请升级至 PRO 版本.

核心能力

核心功能执行

用input_params参数进行配置.

处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置.

处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志.

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置.

处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志.

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：个人用户的嵌入式、知识图谱、JSON、提供基础增删查改、与上下文摘要、知识图谱工具、免费版、为个人用户提供轻、量级的嵌入式知识、图谱能力、文件持久化、通过命令行脚本查、询与维护、实体与关系的增删、紧凑摘要、图谱统计与时间线等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景一:整理学习笔记为结构化知识

用户读完一篇技术文章,希望把其中的概念与关系沉淀到知识图谱.

# 查看当前图谱统计
node （请参考skill目录中的脚本文件） stats
# ...
# 查找已有相关实体
node （请参考skill目录中的脚本文件） find "依赖注入"

Agent 会读取文章,提取实体与关系,写入图谱,并生成 KGML 摘要供下次会话使用.

#KGML v2 | 12e 8r | depth:3 | 2026-07-18
[技术]
依赖注入(DI):pattern — 控制反转,松耦合
  构造器注入:pattern — 通过构造函数传入依赖
  属性注入:pattern — 通过setter传入依赖
%rels
依赖注入>实现>Spring 依赖注入>替代>服务定位器

场景二:会话间保持长期记忆

用户希望下次会话能记住之前讨论过的决策与上下文.

# 列出最近7天创建/更新的实体
node （请参考skill目录中的脚本文件） recent --days 7
# ...
# 查看时间线
node （请参考skill目录中的脚本文件） timeline --from 2026-07-01 --to 2026-07-18

每次会话开始时,Agent 会自动读取 kg-summary.md,把关键实体与关系带入上下文,避免重复解释背景.

场景三:发现孤立知识并补全关系

用户想找出图谱中尚未建立关联的知识点.

# 列出孤立实体(没有任何关系)
node （请参考skill目录中的脚本文件） orphans
# ...
# 按类型筛选
node （请参考skill目录中的脚本文件） type concept
node （请参考skill目录中的脚本文件） cat 技术

Agent 会建议如何把这些孤立实体挂到合适的父节点或建立跨分支关系.

不适用场景

以下场景知识图谱工具(免费版)不适合处理：

• 实时流数据处理
• 小规模数据手动分析
• 非结构化文本情感分析

触发条件

需要数据分析、报表生成、统计洞察、数据可视化时使用。不适用于非本工具能力范围的需求.

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

依赖详情

node （请参考skill目录中的脚本文件） --workspace /path/to/workspace --platform skill-platform

安装脚本会自动检测平台类型(skill-platform / claude / gemini),并对应修改 AGENTS.md、CLAUDE.md 或 GEMINI.md,注入 KG 指令与图谱摘要。脚本是幂等的,可重复运行.

2. 基础查询

node （请参考skill目录中的脚本文件） children       # 直接子节点
node （请参考skill目录中的脚本文件） type          # 按类型查询所有实体
node （请参考skill目录中的脚本文件） cat       # 按分类查询
node （请参考skill目录中的脚本文件） orphans             # 孤立实体
node （请参考skill目录中的脚本文件） stats               # 图谱统计
node （请参考skill目录中的脚本文件） recent [--days 7]   # 最近创建/更新
node （请参考skill目录中的脚本文件） timeline           # 时间线

3. KGML格式速览

#KGML v2 | <实体数>e <关系数>r | depth:<层级> | <日期>
[分类]
标签(别名):类型 — 属性1,属性2
  子标签(CA):类型 — 属性          ← 缩进表示父子关系
%rels
A>动词>B C>动词>D                ← 跨分支关系(使用别名)
%vault key1,key2                 ← 保险库键名(不显示值)

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

示例

基础配置查看与修改

node （请参考skill目录中的脚本文件）                       # 列出所有设置及当前值
node （请参考skill目录中的脚本文件） get summary.tokenBudget
node （请参考skill目录中的脚本文件） set summary.tokenBudget 4000
node （请参考skill目录中的脚本文件） reset summary.tokenBudget
node （请参考skill目录中的脚本文件） --json                 # 完整配置JSON

常用设置

配置文件位置:data/kg-config.json(按Agent隔离,建议加入gitignore).

最佳实践

1. 复杂内容先评估深度

添加复杂内容(论文、报告、系统说明)前,先用深度评估脚本判断应提取多少层.

node （请参考skill目录中的脚本文件） "粘贴文本或摘要"
echo "文章全文" | node （请参考skill目录中的脚本文件）
node （请参考skill目录中的脚本文件） --file /path/to/article.txt
node （请参考skill目录中的脚本文件） --json    # 机器可读格式

关键规则:复杂内容不要只提取2层。评分≥4时,应提取所有命名组织、事件、策略与跨关系.

2. 区分声明式与过程式知识

knowledge 类型同时覆盖声明式与过程式知识,用标签与属性区分:

过程式知识属性建议:

• steps:有序步骤,用 → 或编号(如 "1.查日志 → 2.复现 → 3.修复 → 4.测试")
• context:何时何地应用(如 "网络中断时"、"代码审查时")
• summary:简短说明

3. 定期整理

实体数超过80时,运行整理脚本并重新生成摘要.

node （请参考skill目录中的脚本文件）
node （请参考skill目录中的脚本文件）

4. 安全原则

• 绝不在聊天中打印保险库值,也不写入 memory 或日志文件
• vault.enc.json 与 .vault-key 永不进入上下文
• 个人图谱数据建议加入 gitignore,避免泄露

5. KGML字段速查

常见问题

Q1:免费版支持哪些查询?

支持子节点、按类型、按分类、孤立节点、统计、最近、时间线、变更、低置信度等基础查询。合并、保险库、可视化、跨Agent访问等进阶能力需PRO版.

Q2:KGML摘要会占用多少token?

默认预算5000 token,可通过 summary.tokenBudget 调整。实体数超过400时自动进入紧凑模式.

Q3:免费版能否多Agent共享?

免费版主要面向单Agent。多Agent只读访问(reader.mjs)与跨Agent写入需PRO版支持.

Q4:免费版与PRO版差异?

Q5:数据存储在哪里?

默认存储在 data/ 目录下的 JSON 文件,按Agent隔离。配置文件为 data/kg-config.json,建议加入gitignore避免泄露个人知识.

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux
• Node.js版本: 建议 18 LTS 及以上(用于运行 .mjs 脚本)

第三方依赖

API Key 配置

• 本skill基于Markdown指令规范,无需额外API Key(除内容中明确标注的外部API).
• 个人知识图谱数据本地存储,不上传任何外部服务.

可用性分类

• 分类: MD+EXEC(纯Markdown指令,部分功能需exec命令行执行)
• 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作。免费版聚焦个人单Agent的本地知识图谱管理.

错误处理

已知限制

• 本地运行，不支持多设备同步
• 存储操作依赖云存储服务的可用性
• 免费版有存储容量与带宽限制
• 大文件上传下载速度受网络条件影响

输出格式

{
  "success": true,
  "data": {
    "result": "知识图谱工具(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "knowledge graph"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}