料庫(kù)，并用文件監(jiān)聽實(shí)時(shí)同步知識(shí)圖譜)
graphify add 與 --watch把外部 URL 增量納入語(yǔ)料庫(kù)并用文件監(jiān)聽實(shí)時(shí)同步知識(shí)圖譜【免費(fèi)下載鏈接】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.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/graph/graphifygraphify 的 Pi skill 提供了一條默認(rèn)構(gòu)建流程之外的旁路能力/graphify add url可以把網(wǎng)頁(yè)、論文、推特、視頻等外部?jī)?nèi)容抓取為圖譜語(yǔ)料--watch則啟動(dòng)一個(gè)后臺(tái)監(jiān)聽器在文件變化時(shí)自動(dòng)重建代碼圖譜或提示語(yǔ)義重抽取。本文基于 add-watch 參考文檔 與 ingest.py、watch.py 的源碼實(shí)現(xiàn)完整講解這兩條命令的用法、支持的內(nèi)容類型以及 watch 底層的事件過濾、增量重建與安全護(hù)欄機(jī)制。文檔定位旁路能力不在默認(rèn)構(gòu)建路徑中add-watch.md 是 Pi 智能體技能包中的一份“按需加載”參考文檔開頭明確說明Load this when the user ran/graphify add urlor passed--watch. Neither is part of the default build.也就是說只有當(dāng)用戶顯式觸發(fā)這兩個(gè)動(dòng)作時(shí)智能體才會(huì)讀取該文檔并按其中的指令執(zhí)行。這與 update.md增量更新、transcribe.md視頻轉(zhuǎn)寫等參考文檔共同構(gòu)成了 Pi 技能下/graphify命令族的完整操作手冊(cè)。一、/graphify add url抓取 URL 并寫入語(yǔ)料庫(kù)1. 標(biāo)準(zhǔn)調(diào)用命令文檔給出的執(zhí)行模板如下URL、AUTHOR、CONTRIBUTOR為占位符需替換為實(shí)際值$(cat graphify-out/.graphify_python) -c import sys from graphify.ingest import ingest from pathlib import Path try: out ingest(URL, Path(./raw), authorAUTHOR, contributorCONTRIBUTOR) print(fSaved to {out}) except ValueError as e: print(ferror: {e}, filesys.stderr) sys.exit(1) except RuntimeError as e: print(ferror: {e}, filesys.stderr) sys.exit(1) 其中$(cat graphify-out/.graphify_python)是 graphify 構(gòu)建產(chǎn)物里記錄的 Python 解釋器路徑保證命令與構(gòu)建該圖譜時(shí)使用的環(huán)境一致。參數(shù)語(yǔ)義與 ingest.py 中ingest()的簽名一一對(duì)應(yīng)target_dir語(yǔ)料落盤目錄文檔中固定為./raw即后續(xù)--update管道的輸入根目錄author/contributor寫入文件 frontmatter 的署名元數(shù)據(jù)用于團(tuán)隊(duì)協(xié)作圖譜的溯源。兩者省略時(shí) frontmatter 的contributor回退為unknownValueErrorURL 未通過graphify.security.validate_url校驗(yàn)如非法地址、內(nèi)網(wǎng)地址命令以非零碼退出RuntimeError網(wǎng)絡(luò)抓取失敗HTTP 錯(cuò)誤、DNS 失敗、OSError 等。文檔特別強(qiáng)調(diào)命令報(bào)錯(cuò)時(shí)必須把原因告訴用戶不得靜默繼續(xù)。成功落盤后應(yīng)自動(dòng)對(duì)./raw執(zhí)行--update管道見 update.md 的增量流程把新文件合并進(jìn)已有圖譜。2. 支持的 URL 類型自動(dòng)檢測(cè)文檔列出了六類 URL其判定邏輯與 ingest.py 中_detect_url_type()的實(shí)現(xiàn)一致——按域名或路徑后綴順序分類URL 類型判定條件落盤行為YouTube / 任意視頻域名含youtube.com或youtu.be通過 yt-dlp 下載音頻下次運(yùn)行時(shí)轉(zhuǎn)寫為.txt需pip install graphifyy[video]Twitter/X域名含twitter.com或x.com經(jīng) oEmbed 接口抓取推文正文與作者存為.mdarXiv域名含arxiv.org抓取摘要 元數(shù)據(jù)存為.mdPDF路徑以.pdf結(jié)尾直接下載為.pdf文件圖片路徑以.png/.jpg/.jpeg/.webp/.gif結(jié)尾直接下載下次運(yùn)行時(shí)由 Claude vision 抽取內(nèi)容任意網(wǎng)頁(yè)以上皆不匹配轉(zhuǎn)換為 markdown 后存為.md源碼中有幾個(gè)值得注意的實(shí)現(xiàn)細(xì)節(jié)推文_fetch_tweetx.com鏈接會(huì)被歸一化為twitter.com后請(qǐng)求publish.twitter.com/oembed接口oEmbed 失敗時(shí)不報(bào)錯(cuò)而是落一個(gè)包含“could not fetch content”占位文本的 stub 文件保證語(yǔ)料不丟失。arXiv_fetch_arxiv從 URL 中用正則提取論文編號(hào)轉(zhuǎn)而請(qǐng)求export.arxiv.org/abs/頁(yè)面抽取標(biāo)題、作者與摘要文件名固定為arxiv_{編號(hào)}.md。網(wǎng)頁(yè)_fetch_webpage先剔除script/style再轉(zhuǎn) markdown正文截?cái)嗟?12000 字符以內(nèi)防止超大頁(yè)面撐爆語(yǔ)義抽取。安全所有抓取都經(jīng)過graphify.security的safe_fetch/safe_fetch_text/validate_url且寫入 frontmatter 前用_yaml_str()轉(zhuǎn)義控制字符——源碼注釋明確指出這是為了防止惡意頁(yè)面標(biāo)題注入 YAML 兄弟鍵對(duì)應(yīng)安全項(xiàng) F-009/F-019。視頻能力依賴可選依賴組pyproject.toml 中video [faster-whisper; python_version 3.11, yt-dlp2026.6.9]即graphifyy[video]額外安裝 Whisper 轉(zhuǎn)寫模型要求 Python 3.11與 yt-dlp。音頻下載本身由graphify.transcribe.download_audio()完成轉(zhuǎn)寫動(dòng)作發(fā)生在下一次--update運(yùn)行時(shí)對(duì)應(yīng) transcribe.md 的流程。3. 落盤格式frontmatter 防沖突命名所有文本類抓取結(jié)果都寫成帶 YAML frontmatter 的 markdown字段包括source_url、typetweet/paper/webpage、captured_atUTC ISO 時(shí)間戳、contributor論文還帶arxiv_id、title、paper_authors。這些字段會(huì)被 graphify 的 markdown 抽取器讀取為節(jié)點(diǎn)元數(shù)據(jù)。文件名由_safe_filename()從 URL 的 hostpath 清洗生成非字符合法字符替換為_截?cái)嗟?80 字符。若目標(biāo)文件已存在ingest()會(huì)自動(dòng)追加_1、_2… 后綴避免覆蓋直到第 1000 次為止。二、--watch后臺(tái)監(jiān)聽目錄并自動(dòng)更新圖譜1. 標(biāo)準(zhǔn)調(diào)用命令$(cat graphify-out/.graphify_python) -m graphify.watch INPUT_PATH --debounce 3把INPUT_PATH替換為要監(jiān)聽的目錄。watch.py 的__main__入口定義了兩個(gè)參數(shù)path位置參數(shù)監(jiān)聽目錄默認(rèn)值為.當(dāng)前目錄--debounce最后一次文件活動(dòng)后等待的秒數(shù)默認(rèn) 3.0 秒。文檔對(duì) debounce 的解釋是等待文件活動(dòng)停止后再觸發(fā)避免并行 agent 批量寫入時(shí)每個(gè)文件都觸發(fā)一次重建。源碼中watch()的主循環(huán)每 0.5 秒檢查一次只有time.monotonic() - last_trigger debounce且有待處理變更時(shí)才把本批變更清空并提交處理。按CtrlC停止監(jiān)聽進(jìn)程會(huì)打印Stopped.并停止 observer。2. 行為分叉代碼文件 vs 文檔/論文/圖片文檔給出的行為規(guī)則與 watch.py 中_batch_triggers_rebuild()/_batch_needs_llm_flag()完全對(duì)應(yīng)僅代碼文件變化.py、.ts、.go 等立即重跑 AST 抽取 重建 社區(qū)聚類不需要 LLMgraph.json與GRAPH_REPORT.md自動(dòng)更新文檔、論文或圖片變化寫入graphify-out/needs_update標(biāo)志文件并打印提示要求手動(dòng)運(yùn)行/graphify --update語(yǔ)義重抽取需要 LLM任意被監(jiān)聽文件的刪除也會(huì)觸發(fā)立即重建——因?yàn)榘岩褎h源文件的節(jié)點(diǎn)剔除eviction同樣不需要 LLM全量語(yǔ)料調(diào)和會(huì)丟棄磁盤上已不存在的源對(duì)應(yīng)的節(jié)點(diǎn)?！按a文件”的判定來自 detect.py 中的擴(kuò)展名集合CODE_EXTENSIONS約 100 余個(gè)擴(kuò)展名覆蓋 Python/TS/Go/Rust/Java/C/C#/Swift/Scala/SQL/Terraform/Pascal 等監(jiān)聽器實(shí)際關(guān)注的擴(kuò)展名是CODE_EXTENSIONS | DOC_EXTENSIONS | PAPER_EXTENSIONS | IMAGE_EXTENSIONS的并集.pdf歸 paper.png/.jpg/.webp/.svg等歸 image。3. Agent 工作流建議文檔結(jié)尾給出針對(duì) agentic 工作流的兩條建議在后臺(tái)終端運(yùn)行--watchagent 波次之間的代碼改動(dòng)會(huì)被自動(dòng)拾取如果 agent 同時(shí)還在寫文檔或筆記那些波次結(jié)束后需要手動(dòng)執(zhí)行一次/graphify --update來補(bǔ)上語(yǔ)義重抽取。配套的check_update()函數(shù)cron 安全恒返回 True會(huì)在標(biāo)志文件存在時(shí)打印“Run/graphify --updateto apply semantic re-extraction”的提示方便定時(shí)任務(wù)把待辦暴露給用戶。三、源碼縱深watch 的一次完整重建到底做了什么_rebuild_code()watch.py 核心函數(shù)是上述“代碼變更立即重建”的執(zhí)行體其調(diào)用鏈可概括為目錄穩(wěn)定化_stabilize_rebuild_cwd()處理 git hook 繼承的臨時(shí)工作目錄已被刪除的情況通過GRAPHIFY_REPO_ROOT環(huán)境變量恢復(fù) CWD加鎖_rebuild_lock()用fcntl.flock做每倉(cāng)庫(kù)咨詢鎖Windows 上退化為直通鎖文件.rebuild.lock寫入持有者 PID 供外部輪詢拿不到鎖時(shí)增量變更會(huì)先寫入.pending_changes排隊(duì)鎖持有者重建前后各清空一次隊(duì)列并合并變更集對(duì)應(yīng)并發(fā) post-commit hook 場(chǎng)景源碼標(biāo)注為 issue #1059檢測(cè)與抽取重新detect()出代碼語(yǔ)料并復(fù)用上次的--exclude持久化配置.graphify_build.json對(duì)已有語(yǔ)義層的文檔跳過 AST 快掃然后extract()只解析變更/全量文件增量重建時(shí)還會(huì)從已有g(shù)raph.json中借來未重建文件的 AST 節(jié)點(diǎn)作為跨文件解析上下文避免“改 A 文件導(dǎo)致 A→B 的調(diào)用邊消失”與已有圖譜調(diào)和_reconcile_existing_graph()把新抽取與保留的舊節(jié)點(diǎn)/邊/超邊合并驅(qū)逐已刪源文件的內(nèi)容并做 fail-closed 的“排除存活文件”保護(hù)——文件仍在磁盤但被過濾掉時(shí)不會(huì)當(dāng)成刪除而誤清節(jié)點(diǎn)而是保留并大聲提示聚類與報(bào)告cluster() 社區(qū)標(biāo)簽復(fù)用校驗(yàn) generate()報(bào)告 to_json()原子寫盤先寫.graph.tmp.json再replace若候選圖譜與現(xiàn)有圖譜規(guī)范化后完全相同則不寫任何文件打印No code-graph changes detected收縮護(hù)欄_check_shrink()拒絕“節(jié)點(diǎn)數(shù)變少且損失無法被本次重建/刪除來源解釋”的寫盤防語(yǔ)義 chunk 丟失導(dǎo)致的靜默塌陷除非損失全部歸屬本次重建過的源文件或已聲明的刪除路徑收尾更新manifest.json、清掉陳舊的needs_update標(biāo)志、按需重生成graph.html與已存在的*-callflow.html。監(jiān)聽側(cè)的事件過濾同樣有講究.graphifyignore模式在啟動(dòng)時(shí)一次性加載避免高頻文件系統(tǒng)事件下反復(fù)解析opened/closed_no_write這類“只讀”事件被顯式過濾Linux inotify 會(huì)對(duì)每次打開文件產(chǎn)生事件不過濾會(huì)導(dǎo)致監(jiān)聽器自我觸發(fā)、空轉(zhuǎn)燒 CPUmacOS 上使用PollingObserverFSEvents 對(duì)快速保存可能漏報(bào)graphify-out目錄自身與含.開頭的路徑分量一律忽略。四、實(shí)操注意事項(xiàng)與適用前提執(zhí)行環(huán)境兩個(gè)命令都通過graphify-out/.graphify_python記錄的解釋器運(yùn)行前提是已經(jīng)有一次完整的/graphify構(gòu)建在該目錄下產(chǎn)生了graphify-out/視頻 URL必須額外安裝pip install graphifyy[video]依賴 yt-dlp 與 faster-whisper轉(zhuǎn)寫要求 Python 3.11否則ingest()在 youtube 分支的download_audio導(dǎo)入會(huì)失敗并拋RuntimeError失敗即報(bào)告ingest()對(duì)非法 URL 拋ValueError、對(duì)抓取失敗拋RuntimeError且 watch.py 的重建路徑對(duì)“讀不懂的既有 graph.json”采取 fail-closed——寧可拒絕覆寫也不吞錯(cuò)刪除語(yǔ)義文件純刪除批次由 watch 的 reconcile 掃描直接處理不會(huì)留下陳舊的needs_update標(biāo)志但新增/修改文檔仍需一次手動(dòng)/graphify --update驗(yàn)證參考watch 的并發(fā)排隊(duì)、鎖定與收縮護(hù)欄行為在 tests/test_watch.py 中有大量用例覆蓋ingest 的抓取邏輯可在 tests/test_ingest.py 中對(duì)照閱讀。小結(jié)/graphify add url與--watch補(bǔ)齊了 graphify “代碼圖譜之外”的兩塊拼圖前者把網(wǎng)頁(yè)、論文、推文、視頻等異構(gòu)外部?jī)?nèi)容以統(tǒng)一的 frontmatter-markdown/二進(jìn)制格式納入./raw語(yǔ)料庫(kù)后者讓代碼變更在毫秒級(jí)被監(jiān)聽器捕獲后零 LLM 成本地刷新graph.json與GRAPH_REPORT.md而把需要語(yǔ)義理解的文檔變更明確交給/graphify --update。兩者合在一起構(gòu)成了 graphify 語(yǔ)料庫(kù)從“一次性構(gòu)建”走向“持續(xù)增量同步”的完整閉環(huán)?！久赓M(fèi)下載鏈接】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.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/graph/graphify創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 graphify add 與 --watch：把外部 URL 增量納入語(yǔ)料庫(kù)，并用文件監(jiān)聽實(shí)時(shí)同步知識(shí)圖譜
graphify add 與 --watch把外部 URL 增量納入語(yǔ)料庫(kù)并用文件監(jiān)聽實(shí)時(shí)同步知識(shí)圖譜【免費(fèi)下載鏈接】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.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/graph/graphifygraphify 的 Pi skill 提供了一條默認(rèn)構(gòu)建流程之外的旁路能力/graphify add url可以把網(wǎng)頁(yè)、論文、推特、視頻等外部?jī)?nèi)容抓取為圖譜語(yǔ)料--watch則啟動(dòng)一個(gè)后臺(tái)監(jiān)聽器在文件變化時(shí)自動(dòng)重建代碼圖譜或提示語(yǔ)義重抽取。本文基于 add-watch 參考文檔 與 ingest.py、watch.py 的源碼實(shí)現(xiàn)完整講解這兩條命令的用法、支持的內(nèi)容類型以及 watch 底層的事件過濾、增量重建與安全護(hù)欄機(jī)制。文檔定位旁路能力不在默認(rèn)構(gòu)建路徑中add-watch.md 是 Pi 智能體技能包中的一份“按需加載”參考文檔開頭明確說明Load this when the user ran/graphify add urlor passed--watch. Neither is part of the default build.也就是說只有當(dāng)用戶顯式觸發(fā)這兩個(gè)動(dòng)作時(shí)智能體才會(huì)讀取該文檔并按其中的指令執(zhí)行。這與 update.md增量更新、transcribe.md視頻轉(zhuǎn)寫等參考文檔共同構(gòu)成了 Pi 技能下/graphify命令族的完整操作手冊(cè)。一、/graphify add url抓取 URL 并寫入語(yǔ)料庫(kù)1. 標(biāo)準(zhǔn)調(diào)用命令文檔給出的執(zhí)行模板如下URL、AUTHOR、CONTRIBUTOR為占位符需替換為實(shí)際值$(cat graphify-out/.graphify_python) -c import sys from graphify.ingest import ingest from pathlib import Path try: out ingest(URL, Path(./raw), authorAUTHOR, contributorCONTRIBUTOR) print(fSaved to {out}) except ValueError as e: print(ferror: {e}, filesys.stderr) sys.exit(1) except RuntimeError as e: print(ferror: {e}, filesys.stderr) sys.exit(1) 其中$(cat graphify-out/.graphify_python)是 graphify 構(gòu)建產(chǎn)物里記錄的 Python 解釋器路徑保證命令與構(gòu)建該圖譜時(shí)使用的環(huán)境一致。參數(shù)語(yǔ)義與 ingest.py 中ingest()的簽名一一對(duì)應(yīng)target_dir語(yǔ)料落盤目錄文檔中固定為./raw即后續(xù)--update管道的輸入根目錄author/contributor寫入文件 frontmatter 的署名元數(shù)據(jù)用于團(tuán)隊(duì)協(xié)作圖譜的溯源。兩者省略時(shí) frontmatter 的contributor回退為unknownValueErrorURL 未通過graphify.security.validate_url校驗(yàn)如非法地址、內(nèi)網(wǎng)地址命令以非零碼退出RuntimeError網(wǎng)絡(luò)抓取失敗HTTP 錯(cuò)誤、DNS 失敗、OSError 等。文檔特別強(qiáng)調(diào)命令報(bào)錯(cuò)時(shí)必須把原因告訴用戶不得靜默繼續(xù)。成功落盤后應(yīng)自動(dòng)對(duì)./raw執(zhí)行--update管道見 update.md 的增量流程把新文件合并進(jìn)已有圖譜。2. 支持的 URL 類型自動(dòng)檢測(cè)文檔列出了六類 URL其判定邏輯與 ingest.py 中_detect_url_type()的實(shí)現(xiàn)一致——按域名或路徑后綴順序分類URL 類型判定條件落盤行為YouTube / 任意視頻域名含youtube.com或youtu.be通過 yt-dlp 下載音頻下次運(yùn)行時(shí)轉(zhuǎn)寫為.txt需pip install graphifyy[video]Twitter/X域名含twitter.com或x.com經(jīng) oEmbed 接口抓取推文正文與作者存為.mdarXiv域名含arxiv.org抓取摘要 元數(shù)據(jù)存為.mdPDF路徑以.pdf結(jié)尾直接下載為.pdf文件圖片路徑以.png/.jpg/.jpeg/.webp/.gif結(jié)尾直接下載下次運(yùn)行時(shí)由 Claude vision 抽取內(nèi)容任意網(wǎng)頁(yè)以上皆不匹配轉(zhuǎn)換為 markdown 后存為.md源碼中有幾個(gè)值得注意的實(shí)現(xiàn)細(xì)節(jié)推文_fetch_tweetx.com鏈接會(huì)被歸一化為twitter.com后請(qǐng)求publish.twitter.com/oembed接口oEmbed 失敗時(shí)不報(bào)錯(cuò)而是落一個(gè)包含“could not fetch content”占位文本的 stub 文件保證語(yǔ)料不丟失。arXiv_fetch_arxiv從 URL 中用正則提取論文編號(hào)轉(zhuǎn)而請(qǐng)求export.arxiv.org/abs/頁(yè)面抽取標(biāo)題、作者與摘要文件名固定為arxiv_{編號(hào)}.md。網(wǎng)頁(yè)_fetch_webpage先剔除script/style再轉(zhuǎn) markdown正文截?cái)嗟?12000 字符以內(nèi)防止超大頁(yè)面撐爆語(yǔ)義抽取。安全所有抓取都經(jīng)過graphify.security的safe_fetch/safe_fetch_text/validate_url且寫入 frontmatter 前用_yaml_str()轉(zhuǎn)義控制字符——源碼注釋明確指出這是為了防止惡意頁(yè)面標(biāo)題注入 YAML 兄弟鍵對(duì)應(yīng)安全項(xiàng) F-009/F-019。視頻能力依賴可選依賴組pyproject.toml 中video [faster-whisper; python_version 3.11, yt-dlp2026.6.9]即graphifyy[video]額外安裝 Whisper 轉(zhuǎn)寫模型要求 Python 3.11與 yt-dlp。音頻下載本身由graphify.transcribe.download_audio()完成轉(zhuǎn)寫動(dòng)作發(fā)生在下一次--update運(yùn)行時(shí)對(duì)應(yīng) transcribe.md 的流程。3. 落盤格式frontmatter 防沖突命名所有文本類抓取結(jié)果都寫成帶 YAML frontmatter 的 markdown字段包括source_url、typetweet/paper/webpage、captured_atUTC ISO 時(shí)間戳、contributor論文還帶arxiv_id、title、paper_authors。這些字段會(huì)被 graphify 的 markdown 抽取器讀取為節(jié)點(diǎn)元數(shù)據(jù)。文件名由_safe_filename()從 URL 的 hostpath 清洗生成非字符合法字符替換為_截?cái)嗟?80 字符。若目標(biāo)文件已存在ingest()會(huì)自動(dòng)追加_1、_2… 后綴避免覆蓋直到第 1000 次為止。二、--watch后臺(tái)監(jiān)聽目錄并自動(dòng)更新圖譜1. 標(biāo)準(zhǔn)調(diào)用命令$(cat graphify-out/.graphify_python) -m graphify.watch INPUT_PATH --debounce 3把INPUT_PATH替換為要監(jiān)聽的目錄。watch.py 的__main__入口定義了兩個(gè)參數(shù)path位置參數(shù)監(jiān)聽目錄默認(rèn)值為.當(dāng)前目錄--debounce最后一次文件活動(dòng)后等待的秒數(shù)默認(rèn) 3.0 秒。文檔對(duì) debounce 的解釋是等待文件活動(dòng)停止后再觸發(fā)避免并行 agent 批量寫入時(shí)每個(gè)文件都觸發(fā)一次重建。源碼中watch()的主循環(huán)每 0.5 秒檢查一次只有time.monotonic() - last_trigger debounce且有待處理變更時(shí)才把本批變更清空并提交處理。按CtrlC停止監(jiān)聽進(jìn)程會(huì)打印Stopped.并停止 observer。2. 行為分叉代碼文件 vs 文檔/論文/圖片文檔給出的行為規(guī)則與 watch.py 中_batch_triggers_rebuild()/_batch_needs_llm_flag()完全對(duì)應(yīng)僅代碼文件變化.py、.ts、.go 等立即重跑 AST 抽取 重建 社區(qū)聚類不需要 LLMgraph.json與GRAPH_REPORT.md自動(dòng)更新文檔、論文或圖片變化寫入graphify-out/needs_update標(biāo)志文件并打印提示要求手動(dòng)運(yùn)行/graphify --update語(yǔ)義重抽取需要 LLM任意被監(jiān)聽文件的刪除也會(huì)觸發(fā)立即重建——因?yàn)榘岩褎h源文件的節(jié)點(diǎn)剔除eviction同樣不需要 LLM全量語(yǔ)料調(diào)和會(huì)丟棄磁盤上已不存在的源對(duì)應(yīng)的節(jié)點(diǎn)?！按a文件”的判定來自 detect.py 中的擴(kuò)展名集合CODE_EXTENSIONS約 100 余個(gè)擴(kuò)展名覆蓋 Python/TS/Go/Rust/Java/C/C#/Swift/Scala/SQL/Terraform/Pascal 等監(jiān)聽器實(shí)際關(guān)注的擴(kuò)展名是CODE_EXTENSIONS | DOC_EXTENSIONS | PAPER_EXTENSIONS | IMAGE_EXTENSIONS的并集.pdf歸 paper.png/.jpg/.webp/.svg等歸 image。3. Agent 工作流建議文檔結(jié)尾給出針對(duì) agentic 工作流的兩條建議在后臺(tái)終端運(yùn)行--watchagent 波次之間的代碼改動(dòng)會(huì)被自動(dòng)拾取如果 agent 同時(shí)還在寫文檔或筆記那些波次結(jié)束后需要手動(dòng)執(zhí)行一次/graphify --update來補(bǔ)上語(yǔ)義重抽取。配套的check_update()函數(shù)cron 安全恒返回 True會(huì)在標(biāo)志文件存在時(shí)打印“Run/graphify --updateto apply semantic re-extraction”的提示方便定時(shí)任務(wù)把待辦暴露給用戶。三、源碼縱深watch 的一次完整重建到底做了什么_rebuild_code()watch.py 核心函數(shù)是上述“代碼變更立即重建”的執(zhí)行體其調(diào)用鏈可概括為目錄穩(wěn)定化_stabilize_rebuild_cwd()處理 git hook 繼承的臨時(shí)工作目錄已被刪除的情況通過GRAPHIFY_REPO_ROOT環(huán)境變量恢復(fù) CWD加鎖_rebuild_lock()用fcntl.flock做每倉(cāng)庫(kù)咨詢鎖Windows 上退化為直通鎖文件.rebuild.lock寫入持有者 PID 供外部輪詢拿不到鎖時(shí)增量變更會(huì)先寫入.pending_changes排隊(duì)鎖持有者重建前后各清空一次隊(duì)列并合并變更集對(duì)應(yīng)并發(fā) post-commit hook 場(chǎng)景源碼標(biāo)注為 issue #1059檢測(cè)與抽取重新detect()出代碼語(yǔ)料并復(fù)用上次的--exclude持久化配置.graphify_build.json對(duì)已有語(yǔ)義層的文檔跳過 AST 快掃然后extract()只解析變更/全量文件增量重建時(shí)還會(huì)從已有g(shù)raph.json中借來未重建文件的 AST 節(jié)點(diǎn)作為跨文件解析上下文避免“改 A 文件導(dǎo)致 A→B 的調(diào)用邊消失”與已有圖譜調(diào)和_reconcile_existing_graph()把新抽取與保留的舊節(jié)點(diǎn)/邊/超邊合并驅(qū)逐已刪源文件的內(nèi)容并做 fail-closed 的“排除存活文件”保護(hù)——文件仍在磁盤但被過濾掉時(shí)不會(huì)當(dāng)成刪除而誤清節(jié)點(diǎn)而是保留并大聲提示聚類與報(bào)告cluster() 社區(qū)標(biāo)簽復(fù)用校驗(yàn) generate()報(bào)告 to_json()原子寫盤先寫.graph.tmp.json再replace若候選圖譜與現(xiàn)有圖譜規(guī)范化后完全相同則不寫任何文件打印No code-graph changes detected收縮護(hù)欄_check_shrink()拒絕“節(jié)點(diǎn)數(shù)變少且損失無法被本次重建/刪除來源解釋”的寫盤防語(yǔ)義 chunk 丟失導(dǎo)致的靜默塌陷除非損失全部歸屬本次重建過的源文件或已聲明的刪除路徑收尾更新manifest.json、清掉陳舊的needs_update標(biāo)志、按需重生成graph.html與已存在的*-callflow.html。監(jiān)聽側(cè)的事件過濾同樣有講究.graphifyignore模式在啟動(dòng)時(shí)一次性加載避免高頻文件系統(tǒng)事件下反復(fù)解析opened/closed_no_write這類“只讀”事件被顯式過濾Linux inotify 會(huì)對(duì)每次打開文件產(chǎn)生事件不過濾會(huì)導(dǎo)致監(jiān)聽器自我觸發(fā)、空轉(zhuǎn)燒 CPUmacOS 上使用PollingObserverFSEvents 對(duì)快速保存可能漏報(bào)graphify-out目錄自身與含.開頭的路徑分量一律忽略。四、實(shí)操注意事項(xiàng)與適用前提執(zhí)行環(huán)境兩個(gè)命令都通過graphify-out/.graphify_python記錄的解釋器運(yùn)行前提是已經(jīng)有一次完整的/graphify構(gòu)建在該目錄下產(chǎn)生了graphify-out/視頻 URL必須額外安裝pip install graphifyy[video]依賴 yt-dlp 與 faster-whisper轉(zhuǎn)寫要求 Python 3.11否則ingest()在 youtube 分支的download_audio導(dǎo)入會(huì)失敗并拋RuntimeError失敗即報(bào)告ingest()對(duì)非法 URL 拋ValueError、對(duì)抓取失敗拋RuntimeError且 watch.py 的重建路徑對(duì)“讀不懂的既有 graph.json”采取 fail-closed——寧可拒絕覆寫也不吞錯(cuò)刪除語(yǔ)義文件純刪除批次由 watch 的 reconcile 掃描直接處理不會(huì)留下陳舊的needs_update標(biāo)志但新增/修改文檔仍需一次手動(dòng)/graphify --update驗(yàn)證參考watch 的并發(fā)排隊(duì)、鎖定與收縮護(hù)欄行為在 tests/test_watch.py 中有大量用例覆蓋ingest 的抓取邏輯可在 tests/test_ingest.py 中對(duì)照閱讀。小結(jié)/graphify add url與--watch補(bǔ)齊了 graphify “代碼圖譜之外”的兩塊拼圖前者把網(wǎng)頁(yè)、論文、推文、視頻等異構(gòu)外部?jī)?nèi)容以統(tǒng)一的 frontmatter-markdown/二進(jìn)制格式納入./raw語(yǔ)料庫(kù)后者讓代碼變更在毫秒級(jí)被監(jiān)聽器捕獲后零 LLM 成本地刷新graph.json與GRAPH_REPORT.md而把需要語(yǔ)義理解的文檔變更明確交給/graphify --update。兩者合在一起構(gòu)成了 graphify 語(yǔ)料庫(kù)從“一次性構(gòu)建”走向“持續(xù)增量同步”的完整閉環(huán)?！久赓M(fèi)下載鏈接】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.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/graph/graphify創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考