meng shao(@shao__meng)의 스레드

[오픈 소스 권장 사항] CodeWiki: 대규모 다국어 코드 저장소에 대한 완전하고 체계적이며 아키텍처를 고려한 문서를 자동으로 생성하는 오픈 소스 프레임워크입니다. ⚠️이것은 Google Codewiki가 아닙니다⚠️ 기존의 코드 문서화 도구나 AI 도구는 일반적으로 함수/파일 수준에만 초점을 맞추기 때문에 파일, 모듈, 심지어 전체 시스템 간의 상호작용을 파악하기 어렵습니다. 수십만 줄 또는 수백만 줄의 코드가 포함된 실제 프로젝트의 경우, 수작업 문서화는 막대한 비용이 소요되는 반면, 기존 자동화 도구는 전체적인 아키텍처 관점이 부족한 단편적인 콘텐츠를 생성하는 경우가 많습니다. CodeWiki는 이러한 문제점을 해결하기 위해 설계되었습니다. "프로젝트 위키"와 유사하게 전체 코드 저장소에 대한 완전한 문서를 생성할 수 있으며, 여기에는 고수준 아키텍처 개요, 모듈 간 종속성, 데이터 흐름, 시퀀스 다이어그램, 사용 예 등이 포함되고 다중 모드 출력(텍스트 + 대화형 Mermaid 차트)을 지원합니다. 핵심 혁신(3대 핵심 기술) 1. 계층적 분해는 동적 프로그래밍의 아이디어를 활용하여 거대한 창고를 여러 개의 "모듈 클러스터"로 지능적으로 분할합니다. 이를 통해 아키텍처 컨텍스트를 유지할 뿐만 아니라 각 하위 작업의 크기를 제어할 수 있습니다(86,000~140만 줄의 코드 지원이 검증됨). 2. 재귀적 다중 에이전트 처리는 여러 에이전트 간의 협업을 활용합니다. 간단한 모듈은 직접 생성되고, 복잡한 모듈은 동적으로 분해되어 처리를 위해 하위 에이전트에 위임되므로 대규모 저장소에서도 높은 품질과 확장성을 보장합니다. 이는 단일 LLM 호출보다 더 강력한 "세미 에이전트" 설계입니다. 3. 멀티모달 합성을 통해 출력된 최종 문서에는 마크다운 텍스트가 포함될 뿐만 아니라 다음 내용도 자동으로 포함됩니다. • 아키텍처 다이어그램 • 데이터 흐름 그래프/종속성 그래프 • 시퀀스 다이어그램 • API 참조, 사용 예 등 성능 측정 항목(논문의 벤치마크 CodeWikiBench에서 가져옴) • 클로드와 같은 폐쇄형 소스 모델을 사용하면 평균 품질 점수가 68.79%로 폐쇄형 소스 상용 도구인 DeepWiki보다 4.73% 더 높습니다. 특히 Python/JS와 같은 고급 언어에서 개선이 눈에 띄게 나타났습니다(+10.47%). • 오픈소스 모델은 기존 기준을 크게 뛰어넘는 ~64.8%를 달성할 수 있습니다. 오픈소스 주소: