docs: make Chinese README the default

README.md

@@ -1,11 +1,17 @@
+<!-- WEHUB_ZH_README -->
+> [!NOTE]
+> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。  
+> [English](./README.en.md) · [原始项目](https://github.com/kernalix7/winpodx) · [上游 README](https://github.com/kernalix7/winpodx/blob/HEAD/README.md)  
+> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
+
 <div align="center">
 
 <img src="docs/images/CI.svg" alt="WinPodX" width="320">
 
-### Click an app. Word opens. That's it.
+### 点击应用。Word 就打开了。就这么简单。
 
-<p>Native Linux windows for every Windows app — real icons, real <code>WM_CLASS</code>,<br>
-pin-to-taskbar. FreeRDP RemoteApp + dockur/windows. Zero config.</p>
+<p>为每个 Windows 应用提供原生 Linux 窗口 — 真实图标、真实 <code>WM_CLASS</code>、<br>
+固定到任务栏。FreeRDP RemoteApp + dockur/windows。零配置。</p>
 
 <pre><code># Latest stable release (default)
 curl -fsSL https://raw.githubusercontent.com/kernalix7/winpodx/main/install.sh | bash
@@ -20,7 +26,7 @@ curl -fsSL https://raw.githubusercontent.com/kernalix7/winpodx/main/uninstall.sh
   <img src="docs/images/demo.png" alt="WinPodX in action — Windows apps as native Linux windows on KDE" width="720">
 </a>
 
-<sub>Windows About / Task Manager / PowerShell each in their own Linux window, alongside the WinPodX Dashboard (live Pod / RAM / CPU gauges, workspace tiles).</sub>
+<sub>Windows 关于 / 任务管理器 / PowerShell 各自在独立的 Linux 窗口中运行，旁边是 WinPodX 仪表板（实时 Pod / 内存 / CPU 仪表、工作区磁贴）。</sub>
 
 [![Beta](https://img.shields.io/badge/status-beta-orange?style=for-the-badge)](#status-beta)
 [![Latest](https://img.shields.io/github/v/release/kernalix7/winpodx?include_prereleases&style=for-the-badge&label=latest&color=2962FF)](https://github.com/kernalix7/winpodx/releases)
@@ -32,7 +38,7 @@ curl -fsSL https://raw.githubusercontent.com/kernalix7/winpodx/main/uninstall.sh
 [![stars](https://img.shields.io/github/stars/kernalix7/winpodx?style=flat-square&color=FFD93D&logo=github&logoColor=white)](https://github.com/kernalix7/winpodx/stargazers)
 [![downloads](https://img.shields.io/github/downloads/kernalix7/winpodx/total?style=flat-square&color=2EA44F)](https://github.com/kernalix7/winpodx/releases)
 
-###### Works on
+###### 适用于
 
 [![openSUSE](https://img.shields.io/badge/openSUSE-73BA25?style=flat-square&logo=opensuse&logoColor=white)](https://www.opensuse.org/)
 [![Fedora](https://img.shields.io/badge/Fedora-294172?style=flat-square&logo=fedora&logoColor=white)](https://fedoraproject.org/)
@@ -50,34 +56,34 @@ curl -fsSL https://raw.githubusercontent.com/kernalix7/winpodx/main/uninstall.sh
 
 ---
 
-> ### Status: Beta
-> WinPodX is in active development (**v0.9.0**). **v0.7.0** introduced the **bare-metal disguise** (#246, opt-in / off by default): with `pod.disguise_level balanced | max` the Windows guest reads like a physical machine to VM-detection software (Nvidia GPU-passthrough "code 43", launch-gate VM checks, VM-hostile installers) — verified against al-khaser 0.82 — and the default guest username became `WPX-User`. **v0.7.1** is a UX + integration release: discovered Windows apps now register **automatic file associations** so they appear in your file manager's "Open with" menu (#545, on by default, only *added* — never set as the default handler); the GUI gains **app management** — reset-to-detected, a custom-icon picker, multi-select bulk hide/remove, and a restore list for deleted apps (#530); a **quick app launcher** (`winpodx launch`, #561) gives a Start-menu-style picker bindable to a DE hotkey; **`winpodx gui` no longer blocks the terminal** (#549); `winpodx doctor` **warns on an old FreeRDP** with broken RemoteApp windows (#546); and `install.sh --main` is now honoured on **Atomic Fedora** (#548). **v0.7.2** is a bug-fix release: it fixes a GUI crash on *Refresh Apps* (#567) and the tray *Terminate Session* / *USB Devices* submenus (#573) on KDE/Plasma, discovers apps with Chinese/Japanese/Korean names (#553), keeps the container across `pod stop` (no more recreate-on-update), and gives a clear error when Windows credentials are missing (#569). **v0.7.3** adds **reverse-open of files on the Windows VM itself** — not just your shared Home, the guest `C:` is shared over SMB and mounted with kio-fuse so a host app opens the real guest file and edits save back (#616, KDE) — an opt-in **idle auto-stop** that frees the VM's RAM (#622), and a **`+multitouch`** flag for touchscreen / stylus / pen passthrough (#623); it also fixes `winpodx app refresh` timing out on a slow guest (#619), the Dashboard RAM / Disk gauges sticking on "n/a" (#634), and removes the USB drive-letter auto-mapper that was destabilizing installs (#613, #638). **v0.7.4** lets you **choose where the Windows VM lives** (`install.sh --storage-dir`, #646) and **install from a local Windows ISO** to skip the download (`--win-iso`, #647), defaults a 24 GB+ host to **8 GB VM RAM** (#630); plus fixes — opening a second document in an already-running app, *Open with* on stripped-PATH desktops like Deepin, a clear error on a missing RDP password (#569), the GUI Logs buttons honouring the Docker backend, the `.deb` pulling in `podman-compose` (#644), and the maintenance dialog size (#550). **v0.8.0** makes app discovery **Start-Menu-only by default** — only the apps your Windows Start Menu actually shows, grouped into nested folder sub-groups, with a `desktop.full_app_scan` opt-in for the old scan-everything behaviour (#581); passes your `[pod] keyboard` to FreeRDP as the session layout (#660); stages `--win-iso` *before* compose-up so dockur installs from it instead of downloading (#647); self-heals the reverse-open listener; bumps bundled rdprrap to **0.3.0**; and fixes several GUI crashes — the *Refresh Apps* SIGSEGV, an off-thread display-scale SIGABRT, the Debloat task dialog not auto-closing (#550), and a layout-recursion SIGSEGV with long / CJK app names (#553). **v0.9.0** lets Windows apps handle **URL-scheme links** from Linux — click a `mailto:` link and Outlook opens; app schemes like `slack:` / `vnc:` route to the right Windows app, auto-harvested during discovery and registered as `x-scheme-handler`s (#421, #694). It also **hardens the trust boundary**: a discovered guest app can no longer silently become your default `http`/`https` handler (opt-in only), and the session window-reaper no longer mis-kills a just-relaunched app or mass-kills sessions on a transient scan failure (#680 follow-up); plus fixes for kio-fuse detection on multiarch/KF6 layouts (#697), the reverse-open listener autostarting with the tray (#691), the suspend/resume D-Bus subscription (#690), and the install one-liner auto-installing `git` when missing (#705). The AppImage is **Thin** (~110 MB) — only FreeRDP + Python + Qt + winpodx — and uses the host's `podman` / `docker`. The CLI surface settled in 0.6.0 stands: **`winpodx guest`** (guest-side ops), **`winpodx install`** (install / disk ops), and **`winpodx doctor`** (diagnostics with `--json` / `--quick` / `--fix`); the post-create chain is the single **`winpodx provision`**. First install still takes ~5–10 minutes (Windows VM ISO download + Sysprep + OEM apply); `winpodx pod wait-ready --logs` shows live progress. Please file issues at <https://github.com/kernalix7/winpodx/issues> if something breaks.
+> ### 状态：Beta
+> WinPodX 正在积极开发中（**v0.9.0**）。**v0.7.0** 引入了**裸机伪装**（bare-metal disguise，#246，可选 / 默认关闭）：配合 `pod.disguise_level balanced | max`，Windows 客户机对虚拟机检测软件呈现为物理机（Nvidia GPU 直通「code 43」、启动门控 VM 检查、敌视 VM 的安装程序）—— 已在 al-khaser 0.82 上验证 —— 且默认客户机用户名改为 `WPX-User`。**v0.7.1** 是 UX + 集成版本：发现的 Windows 应用现可注册**自动文件关联**，从而出现在文件管理器的「打开方式」菜单中（#545，默认开启，仅*添加* — 从不设为默认处理程序）；GUI 新增**应用管理** — 重置为检测状态、自定义图标选择器、多选批量隐藏/移除，以及已删除应用的恢复列表（#530）；**快速应用启动器**（`winpodx launch`，#561）提供类似开始菜单的选择器，可绑定到桌面环境快捷键；**`winpodx gui` 不再阻塞终端**（#549）；`winpodx doctor` **在旧版 FreeRDP 导致 RemoteApp 窗口异常时发出警告**（#546）；且 `install.sh --main` 现已在 **Atomic Fedora** 上生效（#548）。**v0.7.2** 是错误修复版本：修复 KDE/Plasma 上 *Refresh Apps* 导致的 GUI 崩溃（#567）以及托盘 *Terminate Session* / *USB Devices* 子菜单问题（#573），可发现中文/日文/韩文名称的应用（#553），在 `pod stop` 时保留容器（更新时不再重建），并在缺少 Windows 凭据时给出明确错误（#569）。**v0.7.3** 新增**在 Windows 虚拟机本身上反向打开文件** — 不仅是共享的主目录，客户机 `C:` 通过 SMB 共享并用 kio-fuse 挂载，使主机应用打开真实的客户机文件且编辑可写回（#616，KDE）— 可选的**空闲自动停止**以释放虚拟机内存（#622），以及用于触摸屏 / 手写笔 / 触控笔直通的 **`+multitouch`** 标志（#623）；还修复了 `winpodx app refresh` 在慢速客户机上超时（#619）、仪表板内存 / 磁盘仪表卡在「n/a」（#634），并移除了导致安装不稳定的 USB 盘符自动映射器（#613、#638）。**v0.7.4** 允许你**选择 Windows 虚拟机存放位置**（`install.sh --storage-dir`，#646）并**从本地 Windows ISO 安装**以跳过下载（`--win-iso`，#647），24 GB 及以上主机默认 **8 GB 虚拟机内存**（#630）；另含修复 — 在已运行应用中打开第二个文档、在 Deepin 等精简 PATH 桌面上的*打开方式*、缺少 RDP 密码时的明确错误（#569）、GUI 日志按钮遵循 Docker 后端、`.deb` 拉取 `podman-compose`（#644），以及维护对话框尺寸（#550）。**v0.8.0** 使应用发现**默认仅扫描开始菜单** — 仅显示 Windows 开始菜单中实际出现的应用，分组为嵌套文件夹子组，并提供 `desktop.full_app_scan` 可选以恢复旧的「扫描一切」行为（#581）；将 `[pod] keyboard` 传递给 FreeRDP 作为会话布局（#660）；在 compose-up *之前*暂存 `--win-iso`，使 dockur 从中安装而非下载（#647）；自愈反向打开监听器；将捆绑的 rdprrap 升级至 **0.3.0**；并修复若干 GUI 崩溃 — *Refresh Apps* SIGSEGV、离线程显示缩放 SIGABRT、Debloat 任务对话框未自动关闭（#550），以及长 / CJK 应用名称导致的布局递归 SIGSEGV（#553）。**v0.9.0** 让 Windows 应用处理来自 Linux 的 **URL scheme 链接** — 点击 `mailto:` 链接即可打开 Outlook；`slack:` / `vnc:` 等应用 scheme 路由到正确的 Windows 应用，在发现过程中自动收集并注册为 `x-scheme-handler`s（#421、#694）。同时**加固信任边界**：已发现的客户机应用不再能静默成为默认 `http`/`https` 处理程序（仅可选），会话窗口回收器不再误杀刚重新启动的应用，或在短暂扫描失败时批量终止会话（#680 后续）；另含 kio-fuse 在多架构/KF6 布局上的检测修复（#697）、反向打开监听器随托盘自动启动（#691）、挂起/恢复 D-Bus 订阅（#690），以及安装单行命令在缺失时自动安装 `git`（#705）。AppImage 为 **Thin**（约 110 MB）— 仅含 FreeRDP + Python + Qt + winpodx — 并使用主机的 `podman` / `docker`。0.6.0 定型的 CLI 界面保持不变：**`winpodx guest`**（客户机侧操作）、**`winpodx install`**（安装 / 磁盘操作）和 **`winpodx doctor`**（诊断，含 `--json` / `--quick` / `--fix`）；创建后链为单一的 **`winpodx provision`**。首次安装仍需约 5–10 分钟（Windows 虚拟机 ISO 下载 + Sysprep + OEM 应用）；`winpodx pod wait-ready --logs` 显示实时进度。如有问题请在 <https://github.com/kernalix7/winpodx/issues> 提交 issue。
 
-**No full-screen RDP.** Each Windows app becomes its own Linux window with its real icon — pinnable, alt-tabbable, file-associated, both directions. Drop into a full Windows desktop only when you actually want one (`winpodx app run desktop`).
+**无需全屏 RDP。** 每个 Windows 应用都会成为独立的 Linux 窗口，并显示其真实图标——可固定到任务栏、可用 Alt+Tab 切换、可关联文件，双向互通。只有在你真正需要时，才切换到完整 Windows 桌面（`winpodx app run desktop`）。
 
-WinPodX runs a Windows container (via [dockur/windows](https://github.com/dockur/windows)) in the background and presents Windows apps as native Linux applications through FreeRDP RemoteApp, while a bearer-authed HTTP agent inside the guest handles the host→guest command channel without flashing a PowerShell window. The reverse direction — Linux apps surfaced in the Windows "Open with…" menu — is handled by a host-side listener that consumes JSON requests written by per-slug Rust shims inside the guest. **Near-zero external Python dependencies** (stdlib only on Python 3.11+; one pure-Python `tomli` fallback on 3.9/3.10).
+WinPodX 在后台通过 [dockur/windows](https://github.com/dockur/windows))) 运行 Windows 容器，并通过 FreeRDP RemoteApp 将 Windows 应用呈现为原生 Linux 应用；访客机内的 bearer 认证 HTTP 代理负责处理主机→访客命令通道，且不会闪现 PowerShell 窗口。反向流程——在 Windows「打开方式…」菜单中显示 Linux 应用——由主机端监听器处理，该监听器消费访客机内按 slug 划分的 Rust shim 写入的 JSON 请求。**近乎零外部 Python 依赖**（Python 3.11+ 仅使用标准库；3.9/3.10 上有一个纯 Python `tomli` 回退方案）。
 
-## Minimum requirements
+## 最低要求
 
-**Before installing**, make sure your machine actually supports virtualisation. WinPodX runs Windows in a KVM-backed container; without these three, the install will run to completion but Windows will never boot.
+**安装前**，请确认你的机器确实支持虚拟化。WinPodX 在基于 KVM 的容器中运行 Windows；若缺少以下三项，安装过程会顺利完成，但 Windows 永远无法启动。
 
-| Requirement | How to check | Fix |
+| 要求 | 如何检查 | 修复方法 |
 |---|---|---|
-| **Intel VT-x or AMD-V enabled in BIOS / UEFI** | `lscpu \| grep -i virtualization` shows `VT-x` or `AMD-V` | Reboot → firmware setup → enable "Intel Virtualization Technology" / "SVM Mode" / "VT-x". OFF by default on many laptops. |
-| **kvm kernel module loaded** | `lsmod \| grep kvm` lists `kvm_intel` or `kvm_amd` | `sudo modprobe kvm_intel` (Intel) or `sudo modprobe kvm_amd` (AMD). Auto-loads on next boot once BIOS allows it. |
-| **Your user is in the `kvm` group** | `id -nG \| tr ' ' '\n' \| grep kvm` returns `kvm` | `sudo usermod -aG kvm $USER`, then log out + back in. |
+| **已在 BIOS / UEFI 中启用 Intel VT-x 或 AMD-V** | `lscpu \| grep -i virtualization` 显示 `VT-x` 或 `AMD-V` | 重启 → 进入固件设置 → 启用「Intel Virtualization Technology」/「SVM Mode」/「VT-x」。许多笔记本默认关闭。 |
+| **kvm 内核模块已加载** | `lsmod \| grep kvm` 列出 `kvm_intel` 或 `kvm_amd` | `sudo modprobe kvm_intel`（Intel）或 `sudo modprobe kvm_amd`（AMD）。BIOS 允许后，下次启动会自动加载。 |
+| **你的用户属于 `kvm` 组** | `id -nG \| tr ' ' '\n' \| grep kvm` 返回 `kvm` | `sudo usermod -aG kvm $USER`，然后注销并重新登录。 |
 
-Hardware: x86_64 or aarch64 CPU with virtualisation extensions, 8 GB+ RAM (12 GB+ recommended), ~30 GB free disk for the Windows image. `install.sh` aborts with the same diagnostic if `/dev/kvm` is missing after the package install step — most "install ran fine but Windows never boots" bug reports trace back to one of the rows above.
+硬件：配备虚拟化扩展的 x86_64 或 aarch64 CPU，8 GB 以上内存（建议 12 GB 以上），Windows 镜像约需 30 GB 可用磁盘空间。若包安装步骤后仍缺少 `/dev/kvm`，`install.sh` 会以相同诊断信息中止——大多数「安装正常但 Windows 无法启动」的问题报告都可追溯到上表中的某一行。
 
-## Quick install
+## 快速安装
 
-One-liner (any supported Linux distro):
+一行命令（任何受支持的 Linux 发行版）：
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/kernalix7/winpodx/main/install.sh | bash
 ```
 
-Or via a native package manager:
+或通过原生包管理器：
 
 ```bash
 # openSUSE Tumbleweed / Leap / Slowroll
@@ -106,15 +112,15 @@ chmod +x winpodx-*-x86_64.AppImage
 ./winpodx-*-x86_64.AppImage setup
 ```
 
-> **After a package-manager / AppImage install:** run `winpodx setup` once to generate `~/.config/winpodx/winpodx.toml` + compose.yaml. The curl one-liner does this for you (and waits ~5–10 min for the Windows first boot); package installs ship the binary only so `apt install` / `dnf install` / `yay -S` / first AppImage launch don't trigger a 10-minute Windows ISO download out of the blue. After setup, just launching an app (`winpodx app run desktop`) auto-provisions the pod the first time.
+> **通过包管理器 / AppImage 安装后：** 请运行一次 `winpodx setup` 以生成 `~/.config/winpodx/winpodx.toml` + compose.yaml。curl 一行命令会自动完成此步骤（并等待 Windows 首次启动约 5–10 分钟）；包安装仅分发二进制文件，因此 `apt install` / `dnf install` / `yay -S` / 首次启动 AppImage 不会突然触发长达 10 分钟的 Windows ISO 下载。完成设置后，只需启动应用（`winpodx app run desktop`），首次运行时会自动配置 pod。
 >
-> The Thin AppImage (0.6.0) bundles Python + Qt + winpodx + FreeRDP only — the container runtime lives on the host (`podman` ≥ 4 recommended, `docker` also supported) so the AppImage no longer fights a host stack you already have (#357, #363). Pre-0.6.0 fat AppImages bundled the whole podman stack and shadowed the host's. Host-side requirements left: a container runtime via your package manager, `/dev/kvm`, `kvm` group membership, and `/etc/subuid` / `/etc/subgid` for rootless Podman. `winpodx setup-host` fixes the kvm / subuid bits via a single `pkexec` prompt; `winpodx doctor` surfaces anything still missing.
+> 精简版 AppImage（0.6.0）仅捆绑 Python + Qt + winpodx + FreeRDP——容器运行时位于主机上（推荐 `podman` ≥ 4，也支持 `docker`），因此 AppImage 不再与主机上已有的技术栈冲突（#357、#363）。0.6.0 之前的完整版 AppImage 捆绑了整个 podman 栈并覆盖了主机的配置。主机端仍需：通过包管理器安装容器运行时、`/dev/kvm`、加入 `kvm` 组，以及用于 rootless Podman 的 `/etc/subuid` / `/etc/subgid`。`winpodx setup-host` 通过单次 `pkexec` 提示修复 kvm / subuid 相关配置；`winpodx doctor` 会列出仍缺失的项。
 
-See [docs/INSTALL.md](docs/INSTALL.md) for offline / air-gapped builds, source installs, version pinning, and uninstall.
+离线 / 气隙构建、源码安装、版本锁定和卸载请参阅 [docs/INSTALL.md](docs/INSTALL.md)。
 
-## First-time setup
+## 首次设置
 
-If you used the `curl install.sh` one-liner, setup already ran and the Windows VM is booting -- skip to [Launch](#launch). For every other install path (package managers, AppImage, source, pip) run setup once before the first app launch:
+如果你使用了 `curl install.sh` 一行命令，设置已完成且 Windows 虚拟机正在启动——请跳转到[启动](#launch)。对于其他所有安装方式（包管理器、AppImage、源码、pip），请在首次启动应用前运行一次设置：
 
 ```bash
 # Auto setup -- host-detected defaults, no prompts
@@ -124,23 +130,23 @@ winpodx setup
 winpodx setup --customize
 ```
 
-Setup writes `~/.config/winpodx/winpodx.toml` + `compose.yaml`, registers the GUI launcher, and confirms the host has FreeRDP + Podman / Docker + KVM. If any of those are missing, the output ends with a per-distro install command (e.g. `sudo apt install xfreerdp3 podman podman-compose` on Debian / Ubuntu, `sudo dnf install ...` on Fedora) -- run it and re-run `winpodx setup`.
+设置会写入 `~/.config/winpodx/winpodx.toml` + `compose.yaml`，注册 GUI 启动器，并确认主机已安装 FreeRDP + Podman / Docker + KVM。若缺少其中任何一项，输出末尾会给出针对各发行版的安装命令（例如 Debian / Ubuntu 上为 `sudo apt install xfreerdp3 podman podman-compose`，Fedora 上为 `sudo dnf install ...`）——运行该命令后重新执行 `winpodx setup`。
 
-The first app launch then provisions the pod, pulls the dockur image, runs the Windows ISO download + Sysprep + OEM apply, and reaches a usable RDP session in ~5-10 min. `winpodx pod wait-ready --logs` tails container progress live so you can watch each phase:
+首次启动应用时会配置 pod、拉取 dockur 镜像、执行 Windows ISO 下载 + Sysprep + OEM 应用，并在约 5–10 分钟内达到可用的 RDP 会话。`winpodx pod wait-ready --logs` 会实时跟踪容器进度，便于你观察每个阶段：
 
 ```bash
 winpodx app run desktop          # First launch -- ~5-10 min, subsequent launches near-instant
 winpodx pod wait-ready --logs    # Optional: watch first-boot progress live
 ```
 
-Run `winpodx doctor` any time afterwards to re-check host state and surface the next fix command if something drifts:
+之后可随时运行 `winpodx doctor`，重新检查主机状态，若配置发生变化则显示下一步修复命令：
 
 ```bash
 winpodx doctor                   # Read-only -- prints what would need fixing
 winpodx guest apply-fixes        # Re-applies guest-side runtime fixes (RDP timeouts, NIC power-save, etc.)
 ```
 
-## Launch
+## 启动
 
 ```bash
 winpodx app run word              # Launch Word
@@ -149,119 +155,122 @@ winpodx app run desktop           # Full Windows desktop
 winpodx launch                    # Quick app launcher (Start-menu style picker)
 ```
 
-Or just click an app icon in your application menu. `winpodx launch` opens a searchable picker of your Windows apps — bind it to a desktop-environment custom shortcut (KDE: *System Settings → Shortcuts → Custom*; GNOME: *Settings → Keyboard → Custom Shortcuts*) for a system-wide hotkey. See [docs/USAGE.md](docs/USAGE.md) for the full CLI, the Qt6 GUI, health checks, and configuration.
+或直接点击应用菜单中的应用图标。`winpodx launch` 会打开可搜索的 Windows 应用选择器——可将其绑定到桌面环境的自定义快捷方式（KDE：*系统设置 → 快捷方式 → 自定义*；GNOME：*设置 → 键盘 → 自定义快捷键*），以设置全局热键。完整 CLI、Qt6 GUI、健康检查和配置请参阅 [docs/USAGE.md](docs/USAGE.md)。
 
-## Key features
+## 主要特性
 
 <table>
 <tr><td colspan="2">
 
-**Bare-metal disguise (VM-detection avoidance)** — new in 0.7.0 · opt-in, off by default
-- Makes the Windows guest read as a **physical machine** to software that refuses to run under a detected hypervisor — Nvidia GPU-passthrough "code 43", launch-gate VM checks, VM-hostile installers
-- `pod.disguise_level balanced | max`: **balanced** hides the CPUID hypervisor bit + KVM signature and mirrors the host's real SMBIOS/DMI; **max** ("Hardened") adds a locally-built patched-QEMU image (`winpodx disguise build-image`) that rewrites the ACPI / disk / sensor / USB fingerprints and drops the virtio + Red-Hat PCI tells (keeps USB3)
-- Host-derived strings stay in the **local image only** (never committed to git); serial / UUID / asset-tag are never read
-- **al-khaser 0.82-verified** — enable with `winpodx config set pod.disguise_level max` or the GUI Settings "Bare-metal" selector
-- [Details →](docs/FEATURES.md#bare-metal-disguise-vm-detection-avoidance)
+**裸机伪装（VM 检测规避）** — 0.7.0 新增 · 可选启用，默认关闭
+- 使拒绝在已检测到的虚拟机管理程序下运行的软件将 Windows 访客机识别为**物理机**——包括 Nvidia GPU 直通「code 43」、启动门禁 VM 检查、反虚拟机安装程序
+- `pod.disguise_level balanced | max`：**balanced**（平衡）隐藏 CPUID 虚拟机管理程序位 + KVM 签名，并镜像主机真实 SMBIOS/DMI；**max**（「Hardened」加固）额外添加本地构建的修补版 QEMU 镜像（`winpodx disguise build-image`），重写 ACPI / 磁盘 / 传感器 / USB 指纹，并移除 virtio + Red-Hat PCI 标识（保留 USB3）
+- 源自主机的字符串仅保存在**本地镜像**中（绝不会提交到 git）；序列号 / UUID / 资产标签均不会被读取
+- **已通过 al-khaser 0.82 验证** — 通过 `winpodx config set pod.disguise_level max` 或 GUI 设置中的「Bare-metal」选项启用
+- [详情 →](docs/FEATURES.md#bare-metal-disguise-vm-detection-avoidance)
 
 </td></tr>
 <tr><td width="50%">
 
-**Reverse-open**
-- Linux apps appear in the Windows guest's right-click "Open with…" menu by default
-- Correct per-app icons in both the short menu and the long "Choose another app" dialog
-- Selecting one round-trips the file open to host `xdg-open`
-- Auto-discovers host-side Linux apps + their MIME associations from freedesktop standards
-- Manage via `winpodx host-open` CLI or the GUI Settings panel
-- [Details →](docs/FEATURES.md#reverse-open-linux-apps-in-windows-open-with)
-
-</td><td width="50%">
-
-**Seamless app windows**
-- RemoteApp (RAIL) renders each Windows app as a native Linux window — no full desktop
-- Per-app taskbar icons via `WM_CLASS` matching (`/wm-class:<stem>` + `StartupWMClass`)
-- Bidirectional file associations: double-click `.docx` in your file manager → Word opens
-- Multi-session RDP: bundled [rdprrap](https://github.com/kernalix7/rdprrap) auto-enables up to 10 independent sessions
-- Multi-monitor RAIL (0.6.0): a remote-app window keeps working input when dragged onto a second monitor — on by default (`cfg.rdp.multimon`, default `span`)
-- RAIL prerequisites set automatically during unattended install
-
-</td></tr>
-<tr><td width="50%">
-
-**Zero-config launch**
-- First app click auto-provisions everything: config, container, desktop entries
-- Auto-discovery on first boot scans the running Windows guest and registers every installed app with its real icon (Registry App Paths, Start Menu, UWP/MSIX, Chocolatey, Scoop)
-- Manual rescan any time via `winpodx app refresh` or the GUI Refresh button
-- Multi-backend: Podman (default), Docker, manual RDP (the libvirt backend was dropped in 0.6.0 — stay on ≤0.5.x or use the manual backend for your own libvirt domain)
-
-</td><td width="50%">
-
-**Peripherals & sharing**
-- **Clipboard**: bidirectional copy-paste (text + images) — on by default
-- **Sound**: RDP audio streaming (`/sound:sys:alsa`) — on by default
-- **Printer**: Linux printers shared to Windows — on by default
-- **Home directory**: shared as `\\tsclient\home`
-- **USB drives**: auto-mapped to drive letters (E:, F:, …) via FileSystemWatcher; subfolders work for drives plugged in after session start; the USB desktop shortcut (`\\tsclient\media`) always resolves, opening an empty folder when nothing is mounted instead of erroring
-- **Host USB / PCI device passthrough** (0.6.0): pass real host devices into the Windows guest — `winpodx device list / attach <id> / detach <id>`, a GUI "Devices" tab (two-column host↔guest mover), and a system-tray USB switcher. USB hot-plugs live (`cfg.pod.usb_live`, default on); PCI is boot-added and needs a guest restart plus a `--force` / dialog confirmation
-
-</td></tr>
-<tr><td width="50%">
-
-**Automation & security**
-- Auto suspend / resume: container pauses when idle, resumes on next launch
-- Pod auto-start on login (v0.5.9, opt-in): `winpodx autostart on` installs a tray autostart entry so the pod starts/resumes at login — off by default (`autostart off|status`, or a GUI Settings checkbox)
-- UNRESPONSIVE → recover (v0.5.5): stalled RDP guest is detected on `RUNNING → UNRESPONSIVE` and self-healed via in-guest TermService cycle, no `pod restart` needed
-- Host-adaptive Windows-on-KVM tuning profile (v0.5.5): `+invtsc`, `platform_tick` and more, gated by host capability — `tuning_profile = auto|safe|off`
-- Password auto-rotation: 20-char cryptographic password, 7-day cycle with atomic rollback
-- Smart DPI scaling: auto-detects from GNOME, KDE, Sway, Hyprland, Cinnamon, xrdb
-- Windows debloat: telemetry, ads, Cortana, search indexing disabled by default
-- FreeRDP `extra_flags` allowlist (regex-validated) as the user-input safety boundary
-- Time sync: force Windows clock resync after host sleep/wake
-
-</td><td width="50%">
-
-**Operations & resilience**
-- Multilingual UI (v0.5.9): tray / GUI / CLI fully translated to 7 languages (en / ko / zh / ja / de / fr / it), auto-detected from `$LANG` — override with `winpodx language <code>` or GUI Settings → "WinPodX UI language"
-- Windows disk auto-grow (v0.5.9): C: grows itself when it fills past a threshold while idle, bounded by host free space — or grow on demand (`winpodx install grow-disk [SIZE]`, `winpodx install disk-usage`, GUI Tools → Grow Disk)
-- Guest sync (v0.5.9): push updated agent / urlacl / rdprrap / fixes into a running guest after a host upgrade — automatic once per pod start, or `winpodx guest sync [--force]`
-- Offline / air-gapped install (`--source` + `--image-tar`)
-- One-line uninstall (keeps Windows VM data unless `--purge`)
-- Health checks via `winpodx doctor` (deps / pod / RDP / agent / disk / round-trip / password age; `--json` for machine-readable, `--quick` for cheap subset, `--fix` for idempotent auto-remediation of common findings)
-- Redesigned Qt6 GUI (0.6.0): a left Start-menu-style navigation sidebar + a new **Dashboard** home with live Pod / RAM / CPU ring gauges, disk usage, an auto-recovery status card, pinned/recent workspace tiles, and a reverse-open toggle; the app launcher is now the "All apps" page, alongside Devices / Settings / Tools / Terminal / Info — plus a lighter system tray. In-house SVG icon set, responsive reflow, and a hero search that doubles as a command bar
-- Stdlib-leaning Python (no pip-deps on 3.11+; one `tomli` fallback on 3.9 / 3.10)
+**反向打开**
+- Linux 应用默认出现在 Windows 访客机右键「打开方式…」菜单中
+- 在快捷菜单和较长的「选择其他应用」对话框中均显示正确的各应用图标
+- 选择后会将文件打开操作往返传递至主机 `xdg-open`
+- 根据 freedesktop 标准自动发现主机端 Linux 应用及其 MIME 关联
+- 通过 `winpodx host-open` CLI 或 GUI 设置面板管理
+- [详情 →](docs/FEATURES.md#reverse-open-linux-apps-in-windows-open-with)
 
 </td></tr>
 </table>
 
-See [docs/FEATURES.md](docs/FEATURES.md) for deep dives, including multi-session RDP internals, app profile schema, and the reverse-open architecture.
+</td><td width="50%">
 
-## Documentation
+**无缝应用窗口**
+- RemoteApp (RAIL) 将每个 Windows 应用渲染为原生 Linux 窗口——无需完整桌面
+- 通过 `WM_CLASS` 匹配实现按应用显示任务栏图标（`/wm-class:<stem>` + `StartupWMClass`）
+- 双向文件关联：在文件管理器中双击 `.docx` → Word 打开
+- 多会话 RDP：捆绑的 [rdprrap](https://github.com/kernalix7/rdprrap) 自动启用最多 10 个独立会话
+- 多显示器 RAIL（0.6.0）：远程应用窗口拖到第二块显示器时仍保持可用输入——默认开启（`cfg.rdp.multimon`，默认 `span`）
+- 无人值守安装期间自动配置 RAIL 前置条件
 
-| Document | What's inside |
+</td></tr>
+<tr><td width="50%">
+
+**零配置启动**
+- 首次点击应用即自动配置一切：配置、容器、桌面项
+- 首次启动时自动发现会扫描正在运行的 Windows 来宾并注册每个已安装应用及其实际图标（Registry App Paths、开始菜单、UWP/MSIX、Chocolatey、Scoop）
+- 随时通过 `winpodx app refresh` 或 GUI 刷新按钮手动重新扫描
+- 多后端：Podman（默认）、Docker、手动 RDP（0.6.0 已移除 libvirt 后端——请继续使用 ≤0.5.x，或使用手动后端连接你自己的 libvirt 域）
+
+</td><td width="50%">
+
+**外设与共享**
+- **剪贴板**：双向复制粘贴（文本 + 图片）——默认开启
+- **声音**：RDP 音频流（`/sound:sys:alsa`）——默认开启
+- **打印机**：Linux 打印机共享给 Windows——默认开启
+- **主目录**：以 `\\tsclient\home` 共享
+- **USB 驱动器**：通过 FileSystemWatcher 自动映射为盘符（E:、F:、…）；会话开始后插入的驱动器子文件夹也可用；USB 桌面快捷方式（`\\tsclient\media`）始终可用，未挂载时打开空文件夹而非报错
+- **主机 USB / PCI 设备直通**（0.6.0）：将真实主机设备传入 Windows 来宾——`winpodx device list / attach <id> / detach <id>`、GUI「Devices」标签页（双列主机↔来宾移动器）以及系统托盘 USB 切换器。USB 热插拔实时生效（`cfg.pod.usb_live`，默认开启）；PCI 在启动时添加，需要来宾重启以及 `--force` / 对话框确认
+
+</td></tr>
+<tr><td width="50%">
+
+**自动化与安全**
+- 自动挂起/恢复：空闲时暂停容器，下次启动时恢复
+- 登录时 Pod 自动启动（v0.5.9，可选）：`winpodx autostart on` 安装托盘自启动项，使 pod 在登录时启动/恢复——默认关闭（`autostart off|status`，或 GUI 设置复选框）
+- UNRESPONSIVE → 恢复（v0.5.5）：在 `RUNNING → UNRESPONSIVE` 上检测卡死的 RDP 来宾，通过来宾内 TermService 循环自愈，无需 `pod restart`
+- 主机自适应 Windows-on-KVM 调优配置（v0.5.5）：`+invtsc`、`platform_tick` 等，按主机能力门控——`tuning_profile = auto|safe|off`
+- 密码自动轮换：20 位加密密码，7 天周期，支持原子回滚
+- 智能 DPI 缩放：从 GNOME、KDE、Sway、Hyprland、Cinnamon、xrdb 自动检测
+- Windows 精简：默认禁用遥测、广告、Cortana、搜索索引
+- FreeRDP `extra_flags` 白名单（正则验证）作为用户输入安全边界
+- 时间同步：主机休眠/唤醒后强制 Windows 时钟重新同步
+
+</td><td width="50%">
+
+**运维与韧性**
+- 多语言 UI（v0.5.9）：托盘 / GUI / CLI 完整翻译为 7 种语言（en / ko / zh / ja / de / fr / it），从 `$LANG` 自动检测——通过 `winpodx language <code>` 或 GUI 设置 → "WinPodX UI language" 覆盖
+- Windows 磁盘自动扩容（v0.5.9）：空闲时 C: 在超过阈值后自动增长，受主机可用空间限制——或按需扩容（`winpodx install grow-disk [SIZE]`、`winpodx install disk-usage`、GUI Tools → Grow Disk）
+- 来宾同步（v0.5.9）：主机升级后将更新的 agent / urlacl / rdprrap / 修复推送到正在运行的来宾——每次 pod 启动自动一次，或通过 `winpodx guest sync [--force]`
+- 离线 / 气隙安装（`--source` + `--image-tar`）
+- 一行命令卸载（除非 `--purge`，否则保留 Windows VM 数据）
+- 通过 `winpodx doctor` 进行健康检查（deps / pod / RDP / agent / disk / round-trip / password age；`--json` 用于机器可读输出，`--quick` 用于轻量子集，`--fix` 用于对常见发现进行幂等自动修复）
+- 重新设计的 Qt6 GUI（0.6.0）：左侧开始菜单风格导航侧栏 + 全新 **Dashboard** 主页，含实时 Pod / RAM / CPU 环形仪表、磁盘用量、自动恢复状态卡片、固定/最近工作区磁贴及反向打开切换；应用启动器现为「All apps」页面，与 Devices / Settings / Tools / Terminal / Info 并列——以及更轻量的系统托盘。自研 SVG 图标集、响应式重排，以及兼作命令栏的主搜索框
+- 偏向标准库的 Python（3.11+ 无 pip 依赖；3.9 / 3.10 上有一个 `tomli` 回退）
+
+</td></tr>
+</table>
+
+深入细节请参阅 [docs/FEATURES.md](docs/FEATURES.md)，包括多会话 RDP 内部机制、应用配置文件架构以及反向打开架构。
+
+## 文档
+
+| 文档 | 内容 |
 |----------|---------------|
-| [INSTALL.md](docs/INSTALL.md) | Every install path — one-liner, package managers, AppImage, offline, Nix, source |
-| [USAGE.md](docs/USAGE.md) | CLI reference, Qt6 GUI tour, health checks, configuration file |
-| [FEATURES.md](docs/FEATURES.md) | Reverse-open, multi-session RDP, peripherals, app profiles, auto-discovery |
-| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | How it works (diagram), tech stack, source tree, data flows |
-| [COMPARISON.md](docs/COMPARISON.md) | WinPodX vs winapps / LinOffice / winboat, and WinPodX vs Wine |
-| [CHANGELOG.md](CHANGELOG.md) | Full version history |
-| [CONTRIBUTING.md](CONTRIBUTING.md) | Development setup and workflow |
-| [SECURITY.md](SECURITY.md) | Security disclosure process |
+| [INSTALL.md](docs/INSTALL.md) | 所有安装路径——一行命令、包管理器、AppImage、离线、Nix、源码 |
+| [USAGE.md](docs/USAGE.md) | CLI 参考、Qt6 GUI 导览、健康检查、配置文件 |
+| [FEATURES.md](docs/FEATURES.md) | 反向打开、多会话 RDP、外设、应用配置文件、自动发现 |
+| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | 工作原理（图示）、技术栈、源码树、数据流 |
+| [COMPARISON.md](docs/COMPARISON.md) | WinPodX 对比 winapps / LinOffice / winboat，以及 WinPodX 对比 Wine |
+| [CHANGELOG.md](CHANGELOG.md) | 完整版本历史 |
+| [CONTRIBUTING.md](CONTRIBUTING.md) | 开发环境搭建与工作流 |
+| [SECURITY.md](SECURITY.md) | 安全披露流程 |
 
-## Supported distros
+## 支持的发行版
 
-| Distro | Package manager | Status |
+| 发行版 | 包管理器 | 状态 |
 |--------|-----------------|--------|
-| openSUSE Tumbleweed / Leap 15.6 / Leap 16.0 / Slowroll | zypper | Tested |
-| Fedora 42 / 43 / 44 / Rawhide | dnf | Supported |
-| Fedora Silverblue / Kinoite / Sericea / Bluefin / Bazzite (42 / 43 / 44) | rpm-ostree (OBS, `--apply-live`) | Supported |
-| Debian 12 / 13, Ubuntu 24.04 / 25.04 / 25.10 / 26.04 | apt | Supported |
-| AlmaLinux / Rocky / RHEL 9 / 10 | dnf | Supported |
-| Arch / Manjaro | pacman + `yay -S winpodx` | Supported |
-| NixOS (and Nix on any distro) | nix flake | Supported |
+| openSUSE Tumbleweed / Leap 15.6 / Leap 16.0 / Slowroll | zypper | 已测试 |
+| Fedora 42 / 43 / 44 / Rawhide | dnf | 支持 |
+| Fedora Silverblue / Kinoite / Sericea / Bluefin / Bazzite（42 / 43 / 44） | rpm-ostree（OBS，`--apply-live`） | 支持 |
+| Debian 12 / 13，Ubuntu 24.04 / 25.04 / 25.10 / 26.04 | apt | 支持 |
+| AlmaLinux / Rocky / RHEL 9 / 10 | dnf | 支持 |
+| Arch / Manjaro | pacman + `yay -S winpodx` | 支持 |
+| NixOS（及任意发行版上的 Nix） | nix flake | 支持 |
 
-Each tag push (`v*.*.*`) publishes to all channels automatically — see [packaging/](packaging/) for maintainer details.
+每次标签推送（`v*.*.*`）会自动发布到所有渠道——维护者详情请参阅 [packaging/](packaging/)。
 
-## Testing
+## 测试
 
 ```bash
 # From repo root (no install needed)
@@ -271,15 +280,15 @@ ruff check src/ tests/      # Lint
 ruff format --check src/ tests/
 ```
 
-## Contributing
+## 贡献
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, branch naming, commit conventions, and CI expectations.
+开发环境搭建、分支命名、提交规范及 CI 要求请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
 
-## Security
+## 安全
 
-For security issues, follow the process in [SECURITY.md](SECURITY.md).
+安全问题请遵循 [SECURITY.md](SECURITY.md) 中的流程。
 
-## Star History
+## Star 历史
 
 <a href="https://star-history.com/#kernalix7/winpodx&Date">
   <picture>
@@ -289,16 +298,16 @@ For security issues, follow the process in [SECURITY.md](SECURITY.md).
   </picture>
 </a>
 
-## Support
+## 支持
 
-If WinPodX makes your Linux desktop a little nicer:
+如果 WinPodX 让你的 Linux 桌面更好用一些：
 
 [![GitHub Sponsors](https://img.shields.io/badge/Sponsor-GitHub-EA4AAA?logo=githubsponsors&logoColor=white&style=for-the-badge)](https://github.com/sponsors/kernalix7)
 [![Ko-fi](https://img.shields.io/badge/Ko--fi-F16061?logo=ko-fi&logoColor=white&style=for-the-badge)](https://ko-fi.com/kernalix7)
 [![Fairy](https://img.shields.io/badge/🧚_Fairy-EE6E73?style=for-the-badge&logoColor=white)](https://fairy.hada.io/@kernalix7)
 
-GitHub Sponsors supports recurring or one-time sponsorship; Ko-fi handles international cards and PayPal; fairy.hada.io is a Korean tipping platform. Bug reports, PRs, and stars on the repo are equally appreciated and free.
+GitHub Sponsors 支持定期或一次性赞助；Ko-fi 支持国际银行卡和 PayPal；fairy.hada.io 是韩国打赏平台。Bug 报告、PR 和给仓库点 Star 同样受欢迎，而且免费。
 
-## License
+## 许可证
 
 [MIT](LICENSE) — Kim DaeHyun (kernalix7@kodenet.io)