yizhiyanhua-ai/fireworks-tech-graph

解決的問題

fireworks-tech-graph 免除了手動繪製技術圖表的需求。它允許使用者以自然語言（英文或中文）描述系統架構或流程，並自動產生經過幾何檢查的精美圖表，支援 SVG、PNG 和互動式 HTML 格式，以及語義 GIF 動畫。

運作方式

本專案作為 Codex 和 Claude Code 等 AI 助理的代理技能運作。它遵循有界的驗證迴圈以確保品質：

1. 生成：將自然語言提示轉換為語義中間表示 (IR)，然後轉換為 SVG。
2. 確定性驗證：檢查 XML 結構、標記完整性和路徑幾何，以防止邊緣重疊或航點格式錯誤等問題。
3. 感知驗證：將 SVG 渲染為 PNG 並執行視覺回讀，以檢查是否有裁剪、標籤碰撞和路由品質問題。
4. 定向修正：如果發現錯誤，系統會在最終交付前對特定座標或標籤執行針對性的修正。

適用對象

• 軟體工程師：用於建立 C4 評論、雲端部署圖表和事件驅動架構圖。
• AI/代理開發人員：用於視覺化 RAG 管線、多代理協作和記憶體架構。
• 技術文件撰寫人員：用於產生一致且高品質的文件視覺效果，而無需手動繪圖工具。

亮點

• 12 種視覺風格：包含 11 種由生成器支援的風格和一種 AI 創作的「Dark Luxury」風格。
• 工程契約：對特定圖表類型（例如 C4、Cloud Fabric、Event Transit）強制執行嚴格規則，以確保技術準確性。
• 全面支援：支援 14 種 UML 圖表類型和專門的 AI/代理領域模式（例如 Mem0、Tool Call 流程）。
• 語義動畫：將 SVG 轉換為 GIF，其中連接器以特定的語義順序繪製，並具有「settled-flow」時間軸。
• 幾何安全路由：使用確定性的正交路由來避免線條交叉並最小化彎曲。
• 互動式匯出：產生具有平移/縮放、主題切換和多種匯出格式的離線 HTML 檔案。