WorkBuddy安装依赖下载慢时，应优先切换国内镜像源：CentOS/RHEL系换阿里云Yum源，Ubuntu/Debian系换清华apt源；内网环境可构建离线本地仓库；仅临时调试可禁用GPG校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Linux系统上安装WorkBuddy时发现依赖下载缓慢、超时或因网络策略无法拉取远程包，则很可能是系统默认Yum源或apt源位于境外或响应延迟较高。以下是针对此问题的多种加速方案：
一、切换为国内镜像Yum源（CentOS/RHEL系）
替换系统默认base、epel等仓库地址为国内高校或云服务商镜像，可显著提升rpm包及依赖解析速度，避免DNS污染与跨境路由绕行。
1、备份原配置：sudo cp -r /etc/yum.repos.d/ /etc/yum.repos.d.bak。
2、清空原有repo文件：sudo rm -f /etc/yum.repos.d/*.repo。
3、下载阿里云CentOS镜像源配置（以CentOS 7为例）：sudo curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo。
4、启用EPEL扩展源：sudo yum install -y epel-release，随后执行sudo sed -i 's|^#baseurl=https://download.fedoraproject.org/pub|baseurl=https://mirrors.aliyun.com|g' /etc/yum.repos.d/epel.repo。
5、生成缓存并验证：sudo yum clean all && sudo yum makecache，输出中出现“元数据缓存已建立”即表示生效。
二、更换为清华源apt源（Ubuntu/Debian系）
Ubuntu默认使用archive.ubuntu.com，该域名在国内部分运营商下存在解析慢、连接不稳定等问题；切换至tsinghua.edu.cn镜像可降低首包延迟并提升并发下载吞吐。
1、备份原sources.list：sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak。
2、清空并写入清华源配置（以Ubuntu 22.04为例）：echo "deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse" | sudo tee /etc/apt/sources.list。
3、追加更新源与安全源：echo "deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse" | sudo tee -a /etc/apt/sources.list；echo "deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse" | sudo tee -a /etc/apt/sources.list。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
4、更新索引：sudo apt update，观察终端是否快速输出“获取：1 https://mirrors.tuna.tsinghua.edu.cn…”且无timeout提示。
三、配置离线本地Yum/Apt仓库（内网隔离环境）
当目标服务器完全断网或处于高安全等级内网时，无法访问任何公网源，此时需预先在联网机器构建本地仓库镜像，并通过局域网HTTP共享服务提供给安装节点使用，彻底规避外网依赖。
1、在联网主机上安装reposync工具：sudo yum install -y yum-utils（CentOS）或sudo apt install -y apt-mirror（Ubuntu）。
2、同步核心仓库（以CentOS 7 + EPEL为例）：sudo reposync -r base -r epel --download-metadata -p /var/www/html/yum/；Ubuntu侧执行：sudo apt-mirror /etc/apt/mirror.list（需先配置mirror.list指向官方源）。
3、启动简易HTTP服务：sudo python3 -m http.server 8000 -d /var/www/html（CentOS）或sudo systemctl start nginx（Ubuntu，需预装nginx并配置root为/mirror）。
4、在目标机修改源地址为内网IP：sed -i 's|https://mirrors.tuna.tsinghua.edu.cn|http://192.168.1.100:8000|g' /etc/apt/sources.list（Ubuntu）或替换/etc/yum.repos.d/中所有baseurl为http://192.168.1.100/yum/（CentOS）。
四、禁用GPG校验与元数据检查（临时调试场景）
某些老旧镜像站未及时更新GPG密钥或repomd.xml签名，导致yum/apt卡在验证阶段；在可信局域网环境中，可临时关闭校验以跳过阻塞点，加快依赖解析流程。
1、CentOS临时关闭：sudo sed -i 's/gpgcheck=1/gpgcheck=0/g' /etc/yum.repos.d/*.repo；同时添加metadata_expire=1m避免缓存过期重检。
2、Ubuntu临时关闭：echo "APT::Get::AllowUnauthenticated \"true\";" | sudo tee /etc/apt/apt.conf.d/99allow-unauthenticated。
3、执行更新命令后立即恢复：sudo sed -i 's/gpgcheck=0/gpgcheck=1/g' /etc/yum.repos.d/*.repo；删除上述99allow-unauthenticated文件。
