knowledge-graph

核心用法

该Skill提供了一套基于Python脚本的知识图谱维护方案，通过命令行工具对本地文件系统中的实体数据进行确定性管理。用户通过python3 skills/knowledge-graph/scripts/kg.py调用脚本，使用add子命令可向指定实体（如people/safa）的特定分类（如status）添加原子化事实，系统会自动生成递增ID（如<slug>-001格式）并追加到items.json数组中。当事实需要更新时，使用supersede命令可通过指定旧事实ID（如safa-002），将其标记为superseded状态，同时创建带有新ID的事实记录，实现历史版本保留而非物理删除。summarize命令则读取所有活跃（非过期）事实，自动聚合生成结构化的summary.md摘要文档。所有操作严格限定在life/areas/目录下，实体路径遵循<kind>/<slug>/的层级结构，确保数据组织的清晰性。

显著优点

首先是极致的安全性，采用纯Python标准库实现，零外部依赖，完全消除了供应链攻击和依赖冲突风险；其次是数据主权保障，所有数据仅存于本地文件系统，无网络传输行为，从根本上规避隐私泄露风险；第三是版本化思维，通过supersede机制实现事实的软删除与历史追溯，符合知识累积的特性，支持学术级别的引用溯源；第四是Git友好性，纯文本JSON和Markdown格式天然支持版本控制，便于diff查看和分支管理；第五是确定性更新，脚本化操作确保数据格式一致性、ID连续性及操作原子性，避免手动编辑JSON导致的语法错误。

潜在缺点或局限性

作为T3来源（个人开发者）的项目，长期维护稳定性和持续更新存在不确定性；功能局限于单机环境，缺乏多用户并发控制机制与文件锁定策略，不适合团队协作或多进程写入场景；无网络同步能力，无法实现跨设备实时数据共享；纯命令行交互方式对非技术用户有学习门槛，缺乏图形化界面和可视化图谱展示；错误提示及文档为英文，本地化支持不足；此外，大规模数据（百万级事实）下的查询性能未经优化，更适合个人知识管理而非企业级知识库应用。

适合的目标群体

适用于注重数据隐私的个人知识管理用户、需要维护实体关系网络的开发者、学术研究者以及希望建立本地化数字花园的技术写作者。特别适合那些对数据版本控制有严格要求、偏好文件化存储方案、且具备基础命令行操作能力的用户。明确不推荐用于需要高并发写入的企业团队环境或需要实时协作的共享知识库场景。

使用风险

尽管安全评级为A级，仍需建立定期备份life/areas/目录的机制以防文件损坏；确保运行用户具备目标目录的读写权限，避免权限不足导致的操作失败；输入实体名称时需严格遵循[a-z0-9-]+正则规范，防止路径遍历风险；由于缺乏并发控制，建议配合Git进行数据版本管理，以缓解潜在的写入冲突问题；此外，虽然脚本无破坏性命令，但错误的supersede操作可能导致事实状态混乱，建议在关键操作前进行数据快照。