在银河麒麟系统安装金山文档需严格采用arm64原生路径：先用uname -m确认aarch64架构、cat /etc/os-version核验desktop edition且≥v10 sp1，旧版本须先升级；再下载官网arm64版.deb包，通过应用商店或命令行安装，依赖缺失时执行sudo apt --fix-broken install补全；首次启动若卡顿，可用kdocs --no-sandbox重试。
在银河麒麟操作系统上安装金山文档独立客户端，需避开x86_64二进制包兼容性陷阱，直接采用ARM64原生适配路径，否则启动失败或功能残缺。
确认系统架构与版本
打开终端，执行uname -m，输出必须为aarch64；再运行cat /etc/os-version | grep "Edition"，确认显示“Desktop Edition”且版本号≥V10 SP1。若为V10早期小版本，先执行sudo apt update && sudo apt full-upgrade -y升级基础组件——旧版内核缺少对WPS沙箱进程的cgroup v2支持，会导致客户端闪退。
这一步不可跳过。【未验证架构就下载x86包将导致安装后无法启动】
获取并安装ARM64专用客户端
方法一：官网直装（推荐）
① 访问金山文档Linux版下载页（kdocs.cn/download），选择「ARM64 Linux版」→点击「立即下载」；
② 下载完成后，在文件管理器中右键该.deb包→「使用应用商店安装」；
③ 安装过程中若弹出“依赖缺失”提示，不要点取消，立即打开终端执行sudo apt --fix-broken install，回车后自动补全libglib2.0-0、libappindicator3-1等关键依赖。
方法二：命令行静默安装（适合批量部署）
直接在终端中粘贴执行：wget https://wdl1.cache.wps.cn/kdocs/linux/arm64/kdocs_1.7.0_arm64.deb && sudo apt install ./kdocs_1.7.0_arm64.deb -y。注意URL中的arm64不能替换成amd64，否则安装成功但运行时报“Exec format error”。
首次启动与账号绑定
安装完毕后，点击启动器图标或终端输入kdocs启动程序。首次运行会自动拉起初始化向导：
→ 点击「登录WPS账号」，输入手机号+验证码；
→ 勾选「同步本地文档到云空间」，确保“我的文档”目录被自动映射为~/KDocs；
→ 若界面卡在加载状态超过15秒，关闭窗口，终端执行killall kdocs && kdocs --no-sandbox重试——飞腾CPU部分型号需临时禁用Chromium沙箱机制。
登录成功后，桌面右下角会出现KDocs托盘图标，点击即可快速新建文档或查看最近协作记录。
