updat readme

This commit is contained in:
ifurther
2025-05-26 21:20:17 +08:00
parent 63cd5eddd7
commit 7ad084b27f
+46 -46
View File
@@ -8,23 +8,23 @@
[English](./README.md) | 繁體中文 | [日本語](./README_JP.md) [English](./README.md) | 繁體中文 | [日本語](./README_JP.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,7 +36,7 @@ https://github.com/user-attachments/assets/4bd5faf6-459f-4f94-bd1d-238c4b331469
確保已安裝了 Chrome driverDocker 和 Python 3.10(或更新)。 確保已安裝了 Chrome driverDocker 和 Python 3.10(或更新)。
我们强烈建议您使用 Python 3.10 进行设置,否则可能发生依赖错误。 我们强烈建议您使用 Python 3.10 進行設定,否则可能发生依赖错误。
有關於 Chrome driver 的問題,請參見 **Chromedriver** 部分。 有關於 Chrome driver 的問題,請參見 **Chromedriver** 部分。
@@ -64,7 +64,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
@@ -73,7 +73,7 @@ pip3 install jieba cn2an
**手動安裝:** **手動安裝:**
**注意:对于任何操作系统,请确保您安装的 ChromeDriver 您已安装的 Chrome 版本匹配。运行 `google-chrome --version`。如果您的 Chrome 版本 > 135请参阅已知问题** **注意:對於不同作業系統,請確保已經安装的 ChromeDriver 您已安装的 Chrome 版本一致。可以執行 `google-chrome --version`。如果您的 Chrome 版本 > 135請參考已知问题**
- *Linux*: - *Linux*:
@@ -81,7 +81,7 @@ pip3 install jieba cn2an
安装依赖项:`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`
@@ -104,11 +104,11 @@ pip3 install jieba cn2an
安装 pyreadline3`pip install pyreadline3` 安装 pyreadline3`pip install pyreadline3`
手动安装 portaudio(例如,通过 vcpkg 或预编译的二制文件),然后运行:`pip install pyaudio` 手动安装 portaudio(例如,通过 vcpkg 或預編譯的二制文件),然後運行:`pip install pyaudio`
从以下址手动下载并安装 chromedriverhttps://sites.google.com/chromium.org/driver/getting-started 从以下址手动下载并安装 chromedriverhttps://sites.google.com/chromium.org/driver/getting-started
chromedriver 放置在包含在您的 PATH 中的目录中。 chromedriver 放置在包含在您的 PATH 中的目录中。
安装 requirements`pip3 install -r requirements.txt` 安装 requirements`pip3 install -r requirements.txt`
@@ -116,45 +116,45 @@ pip3 install jieba cn2an
**建議至少使用 Deepseek 14B 以上參數的模型,較小的模型難以使用助理功能並且很快就會忘記上下文之間的關係。** **建議至少使用 Deepseek 14B 以上參數的模型,較小的模型難以使用助理功能並且很快就會忘記上下文之間的關係。**
**本地行助手** **本地行助手**
启动你的本地提供者,例如使用 ollama: 啟動你的本地提供者,例如使用 ollama:
```sh ```sh
ollama serve ollama serve
``` ```
请参下方支持的本地提供者列表。 请参下方支持的本地提供者列表。
修改 config.ini 文件以设置 provider_name 为支持的提供者,并 provider_model 设置为该提供者支持的 LLM。我们推荐使用具有推理能力的模型,如 *Qwen**Deepseek* 修改 config.ini 文件以設定 provider_name 为支持的提供者,并 provider_model 設定为该提供者支持的 LLM。我们推荐使用具有推理能力的模型,如 *Qwen**Deepseek*
请参见 README 末尾的 **FAQ** 部分了解所需硬件。 请参见 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 来减少瀏覽器檢測
``` ```
**本地提供者列表** **本地提供者列表**
| 提供者 | 本地? | 描述 | | 提供者 | 本地? | 描述 |
|-------------|--------|-------------------------------------------------------| |-------------|--------|-------------------------------------------------------|
| ollama | 是 | 使用 ollama 作为 LLM 提供者,轻松本地行 LLM | | ollama | 是 | 使用 ollama 作为 LLM 提供者,轻松本地行 LLM |
| lm-studio | 是 | 使用 LM Studio 本地行 LLM `provider_name` 设置`lm-studio`| | lm-studio | 是 | 使用 LM Studio 本地行 LLM `provider_name` 設定`lm-studio`|
| openai | 否 | 使用兼容的 API | | openai | 否 | 使用兼容的 API |
下一步: [Start services and run AgenticSeek](#Start-services-and-Run) 下一步: [Start services and run AgenticSeek](#Start-services-and-Run)
@@ -184,14 +184,14 @@ provider_server_address = 127.0.0.1:5000
--- ---
## 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 提供支持)
- 前端 - 前端
@@ -201,25 +201,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 +228,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 了!
@@ -287,11 +287,11 @@ python3 cli.py
所以我們希望你在使用時,能明確地表明你希望他要怎麼做,下面給你一個範例! 所以我們希望你在使用時,能明確地表明你希望他要怎麼做,下面給你一個範例!
你該說: 你該說:
- 进行网络搜索,找出哪些国家最适合自旅行 - 進行網路搜索,找出哪些国家最适合自旅行
而不是說: 而不是說:
- 你知道哪些国家适合自旅行? - 你知道哪些国家适合自旅行?
--- ---
@@ -357,7 +357,7 @@ provider_server_address = x.x.x.x:3333
## 語音轉文字 ## 語音轉文字
请注意,目前语音转文字功能仅支持英语。 请注意,目前語音轉文字功能僅支援英语。
預設狀況下,語音轉文字功能是停用的。若要啟用它,請在 `config.ini` 檔案中,將 `listen` 選項設為 `True` 預設狀況下,語音轉文字功能是停用的。若要啟用它,請在 `config.ini` 檔案中,將 `listen` 選項設為 `True`
@@ -538,13 +538,13 @@ https://googlechromelabs.github.io/chrome-for-testing/
**Q: 是否支持中文以外的语言?** **Q: 是否支持中文以外的语言?**
DeepSeek R1 天生说中文 DeepSeek R1 天生说中文
但注意:代理路由系统只懂英文,所以必须通过 config.ini 的 languages 参数(如 languages = en zh)告诉系统: 但注意:代理路由系统只懂英文,所以必须通过 config.ini 的 languages 参数(如 languages = en zh)告诉系统:
如果不设置中文?果可能是:你让它写代码,结果跳出来个"生代理"(虽然我们根本没有这个代理... 但系统一脸懵圈!) 如果不設定中文?果可能是:你讓它寫代码,结果跳出来个"生代理"(虽然我们根本没有这个代理... 但系统一脸懵圈!)
实际上下载一个小型翻译模型来协助任务分配 实际上下载一个小型翻译模型来协助任务分配
## 貢獻 ## 貢獻
@@ -556,8 +556,8 @@ DeepSeek R1 天生会说中文
## 维护者: ## 维护者:
> [Fosowl](https://github.com/Fosowl) | 巴黎时间 | (有时很忙) > [Fosowl](https://github.com/Fosowl) | 巴黎時間 | (有时很忙)
> [https://github.com/antoineVIVIES](https://github.com/antoineVIVIES) | 台北时间 | 常很忙) > [https://github.com/antoineVIVIES](https://github.com/antoineVIVIES) | 台北時間 | 常很忙)
> [steveh8758](https://github.com/steveh8758) | 台北时间 | 是很忙) > [steveh8758](https://github.com/steveh8758) | 台北時間 | 是很忙)