YOUTUBE影片：https://youtu.be/xHJHfwYp00s

🔹 1. 安裝環境

🛠️ 必要條件

1. Node.js 環境

   • 需要安裝 Node.js（建議使用 LTS 版本）。
   • 若未安裝，可前往 Node.js 官方網站 下載並安裝。
   • 可透過指令確認安裝：

   node -v
   npm -v
   

   

2. Git 環境

   • 若未安裝，可前往 Git 官方網站 下載並安裝。
   • 確認安裝：

   git --version
   

   

🔹 2. 克隆 GitHub Repository

在終端機 (Terminal) 或命令提示字元 (CMD) 中執行：

git clone <https://github.com/DZHNG/deep-research.git>

進入專案目錄：

cd deep-research

🔹 3. 安裝依賴

執行：

npm install

這將安裝 所有必要的 Node.js 套件。

🔹 4. 設定環境變數

1. 複製 .env.example 並重新命名為 .env.local：

   cp .env.example .env.local
   

   1. 編輯 .env.local，填入 API Key

      • 使用 文字編輯器（如 VS Code、nano、vim）打開 .env.local。

      • 添加 Firecrawl 和 OpenAI API Key：

        FIRECRAWL_KEY="your_firecrawl_key"
        OPENAI_KEY="your_openai_key"
        

   2. 如果使用本地 LLM（例如 OpenRouter 或 Gemini），可設定：

      OPENAI_ENDPOINT="<http://localhost:1234/v1>"
      OPENAI_MODEL="custom_model"
      

🔹 5. 執行 AI 研究助手

啟動 AI 研究助手：

npm start

⚡ 執行過程

1. 系統提示輸入研究查詢

   • 例如：

     請輸入您的研究查詢：
     > 最新的零知識證明技術
     

1. 設定研究廣度與深度
   • 研究廣度：決定要搜尋多少主題（建議值：3-10，預設值：4）。
   • 研究深度：決定探索的遞歸層數（建議值：1-5，預設值：2）。
2. AI 會開始：
   • 生成搜尋查詢
   • 抓取並處理搜尋結果
   • 根據研究內容遞歸探索
   • 產生完整的 Markdown 研究報告

🔹 6. 查看輸出