/ README-zh-Hant.md
README-zh-Hant.md
1 <h1 align="center"> 2 <img src="https://github.com/user-attachments/assets/ec60b0c4-87ba-48f4-981a-c55ed0e8497b" height="100" width="375" alt="banner" /><br> 3 </h1> 4 5 6 <div align="center"> 7 8 [](https://github.com/nanobrowser) 9 [](https://x.com/nanobrowser_ai) 10 [](https://discord.gg/NN3ABHggMK) 11 [<img src="https://deepwiki.com/badge.svg" height="28" alt="Ask DeepWiki">](https://deepwiki.com/nanobrowser/nanobrowser) 12 13 </div> 14 15 ## 🌐 Nanobrowser 16 17 Nanobrowser 是一款在瀏覽器中執行的開放原始碼 AI 網頁自動化工具。作為 OpenAI Operator 的免費替代方案，提供彈性的 LLM 選項與多代理系統。 18 19 ⬇️ 從 [Chrome 線上應用程式商店](https://chromewebstore.google.com/detail/nanobrowser/imbddededgmcgfhfpcjmijokokekbkal) 免費取得 Nanobrowser 20 21 👏 加入我們的 [Discord](https://discord.gg/NN3ABHggMK) | [X](https://x.com/nanobrowser_ai) 社群 22 23 ❤️ 喜歡 Nanobrowser 嗎？請給我們一顆星星 🌟 並協助分享！ 24 25 <div align="center"> 26 <img src="https://github.com/user-attachments/assets/112c4385-7b03-4b81-a352-4f348093351b" width="600" alt="Nanobrowser Demo GIF" /> 27 <p><em>Nanobrowser 的多代理系統即時分析 HuggingFace，其中 Planner 會在遇到障礙時自行修正，並動態指示 Navigator 調整做法——這一切都在本機瀏覽器中執行。</em></p> 28 </div> 29 30 ## 🔥 為什麼選擇 Nanobrowser？ 31 32 正在尋找功能強大的 AI 瀏覽器代理，卻不想每月為 OpenAI Operator 支付 200 美元嗎？**Nanobrowser** 作為一款 Chrome 擴充功能，提供進階的網頁自動化能力，同時讓您保有完全的掌控權： 33 34 - **100% 免費** - 無訂閱費或隱藏成本。安裝後使用自己的 API 金鑰，只需支付給供應商的 API 使用費。 35 - **注重隱私** - 所有處理都在本機瀏覽器內完成。您的認證資訊會儲存在本機，絕不會與任何雲端服務分享。 36 - **彈性的 LLM 選項** - 可連接您偏好的 LLM 供應商，並可為不同代理選擇不同模型。 37 - **完全開放原始碼** - 瀏覽器自動化過程完全透明，沒有任何黑箱作業或隱藏的處理程序。 38 39 > **請注意：** 我們目前支援 OpenAI、Anthropic、Gemini、Ollama、Groq、Cerebras、Llama 以及自訂的 OpenAI 相容供應商，未來將會支援更多。 40 41 42 ## 📊 主要功能 43 44 - **多代理系統**：由專業的 AI 代理協同合作，完成複雜的網頁工作流程 45 - **互動式側邊面板**：直覺的聊天介面，提供即時的狀態更新 46 - **任務自動化**：跨網站無縫自動化重複性任務 47 - **後續提問**：針對已完成的任務提出與上下文相關的追問 48 - **對話歷史紀錄**：輕鬆存取並管理與 AI 代理的互動歷史 49 - **支援多種 LLM**：可連接您偏好的 LLM 供應商，並為不同代理指派不同模型 50 51 52 ## 🌐 瀏覽器支援 53 54 **正式支援：** 55 - **Chrome** - 完整支援所有功能 56 - **Edge** - 完整支援所有功能 57 58 **不支援：** 59 - Firefox、Safari，以及其他 Chromium 衍生瀏覽器 (Opera、Arc 等) 60 61 > **注意**：雖然 Nanobrowser 可能可在其他 Chromium 系瀏覽器上運作，我們仍建議使用 Chrome 或 Edge，以獲得最佳體驗並確保相容性。 62 63 64 ## 🚀 快速入門 65 66 1. **從 Chrome 線上應用程式商店安裝** (穩定版)： 67 * 前往 [Nanobrowser 的 Chrome 線上應用程式商店頁面](https://chromewebstore.google.com/detail/nanobrowser/imbddededgmcgfhfpcjmijokokekbkal) 68 * 按一下 [新增至 Chrome] 按鈕 69 * 在提示出現時確認安裝 70 71 > **重要提示**：若要體驗最新功能，請參考下方的 [「手動安裝最新版本」](#-手動安裝最新版本) 進行安裝，因為 Chrome 線上應用程式商店的版本可能會因審核流程而延遲。 72 73 2. **設定代理模型**： 74 * 按一下工具列中的 Nanobrowser 圖示以開啟側邊面板 75 * 按一下右上角的 `設定` 圖示 76 * 新增 LLM API 金鑰 77 * 為不同代理 (Navigator、Planner) 選擇要使用的模型 78 79 ## 🔧 手動安裝最新版本 80 81 若要取得包含所有最新功能的版本： 82 83 1. **下載** 84 * 從官方 GitHub 的 [版本頁面](https://github.com/nanobrowser/nanobrowser/releases) 下載最新的 `nanobrowser.zip` 檔案。 85 86 2. **安裝**： 87 * 解壓縮 `nanobrowser.zip`。 88 * 在 Chrome 中開啟 `chrome://extensions/` 89 * 啟用 `開發人員模式` (右上角) 90 * 按一下 `載入未封裝的擴充功能` (左上角) 91 * 選擇已解壓縮的 `nanobrowser` 資料夾。 92 93 3. **設定代理模型** 94 * 按一下工具列中的 Nanobrowser 圖示以開啟側邊面板 95 * 按一下右上角的 `設定` 圖示。 96 * 新增 LLM API 金鑰。 97 * 為不同代理 (Navigator、Planner) 選擇要使用的模型。 98 99 4. **升級**： 100 * 從版本頁面下載最新的 `nanobrowser.zip` 檔案。 101 * 解壓縮並用新檔案覆寫您現有的 Nanobrowser 檔案。 102 * 前往 Chrome 的 `chrome://extensions/` 頁面，然後在 Nanobrowser 卡片上按一下重新整理圖示。 103 104 ## 🛠️ 從原始碼建置 105 106 如果您偏好自行建置 Nanobrowser，請依照以下步驟操作： 107 108 1. **先決條件**： 109 * [Node.js](https://nodejs.org/) (v22.12.0 或更高版本) 110 * [pnpm](https://pnpm.io/installation) (v9.15.1 或更高版本) 111 112 2. **複製儲存庫**： 113 ```bash 114 git clone https://github.com/nanobrowser/nanobrowser.git 115 cd nanobrowser 116 ``` 117 118 3. **安裝相依套件**： 119 ```bash 120 pnpm install 121 ``` 122 123 4. **建置擴充功能**： 124 ```bash 125 pnpm build 126 ``` 127 128 5. **載入擴充功能**： 129 * 建置完成的擴充功能將位於 `dist` 目錄中 130 * 依照「手動安裝」一節中的步驟，將擴充功能載入瀏覽器 131 132 6. **開發模式** (選用)： 133 ```bash 134 pnpm dev 135 ``` 136 137 ## 🤖 選擇您的模型 138 139 Nanobrowser 允許您為每個代理設定不同的 LLM 模型，以平衡效能與成本。以下是建議的設定： 140 141 ### 追求高效能 142 - **Planner**：Claude Sonnet 4 143 - 更佳的推理與規劃能力 144 - **Navigator**：Claude Haiku 3.5 145 - 有效率地處理網頁導覽任務 146 - 在效能與成本之間取得良好平衡 147 148 ### 講求成本效益 149 - **Planner**：Claude Haiku 或 GPT-4o 150 - 以較低成本獲得合理的效能 151 - 處理複雜任務可能需要更多次的迭代 152 - **Navigator**：Gemini 2.5 Flash 或 GPT-4o-mini 153 - 輕量級且具成本效益 154 - 適合基本的導覽任務 155 156 ### 本機模型 157 - **設定選項**： 158 - 使用 Ollama 或其他自訂的 OpenAI 相容供應商，在本機執行模型 159 - 零 API 成本並確保完全隱私，所有資料都保留在本機電腦 160 161 - **推薦模型**： 162 - **Qwen3-30B-A3B-Instruct-2507** 163 - **Falcon3 10B** 164 - **Qwen 2.5 Coder 14B** 165 - **Mistral Small 24B** 166 - [社群最新測試結果](https://gist.github.com/maximus2600/75d60bf3df62986e2254d5166e2524cb) 167 - 歡迎社群成員在我們的 [Discord](https://discord.gg/NN3ABHggMK) 分享其他本機模型的使用經驗 168 169 - **提示詞工程**： 170 - 本機模型通常需要更具體、清楚的提示詞 171 - 避免使用高層次、模糊的指令 172 - 將複雜的任務拆解成清楚、詳細的步驟 173 - 提供明確的上下文與限制條件 174 175 > **請注意**：講求成本效益的設定可能會產生較不穩定的輸出，且處理複雜任務時可能需要更多次的迭代。 176 177 > **提示**：歡迎盡情嘗試自己的模型設定！找到絕佳組合了嗎？到我們的 [Discord](https://discord.gg/NN3ABHggMK) 與社群分享，幫助大家最佳化設定。 178 179 ## 💡 實際應用案例 180 181 以下是幾個只要一句話就能完成的強大任務： 182 183 1. **新聞摘要**： 184 > "前往 TechCrunch，擷取過去 24 小時內的 10 大頭條新聞" 185 186 2. **GitHub 研究**： 187 > "在 GitHub 上找出星星數最多的熱門 Python 儲存庫" 188 189 3. **購物研究**： 190 > "在 Amazon 上找一款具備防水設計、價格低於 50 美元的可攜式藍牙喇叭，且電池續航力至少要有 10 小時" 191 192 ## 🛠️ 發展藍圖 193 194 我們正積極開發 Nanobrowser，未來將有更多令人期待的功能推出，歡迎加入我們！ 195 196 請至我們的 [GitHub Discussions](https://github.com/nanobrowser/nanobrowser/discussions/85) 查看詳細的發展藍圖與即將推出的功能。 197 198 ## 🤝 如何貢獻 199 200 **我們需要您的幫助，讓 Nanobrowser 變得更好！** 我們歡迎各種形式的貢獻： 201 202 * **分享提示詞與使用案例** 203 * 加入我們的 [Discord 伺服器](https://discord.gg/NN3ABHggMK)。 204 * 分享您如何使用 Nanobrowser，協助我們建立實用的提示詞與實際應用案例資料庫。 205 * **提供回饋意見** 206 * 試用 Nanobrowser，並在我們的 [Discord 伺服器](https://discord.gg/NN3ABHggMK) 上提供效能回饋或改進建議。 207 * **貢獻程式碼** 208 * 請參閱我們的 [CONTRIBUTING.md](CONTRIBUTING.md)，瞭解如何為本專案貢獻程式碼的指南。 209 * 針對錯誤修復、新功能或文件改進，提出 Pull Request。 210 211 212 我們深信開放原始碼與社群協作的力量。歡迎與我們一同打造網頁自動化的未來！ 213 214 215 ## 🔒 安全性 216 217 如果您發現安全漏洞，請**不要**透過 Issues、Pull Request 或 Discussions 公開揭露。 218 219 請建立一個 [GitHub Security Advisory](https://github.com/nanobrowser/nanobrowser/security/advisories/new) 來負責任地回報此漏洞。這讓我們能在漏洞被公開之前解決問題。 220 221 我們感謝您協助維護 Nanobrowser 及其使用者的安全！ 222 223 ## 💬 社群 224 225 歡迎加入我們持續成長的開發者與使用者社群： 226 227 - [Discord](https://discord.gg/NN3ABHggMK) - 與團隊及社群成員交流 228 - [Twitter](https://x.com/nanobrowser_ai) - 追蹤最新的更新與公告 229 - [GitHub Discussions](https://github.com/nanobrowser/nanobrowser/discussions) - 分享您的想法並提出問題 230 231 ## 👏 致謝 232 233 Nanobrowser 的開發建立在許多優秀的開放原始碼專案之上： 234 235 - [Browser Use](https://github.com/browser-use/browser-use) 236 - [Puppeteer](https://github.com/EmergenceAI/Agent-E) 237 - [Chrome Extension Boilerplate](https://github.com/Jonghakseo/chrome-extension-boilerplate-react-vite) 238 - [LangChain](https://github.com/langchain-ai/langchainjs) 239 240 由衷感謝這些專案的建立者與貢獻者！ 241 242 ## 📄 授權 243 244 本專案採用 Apache License 2.0 授權 - 詳情請參閱 [LICENSE](LICENSE) 檔案。 245 246 由 Nanobrowser 團隊用 ❤️ 打造。 247 248 喜歡 Nanobrowser 嗎？請給我們一顆星星 🌟 並加入我們的 [Discord](https://discord.gg/NN3ABHggMK) | [X](https://x.com/nanobrowser_ai) 249 250 ## ⚠️ 衍生專案免責聲明 251 252 **我們明確「不予背書、不提供支援、也不參與」任何** 基於本程式碼所打造、與加密貨幣、代幣、NFT 或其他區塊鏈相關應用有關的專案。 253 254 **此類衍生專案與官方 Nanobrowser 專案或核心團隊** 「**沒有任何關聯**、**非由我們維護**、亦**未與我們有任何連結**」。 255 256 **對於使用第三方衍生專案所造成的任何損失、損害或問題，我們概不負責。** 使用者與其互動時請自行承擔風險。 257 258 **我們保留權利** 對任何濫用或誤導性使用我們名稱、程式碼或品牌的行為，公開聲明切割並加以澄清。 259 260 我們鼓勵開放原始碼創新，但也提醒社群務必審慎判斷。請在使用由獨立開發者基於本程式碼所打造的任何軟體或服務前，先充分了解相關風險。 261 262