ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

graphify hook install:让知识图谱在每次 Git Commit 后自动重建的完整指南

graphify hook install:让知识图谱在每次 Git Commit 后自动重建的完整指南 graphify hook install让知识图谱在每次 Git Commit 后自动重建的完整指南【免费下载链接】graphifyTurn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.项目地址: https://gitcode.com/GitHub_Trending/graph/graphifygraphify 是一款能把代码库、文档、SQL 表结构和配置文件转换为可查询知识图谱的开源工具支持 Claude Code、Cursor、Codex、Gemini CLI 等 15 AI 编程助手。本文介绍graphify hook install命令——一条命令即可在 Git 仓库中注册钩子让知识图谱在每次 commit 后自动增量重建全程本地 AST 解析、零 LLM 成本再也不用手动刷新图谱。为什么需要知识图谱自动重建手动构建图谱的体验是这样的每次改了代码都得重新跑一遍/graphify .稍一疏忽图谱就和真实代码脱节了。graphify hook install解决的正是这个痛点能力说明 每次 commit 自动增量重建只重新解析本次改动的代码文件速度快 切换分支全量重建post-checkout 钩子在切分支时刷新整张图谱⚡ 后台异步执行git commit 秒回绝不被图谱重建阻塞 自带 graph.json 合并驱动两人并行提交时图谱自动 union 合并永不留下冲突标记 零 API 成本纯 tree-sitter AST 解析本地完成不消耗 LLM 额度前置条件先装 graphify再注册 Hook第一步安装 graphify CLI需要 Python 3.10推荐用 uvuv tool install graphifyy # 或 pipx install graphifyy第二步在目标 Git 仓库内注册 hookgraphify hook install # 安装 post-commit post-checkout 钩子 graphify hook uninstall # 卸载精确移除 graphify 段落保留其他钩子 graphify hook status # 查看当前安装状态只需在项目根目录或任意子目录执行一次即可。hook 会自动向上查找.git目录并尊重core.hooksPath配置例如 Husky 9 会把钩子装到.husky/而非默认的.git/hooks已存在的钩子会被追加而不是覆盖不会破坏你项目里其他团队写的 post-commit 脚本。⚠️ 注意如果你升级或重装了 graphify请重新执行一次graphify hook install——它会在安装时把当前 Python 解释器的绝对路径钉入钩子脚本刷新后 hook 依然能在 GUI 客户端和 CI 里正常工作。Hook 工作原理一次 Commit 背后发生了什么安装后graphify 会在钩子文件中写入带# graphify-hook-start标记的脚本段核心逻辑见 graphify/hooks.py每次 commit 的流程如下识别变更通过git diff HEAD~1 HEAD拿到本次提交改动的所有文件智能跳过rebase / merge / cherry-pick 进行中、只改了graphify-out/产物、或处于 git worktree 时直接跳过重建增量重建只对被改动的代码文件重跑 AST 提取合并进现有graph.json而不是从零开始解析整个仓库后台执行重建进程被完全分离到后台运行git commit立即返回重建日志写入~/.cache/graphify-rebuild.log想看进度随时查。切换分支时post-checkout 钩子会执行一次全量重建因为分支切换可能涉及任意文件的变动同样在后台完成。一个巧妙的设计增量重建之间如果撞上锁比如上一次 commit 的重建还没跑完新的变更会进入待处理队列等锁释放后自动合并补跑不会丢任何一次提交。团队协作graph.json 冲突怎么破多人开发时graph.json也会被提交进 Git两人同时改图就会撞出合并冲突。graphify hook install会顺手注册一个git 合并驱动在 git config 中写入merge.graphify驱动并在.gitattributes里声明graphify-out/graph.json mergegraphify。效果是——两位同事并行提交后 pull两边的图谱会被自动union 合并graph.json永远不会出现冲突标记。推荐团队工作流一人执行/graphify .并连同graphify-out/一起提交其他成员 pull 后AI 助手即可直接读取图谱无需等待重建全员执行graphify hook install开启自动重建文档或论文等非代码内容变更时手动执行/graphify --update刷新对应节点。常见问题排查Qcommit 后日志显示 could not locate a Python with graphify installedhook 找不到安装了 graphify 的 Python。检查graphify命令所在目录是否在 PATH 中或重装后重新运行graphify hook install刷新钉入路径。QWindows 用户 commit 后图谱没更新旧版用nohup后台化在 Git for Windows 的 MSYS shell 里会静默失败现版本改用 Python 自行分离进程跨平台可靠。请确认已升级到新版并重新执行graphify hook install。Q想临时关闭自动重建设置环境变量GRAPHIFY_SKIP_HOOK1即可commit 和切分支都会跳过重建。Q担心大仓库重建太久卡住重建默认 600 秒超时保护可用GRAPHIFY_REBUILD_TIMEOUT调整用GRAPHIFY_MAX_WORKERS可控制解析并行度。快速上手清单uv tool install graphifyy # 1. 安装 CLI graphify hook install # 2. 在仓库内注册 hook一次即可 git commit -m feat: xxx # 3. 正常开发图谱自动保持新鲜 graphify hook status # 4. 随时确认 hook 状态更多细节可参考 docs/how-it-works.md 了解图谱构建原理以及 ARCHITECTURE.md 查看整体架构。一句话总结graphify hook install是让整个团队的知识图谱永不陈旧的最短路径——一次安装之后每次 commit 背后AST 解析在后台默默完成你只管写代码。【免费下载链接】graphifyTurn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.项目地址: https://gitcode.com/GitHub_Trending/graph/graphify创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表