从 Mac App Store 安装的盘屿，请看 App Store 版帮助。
第一次使用
- 跟着向导完成设置第一次打开盘屿会弹出设置向导，共三步：允许盘屿在后台运行、启用盘屿的文件系统扩展（“文件系统扩展”列表里的“盘屿 NTFS”）、允许盘屿读取磁盘（完全磁盘访问）。每一步点按钮会直接打开对应的系统设置页面，按提示打开开关即可，打开后向导会自动打勾。中途关掉也没关系，可以在设置的“首次使用”中继续。
- 插入磁盘插入 NTFS 移动硬盘或 U 盘。盘屿在后台检查，通过后自动开启读写，侧栏会显示“可读写”。
- 照常使用在 Finder 和其他应用里新建、编辑、保存、移动或删除文件。
- 推出在盘屿或 Finder 中推出后再拔线。提示磁盘正被使用时，先关闭占用它的应用。
磁盘只读了怎么办
选中这块盘，点“读写不了？检查一下”：盘屿会逐项检查开启读写需要的条件——后台组件、完全磁盘访问、文件系统扩展、这块盘本身，以及上次没成功的原因——每项不通过都附有处理办法，很多可以一键处理。也可以看窗口底部的提示，按提示处理：
- 窗口顶部提示“还差一步”，文件系统扩展还没打开：打开“系统设置 → 通用 → 登录项与扩展 → 文件系统扩展”，打开“盘屿 NTFS”右边的开关。“按 App”页面里盘屿下面的“FSKit Modules”开关不用管，打不开也没关系。不需要重启，打开后把磁盘拔下再插上，或点盘屿右上角的刷新。
- 上次在 Windows 中没有安全弹出：把磁盘接回 Windows，打开一次，然后用任务栏的“安全删除硬件”弹出，再插回 Mac。
- Windows 处于休眠或“快速启动”：在那台 Windows 电脑上完全关机后再插回 Mac。
- 磁盘需要检查：在 Windows 中打开磁盘属性 → 工具 → 检查，完成后安全弹出。没有 Windows 时，可点提示旁的“在 Mac 上检查…”：盘屿只读检查全部文件和文件夹记录，没有发现问题才清除标记并开启读写。它不等同于 Windows 的完整磁盘检查，重要且没有备份的数据建议优先在 Windows 中检查。如果提示“文件记录有问题”，说明这块盘确实需要 Windows 的磁盘检查，文件仍可以只读打开和拷出；没有 Windows 电脑时，也可以把盘接到 Mac 上的 Windows 虚拟机里检查。如果提示“有一部分内容读不出来”，先换根数据线或换个接口再试。
其他提示：
- 上次读写时被直接断开：插回时盘屿会先自动把盘恢复到断开前的一致状态，再开启读写。如果提示“恢复前的安全核对没有通过”，磁盘保持只读、没有做任何修改，文件仍可以拷出，请导出诊断并反馈；如果提示“这次没能完成恢复”，拔下后重新插入再试。
- 写保护：拨开磁盘或读卡器上的写保护（锁定）开关，再重新插入。
- 没能以读写方式挂载：重启 Mac 后重新插入。仍然出现时，在设置 → 支持中导出诊断并通过下方反馈页告诉我们。
- 盘屿的文件系统扩展意外退出：这块盘在重启 Mac 前无法读写或推出。保存好其他工作后重启 Mac，再插上这块盘，盘屿会自动回到最后一致的状态（退出前约 20 秒内的改动会被撤销）。
- 文件系统扩展没有开启写入：检查磁盘或读卡器的写保护开关；如果这块盘上次写入时被直接拔掉，接回 Windows 打开一次并安全弹出后再插回。
如果是在 Mac 上写入时意外断开，盘屿会在下次连接时自动恢复，无需处理。
拷贝时拔了线怎么办
磁盘本身不用处理：重新插上后，盘屿会自动把盘恢复到拔线前约 20 秒的一致状态，再开启读写。但正在进行的拷贝会中断，拔线前约 20 秒内拷完的文件也会一并退回：
- 用盘屿拷贝的（推荐）：在可读写的盘上点“拷贝到这块盘…”，或把文件拖进盘屿窗口。拔线、推出或退出盘屿后，盘插回并开启读写，盘屿会先核对已经拷好的部分，再自动接着拷，被退回的文件也会补齐，不用重新选择。
- 用访达拷贝的：插回后把同一批文件再拖一次。提示有同名项目时，确定已经完整拷完的可以选“跳过”；拔线时正在拷的那个文件只有前面一部分，要选“替换”。如果这次是在覆盖盘上的旧文件，或者拿不准，全部选“替换”最稳妥，否则可能留下不完整的文件或旧版本。
- 文件很多或很大时：可以在“终端”中运行
rsync -a --progress 源文件夹/ 目标文件夹/。拔线后插回，再运行同一条命令，它会跳过已经拷完的文件，只补拷没完成的（被打断的那个文件会从头拷）。
能先推出再拔线就尽量先推出。
抹掉为 NTFS
在右上角“更多”菜单中选择“抹掉磁盘…”，选择外接 USB 磁盘，再选择抹掉整块磁盘（GUID 或 MBR 分区表）或单个 Windows 数据分区，输入名称后确认。抹掉会删除全部数据且无法撤销；内置盘、系统盘和挂着 Mac 卷的磁盘不会出现在可选列表里。完成后可在 Windows 和 Mac 上读写。
BitLocker 加密的磁盘
插入后，侧栏会显示“BitLocker · 已锁定”。选中它，输入密码，或切换到“恢复密钥”输入 48 位数字，点“解锁”。解锁后自动打开 Finder，可以像普通磁盘一样拷贝、修改和删除文件。用完先点“锁定”或在 Finder 中推出，再拔线；直接拔线的话，下次解锁会先撤回拔线前约 20 秒内的写入。如果盘需要检查、来自休眠的 Windows 或上次没有安全弹出，会以只读方式打开，并说明原因；BitLocker 盘需要检查时请在 Windows 中检查（“在 Mac 上检查…”只用于普通 NTFS 盘）。恢复密钥通常保存在你的 Microsoft 账户（aka.ms/myrecoverykey）、打印件或开启 BitLocker 时保存的文件里。密码只用于本次解锁，不会保存。正在加密或解密中的磁盘请等 Windows 完成后再试。Windows 7 默认的“带扩散器的 AES”加密方式不支持，盘屿会说明原因。
常见问题
盘屿收费吗？
官网版免费，源码以 GNU GPL v2 开放。没有账号、订阅或内购。
为什么我的 NTFS 磁盘是只读的？
盘屿每次开启读写前都会检查磁盘。如果这块盘上次在 Windows 中没有安全弹出、Windows 处于休眠或“快速启动”，或者磁盘被标记为需要检查，盘屿会保持只读，并在窗口底部说明原因和处理方法。
需要哪些授权？
第一次使用时，在盘屿设置里启用文件系统扩展、允许后台组件，并为盘屿开启完全磁盘访问。之后插入磁盘即可使用，不需要每次输入密码，也无需关闭系统完整性保护（SIP）。
哪些 Mac 可以使用？
需要 macOS 15.4 或更高版本。Apple 芯片 Mac 正式支持；Intel Mac 为测试版支持，还没有在 Intel 真机上验证。目前在 macOS 27.2 上完成了实体硬盘的完整验证；macOS 26.6 上完成了安装和磁盘镜像读写验证；macOS 15.6.1 上在虚拟机里验证了主要磁盘流程；其他版本尚未验证。注意：macOS 15.7.7、15.8 和 15.8.1 暂不支持读写挂载，见下一条。
macOS 15.7.7、15.8 或 15.8.1 上开启读写失败怎么办？
这些版本暂不支持盘屿的读写挂载，目前暂无有效解决方案。我们已在 15.7.7、15.8.1 复现系统 FSKit 异常，Apple 自带的 FAT 模块使用相同挂载路径也失败；15.8 有同类用户反馈。重新安装或授权不是已验证的解决办法。文件仍可只读打开和拷出；如考虑升级，请先查看兼容性页面中已验证的版本和测试范围。在“系统设置 → 通用 → 关于本机”查看系统版本。
在 Windows 上没弹出就拔了盘，怎么办？
插到 Mac 上仍能打开和复制文件，但盘屿会先保持只读，因为 Windows 还有没写完的改动，此时在 Mac 上写入可能损坏磁盘。拔盘那一刻 Windows 正在写的文件可能不完整，其他文件不受影响。处理方法：把盘插回任意一台 Windows 电脑，打开一次，再用“安全删除硬件”弹出，插回 Mac 就会自动开启读写；如果 Windows 提示磁盘有错误，先在“属性 → 工具 → 检查”中修复。都不需要格式化。暂时没有 Windows 电脑时，可以先把重要文件复制出来。如果盘有异响、无法识别或读取大量出错，请先停止写入，交给专业数据恢复工具或服务处理。
没推出就拔线会怎样？
盘屿会记录每次写入，下次连接时先恢复，再开启读写。移动硬盘自身的写入缓存断电会丢失，所以盘屿会把拔线前约 20 秒内的写入一并退回，回到确定已写进硬盘的状态；这段时间里拷贝的文件需要重新拷贝（重拷时怎么选，见帮助页“拷贝时拔了线怎么办”）。请尽量先推出再拔线。
是否支持加密磁盘？
BitLocker 加密的磁盘可以用密码或恢复密钥解锁后读写，和普通 NTFS 盘一样有拔线保护；EFS 加密文件暂不支持。盘屿不提供磁盘修复或数据恢复。
如何推出和卸载？
在盘屿或 Finder 中推出磁盘。如果提示磁盘正被使用，先关闭占用它的应用再试，盘屿不会强制推出。卸载时先推出所有磁盘，关闭“登录时启动盘屿”，在设置中移除后台组件，再退出并删除应用；完整步骤见“帮助”页的“卸载”。
导出诊断
在设置 → 支持中选择“导出诊断…”，或在“读写不了？检查一下”里导出。报告包含系统与组件状态、外接盘的类型和连接方式、最近 20 次磁盘操作的结果，以及盘屿最近 24 小时的运行记录（已去掉路径、名称和磁盘标识），不含卷名、完整路径或文件内容。导出前可以先预览；反馈问题时附上它，通常不用来回询问就能看出卡在哪一步。
反馈问题
遇到问题或有建议，可以在 GitHub 反馈页提交（需要 GitHub 账号）。请写明 macOS 版本、盘屿版本和窗口里的提示；附上导出的诊断报告最有帮助。提交前请检查一遍，不要贴出卷名、文件路径等个人信息。
更新
盘屿会自动检查更新，也可以在设置中手动检查。安装更新前会先安全结束磁盘读写，磁盘正被使用时会等待。
卸载
- 推出磁盘在盘屿或 Finder 中推出所有 NTFS 磁盘。
- 关闭登录启动打开设置（⌘,），在“通用”中关闭“登录时启动盘屿”。
- 移除组件在设置 → 支持中展开“NTFS 引擎”，点“移除组件”，看到后台组件显示“尚未设置”即可。
- 删除应用退出盘屿（⌘Q），把“应用程序”中的“盘屿”拖到废纸篓。
完成以上步骤后，盘屿不会再在后台运行，文件系统扩展也会从系统设置中消失。磁盘上的文件不受影响，NTFS 磁盘之后仍可由 macOS 以只读方式打开。
彻底清除（可选）
系统会保留几个很小的设置和缓存文件（合计不到 1 MB），不影响使用。如需一并删除，请先确认每块 NTFS 磁盘最近一次都是正常推出的：写入中断后的恢复记录就保存在其中，删除后将无法再自动恢复。然后在 Finder 中按 ⇧⌘G，逐个前往并删除：
~/Library/Containers/top.qisw.volisle.filesystem~/Library/Application Scripts/top.qisw.volisle.filesystem~/Library/Preferences/top.qisw.volisle.plist~/Library/Caches/top.qisw.volisle~/Library/HTTPStorages/top.qisw.volisle
后台组件还在系统目录中留下一个空的锁文件，可在“终端”中运行以下命令删除（需要输入管理员密码）：
sudo rm -r /private/var/db/volisle