hawkli-1994/deerflow-book

해결하는 문제

이 책은 개발자가 DeerFlow를 블랙박스로 사용하는 것을 넘어서도록 돕습니다. DeerFlow 2.0의 내부 아키텍처와 소스 코드를 설명하여 독자가 자신의 프로젝트에 맞게 수정, 확장 또는 그 위에 구축할 수 있게 합니다. 프레임워크 호출 방법만 보여주는 대신, 실제 소스 파일과 실용적인 예제를 통해 코드가 왜 그렇게 설계되었는지 파고듭니다.

작동 방식

이 책은 세 부분으로 구성됩니다. 1부는 이론적 기초를 다룹니다: DeerFlow가 무엇인지, Skills 대 Tools, Sub-Agents, Sandbox, Memory, 컨텍스트 엔지니어링과 같은 핵심 개념, 그리고 전체 아키텍처입니다. 2부는 소스 코드를 장별로 깊이 있게 다루며, ThreadState 타입 시스템, 미들웨어 체인, Skills 및 Tools 관리자, Sub-Agent 실행기, Sandbox 제공자, Memory 시스템 및 컨텍스트 엔지니어링 기술을 설명합니다. 3부는 실제 2차 개발에 초점을 맞춥니다: OAuth 2.0을 사용한 MCP 서버 통합, 멀티모달 출력(PPT, 팟캐스트, 이미지, 비디오, 대시보드)을 갖춘 사용자 정의 Skills 구축, 인간 개입 승인 흐름 추가, 멀티테넌트 격리, RBAC 및 감사 시스템과 같은 엔터프라이즈 사례입니다. 각 장은 설명하는 실제 DeerFlow 소스 파일을 참조하며, 최신 버전에 맞게 지속적으로 업데이트됩니다.

대상 독자

이 책은 에이전트 또는 LLM 애플리케이션에 대한 경험이 있고 진지한 커스터마이징을 원하는 개발자를 대상으로 합니다. Python 3.12+, 타입 어노테이션, 비동기 프로그래밍 및 기본 LangChain/LangGraph 개념에 익숙해야 합니다. 초보자, 2차 개발 엔지니어, 엔터프라이즈 애플리케이션 개발자 및 잠재적 소스 기여자를 위한 다양한 읽기 경로가 있습니다.

하이라이트

• 소스 수준 분석: 각 장은 실제 DeerFlow 소스 코드를 다루며, 높은 수준의 아이디어만이 아닙니다.
• 실용 지향: 프로젝트에서 직접 사용할 수 있는 완전한 2차 개발 예제를 제공합니다.
• 아키텍처 사고: "사용 방법"뿐만 아니라 "왜 이렇게 설계되었는지"도 설명합니다.
• 지속적 업데이트: DeerFlow 릴리스와 동기화되며, 최근 업데이트는 메모리, 스킬, 샌드박스 및 OAuth를 다룹니다.
• Docker 빠른 시작 가이드 및 로컬 설정 참조를 포함합니다.
• MIT 라이선스로 오픈 소스이며, 기여 지침을 제공합니다.