ARM架构信创环境部署WorkBuddy需采用ARM64服务端，官方不提供GUI客户端，支持二进制直装、Docker容器化及Ansible自动化三种方式，分别适配统信UOS/麒麟V10 SP3+、海光/飞腾平台+麒麟容器运行时、多节点信创云管场景。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您计划在ARM架构服务器上部署WorkBuddy，且需满足信创环境（如麒麟、统信UOS、中科方德等国产操作系统）兼容性要求，则不能直接使用面向x86_64或macOS/Windows的客户端安装包。WorkBuddy官方未提供原生信创系统GUI客户端，但支持通过Linux ARM64二进制服务端在符合内核与依赖要求的信创发行版中部署Claw协议服务。以下是适配该场景的多种安装路径：
一、二进制直装部署（推荐用于统信UOS/麒麟V10 SP3+）
此方式绕过图形界面依赖，以systemd服务形式运行workbuddy-server ARM64二进制文件，适用于已预装基础运行时的信创服务器环境，资源占用低且可控性强。
1、确认系统满足最低要求：执行uname -m输出aarch64，cat /etc/os-release显示uos或kylin且版本≥V10 SP3，内核≥5.4。
2、安装必要依赖：执行sudo apt update && sudo apt install -y curl unzip libglib2.0-0 libsm6 libxrender1 libxext6 libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libasound2（统信UOS适用）；若为麒麟V10，使用sudo yum install -y ...对应包名。
3、创建部署目录：sudo mkdir -p /opt/workbuddy && cd /opt/workbuddy。
4、下载官方ARM64服务端包：sudo curl -L https://www.codebuddy.cn/work/workbuddy-server-linux-arm64.tar.gz -o workbuddy-server-linux-arm64.tar.gz。
5、校验完整性：echo "f3a7e9b2c8d1e0f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8 workbuddy-server-linux-arm64.tar.gz" | sha256sum -c（以官网公示SHA256值为准）。
6、解压并授权：sudo tar -xzf workbuddy-server-linux-arm64.tar.gz && sudo chmod +x workbuddy-server。
7、生成systemd服务单元文件：
sudo tee /etc/systemd/system/workbuddy-server.service <<'EOF'<br>[Unit]<br>Description=WorkBuddy Server (ARM64)<br>After=network.target<br><br>[Service]<br>Type=simple<br>User=workbuddy<br>Group=workbuddy<br>WorkingDirectory=/opt/workbuddy<br>ExecStart=/opt/workbuddy/workbuddy-server --config /opt/workbuddy/config.yaml<br>Restart=always<br>RestartSec=10<br>Environment=CLAW_TOKEN=<strong><font color="green">your_claw_token_here</font></strong><br><br>[Install]<br>WantedBy=multi-user.target<br>EOF。
8、创建专用用户并启用服务：sudo useradd -r -s /bin/false workbuddy && sudo chown -R workbuddy:workbuddy /opt/workbuddy && sudo systemctl daemon-reload && sudo systemctl enable --now workbuddy-server。
二、Docker容器化部署（适配海光/飞腾平台+麒麟容器运行时）
该方案利用国产化容器引擎（如iSulad、KubeSphere Edge定制版）运行ARM64镜像，规避宿主机GLIBC版本冲突问题，适合已部署信创容器底座的政企环境。
1、确认容器运行时可用：执行isula version（麒麟）或kubectl get nodes（KubeSphere边缘集群），确保节点Arch显示arm64。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、拉取腾讯云官方多架构镜像：sudo isula pull ccr.ccs.tencentyun.com/workbuddy/server:latest-arm64（麒麟V10 SP3+默认支持）。
3、准备配置挂载目录：sudo mkdir -p /data/workbuddy/config && sudo chown -R 1001:1001 /data/workbuddy（1001为镜像内workbuddy用户UID）。
4、生成/data/workbuddy/config/config.yaml，至少包含claw_token: "<strong><font color="green">your_claw_token_here</font></strong>"与log_level: info。
5、启动容器：
sudo isula run -d --name workbuddy-svr --restart=always \<br>-v /data/workbuddy/config:/app/config \<br>-p 8080:8080 \<br>--network host \<br>ccr.ccs.tencentyun.com/workbuddy/server:latest-arm64。
6、验证服务健康：curl -s http://localhost:8080/health | grep '"status":"ok"' && echo "✅"。
三、Ansible自动化集群部署（适配信创云管平台纳管场景）
当需在多个飞腾/鲲鹏服务器节点批量部署且纳入统一运维体系时，可复用Ansible Playbook，通过国产化SSH通道与systemd模块完成标准化交付，避免人工操作误差。
1、在Ansible控制节点（x86管理机或ARM跳板机）确认ansible --version ≥2.12，且已配置免密登录至所有信创目标主机。
2、编辑/etc/ansible/hosts，添加信创主机组：
[xinchuang_servers]<br>server1 ansible_host=192.168.10.101 ansible_user=opuser ansible_python_interpreter=/usr/bin/python3<br>server2 ansible_host=192.168.10.102 ansible_user=opuser ansible_python_interpreter=/usr/bin/python3。
3、创建Playbook workbuddy-xinchuang.yml，定义变量workbuddy_arch: "arm64"与os_family: "uos"（或"kylin"）。
4、任务中调用community.general.archive模块解压ARM64包，并使用ansible.builtin.systemd模块注册服务，指定state: started与enabled: true。
5、注入CLAW_TOKEN时采用Ansible Vault加密：ansible-vault encrypt_string 'your_real_token' --name 'CLAW_TOKEN'，写入group_vars/xinchuang_servers.yml。
6、执行部署：ansible-playbook -i /etc/ansible/hosts workbuddy-xinchuang.yml --limit uos_servers（仅作用于统信节点）。
