如何把代码知识图谱分享给整个团队Understand-Anything git提交与git-lfs最佳实践【免费下载链接】Understand-AnythingGraphs that teach graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.项目地址: https://gitcode.com/GitHub_Trending/un/Understand-AnythingUnderstand-Anything 能把任意代码库变成一份可交互的代码知识图谱而这份图谱本质上只是一组 JSON 文件。把它通过git 提交进仓库、用git-lfs管理大文件团队成员就能直接打开交互式仪表盘——无需重新分析、无需 API Key。一、为什么知识图谱值得提交到 Git运行/understand命令后插件会用多智能体流水线扫描整个项目把每个文件、函数、类和依赖关系都提取出来最终生成一份存放在.ua/数据目录中的knowledge-graph.json详见 README.md 与 understand-anything-plugin/skills/understand/SKILL.md。对团队来说图谱即文档新人上手新成员克隆仓库即可看到架构全景不用先读 20 万行代码PR 评审结合 diff 影响分析快速判断改动的波及范围docs-as-code图谱随代码一起版本化每次提交都有对应的快照核心文件包括knowledge-graph.json、meta.json、fingerprints.json等全部是纯文本 JSON天然适合纳入版本管理。二、git 提交清单哪些文件该进仓库原则很简单提交.ua/下所有内容但排除本地临时产物。文件/目录是否提交说明.ua/knowledge-graph.json✅知识图谱主体.ua/meta.json、fingerprints.json✅元数据与增量更新基线.ua/intermediate/❌流水线中间缓存属于本地草稿.ua/diff-overlay.json❌本地 diff 叠加层每人不同在.gitignore中加入两行即可.ua/intermediate/ .ua/diff-overlay.json 早期项目可能使用旧目录名.understand-anything/规则相同替换目录名即可。三、启用自动更新每次提交图谱自动保鲜图谱最怕的是与代码脱节。Understand-Anything 内置了提交后钩子执行一次/understand --auto-update即可开启此后每次git commit都会触发增量更新——只重新分析有结构性变化的文件并自动把更新后的图谱纳入提交。钩子实现understand-anything-plugin/hooks/post-tool-use-auto-update.mjs更新策略understand-anything-plugin/hooks/auto-update-prompt.md纯删除、纯注释、生成物提交会零 token 直接跳过成本极低。发布前再手动跑一次/understand确保版本打点时图谱是最新的。四、大图谱10 MB上 git-lfs 的三步配置中小项目的图谱只有几百 KB直接git add即可但大型单体仓库的图谱可能轻松超过 10 MB频繁提交会拖慢克隆速度。此时用git-lfs跟踪即可只需三步git lfs install git lfs track .ua/*.json git add .gitattributes .ua/ git commit -m chore: track knowledge graph with git-lfs这样图谱 JSON 的实际内容会被存到 LFS 远端仓库里只保留一个指针文件克隆速度不受影响。五、队友零配置打开交互式仪表盘这是团队共享最棒的一点看图谱的人不需要 Claude Code、不需要 LLM、不需要 API Key。只要 Node.js 18用一条npx命令运行官方的独立 viewer 包下载地址见 README.md View the dashboard without Claude Code 一节细节在 understand-anything-plugin/packages/viewer/README.md指向已克隆的项目目录即可终端打印带一次性 token 的本地 URL浏览器打开即得完整仪表盘支持缩放、搜索、点击节点查看代码与白话解释、跟随引导式导览数据只从本地磁盘只读提供不离开你的机器新成员完整上手流程git clone https://gitcode.com/GitHub_Trending/un/Understand-Anything cd your-project git lfs pull # 若图谱启用了 LFS # 运行 viewer 打开仪表盘想感受一份真实图谱长什么样可以参考项目自带的示例数据 understand-anything-plugin/packages/dashboard/public/knowledge-graph.json。六、团队共享最佳实践清单 ✅场景推荐做法图谱较小几 MB 内直接git add .ua/提交图谱超过 10 MB用 git-lfs 跟踪.ua/*.json图谱要与代码保持一致开启/understand --auto-update巨型 monorepo用/understand src/frontend圈定子目录分批提交发版打 tag 前手动重跑一次/understand中文团队首次运行加--language zh图谱描述与界面同步中文化一句话总结图谱就是 JSONJSON 就该进 Git——小图直提大图上 LFS配一个自动更新钩子团队的代码理解从此有了版本化的单一事实来源。【免费下载链接】Understand-AnythingGraphs that teach graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.项目地址: https://gitcode.com/GitHub_Trending/un/Understand-Anything创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考