export + exporters：圖 → 檔案

to_json 是 graphify 最重視資料安全的地方：

1. Shrink guard（issue #479 的核心）：如果既有 graph.json 存在且新圖節點數更少，拒絕覆寫。因為「新圖比較小」通常代表前一次 session 的 chunk 檔遺失、或 fuzzy dedup 誤併。讀不到既有檔（corrupt）時也 fail-safe——寧可不寫，也不讓局部重建覆蓋掉好的圖。
2. 寫入節點中繼：每個節點補上 community、community_name、norm_label（去掉重音符號的小寫 label，供檢索）。
3. 邊方向還原：無向 NetworkX 儲存可能把 calls 等有向邊的端點順序搞反，build 時在 _src/_tgt 藏了真實端點，這裡還原（issue #563）。
4. 超邊防護：圖沒有 hyperedges key 但磁碟上的舊檔有——印出清楚警告（issue #2485）。
5. Atomic write：write_json_atomic() 原子寫入——中途當機不會截斷好的 graph.json。

段落式說明：--obsidian flag 的實作。為每個社群產生一篇 _COMMUNITY_<name>.md，節點之間用 Obsidian wikilink（[[…]]）互連——這樣你在 Obsidian 的 graph view 直接看到整個知識圖譜。檔名用 _obsidian_safe_stem 安全化、_dedup_node_filenames 避免同名檔衝突、frontmatter 用 _yaml_str 防注入（與 security 對應）。

段落式說明：

• to_cypher(G, path) — 產生 cypher.txt（Neo4j / FalkorDB 匯入），_cypher_escape / _cypher_label 處理 Cypher 字串與 label 安全。
• to_graphml(G, path) — 輸出 GraphML（Gephi / yEd）。
• to_svg(G, path) — SVG 圖（Notion / GitHub 內嵌）。
• to_canvas(G, …) — Obsidian Canvas 輸出。
• backup_if_protected(out_dir) — 目標目錄受保護時先備份。

這就是本站 實作案例 互動圖的生成器。輸出是單一自含 HTML：

• 資料內嵌：節點（含顏色、大小、community）、邊、圖例各自序列化成 JS 常量（RAW_NODES / RAW_EDGES / LEGEND）寫進 <script>。
• 視覺化：用 vis-network（unpkg CDN）以 forceAtlas2Based 物理引擎畫力導向圖。
• 側欄：搜尋、節點資訊（type / community / source / degree / neighbors）、社群圖例（可勾選隱藏）。
• 超邊疊加：_hyperedge_script 在 canvas afterDrawing 時畫半透明群組區域。
• HTML-escape：節點 label 都經過 esc() 才進 innerHTML——這呼應 SECURITY.md 的 XSS 緩解。

段落式說明：

• _html_styles() — 回傳內嵌 CSS 字串（深色主題、側欄、圖例）。
• _html_script(nodes_json, edges_json, legend_json) — 組出全部渲染 JS（dataset 建立、network 選項、搜尋、點選、圖例互動）。
• _viz_node_limit() — 節點上限防護（超過就不生成 HTML，避免瀏覽器開不動）。
• _hyperedge_script(hyperedges_json) — 超邊的 canvas 疊加渲染。

段落式說明：build_tree(paths) 把檔案路徑清單組成一棵樹（_common_root 找出共同根、_make_truncation_leaf 處理過多子節點），emit_html / write_tree_html 渲染成自含 HTML。這讓瀏覽者先看到專案結構，再進圖。

段落式說明：graphify export callflow-html 的實作。讀取圖資料（load_graph），把節點/邊正規化成統一形狀（normalize_node / normalize_edge），最後渲染成含 Mermaid 圖的 HTML。裝了 hook 時，每次 git commit 都會自動重新生成。