diff --git a/README.md b/README.md
index 0b42616..c99b8cb 100644
--- a/README.md
+++ b/README.md
@@ -317,17 +317,79 @@ pip install -r requirements.txt
# uv版本命令(更快速安装)
uv pip install -r requirements.txt
-# 如果不想使用本地情感分析模型(算力需求很小,默认安装cpu版本),可以将该文件中的“机器学习”部分注释掉再执行指令
+# 如果不想使用本地情感分析模型(算力需求很小,默认安装cpu版本),可以将该文件中的"机器学习"部分注释掉再执行指令
```
-### 3. 安装Playwright浏览器驱动
+### 3. 安装 PDF 导出所需系统依赖(可选)
+
+> ⚠️ **注意**:如果您需要使用 PDF 导出功能,请按照以下步骤安装系统依赖。如果不需要 PDF 导出功能,可以跳过此步骤,系统其他功能不受影响。
+
+
+📦 macOS 系统安装步骤
+
+```bash
+# 1. 安装系统依赖(在宿主机上执行)
+brew install pango gdk-pixbuf libffi
+
+# 2. 设置环境变量(必需)
+export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH
+
+# 或永久添加到 ~/.zshrc
+echo 'export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc
+source ~/.zshrc
+```
+
+
+
+
+🐧 Ubuntu/Debian 系统安装步骤
+
+```bash
+# 1. 安装系统依赖(在宿主机上执行)
+sudo apt-get update
+sudo apt-get install -y \
+ libpango-1.0-0 \
+ libpangoft2-1.0-0 \
+ libgdk-pixbuf2.0-0 \
+ libffi-dev \
+ libcairo2
+```
+
+
+
+
+🎩 CentOS/RHEL 系统安装步骤
+
+```bash
+# 1. 安装系统依赖(在宿主机上执行)
+sudo yum install -y pango gdk-pixbuf2 libffi-devel cairo
+```
+
+
+
+
+🪟 Windows 系统安装步骤
+
+```powershell
+# 1. 下载并安装 GTK3 Runtime(在宿主机上执行)
+# 访问:https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases
+# 下载最新版本的 .exe 文件并安装
+
+# 2. 重启命令行或 IDE
+```
+
+
+
+> 💡 **提示**:如果使用 Docker 部署,无需手动安装这些依赖,Docker 镜像已包含所有必要的系统依赖。
+
+### 4. 安装Playwright浏览器驱动
```bash
# 安装浏览器驱动(用于爬虫功能)
playwright install chromium
```
-### 4. 配置LLM与数据库
+### 5. 配置LLM与数据库
复制一份项目根目录 `.env.example` 文件,命名为 `.env`
@@ -366,9 +428,9 @@ INSIGHT_ENGINE_MODEL_NAME=
```
推荐LLM API供应商:[推理时代](https://aihubmix.com/?aff=8Ds9)
-### 5. 启动系统
+### 6. 启动系统
-#### 5.1 完整系统启动(推荐)
+#### 6.1 完整系统启动(推荐)
```bash
# 在项目根目录下,激活conda环境
@@ -389,13 +451,13 @@ python app.py
> 注1:一次运行终止后,streamlit app可能结束异常仍然占用端口,此时搜索占用端口的进程kill掉即可
-> 注2:数据爬取需要单独操作,见5.3指引
+> 注2:数据爬取需要单独操作,见6.3指引
> 注3:如果服务器远程部署出现页面显示问题,见[PR#45](https://github.com/666ghj/BettaFish/pull/45)
访问 http://localhost:5000 即可使用完整系统
-#### 5.2 单独启动某个Agent
+#### 6.2 单独启动某个Agent
```bash
# 启动QueryEngine
@@ -408,7 +470,7 @@ streamlit run SingleEngineApp/media_engine_streamlit_app.py --server.port 8502
streamlit run SingleEngineApp/insight_engine_streamlit_app.py --server.port 8501
```
-#### 5.3 爬虫系统单独使用
+#### 6.3 爬虫系统单独使用
这部分有详细的配置文档:[MindSpider使用说明](./MindSpider/README.md)