需先确认系统架构：x86_64用WineHQ官方源安装winehq-stable，aarch64则必须用Box64+Wine64或Box86+Wine32组合方案，并补全微软字体、VC运行库及虚拟桌面配置。
一、确认系统架构与版本
如果您在麒麟操作系统上尝试运行 Windows 程序但 Wine 无法启动或报错，则可能是由于系统架构（x86_64 或 aarch64）与 Wine 版本不匹配，或系统源未正确适配所致。以下是针对不同架构的多种安装路径：
1、在终端中执行 uname -m 查看当前 CPU 架构：若输出为 x86_64，则适用标准 Debian/Ubuntu 兼容方案；若输出为 aarch64，则必须采用 Box64/Box86 协同方案。
2、执行 cat /etc/os-release | grep -E "(VERSION|ID_LIKE)" 获取系统标识：重点关注 ID_LIKE="debian ubuntu"（表明为 apt 系统）或 VERSION_CODENAME 字段（如 focal 对应 Ubuntu 20.04，即银河麒麟 V10 SP1 常用基线）。
二、x86_64 架构下通过官方源安装 Wine
该方法适用于银河麒麟桌面版 V10（x86_64）等基于 Debian/Ubuntu 的发行版，可直接获取 WineHQ 提供的稳定版二进制包，兼容性高且维护及时。
1、启用 i386 多架构支持：sudo dpkg --add-architecture i386 && sudo apt update
2、下载并导入 WineHQ GPG 密钥：wget -nc https://dl.winehq.org/wine-builds/winehq.key && sudo apt-key add winehq.key
3、添加对应代号的 Wine 官方仓库（以 focal 为例）：sudo sh -c 'echo "deb https://dl.winehq.org/wine-builds/ubuntu/ focal main" > /etc/apt/sources.list.d/winehq.list'
4、更新索引并安装稳定版：sudo apt update && sudo apt install --install-recommends winehq-stable
5、验证安装结果：wine --version 应返回类似 wine-9.16 的输出。
三、aarch64（ARM64）架构下使用 Box64 + Wine64 方案
原生 Wine 不支持 ARM64 指令集，必须借助 Box64 动态二进制翻译层将 x86_64 Windows 程序指令实时转译为 ARM64 指令。此方案专为飞腾、鲲鹏等国产 ARM 平台优化，实测可运行 PDF-XChange Editor 等中等复杂度应用。
1、添加 Box64 官方 APT 源：sudo wget https://ryanfortner.github.io/box64-debs/box64.list -O /etc/apt/sources.list.d/box64.list
2、更新软件包列表：sudo apt update
3、安装 Box64 与 Wine64：sudo apt install box64 wine64
4、手动创建软链接以统一调用入口：sudo ln -sf /usr/bin/wine64 /usr/local/bin/wine
ClawUsage Windows Hardlock
通过聊天（Telegram / 飞书）执行本地 `clawusage` 监控命令。当用户输入 `/clawusage ...`，或提出“查看 Codex 用量”、“开启/关闭自动…”等请求时触发使用。
5、首次运行任意 .exe 文件触发初始化：wine notepad.exe（自动创建 ~/.wine 目录及基础注册表）。
四、aarch64 架构下兼容 32 位 Windows 程序的 Box86 + Wine32 方案
部分旧版工具（如早期微信开发者工具依赖组件）为 i386 编译，需 Box86 翻译层配合 Wine32 运行。该路径独立于 Wine64，需单独部署，避免库冲突。
1、安装 Box86（需先满足编译依赖）：sudo apt install build-essential git cmake python3 libusb-1.0-0-dev libudev-dev libasound2-dev
2、克隆并编译 Box86：git clone https://github.com/ptitSeb/box86 && cd box86 && mkdir build && cd build && cmake .. -DRPI4=1 && make -j$(nproc)
3、安装编译产物：sudo make install
4、下载 Wine32 for ARM（推荐从社区构建版获取）：wget https://github.com/GloriousEggroll/wine-ge-custom/releases/download/9.0-GE-2/wine-9.0-GE-2-arm64.tar.xz
5、解压并配置环境变量：tar -xf wine-9.0-GE-2-arm64.tar.xz -C ~/wine32 && echo 'export PATH="$HOME/wine32/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
五、安装后必备配置与字体支持
Wine 默认环境缺少 Windows 核心字体与运行时库，会导致界面乱码、按钮不可点或程序闪退。以下操作为通用补全步骤，适用于所有架构。
1、安装微软核心字体：sudo apt install ttf-mscorefonts-installer，执行中需按 Tab 键选中 Yes 确认许可协议。
2、安装常用 Visual C++ 运行库：wget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks && chmod +x winetricks && sudo mv winetricks /usr/local/bin/ && winetricks -q vcrun2019
3、启动图形化配置界面：winecfg，在 “Graphics” 页勾选 Emulate a virtual desktop，分辨率设为 1024x768 可显著提升多数 GUI 程序稳定性。
4、映射 Windows 程序常用目录：在 winecfg → Drives 中点击 “Add”，将 /home/用户名/Documents 映射为 D: 盘，便于程序直接读写。
