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 파일을 생성합니다.