chengkml
31 lines
1.4 KiB
Markdown
31 lines
1.4 KiB
Markdown
## 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/` 为新生成工件，提交前应按需要决定是否纳入版本管理。
|