必须先确认软件通过UOS官方兼容认证，再安装dotnet6、OpenJDK17、国产数据库ODBC驱动，最后按需启用Wine-UOS增强版运行已认证老版本。
在统信UOS系统中运行用友、金蝶等Windows版会计软件时，若双击安装包无反应、启动后白屏、功能按钮灰色不可用或数据库连接失败，说明当前环境缺少财务类软件必需的运行上下文与国产化适配组件，不能仅靠通用Wine方案解决。
确认软件是否通过UOS官方兼容认证
未获认证的会计软件版本存在注册表调用异常、加密狗驱动缺失、打印控件崩溃等底层风险，强行部署可能导致账套损坏或审计不合规。【必须先完成此步，否则后续所有操作均无效】
1、打开浏览器访问统信软件官网→点击顶部导航栏“生态认证”→进入认证查询页面。
2、在搜索框中输入完整产品名与版本号，例如“用友U8+ 15.0”“金蝶K/3 WISE V14.3”“金蝶云·星空 7.5”，注意区分大小写与空格。
3、核对结果中的“适配架构”是否匹配您UOS设备的CPU类型（飞腾FT-2000+/鲲鹏920/兆芯KX-6000），并确认“UOS版本”字段明确标注为V20 2403或V20 2503（2026年主流版本）。
4、若查询结果为空或状态为“测试中”，立即停止安装，联系用友/金蝶客服索要UOS专用安装包，或改用其发布的云原生Web客户端。
安装会计软件必需的核心依赖组件
财务软件对.NET、Java、ODBC三类组件有强耦合依赖，缺失任一都将导致登录界面卡死或凭证录入失败。
方法一：终端批量安装统信定制组件
1、打开终端，执行：sudo apt update && sudo apt install dotnet6-runtime-uos openjdk-17-jdk odbcinst1debian2
2、验证安装结果：运行dotnet --list-runtimes应显示包含“Microsoft.NETCore.App 6.0.x”；运行java -version输出必须含“OpenJDK 17.0.x”且无“Oracle”字样。
3、配置ODBC数据源：进入“控制中心→硬件→ODBC数据源”，点击“添加DSN”，选择对应国产数据库驱动（如达梦DM8-UOS、人大金仓KingbaseES-V8），填写服务名、端口、数据库名，测试连接成功后保存。
方法二：手动部署金蝶专用Java环境（仅限K/3 WISE本地版）
1、从金蝶官网下载“K/3 WISE UOS适配版JDK11压缩包”，解压至/opt/jdk-k3wise。
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
2、执行sudo update-alternatives --install /usr/bin/java java /opt/jdk-k3wise/bin/java 100，再运行sudo update-alternatives --config java，选择该路径。
【注意：严禁混用Oracle JDK与OpenJDK，K/3 WISE会因类加载器冲突直接退出】
启用Wine兼容层运行已认证的老版本
仅适用于通过认证但未提供原生UOS安装包的旧版软件（如用友U8 13.0），且必须关闭联网与加密狗识别功能。
第一步：安装统信定制Wine组件
1、打开应用商店→搜索“Wine-UOS增强版”→点击安装（非社区版wine或deepin-wine）。
第二步：创建隔离前缀并初始化
1、终端执行：WINEPREFIX=$HOME/.wine-u8 WINEARCH=win32 winecfg
2、在弹出窗口中，“Desktop Integration”选项卡取消勾选“Show windows in taskbar”；“Graphics”选项卡勾选“Emulate a virtual desktop”，分辨率设为1024x768。
3、关闭窗口后，执行：WINEPREFIX=$HOME/.wine-u8 winetricks -q vcrun2019 corefonts gdiplus
第三步：静默安装并启动
1、右键点击U8安装程序（如U8Setup.exe）→选择“使用Wine-UOS增强版打开”。
2、安装过程中全程保持默认路径（C:\U8Soft\），禁止点击“浏览”修改路径。
3、安装完成后，在终端执行：WINEPREFIX=$HOME/.wine-u8 wine ~/.wine-u8/drive_c/U8Soft/U8Client/U8Client.exe
