Files
Nexus/docs/changelog/2026-05-26-knowledge-graph-restructure.md
T
Your Name b1aa235726 fix: Gate3 false positive + test_api.py production compatibility
- Gate3: Replace loose grep (matched "0/25 failed" summary) with precise
  [FAIL] marker counting + "N test(s) failed" pattern
- test_api.py: Add .env credential loading for gate check automation
- test_api.py: Fix REST status codes (POST→201, DELETE→204)
- test_api.py: Add 204 empty body handling, dynamic ID, pre-cleanup
- Add gate_log.jsonl tracking to all 7 gates
- Add knowledge graph restructure changelog

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-26 19:33:31 +08:00

3.5 KiB
Raw Blame History

知识图谱重组 + MegaMemory 嵌入模型部署

日期: 2026-05-26 变更摘要: 重组两个知识库,去重规则知识,补全项目架构知识;部署 Xenova 嵌入模型使 MegaMemory 语义搜索可用

动机

  1. 完美实现原则(全局CLAUDE.md)、Nexus实现原则Nexus强制标准纪律 三者 80% 内容重叠,知识图谱里再存一遍纯属冗余——规则已在 CLAUDE.md 每次session自动加载
  2. 知识图谱完全缺少项目架构知识(模块、技术栈、数据流、部署拓扑),无法通过语义搜索快速定位模块
  3. MegaMemory 的 understand 语义搜索一直报 "fetch failed"——嵌入模型未下载

变更内容

server-memory(全局跨项目)

  • 删除 9 个重复规则实体: 完美实现原则、Nexus实现原则、Nexus强制标准纪律、ThreeIronRules、FourDimensionChecklist、ProblemReportFormat、AuditEnforcementMechanism、MandatoryFileModificationFlow、LineWalkAudit8Steps
  • 保留 2 个非规则实体: uzuma(用户偏好)、Nexus-Production-Server(服务器信息)

MegaMemory(项目级架构知识)

  • 创建 19 个概念节点: 项目顶层 + 9个架构模块 + 4个基础设施子模块 + 3个认证子模块 + 2个独立配置
  • 创建 30 条关系边: 项目→模块(connects_to/depends_on)、模块→子模块(implements)、数据流→基础设施(connects_to/depends_on)
  • 生成 384 维嵌入向量: 所有节点通过 Xenova/all-MiniLM-L6-v2 本地模型生成嵌入

嵌入模型部署

  • 从 hf-mirror.com 下载 Xenova/all-MiniLM-L6-v2 量化 ONNX 模型(23MB
  • 先通过远程 Linux 服务器下载,再 SCP 传回本地
  • 模型放置到 node_modules/@xenova/transformers/models/ 本地路径

知识图谱结构

nexus-project (feature)
├── nexus-backend (module) — FastAPI Clean Architecture 4层
├── nexus-frontend (module) — Tailwind+Alpine.js 12页面
├── nexus-infra (module) — SSH池+Redis+Telegram+WebSocket
│   ├── nexus-ssh-pool (component)
│   ├── nexus-redis (component)
│   ├── nexus-telegram (component)
│   └── nexus-websocket (component)
├── nexus-auth (feature) — JWT+TOTP+Agent API Key
│   ├── nexus-jwt (component)
│   ├── nexus-totp (component)
│   └── nexus-agent-auth (component)
├── nexus-dataflow (pattern) — 心跳→Redis→MySQL+WS+TG
├── nexus-gates (config) — 7门控部署
├── nexus-sync (feature) — 4种同步模式
├── nexus-database (module) — 14表+加密+脱敏
└── nexus-deploy (config) — 3层守护+SCP部署

nexus-production (config) — 服务器连接信息
uzuma (config) — 用户偏好

涉及文件

  • .megamemory/knowledge.db — MegaMemory SQLite 数据库(19节点+30边+19嵌入)
  • .megamemory/populate.py — 数据导入脚本(一次性使用)
  • ~/.cache/xenova/transformers/ — Xenova 模型缓存
  • node_modules/@xenova/transformers/models/Xenova/all-MiniLM-L6-v2/ — 本地模型文件

是否需迁移/重启

  • 重启 Claude Code 后 MegaMemory MCP 会自动连接并使用已下载的模型

验证方式

  1. megamemory stats 显示 19 nodes / 30 edges
  2. megamemory list_roots 返回 3 个根节点
  3. megamemory understand "认证系统" 返回 JWT/TOTP/Agent认证(相似度 >0.15
  4. megamemory understand "心跳数据流转" 返回数据流概念(相似度 >0.50)
  5. server-memory read_graph 只剩 2 个实体(uzuma + Nexus-Production-Server