Graphify 运维 Runbook
适用范围
用于维护客户代码库、文档库或 FDE 知识库的 Graphify 图谱产物。
常规操作
| 操作 | 目的 |
|---|---|
/graphify . | 对当前项目构建或重建知识图谱 |
graphify query | 查询概念、模块、依赖和业务链路 |
graphify path | 查找两个节点之间的路径 |
graphify explain | 解释单个节点 |
graphify prs --triage | 按图谱影响度分析 PR |
graphify hook install | 安装 Git hook 自动重建 |
首次构建检查
- 已确认扫描目录。
- 已在项目根目录建立
.graphifyignore。 - 已排除敏感文件和大型无关目录。
- 已确认客户允许本地或受控环境构图。
- 已记录 Graphify 版本。
- 已保存输出路径。
输出文件
graphify-out/
├── graph.html
├── GRAPH_REPORT.md
├── graph.json
└── cache/常见问题
| 问题 | 处理 |
|---|---|
| 图谱节点太多 | 缩小扫描目录，排除生成物和依赖目录 |
| 查询结果噪声大 | 提供更具体的问题，加入关键模块名 |
| 图谱过期 | 手动重建或安装 hook |
| 敏感数据误入 | 删除输出，更新排除规则，重新构建 |
| 内部冠军不会用 | 提供 10 个常用查询模板并演练 |
.graphifyignore 基线
构图前复制 graphifyignore-template 到项目根目录，命名为 .graphifyignore。至少排除：
node_modules/dist/,build/,out/.next/,.nuxt/.venv/,venv/.git/graphify-out/.env*,*.pem,*.key- 大型压缩包和媒体文件
交接清单
- 客户能打开
graph.html。 - 客户能运行至少 3 个查询。
- 客户知道何时重建图谱。
- 客户知道如何维护
.graphifyignore并排除敏感路径。 - Graphify 输出已纳入项目交付物或内部工具链。