桌面客户端
Qubix Drive 桌面应用程序将您的 Qubix 内容挂载为本地磁盘。该磁盘看起来与普通文件夹和文件无异，您保存的每一处更改都会直接写回 Qubix 服务器——其工作方式与 Google Drive 桌面版相同。它让您可以在 VS Code、vim 或任何工具中进行编辑，并使用 cp、mv 或 rsync 复制文件。
磁盘内容
挂载的磁盘包含三个顶级文件夹：
websites/— 每个站点对应一个文件夹，包含其真实的文件树（index.html、static/…、图片）。保存文件会上传新版本，站点会保留其历史记录，与在面板中编辑时完全相同。scripts/— 您的自动化脚本，每个脚本为一个.js文件，包含脚本代码。计划、启用/停用状态和描述保留在面板中。drive/— 您的 Drive 文件夹和页面。
您只能看到您的账户有权访问的内容，服务器决定您可以更改哪些内容——与面板中的访问权限相同。
1. 安装 FUSE 驱动
该应用通过名为 FUSE 的系统组件以磁盘形式呈现自身。请首先为您的系统安装对应的驱动：
- macOS — macFUSE
- Windows — WinFsp
- Linux — libfuse
若未安装，应用可以启动，但无法挂载，并会提示您缺少驱动。
2. 下载应用
在面板中打开 下载 页面，下载适用于您系统的 Qubix Drive。
该应用尚未通过 Apple 公证。如果 macOS 在首次启动时阻止它，请在 系统设置 → 隐私与安全 中允许运行，然后重新打开。
3. 登录
使用 login 命令运行应用，提供您的面板地址和账户邮箱。系统会要求您输入密码。
地址可以粘贴从面板复制的任意链接——仅使用其中的地址部分。会话会保存在您的计算机上，因此只需登录一次。随时可通过 qubix-fs whoami 查看当前状态。
4. 挂载磁盘
macOS 和 Linux — 指定一个文件夹作为挂载点：
qubix-fs mount ~/QubixDrive
磁盘将以名为 Qubix 的卷的形式出现。
Windows — 直接运行 qubix-fs mount，磁盘将以 Q:\ 的形式出现。
保持命令运行——这样可以保持磁盘连接。按下 Ctrl-C，或运行 qubix-fs unmount ~/QubixDrive，即可断开连接。
使用磁盘
像使用普通磁盘一样打开、编辑和保存文件——每次保存都会同步回服务器。有几点与普通本地磁盘的行为有所不同：
- 脚本无法从磁盘中删除。 为避免意外删除正在运行的自动化脚本，删除脚本文件的操作会被拒绝——请在面板中删除脚本。站点文件可以删除（历史记录会被保留）。
- 每个文件夹只能添加对应类型的文件。 新脚本以
.js文件形式放在scripts/下；新 Drive 页面放在drive/下。不能仅通过在根目录下创建文件夹来新建站点、脚本或顶级项目。 - 名称可能会带有简短后缀。 当两个项目同名时，应用会在括号中添加一段短码——例如
My landing [a1b2c3d4]——以区分各项。该短码仅用于区分同名项目。 - 无离线模式。 磁盘是服务器内容的实时视图。如果连接中断，保存操作将失败，直到连接恢复——不会进行排队。被拒绝的保存（例如脚本存在语法错误）不会影响已存储的版本。
- 访问权限由服务器控制。 如果您没有权限更改某内容，保存操作将被拒绝——与面板中的规则相同。
如果您的会话过期或被撤销，磁盘将无法连接到服务器，应用会提示您重新连接。再次运行 login 命令即可恢复连接。