stephane.david/agenticSeek
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README_CHT.md

Browse Source
This commit is contained in:
Sad
2025-06-02 03:46:55 +08:00
parent eff5921217
commit a7c38819d6
1 changed files with 159 additions and 156 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README_CHT.md
+159 -156
View File
@@ -1,30 +1,23 @@
# AgenticSeek: 類似 Manus 但基於 Deepseek R1 Agents 的本地模型。 # AgenticSeek: 類似 Manus 但基於 Deepseek R1 Agents 的本地模型
<p align="center"> <p align="center">
<img align="center" src="./media/whale_readme.jpg"> <img align="center" src="./media/whale_readme.jpg">
<p> <p>
-------------------------------------------------------------------------------- [English](./README.md) | [中文](./README_CHS.md) | 繁體中文 | [日本語](./README_JP.md) | [Português (Brasil)](./README_PTBR.md)
[English](./README.md) | 繁體中文 | [日本語](./README_JP.md) | [Português (Brasil)](./README_PTBR.md)
*一個 **100% 本地替代 Manus AI** 的方案，這款支援語音的 AI 助理能夠自主瀏覽網頁、編寫代碼和規劃任務，同時將所有數據保留在您的裝置上。專為本地推理模型量身打造，完全在您自己的硬體上執行，確保完全的隱私保護和零雲端依賴。*
*一个 **100% 本地替代 Manus AI** 的方案，這款支持語音的 AI 助理能够自主瀏覽網頁、编寫代码和規劃任務，同时將所有用戶資料保留在您的裝置上。專門為本地推理模型量身打造，完全在您自己的硬體上執行，确保完全的隐私保护和零雲端依賴。*
[![Visit AgenticSeek](https://img.shields.io/static/v1?label=Website&message=AgenticSeek&color=blue&style=flat-square)](https://fosowl.github.io/agenticSeek.html) ![License](https://img.shields.io/badge/license-GPL--3.0-green) [![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white)](https://discord.gg/8hGDaME3TC) [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/fosowl.svg?style=social&label=Update%20%40Fosowl)](https://x.com/Martin993886460) [![Visit AgenticSeek](https://img.shields.io/static/v1?label=Website&message=AgenticSeek&color=blue&style=flat-square)](https://fosowl.github.io/agenticSeek.html) ![License](https://img.shields.io/badge/license-GPL--3.0-green) [![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white)](https://discord.gg/8hGDaME3TC) [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/fosowl.svg?style=social&label=Update%20%40Fosowl)](https://x.com/Martin993886460)
### 为什么選擇 AgenticSeek？ ### 為什麼選擇 AgenticSeek？
* 🔒 完全本地化與隐私保护 - 所有功能都在您的设备上運行 — 无云端服务，无数据共享。您的文件、对话和搜索始终保持私密。 * 🔒 完全本地化與隱私保護 - 所有功能都在您的裝置上執行 — 無雲端服務，無數據共享。您的檔案、對話和搜索始終保持私密。
* 🌐 智慧網頁瀏覽 - AgenticSeek 能夠自主瀏覽網頁 — 搜索、閱讀、提取資訊、填寫網頁表單 — 全程無需人工操作。
* 🌐 智能網頁瀏覽 - AgenticSeek 能够自主瀏覽網頁 — 搜索、閱读、提取信息、填寫網页表單 — 全程无需人工操作。 * 💻 自主編碼助手 - 需要程式碼？它可以編寫、除錯並執行 Python、C、Go、Java 等多種語言的程式 — 全程無需監督。
* 🧠 智慧代理選擇 - 您提問，它會自動選擇最適合該任務的代理。就像擁有一個隨時待命的專家團隊。
* 💻 自主编码助手 - 需要代码？它可以编寫、调试并運行 Python、C、Go、Java 等多种语言的程序 — 全程无需监督。 * 📋 規劃與執行復雜任務 - 從旅行規劃到複雜專案 — 它能將大型任務分解為步驟，並利用多個 AI 代理完成工作。
* 🎙️ 語音功能 - 清晰、快速、未來感十足的語音與語音轉文字功能，讓您能像科幻電影中一樣與您的個人 AI 助手對話。
* 🧠 智能代理选择 - 您提问，它會自动选择最适合该任务的代理。就像拥有一个随时待命的專家团队。
* 📋 规划與执行复杂任务 - 从旅行规划到复杂项目 — 它能將大型任务分解为步骤，并利用多个 AI 代理完成工作。
* 🎙️ 語音功能 - 清晰、快速、未来感十足的語音與語音轉文本功能，讓您能像科幻电影中一样與您的个人 AI 助手对话。
https://github.com/user-attachments/assets/4bd5faf6-459f-4f94-bd1d-238c4b331469 https://github.com/user-attachments/assets/4bd5faf6-459f-4f94-bd1d-238c4b331469
@@ -36,11 +29,11 @@ https://github.com/user-attachments/assets/4bd5faf6-459f-4f94-bd1d-238c4b331469
確保已安裝了 Chrome driver，Docker 和 Python 3.10（或更新）。 確保已安裝了 Chrome driver，Docker 和 Python 3.10（或更新）。
我们强烈建议您使用 Python 3.10 進行設定，否则可能會发生依赖错误。 我們強烈建議您使用 Python 3.10 進行設定，否則可能會發生依賴錯誤。
有關於 Chrome driver 的問題，請參見 **Chromedriver** 部分。 有關於 Chrome driver 的問題，請參見 **Chromedriver** 部分。
### 1️⃣ **複製儲存庫與設置環境變數** ### 1️⃣ **複製儲存庫與設定環境變數**
```sh ```sh
git clone https://github.com/Fosowl/agenticSeek.git git clone https://github.com/Fosowl/agenticSeek.git
@@ -52,7 +45,7 @@ mv .env.example .env
```sh ```sh
python3 -m venv agentic_seek_env python3 -m venv agentic_seek_env
source agentic_seek_env/bin/activate source agentic_seek_env/bin/activate
# On Windows: agentic_seek_env\Scripts\activate # On Windows: agentic_seek_env\Scripts\activate
``` ```
@@ -64,7 +57,7 @@ source agentic_seek_env/bin/activate
./install.sh ./install.sh
``` ```
** 若要將文字轉成語音（TTS）功能支持中文，你需要安装 jieba（中文分詞庫）和 cn2an（中文數字轉換庫）：** ** 若要讓文字轉成語音（TTS）功能支援中文，你需要安裝 jieba（中文分詞庫）和 cn2an（中文數字轉換庫）：**
``` ```
pip3 install jieba cn2an pip3 install jieba cn2an
@@ -72,51 +65,50 @@ pip3 install jieba cn2an
**手動安裝:** **手動安裝:**
**注意：對於不同的操作系統，請確保您安裝的 ChromeDriver 與您已安裝的 Chrome 版本匹配。執行 `google-chrome --version`。如果您的 Chrome 版本 > 135，請參閱已知問題**
**注意：對於不同作業系統，請確保已經安装的 ChromeDriver 與您已安装的 Chrome 版本一致。可以執行 `google-chrome --version`。如果您的 Chrome 版本 > 135，請參考已知问题**
- *Linux*: - *Linux*:
更新软件包列表：`sudo apt update` 更新軟件包列表：`sudo apt update`
安装依赖项：`sudo apt install -y alsa-utils portaudio19-dev python3-pyaudio libgtk-3-dev libnotify-dev libgconf-2-4 libnss3 libxss1` 安裝依賴項：`sudo apt install -y alsa-utils portaudio19-dev python3-pyaudio libgtk-3-dev libnotify-dev libgconf-2-4 libnss3 libxss1`
安装與您的 Chrome 瀏覽器版本匹配的 ChromeDriver： 安裝與您的 Chrome 瀏覽器版本匹配的 ChromeDriver：
`sudo apt install -y chromium-chromedriver` `sudo apt install -y chromium-chromedriver`
安装 requirements：`pip3 install -r requirements.txt` 安裝 requirements：`pip3 install -r requirements.txt`
- *Macos*: - *Macos*:
更新 brew：`brew update` 更新 brew：`brew update`
安装 chromedriver：`brew install --cask chromedriver` 安裝 chromedriver：`brew install --cask chromedriver`
安装 portaudio：`brew install portaudio` 安裝 portaudio：`brew install portaudio`
升级 pip：`python3 -m pip install --upgrade pip` 升級 pip：`python3 -m pip install --upgrade pip`
升级 wheel：`pip3 install --upgrade setuptools wheel` 升級 wheel：`pip3 install --upgrade setuptools wheel`
安装 requirements：`pip3 install -r requirements.txt` 安裝 requirements：`pip3 install -r requirements.txt`
- *Windows*: - *Windows*:
安装 pyreadline3：`pip install pyreadline3` 安裝 pyreadline3：`pip install pyreadline3`
手动安装 portaudio（例如，通过 vcpkg 或預編譯的二進制文件），然後運行：`pip install pyaudio` 手動安裝 portaudio（例如，通過 vcpkg 或預編譯的二進制檔案），然後執行：`pip install pyaudio`
从以下網址手动下载并安装 chromedriver：https://sites.google.com/chromium.org/driver/getting-started 從以下網址手動下載並安裝 chromedriver：https://sites.google.com/chromium.org/driver/getting-started
將 chromedriver 放置在包含在您的 PATH 中的目录中。 將 chromedriver 放置在包含在您的 PATH 中的目錄中。
安装 requirements：`pip3 install -r requirements.txt` 安裝 requirements：`pip3 install -r requirements.txt`
## 在本地機器上運行 AgenticSeek ## 在本地機器上執行 AgenticSeek
**建議至少使用 Deepseek 14B 以上參數的模型，較小的模型難以使用助理功能並且很快就會忘記上下文之間的關係。** **建議至少使用 Deepseek 14B 以上參數的模型，較小的模型難以使用助理功能並且很快就會忘記上下文之間的關係。**
**本地運行助手** **本地執行助手**
啟動你的本地提供者，例如使用 ollama： 啟動你的本地提供者，例如使用 ollama：
@@ -124,40 +116,47 @@ pip3 install jieba cn2an
ollama serve ollama serve
``` ```
请参閱下方支持的本地提供者列表。 請參閱下方支援的本地提供者列表。
修改 config.ini 文件以設定 provider_name 为支持的提供者，并將 provider_model 設定为该提供者支持的 LLM。我们推荐使用具有推理能力的模型，如 *Qwen* 或 *Deepseek*。 **更新 config.ini**
请参见 README 末尾的 **FAQ** 部分了解所需硬件。 修改 config.ini 檔案以設定 provider_name 為支援的提供者，並將 provider_model 設定為該提供者支援的 LLM。我們推薦使用具有推理能力的模型，如 *Qwen* 或 *Deepseek*。
請參見 README 末尾的 **FAQ** 部分了解所需硬體。
```sh ```sh
[MAIN] [MAIN]
is_local = True # 无论是在本地運行还是使用远程提供者。 is_local = True # 無論是在本地執行還是使用遠端提供者。
provider_name = ollama # 或 lm-studio, openai 等.. provider_name = ollama # 或 lm-studio, openai 等..
provider_model = deepseek-r1:14b # 选择适合您硬件的模型 provider_model = deepseek-r1:14b # 選擇適合您硬體的模型
provider_server_address = 127.0.0.1:11434 provider_server_address = 127.0.0.1:11434
agent_name = Jarvis # 您的 AI 助手的名称 agent_name = Jarvis # 您的 AI 助手的名稱
recover_last_session = True # 是否恢复之前的會话 recover_last_session = True # 是否恢復之前的會話
save_session = True # 是否记住当前會话 save_session = True # 是否記住目前會話
speak = True # 文本轉語音 speak = True # 文字轉語音
listen = False # 語音轉文本，僅适用于命令行界面 listen = False # 語音轉文字，僅適用於命令列界面
work_dir = /Users/mlg/Documents/workspace # AgenticSeek 的工作空间。 work_dir = /Users/mlg/Documents/workspace # AgenticSeek 的工作空間。
jarvis_personality = False # 是否使用更"贾维斯"风格的性格，不推荐在小型模型上使用 jarvis_personality = False # 是否使用更"賈維斯"風格的性格，不推薦在小型模型上使用
languages = en zh # 语言列表，文本轉語音將默认使用列表中的第一种语言 languages = en zh # 語言列表，文字轉語音將預設使用列表中的第一種語言
[BROWSER] [BROWSER]
headless_browser = True # 是否使用无头瀏覽器，只有在使用網页界面时才推荐使用。 headless_browser = True # 是否使用無頭瀏覽器，只有在使用網頁界面時才推薦使用。
stealth_mode = True # 使用无法檢測的 selenium 来减少瀏覽器檢測 stealth_mode = True # 使用無法檢測的 selenium 來減少瀏覽器檢測
``` ```
警告：使用 LM-studio 執行 LLM 時，請*不要*將 provider_name 設定為 `openai`。請將其設定為 `lm-studio`。
注意：某些提供者（如 lm-studio）需要在 IP 前面加上 `http://`。例如 `http://127.0.0.1:1234`
**本地提供者列表** **本地提供者列表**
| 提供者 | 本地? | 描述 |
|-------------|--------|-------------------------------------------------------|
| ollama | 是 | 使用 ollama 作为 LLM 提供者，轻松本地運行 LLM |
| lm-studio | 是 | 使用 LM Studio 本地運行 LLM（將 `provider_name` 設定为 `lm-studio`）|
| openai | 否 | 使用兼容的 API |
下一步： [Start services and run AgenticSeek](#Start-services-and-Run) | 提供者 | 本地? | 描述 |
| --------- | ----- | ------------------------------------------------------------------- |
| ollama | 是 | 使用 ollama 作為 LLM 提供者，輕鬆本地執行 LLM |
| lm-studio | 是 | 使用 LM Studio 本地執行 LLM（將`provider_name` 設定為 `lm-studio`） |
| openai | 否 | 使用相容的 API |
下一步： [Start services and run AgenticSeek](#Start-services-and-Run)
--- ---
@@ -179,21 +178,24 @@ provider_server_address = 127.0.0.1:5000
同時更改你的 IP 為 openai-based api 的 IP。 同時更改你的 IP 為 openai-based api 的 IP。
下一步： [Start services and run AgenticSeek](#Start-services-and-Run) 下一步： [Start services and run AgenticSeek](#Start-services-and-Run)
--- ---
## Start services and Run ## Start services and Run
(啟動服务并運行)
如果需要，请激活你的 Python 环境。 (啟動服務並執行)
如果需要，請啟用你的 Python 環境。
```sh ```sh
source agentic_seek_env/bin/activate source agentic_seek_env/bin/activate
``` ```
啟動所需的服务。这將啟動 `docker-compose.yml` 中的所有服务，包括： 啟動所需的服務。這將啟動 `docker-compose.yml` 中的所有服務，包括：
- searxng - searxng
- redis（由 redis 提供支持） - redis（由 redis 提供支援）
- 前端 - 前端
```sh ```sh
@@ -201,26 +203,25 @@ sudo ./start_services.sh # MacOS
start ./start_services.cmd # Windows start ./start_services.cmd # Windows
``` ```
**選項 1:** 使用 CLI 界面運行。 **選項 1:** 使用 CLI 界面執行。
```sh ```sh
python3 cli.py python3 cli.py
``` ```
**選項 2:** 使用 Web 界面運行。 **選項 2:** 使用 Web 界面執行。
注意：目前我們建議您使用 CLI 界面。Web 界面仍在積極開發中。 注意：目前我們建議您使用 CLI 界面。Web 界面仍在積極開發中。
啟動後端服务。 啟動後端服務。
```sh ```sh
python3 api.py python3 api.py
``` ```
访问 `http://localhost:3000/`，你应该會看到 Web 界面。 訪問 `http://localhost:3000/`，你應該會看到 Web 界面。
请注意，目前 Web 界面不支持消息流式傳輸。
請注意，目前 Web 界面不支援訊息流式傳輸。
*如果你不知道如何開始，請參閱 **Usage** 部分* *如果你不知道如何開始，請參閱 **Usage** 部分*
@@ -228,9 +229,9 @@ python3 api.py
## Usage （使用方法） ## Usage （使用方法）
为确保 agenticSeek 在中文环境下正常工作，请确保在 config.ini 中設定语言選項。 為確保 agenticSeek 在中文環境下正常工作，請確保在 config.ini 中設定語言選項。
languages = en zh languages = en zh
更多信息请参閱 Config 部分 更多資訊請參閱 Config 部分
確定所有的核心檔案都啟用了，也就是執行過這條命令 `./start_services.sh` 然後你就可以使用 `python3 cli.py` 來啟動 AgenticSeek 了！ 確定所有的核心檔案都啟用了，也就是執行過這條命令 `./start_services.sh` 然後你就可以使用 `python3 cli.py` 來啟動 AgenticSeek 了！
@@ -251,7 +252,7 @@ python3 cli.py
> *在 Golang 中幫助我進行矩陣乘法* > *在 Golang 中幫助我進行矩陣乘法*
> *使用 nmap 掃描我的網路，找出是否有任何可疑裝置連接* > *使用 nmap 掃瞄我的網路，找出是否有任何可疑裝置連線*
> *用 Python 製作一個貪食蛇遊戲* > *用 Python 製作一個貪食蛇遊戲*
@@ -279,32 +280,29 @@ python3 cli.py
> *我應該在鍛鍊前還是鍛鍊後服用肌酸？* > *我應該在鍛鍊前還是鍛鍊後服用肌酸？*
當你把指令送出後，AgenticSeek 會自動呼叫最能提供幫助的助理，去完成你交辦的工作和指令。
當你把指令送出後，AgenticSeek 會自動調用最能提供幫助的助理，去完成你交辦的工作和指令。 但也有可能出現怪怪的情況，或是你要找飛機機票，他跑去教你如何一步步做出一臺飛機（開玩笑的，但真的可能出現），因為這是一個早期專案，我們會努力教導他、完善他的！
但也有可能出現怪怪的情況，或是你要找飛機機票，他跑去教你如何一步步做出一台飛機（開玩笑的，但真的可能出現），因為這是一個早期專案，我們會努力教導他、完善他的！
所以我們希望你在使用時，能明確地表明你希望他要怎麼做，下面給你一個範例！ 所以我們希望你在使用時，能明確地表明你希望他要怎麼做，下面給你一個範例！
你該說： 你該說：
- 進行網路搜索，找出哪些国家最适合獨自旅行
- 進行網路搜索，找出哪些國家最適合獨自旅行
而不是說： 而不是說：
- 你知道哪些国家适合獨自旅行？
- 你知道哪些國家適合獨自旅行？
--- ---
## **在本地執行屬於你的 LLM 伺服器**
--- 如果你有一臺功能強大的電腦或伺服器，但你想透過筆記型電腦使用它，那麼你可以選擇在遠端伺服器上執行 LLM。
## **在本地執行屬於你的 LLM 伺服器** ### 1️⃣ **設定並啟動伺服器程式**
如果你有一台功能強大的電腦或伺服器，但你想透過筆記型電腦使用它，那麼你可以選擇在遠端伺服器上執行 LLM。 在執行 AI 模型的「伺服器」上，取得 IP 位址
### 1️⃣ **設定並啟動伺服器腳本**
在運行 AI 模型的「伺服器」上，取得 IP 位址
```sh ```sh
ip a | grep "inet " | grep -v 127.0.0.1 | awk '{print $2}' | cut -d/ -f1 ip a | grep "inet " | grep -v 127.0.0.1 | awk '{print $2}' | cut -d/ -f1
@@ -327,7 +325,7 @@ cd agenticSeek/server/
pip3 install -r requirements.txt pip3 install -r requirements.txt
``` ```
執行伺服器腳本。 執行伺服器程式。
```sh ```sh
python3 app.py --provider ollama --port 3333 python3 app.py --provider ollama --port 3333
@@ -335,14 +333,14 @@ python3 app.py --provider ollama --port 3333
您可以選擇使用 `ollama` 或 `llamacpp` 作為 LLM 的服務框架。 您可以選擇使用 `ollama` 或 `llamacpp` 作為 LLM 的服務框架。
### 2️⃣ **執行** ### 2️⃣ **執行**
在你的電腦上： 在你的電腦上：
- 更改 `config.ini` - 更改 `config.ini`
- `provider_name = server` - `provider_name = server`
- `provider_model = deepseek-r1:14b` - `provider_model = deepseek-r1:14b`
- `provider_server_address = {你執行模型的電腦的 IP 位址}` - `provider_server_address = {你執行模型的電腦的 IP 位址}`
```sh ```sh
[MAIN] [MAIN]
@@ -352,12 +350,11 @@ provider_model = deepseek-r1:14b
provider_server_address = x.x.x.x:3333 provider_server_address = x.x.x.x:3333
``` ```
--- ---
## 語音轉文字 ## 語音轉文字
请注意，目前語音轉文字功能僅支援英语。 請注意，目前語音轉文字功能僅支援英語。
預設狀況下，語音轉文字功能是停用的。若要啟用它，請在 `config.ini` 檔案中，將 `listen` 選項設為 `True`： 預設狀況下，語音轉文字功能是停用的。若要啟用它，請在 `config.ini` 檔案中，將 `listen` 選項設為 `True`：
@@ -365,19 +362,20 @@ provider_server_address = x.x.x.x:3333
listen = True listen = True
``` ```
啟用後 AgenticSeek 會聆聽你是否呼喚他，他才會開始聽你說的話，你可以在 *config.ini* 內去設定，要怎麼叫他。 啟用後 AgenticSeek 會聆聽你是否呼喚它，它才會開始聽你說的話，你可以在 *config.ini* 內去設定，要怎麼叫他。
``` ```
agent_name = Friday agent_name = Friday
``` ```
為了獲得比較好的結果，我們建議使用常見的英文名稱（如 “John” 或 “Emma”）作為他的名字。 爲了獲得比較好的結果，我們建議使用常見的英文名稱（如 「John」 或 「Emma」）作為他的名字。
當你看到程式開始執行時，請大聲說出他的名字，就可以喚醒 AgenticSeek 去聆聽！（如：Friday） 當你看到程式開始執行時，請大聲說出他的名字，就可以喚醒 AgenticSeek 去聆聽！（如：Friday）
清楚說出你的需求。 清楚說出你的需求。
用確認短句結束你說的話，以通知 AgenticSeek 繼續。確認短句的範例包括： 用確認短句結束你說的話，以通知 AgenticSeek 繼續。確認短句的範例包括：
``` ```
"do it", "go ahead", "execute", "run", "start", "thanks", "would ya", "please", "okay?", "proceed", "continue", "go on", "do that", "go it", "do you understand?" "do it", "go ahead", "execute", "run", "start", "thanks", "would ya", "please", "okay?", "proceed", "continue", "go on", "do that", "go it", "do you understand?"
``` ```
@@ -385,6 +383,7 @@ agent_name = Friday
## Config ## Config
Config 範例： Config 範例：
``` ```
[MAIN] [MAIN]
is_local = True is_local = True
@@ -396,7 +395,7 @@ recover_last_session = False
save_session = False save_session = False
speak = False speak = False
listen = False listen = False
work_dir = /Users/mlg/Documents/ai_folder work_dir = /Users/mlg/Documents/ai_folder
jarvis_personality = False jarvis_personality = False
languages = en zh languages = en zh
[BROWSER] [BROWSER]
@@ -405,61 +404,65 @@ stealth_mode = False
``` ```
**說明**: **說明**:
- is_local - is_local
- True：在本地運行。 - True：在本地執行。
- False：在遠端伺服器運行。 - False：在遠端伺服器執行。
- provider_name - provider_name
- 框架類型 - 框架型別
- `ollama`, `server`, `lm-studio`, `deepseek-api` - `ollama`, `server`, `lm-studio`, `deepseek-api`
- provider_model - provider_model
- 運行的模型 - 執行的模型
- `deepseek-r1:1.5b`, `deepseek-r1:14b` - `deepseek-r1:1.5b`, `deepseek-r1:14b`
- provider_server_address - provider_server_address
- 伺服器 IP - 伺服器 IP
- `127.0.0.1:11434` - `127.0.0.1:11434`
- agent_name - agent_name
- AgenticSeek 的名字，用作TTS的觸發單詞。 - AgenticSeek 的名字，用作TTS的觸發單詞。
- `Friday` - `Friday`
- recover_last_session - recover_last_session
- True：從上個對話繼續。 - True：從上個對話繼續。
- False：重啟對話。 - False：重啟對話。
- save_session - save_session
- True：儲存對話紀錄。 - True：儲存對話紀錄。
- False：不保存。 - False：不儲存。
- speak - speak
- True：啟用語音輸出。 - True：啟用語音輸出。
- False：關閉語音輸出。 - False：關閉語音輸出。
- listen - listen
- True：啟用語音輸入。 - True：啟用語音輸入。
- False：關閉語音輸入。 - False：關閉語音輸入。
- work_dir - work_dir
- AgenticSeek 擁有能存取與交互的工作目錄。 - AgenticSeek 擁有能存取與互動的工作目錄。
- jarvis_personality - jarvis_personality
> 就是那個鋼鐵人的 JARVIS
- True：啟用 JARVIS 個性。 > 就是那個鋼鐵人的 JARVIS
- False：關閉 JARVIS 個性。
- True：啟用 JARVIS 個性。
- False：關閉 JARVIS 個性。
- headless_browser - headless_browser
- True：前景瀏覽器。（很酷，推薦使用他 XD） - True：前景瀏覽器。（很酷，推薦使用他 XD）
- False：背景執行瀏覽器。 - False：背景執行瀏覽器。
- stealth_mode - stealth_mode
- 隱私模式，但需要你自己安裝反爬蟲擴充功能。 - 隱私模式，但需要你自己安裝反爬蟲擴充功能。
- languages - languages
- 支持的语言列表。用于代理路由系统。语言列表越长，下载的模型越多。 - 支援的語言列表。用於代理路由系統。語言列表越長，下載的模型越多。
## 框架 ## 框架
下表顯示了可用的框架： 下表顯示了可用的框架：
| 框架 | 本地? | 描述|
|-|-|-|
| ollama | 可 | 使用 ollama 框架去執行本地模型 |
| server | 可 | 本地伺服器執行模型遠端調用 |
| lm-studio | 可 | 使用 LM Studio 在本地運行 LLM（設定provider_name為lm-studio）|
| openai | 不可 | 使用 ChatGPT API（無法保證隱私）|
| deepseek-api | 不可 | 使用 Deepseek API (無法保證隱私)|
| huggingface | 不可 | 使用 Hugging-Face API (無法保證隱私)|
若要選擇框架，請變更 `config.ini` 文件： | 框架 | 本地? | 描述 |
| ------------ | ----- | ------------------------------------------------------------- |
| ollama | 可 | 使用 ollama 框架去執行本地模型 |
| server | 可 | 本地伺服器執行模型遠端呼叫 |
| lm-studio | 可 | 使用 LM Studio 在本地執行 LLM（設定provider_name為lm-studio） |
| openai | 不可 | 使用 ChatGPT API（無法保證隱私） |
| deepseek-api | 不可 | 使用 Deepseek API (無法保證隱私) |
| huggingface | 不可 | 使用 Hugging-Face API (無法保證隱私) |
若要選擇框架，請變更 `config.ini` 檔案：
``` ```
is_local = False is_local = False
@@ -467,7 +470,8 @@ provider_name = openai
provider_model = gpt-4o provider_model = gpt-4o
provider_server_address = 127.0.0.1:5000 provider_server_address = 127.0.0.1:5000
``` ```
`is_local`: 對於任何本地運行的 LLM 都應該為 True，否則為 False。
`is_local`: 對於任何本地執行的 LLM 都應該為 True，否則為 False。
`provider_name`: 透過名稱選擇要使用的框架，請參閱上面的框架清單。 `provider_name`: 透過名稱選擇要使用的框架，請參閱上面的框架清單。
@@ -481,8 +485,7 @@ provider_server_address = 127.0.0.1:5000
**已知問題 #1:** *chromedriver mismatch* **已知問題 #1:** *chromedriver mismatch*
`Exception: Failed to initialize browser: Message: session not created: This version of ChromeDriver only supports Chrome version 113 `Exception: Failed to initialize browser: Message: session not created: This version of ChromeDriver only supports Chrome version 113 Current browser version is 134.0.6998.89 with binary path`
Current browser version is 134.0.6998.89 with binary path`
如果你的瀏覽器和 chromedriver 版本不一樣，就會發生這種情況。 如果你的瀏覽器和 chromedriver 版本不一樣，就會發生這種情況。
@@ -498,18 +501,19 @@ https://googlechromelabs.github.io/chrome-for-testing/
![alt text](./media/chromedriver_readme.png) ![alt text](./media/chromedriver_readme.png)
如果有其他問題，請提供盡量詳細的敘述到 Issues 上，盡可能包含當前環境和問題是怎麼發生的。 如果有其他問題，請提供儘量詳細的敘述到 Issues 上，儘可能包含目前環境和問題是怎麼發生的。
## FAQ ## FAQ
**Q: 我需要什麼硬體？** **Q: 我需要什麼硬體？**
| 模型大小 | GPU | 備註 |
|-----------|--------|-----------------------------------------------------------| | 模型大小 | GPU | 備註 |
| 7B | 8GB Vram | ⚠️ 不推薦。性能較差，經常出現幻覺，規劃代理可能會失敗。 | | -------- | ----------------------------- | --------------------------------------------------------- |
| 14B | 12 GB VRAM (例如 RTX 3060) | ✅ 適用於簡單任務。可能在網頁瀏覽和規劃任務上表現不佳。 | | 7B | 8GB Vram | ⚠️ 不推薦。效能較差，經常出現幻覺，規劃代理可能會失敗。 |
| 32B | 24+ GB VRAM (例如 RTX 4090) | 🚀 大多數任務成功，但可能仍在任務規劃上有困難。 | | 14B | 12 GB VRAM (例如 RTX 3060) | ✅ 適用於簡單任務。可能在網頁瀏覽和規劃任務上表現不佳。 |
| 70B+ | 48+ GB Vram (例如 mac studio) | 💪 表現優異。建議用於高級使用情境。 | | 32B | 24+ GB VRAM (例如 RTX 4090) | 🚀 大多數任務成功，但可能仍在任務規劃上有困難。 |
| 70B+ | 48+ GB Vram (例如 mac studio) | 💪 表現優異。建議用於高級使用情境。 |
**Q：為什麼選擇 Deepseek R1 而不是其他模型？** **Q：為什麼選擇 Deepseek R1 而不是其他模型？**
@@ -517,17 +521,16 @@ https://googlechromelabs.github.io/chrome-for-testing/
**Q：我在執行時 `cli.py` 時出現錯誤。我該怎麼辦？** **Q：我在執行時 `cli.py` 時出現錯誤。我該怎麼辦？**
1. 確保 Ollama 正在運行（ollama serve） 1. 確保 Ollama 正在執行（ollama serve）
2. 你 `config.ini` 內 `provider_name` 的框架選擇正確。 2. 你 `config.ini` 內 `provider_name` 的框架選擇正確。
3. 依賴套件已安裝 3. 依賴套件已安裝
4. 如果均無效，請隨時提出 Issues，同樣盡可能包含當前環境和問題是怎麼發生的。 4. 如果均無效，請隨時提出 Issues，同樣儘可能包含目前環境和問題是怎麼發生的。
**Q：它真的是 100% 本地運行嗎？** **Q：它真的是 100% 本地執行嗎？**
是的，透過 Ollama 或其他框架，所有語音轉文字、LLM 和文字轉語音模型都在本地運行。 是的，透過 Ollama 或其他框架，所有語音轉文字、LLM 和文字轉語音模型都在本地執行。
*但你能選擇非本地執行（OpenAI 或其他 API），同樣也是可以的* *但你能選擇非本地執行（OpenAI 或其他 API），同樣也是可以的*
**Q：我有 Manus 為甚麼還要用 AgenticSeek？** **Q：我有 Manus 為甚麼還要用 AgenticSeek？**
這是我們因為興趣做的一個小 Side-Project，他特別的點在於是一個全部本地化的模型，而且可以像鋼鐵人裡面一樣與 `Jarvis` 對話，聽起來就超級酷的吧！隨著 Manus 的進化，我們也相應的加入更多功能！ 這是我們因為興趣做的一個小 Side-Project，他特別的點在於是一個全部本地化的模型，而且可以像鋼鐵人裡面一樣與 `Jarvis` 對話，聽起來就超級酷的吧！隨著 Manus 的進化，我們也相應的加入更多功能！
@@ -536,15 +539,15 @@ https://googlechromelabs.github.io/chrome-for-testing/
不不不，AgenticSeek 和 Manus 是不同取向的東西，我們優先考慮的是本地執行和隱私，而不是基於雲端。這是一個與 Manus 相比起來更有趣且易使用的方案！ 不不不，AgenticSeek 和 Manus 是不同取向的東西，我們優先考慮的是本地執行和隱私，而不是基於雲端。這是一個與 Manus 相比起來更有趣且易使用的方案！
**Q: 是否支持中文以外的语言？** **Q: 是否支援中文以外的語言？**
DeepSeek R1 天生會说中文 DeepSeek R1 天生會說中文
但注意：代理路由系统只懂英文，所以必须通过 config.ini 的 languages 参数（如 languages = en zh）告诉系统： 但注意：代理路由系統只懂英文，所以必須通過 config.ini 的 languages 參數（如 languages = en zh）告訴系統：
如果不設定中文？後果可能是：你讓它寫代码，结果跳出来个"醫生代理"（虽然我们根本没有这个代理... 但系统會一脸懵圈！） 如果不設定中文？後果可能是：你讓它寫程式碼，結果跳出來個"醫生代理"（雖然我們根本沒有這個代理... 但系統會一臉懵圈！）
实际上會下载一个小型翻译模型来协助任务分配 實際上會下載一個小型翻譯模型來協助任務分配
## 貢獻 ## 貢獻
@@ -554,10 +557,10 @@ DeepSeek R1 天生會说中文
[Contribution guide](./docs/CONTRIBUTING.md) [Contribution guide](./docs/CONTRIBUTING.md)
## 维护者: ## 維護者:
> [Fosowl](https://github.com/Fosowl) | 巴黎時間 | （有时很忙） > [Fosowl](https://github.com/Fosowl) | 巴黎時間 | （有時很忙）
> [https://github.com/antoineVIVIES](https://github.com/antoineVIVIES) | 台北時間 | （經常很忙） > [antoineVIVIES](https://github.com/antoineVIVIES) | 臺北時間 | （經常很忙）
> [steveh8758](https://github.com/steveh8758) | 台北時間 | （總是很忙） > [steveh8758](https://github.com/steveh8758) | 臺北時間 | （總是很忙）