xtool：跨平台桌面工具 #
xtool 是什么？ #
xtool 是一款以 xtool.sh 为官方发布站点的跨平台工具软件，官方同时提供面向 Linux 的 aarch64 / x86_64 双架构 AppImage 免安装镜像，以及面向 macOS 的 xtool.app.zip 应用包。
它的定位是让用户在 Linux 与 macOS 上使用同一套工具链：Linux 用户下载 AppImage 后赋予执行权限即可启动，无需 root 权限、无需配置软件源；macOS 用户解压后即可得到原生 .app 应用包，拖入「应用程序」文件夹就能使用。对于经常在两种系统之间切换、又不想为每台设备重复折腾环境配置的开发者与效率用户来说，xtool 提供了一种「下载即用」的轻量方案。
说明：截至本文撰写时，官方文档页
https://xtool.sh/documentation/xtool/为 JavaScript 动态渲染页面，公开抓取工具仅能获取到「Documentation / © xtool maintainers / Powered by Netlify」等页面框架信息。因此下文中的功能与操作描述，均以官方公开的安装包形态、站点结构与通用打包规范为依据，具体功能细节请以官方文档页面为准。
xtool 有哪些亮点特色？ #
-
一套工具，覆盖两大桌面平台：官方同时维护 Linux 与 macOS 两个平台的分发包，Linux 用户拿到的是 AppImage，macOS 用户拿到的是
.app.zip，跨系统协作时不必再分别寻找替代方案。 -
Linux 端免安装，下载即用：Linux 版本以 AppImage 形式分发，不需要
apt/dnf/pacman等包管理器介入，也不需要 root 权限，把文件放进任意目录、赋予执行权限后双击或命令行启动即可运行。 -
原生支持 ARM64 与 x86_64 双架构：官方分别打包了
xtool-aarch64.AppImage与xtool-x86_64.AppImage，无论是 Apple Silicon 上的 Linux 虚拟机、树莓派类 ARM 设备，还是主流的 x86_64 桌面与服务器，都能找到对应的构建版本。 -
macOS 采用原生应用包分发：macOS 版本以
xtool.app.zip形式提供，解压后即为标准的.app应用包，可以像普通 Mac 软件一样拖入「应用程序」目录、固定在 Dock 中或通过聚焦搜索启动。 -
体积克制，便于随身携带：三份安装包体积分别为 52.1 MB、54.0 MB 与 25.7 MB，其中 Linux AppImage 可以放在 U 盘或同步盘中随身携带，在不同机器上直接运行，不会污染宿主系统的包管理环境。
-
由官方维护者持续维护：站点由 xtool maintainers 维护并托管于 Netlify，文档中心采用独立的
/documentation/xtool/路径，说明项目具备持续的文档与版本维护机制。
免费下载 xtool #
以下为官方提供的各平台安装包，点击链接即可下载。请根据你的操作系统与 CPU 架构选择对应文件。
| 文件名 | 描述 | 大小 | 下载 |
|---|---|---|---|
xtool-aarch64.AppImage |
Linux ARM64（aarch64）免安装镜像，适用于 Apple Silicon 虚拟机、ARM 开发板及 ARM 服务器 | 52.1 MB | 夸克网盘 |
xtool-x86_64.AppImage |
Linux x86_64 免安装镜像，适用于主流 Intel / AMD 桌面与服务器 | 54.0 MB | 夸克网盘 |
xtool.app.zip |
macOS 应用包，解压后得到 xtool.app |
25.7 MB | 夸克网盘 |
提示：下载前请先确认自己的系统架构。Linux 下可在终端执行
uname -m，输出aarch64或arm64时选择 aarch64 版本，输出x86_64时选择 x86_64 版本。
xtool 如何使用？ #
xtool 的使用流程非常直接，初次接触的用户按照以下步骤即可完成从下载到启动的全过程：
-
确认系统架构：在 Linux 终端执行
uname -m查看 CPU 架构；macOS 用户可直接选择xtool.app.zip，无需额外判断。 -
下载对应安装包：从上方的下载表格中选择与你的系统匹配的文件，通过夸克网盘下载到本地。
-
Linux 用户赋予执行权限：进入文件所在目录，执行
chmod +x xtool-*.AppImage，随后双击文件，或在终端中执行./xtool-x86_64.AppImage启动。 -
macOS 用户解压并移动：双击
xtool.app.zip完成解压，将得到的xtool.app拖入「应用程序」文件夹，然后双击启动。 -
查阅官方文档了解具体功能：由于 xtool 的功能入口与命令参数会随版本迭代变化，建议在启动后访问官方文档页
https://xtool.sh/documentation/xtool/获取与当前版本对应的操作说明。
若 xtool 提供命令行子命令，可在终端中尝试
./xtool-x86_64.AppImage --help查看当前版本支持的全部参数（具体以实际输出为准）。
xtool 的常见问题？ #
xtool 支持哪些操作系统？
根据官方提供的下载文件，xtool 目前覆盖 Linux（aarch64、x86_64 两种架构的 AppImage）与 macOS（.app.zip）两个平台。官方下载列表中未提供 Windows 安装包，Windows 用户暂时无法直接使用官方分发包。
xtool 是免费的吗？
官方下载入口提供的安装包可直接获取，未设置付费墙或授权码环节。如果你关注后续是否会有增值服务或商业授权，建议以官网 https://xtool.sh/ 的最新公告为准。
Linux 下双击 AppImage 没有反应怎么办？
最常见的原因是文件缺少执行权限，执行 chmod +x xtool-x86_64.AppImage 即可解决。如果仍然无法启动，可能是系统缺少 FUSE 支持（Ubuntu 22.04 及以上版本需要安装 libfuse2），此时可以改用 ./xtool-x86_64.AppImage --appimage-extract 解包后运行。
macOS 提示「无法打开，因为 Apple 无法检查其是否包含恶意软件」怎么办？
这是 Gatekeeper 对非 App Store 应用的常规拦截。可以在「系统设置 → 隐私与安全性」中点击「仍要打开」，或在终端执行 xattr -dr com.apple.quarantine /Applications/xtool.app 移除隔离属性后再启动。
如何判断该下载 aarch64 还是 x86_64 版本？
在 Linux 终端执行 uname -m：输出 aarch64 或 arm64 时选择 aarch64 版本；输出 x86_64 或 amd64 时选择 x86_64 版本。选错架构会导致程序无法执行。
文档页打开后是空白怎么办？
https://xtool.sh/documentation/xtool/ 是一个依赖 JavaScript 渲染的页面，需要浏览器启用 JavaScript 才能正常显示内容。如果长期空白，可以尝试更换浏览器、关闭广告拦截插件，或直接访问官网首页 https://xtool.sh/ 寻找文档入口。
xtool 如何安装？ #
xtool 在两个平台上都采用「免安装」的分发形式，严格来说不需要传统的安装流程，但为了让程序更好地融入系统，建议按以下方式处理。
Linux（AppImage） #
- 从下载表格中下载与你的 CPU 架构匹配的 AppImage 文件。
- 将文件移动到一个固定目录，例如
~/Applications/：mkdir -p ~/Applications && mv xtool-*.AppImage ~/Applications/ - 赋予执行权限：
chmod +x ~/Applications/xtool-x86_64.AppImage - 直接运行：
~/Applications/xtool-x86_64.AppImage - （可选）如需在应用菜单中显示图标，可使用 AppImageLauncher 等工具，或手动创建
.desktop文件放入~/.local/share/applications/。 - （可选）若系统提示缺少 FUSE，安装运行时依赖：
sudo apt install libfuse2 # Debian / Ubuntu
注意：AppImage 不会向系统目录写入文件，也不依赖包管理器，因此升级时只需用新版本文件替换旧文件即可。
macOS（.app.zip） #
- 下载
xtool.app.zip并双击解压，得到xtool.app。 - 将
xtool.app拖入「应用程序」（Applications）文件夹。 - 首次启动时，在「应用程序」中右键点击
xtool.app，选择「打开」，然后在弹窗中确认「打开」。 - 如果系统提示应用已损坏或来自未验证的开发者，请在终端执行：
xattr -dr com.apple.quarantine /Applications/xtool.app - 启动成功后，可将图标固定在 Dock 中以便随时调用。
注意：macOS 版本未通过 App Store 分发，因此每次系统大版本更新后，可能需要重新确认一次安全授权。
xtool 如何卸载？ #
由于 xtool 采用免安装的分发方式，卸载过程同样简单，主要工作是删除程序本体与可能残留的配置文件。
Linux #
- 关闭正在运行的 xtool 进程。
- 删除 AppImage 文件本身：
rm ~/Applications/xtool-*.AppImage - 如果之前创建过桌面快捷方式，一并删除：
rm ~/.local/share/applications/xtool.desktop - 检查并清理用户目录下可能残留的配置与缓存（目录名以实际版本为准）：
ls -d ~/.config/xtool ~/.cache/xtool ~/.local/share/xtool 2>/dev/null rm -rf ~/.config/xtool ~/.cache/xtool ~/.local/share/xtool - 如果使用过
--appimage-extract解包运行，请同时删除解包生成的squashfs-root目录。
macOS #
- 退出正在运行的 xtool。
- 打开「访达 → 应用程序」，将
xtool.app拖入废纸篓，或右键选择「移到废纸篓」。 - 清空废纸篓以彻底删除程序本体。
- 如需一并清理配置文件与缓存，可在「访达」中按下
Command + Shift + G，依次前往并删除以下目录中与 xtool 相关的文件：~/Library/Application Support/xtool~/Library/Preferences/sh.xtool.*~/Library/Caches/xtool~/Library/Logs/xtool
- 如果曾在「系统设置 → 隐私与安全性 → 辅助功能 / 完全磁盘访问权限」中为 xtool 授权，建议在卸载后手动移除对应条目。
提示：卸载前建议先备份配置文件（若存在），以免后续重新安装时需要重新配置。