📦 Project Knowledge Graph

项目知识图谱 一个本地的FalkorDB支持的语义索引，覆盖所有项目文档。可以通过概念进行查询，例如“显示所有关于FalkorDB复制的内容”，返回匹配的技能、摘要、架构文档等，按TF-IDF相关性排名，使用Cypher CONTAINS作为主要过滤器。

架构知识索引 │ 扫描项目目录中的.md文档 ├── docs/recaps/、docs/daily-recaps/ ├── docs/plans/ ├── 项目内存文件 ├── docs/architecture/、docs/features/、docs/operations/、docs/pipeline/ ├── TECHNICAL-DOCUMENTATION.md、FUNCTIONAL-SPECIFICATIONS.md └── */SKILL.md（Hermes技能） │ 按标题和段落（最多2000个字符）分块 │ 合并到FalkorDB图中作为：Chunk节点 │ 知识查询“概念” │ 阶段1：Cypher CONTAINS（快速主要过滤器） 阶段2：TF-IDF重新排名 │ 按项目、文件、标题、片段排名的结果 设置（一次性）

• 启动FalkorDB容器

docker run -d \ --restart=unless-stopped \ -p 127.0.0.1:16379:6379 \ -v knowledge-graph-data:/data \ --name knowledge-graph \ falkordb/falkordb:latest 安全：端口绑定到127.0.0.1（仅本地主机）- FalkorDB无法从网络上的其他机器访问。没有配置身份验证，因为服务仅对本地进程可访问。 Docker镜像注意：falkordb/falkordb:latest是一个可变标签。为了固定摘要（推荐用于生产），用拉取后的当前SHA256替换标签： docker pull falkordb/falkordb:latest DIGEST=$(docker inspect --format='{{index .RepoDigests 0}}' falkordb/falkordb:latest) echo "用@${DIGEST#@}替换：latest" 然后在docker run命令中使用falkordb/falkordb@sha256：... 检查更新，而不是依赖自动拉取。 通过--restart=unless-stopped在Docker守护进程启动时自动启动。 数据在Docker卷中持久化。 持久化注意：容器使用--restart=unless-stopped来在Docker重启后幸存，但不会在手动docker stop后自动重启。要完全禁用持久化，请省略--restart并在需要时手动启动容器。

• 安装Python依赖

pip install falkordb==1.6.1

• 验证

python3 ~/.hermes/scripts/project-knowledge-index.py doctor 应该显示所有8个项目根目录，文档数量和健康的FalkorDB连接。

使用 索引所有项目 # 首次索引（~60s）- 随后增量（<1s） python3 ~/.hermes/scripts/project-knowledge-index.py index # 预览而不写入 python3 ~/.hermes/scripts/project-knowledge-index.py index --dry-run 查询概念 # 基本搜索 python3 ~/.hermes/scripts/project-knowledge-index.py query "FalkorDB复制" # 按项目过滤 python3 ~/.hermes/scripts/project-knowledge-index.py query "批量写入" --project CI # 按文档类型过滤（摘要、计划、技能、claude、架构） python3 ~/.hermes/scripts/project-knowledge-index.py query "软删除" --type skill 统计和健康 python3 ~/.hermes/scripts/project-knowledge-index.py stats python3 ~/.hermes/scripts/project-knowledge-index.py doctor

查询算法 两阶段排名：Cypher CONTAINS - 找到所有包含搜索词的块。快速、精确匹配的主要过滤器。支持在此阶段按--project和--type过滤。 TF-IDF重新排名 - 计算每个候选项与查询标记的词频×逆文档频率。得分相对于结果集（最佳匹配=最高得分）。这比纯CONTAINS提供了更好的结果，而无需LLM嵌入或API调用。

如何在会话中使用 处理之前见过的问题时： # 我们如何处理PostgreSQL迁移？ python3 ~/.hermes/scripts/project-knowledge-index.py query "PostgreSQL迁移" # 批量操作在项目中的模式是什么？ python3 ~/.hermes/scripts/project-knowledge-index.py query "批量" --type skill # 我们是否记录了Ollama速率限制？ python3 ~/.hermes/scripts/project-knowledge-index.py query "Ollama速率限制" # 我们对软删除了解了什么？ python3 ~/.hermes/scripts/project-knowledge-index.py query "软删除" --project MyApp

索引内容 项目 典型文档 样本内容 具有项目内存文件的任何项目 摘要、计划、内存文件 会议摘要、实施计划、方法论规则 具有docs/的任何项目 架构、功能、操作、管道 关于每个组件的主题文档 具有技术/功能规格的任何项目 全面的技术规格 架构决策、设计模式等