hawkli-1994/deerflow-book

解決する課題

この本は、開発者が DeerFlow をブラックボックスとして使うことを超えるのに役立ちます。DeerFlow 2.0 の内部アーキテクチャとソースコードを解説し、読者が自分のプロジェクト用に修正、拡張、またはその上に構築できるようにします。フレームワークの呼び出し方を示すだけでなく、実際のソースファイルと実践的な例を用いて、コードがなぜそのように設計されているのかを掘り下げます。

仕組み

この本は3部構成です。第1部では理論的基盤を扱います：DeerFlow とは何か、Skills と Tools、Sub-Agents、Sandbox、Memory、コンテキストエンジニアリングなどの核となる概念、そして全体アーキテクチャです。第2部ではソースコードを章ごとに深掘りし、ThreadState 型システム、ミドルウェアチェーン、Skills と Tools マネージャー、Sub-Agent 実行器、Sandbox プロバイダー、Memory システム、コンテキストエンジニアリング技術を説明します。第3部は実際の二次開発に焦点を当てます：OAuth 2.0 を使用した MCP サーバーの統合、マルチモーダル出力（PPT、ポッドキャスト、画像、ビデオ、ダッシュボード）を備えたカスタム Skills の構築、人間参加型の承認フローの追加、マルチテナント分離、RBAC、監査システムなどのエンタープライズ事例です。各章は説明する実際の DeerFlow ソースファイルを参照し、最新バージョンに合わせて継続的に更新されます。

対象読者

この本は、エージェントや LLM アプリケーションの経験があり、本格的なカスタマイズを希望する開発者を対象としています。Python 3.12+、型注釈、非同期プログラミング、基本的な LangChain/LangGraph の概念に精通していることが期待されます。初心者、二次開発エンジニア、エンタープライズアプリケーション開発者、潜在的なソースコントリビューター向けに異なる読書経路があります。

ハイライト

• ソースレベル分析：各章は実際の DeerFlow ソースコードに踏み込み、高レベルのアイデアだけではありません。
• 実践志向：プロジェクトで直接使用できる完全な二次開発例を提供。
• アーキテクチャ思考：「使い方」だけでなく「なぜこのように設計されたか」も説明。
• 継続的更新：DeerFlow リリースと同期し、最近の更新ではメモリ、スキル、サンドボックス、OAuth をカバー。
• Docker クイックスタートガイドとローカル設定の参照を含む。
• MIT ライセンスでオープンソース、貢献ガイドライン付き。