fquiz/memory/2026-05-12.md

Work Log - graphify 构建 api/app 后端知识图谱（2026-05-12）

• 背景：

  • 对 ./api/app 执行 $graphify，目标是生成后端结构图谱，辅助后续代码导航与跨模块关系追踪。
  • 仓库根目录检测结果超过 graphify 建议阈值，因此改为对子目录 api/app 单独建图。

• 语料与执行结果：

  • api/app 检测为纯代码语料：110 个代码文件，约 60,168 词。
  • 按 graphify 规则跳过 semantic extraction，仅执行 AST 抽取、聚类、报告与 HTML 可视化。
  • 产物位于仓库根目录 graphify-out/：
    • graph.html
    • GRAPH_REPORT.md
    • graph.json
    • cost.json
    • manifest.json

• 关键指标：

  • 图规模：1174 nodes / 3445 edges / 35 communities。
  • Token benchmark：
    • 语料约 80,224 naive tokens
    • 平均查询成本约 12,893 tokens
    • 约 6.2x token reduction per query

• 关注点：

  • 主要桥接节点包括 utcnow()、publish_topic()、Base、UserPublic、normalize_virtual_path()。
  • 低内聚社区主要集中在 Elevation Workflow、Lightning Analysis，适合后续做依赖与职责拆分审视。

• 风险与影响：

  • 本次未改业务代码，仅新增图谱输出与当天记忆文件。
  • graphify-out/ 与 api/app/graphify-out/cache/ast/ 为新生成工件，提交前应按需要决定是否纳入版本管理。