From 40c017a59ac9170ef03f50017659bb68f34e7bad Mon Sep 17 00:00:00 2001
From: Hongyu Shi <shywzt@iCloud.com>
Date: Thu, 30 Oct 2025 09:46:31 +0800
Subject: [PATCH] docs: deploy guide v2 (part 3)

Signed-off-by: Hongyu Shi <shywzt@iCloud.com>
---
 ...50\347\275\262\346\211\213\345\206\214.md" | 40 +++++++++++++------
 1 file changed, 28 insertions(+), 12 deletions(-)

diff --git "a/docs/\351\203\250\347\275\262\346\211\213\345\206\214.md" "b/docs/\351\203\250\347\275\262\346\211\213\345\206\214.md"
index 143a269..55d6623 100644
--- "a/docs/\351\203\250\347\275\262\346\211\213\345\206\214.md"
+++ "b/docs/\351\203\250\347\275\262\346\211\213\345\206\214.md"
@@ -20,6 +20,8 @@ sudo dnf update -y
 sudo dnf install -y openeuler-intelligence-cli openeuler-intelligence-installer
 ```
 
+**注**：*如果在 openEuler 24.03 LTS SP2 上找不到 `openeuler-intelligence-cli` 软件包，请参考 Q&A 中的解决方案。*
+
 ### 2.2 初始化 openEuler Intelligence
 
 ```bash
@@ -141,9 +143,23 @@ sudo systemctl restart oi-runtime
 
 ## 4. 常见问题解答 (Q&A)
 
-### Q1: 部署过程中遇到 pip 包下载很慢怎么办？
+### Q1: openEuler 24.03 LTS SP2 搜不到软件包怎么办？
+
+**A1**: 官方源默认没有配置 EPOL 仓的 update 源，可以手动添加 EPOL 仓的源配置文件 `/etc/yum.repos.d/openEuler.repo`，内容如下：
+
+```ini
+[update-EPOL]
+name=update-EPOL
+baseurl=https://repo.openeuler.org/openEuler-24.03-LTS-SP2/EPOL/update/main/$basearch/
+metadata_expire=1h
+enabled=1
+gpgcheck=1
+gpgkey=http://repo.openeuler.org/openEuler-24.03-LTS-SP2/OS/$basearch/RPM-GPG-KEY-openEuler
+```
+
+### Q2: 部署过程中遇到 pip 包下载很慢怎么办？
 
-A1: 可以使用国内的 pip 镜像源，例如清华大学的镜像源。可以通过修改 pip 配置文件来使用清华镜像源：
+**A2**: 可以使用国内的 pip 镜像源，例如清华大学的镜像源。可以通过修改 pip 配置文件来使用清华镜像源：
 
 ```bash
 mkdir -p ~/.pip
@@ -151,9 +167,9 @@ echo "[global]" > ~/.pip/pip.conf
 echo "index-url = https://pypi.tuna.tsinghua.edu.cn/simple" >> ~/.pip/pip.conf
 ```
 
-### Q2: 如果无法访问外网，如何获取所需的依赖包？
+### Q3: 如果无法访问外网，如何获取所需的依赖包？
 
-A2: 可以在有外网的环境中下载所需的依赖包，然后通过 U 盘等方式将其拷贝到目标环境中进行安装。具体步骤如下：
+**A3**: 可以在有外网的环境中下载所需的依赖包，然后通过 U 盘等方式将其拷贝到目标环境中进行安装。具体步骤如下：
 
 1. 在有外网的环境中，使用以下命令下载所需的依赖包：
 
@@ -173,20 +189,20 @@ pip install --no-index --find-links=/path/to/download/dir <package-name>
 
 将 `/path/to/download/dir` 替换为实际的下载目录，`<package-name>` 替换为实际需要安装的包名。
 
-### Q3: 服务器系统版本受制约，无法升级到 openEuler 24.03 LTS SP2，怎么办？
+### Q4: 服务器系统版本受制约，无法升级到 openEuler 24.03 LTS SP2，怎么办？
 
-A3: 可以尝试在当前系统版本上手动安装所需的软件包和依赖项。由于 openEuler 24.03 LTS 以上的版本都使用 6.6 版本的内核和 Python 3.11，因此只需要将 `/etc/os-release` 和 `/etc/openEuler-release` 文件中的版本信息修改为 24.03 LTS SP2 即可。
+**A4**: 可以尝试在当前系统版本上手动安装所需的软件包和依赖项。由于 openEuler 24.03 LTS 以上的版本都使用 6.6 版本的内核和 Python 3.11，因此只需要将 `/etc/os-release` 和 `/etc/openEuler-release` 文件中的版本信息修改为 24.03 LTS SP2 即可。
 
 请注意，使用这种方法安装需要自行准备所需的软件包和依赖项，可能会遇到兼容性问题，建议在测试环境中进行验证后再应用到生产环境中。
 
-### Q4: 全量部署后，如何访问图形界面？
+### Q5: 全量部署后，如何访问图形界面？
 
-A4: 全量部署完成后，可以通过浏览器访问图形界面。默认情况下，图形界面的访问地址为 `http://localhost:8080`。
+**A5**: 全量部署完成后，可以通过浏览器访问图形界面。默认情况下，图形界面的访问地址为 `http://localhost:8080`。
 
-### Q5: 全量部署后，Shell 端无法连接后端服务怎么办？
+### Q6: 全量部署后，Shell 端无法连接后端服务怎么办？
 
-A5: 请先通过浏览器访问图形界面，确保后端服务已正常启动。浏览器正常登录后，需要打开“开发者工具”，从“应用”选项卡中找到“本地存储”，查看 `ECSESSION` 键对应的值。然后在 Shell 端按下 `Ctrl + S` 打开设置页面，找到“API 密钥”输入框，将 `ECSESSION` 的值粘贴进去并保存。保存后，Shell 端即可正常连接后端服务。
+**A6**: 请先通过浏览器访问图形界面，确保后端服务已正常启动。浏览器正常登录后，需要打开“开发者工具”，从“应用”选项卡中找到“本地存储”，查看 `ECSESSION` 键对应的值。然后在 Shell 端按下 `Ctrl + S` 打开设置页面，找到“API 密钥”输入框，将 `ECSESSION` 的值粘贴进去并保存。保存后，Shell 端即可正常连接后端服务。
 
-### Q6: 全量部署后，如何初始化智能体？
+### Q7: 全量部署后，如何初始化智能体？
 
-A6: 全量部署后，需先在网页端注册名为 `openEuler` 的管理员用户，然后登录图形界面。先在“插件中心”中注册所需的 MCP Server 服务，然后在“应用中心”中创建并配置智能体。具体操作请参考 Web 图形界面的使用手册。
+**A7**: 全量部署后，需先在网页端注册名为 `openEuler` 的管理员用户，然后登录图形界面。先在“插件中心”中注册所需的 MCP Server 服务，然后在“应用中心”中创建并配置智能体。具体操作请参考 Web 图形界面的使用手册。
-- 
Gitee