XCOrganizer 是一款专为 macOS 设计的 X-Plane 飞行模拟器地景库管理工具。它通过智能排序、冲突检测和直观的可视化界面，帮助用户高效管理庞杂的地景文件，确保飞行模拟体验的稳定与真实。本指南将详细介绍其核心功能与完整操作流程。

一、核心界面与工作区详解

XCOrganizer 的主界面设计清晰，主要分为四个功能区域。

顶部工具栏：包含核心操作按钮，如“检查自定义地景”、“启用/禁用选中的地景”、“验证地景顺序”以及“打开 X-Plane 日志”等。
左侧地景库列表（主工作区）：以可折叠的树状结构展示所有已扫描到的地景包。每个地景包前有复选框用于启用或禁用，并通过颜色和图标直观显示状态（如绿色对钩表示正常，黄色感叹号表示警告，红色叉号表示错误或冲突）。
中部信息与预览面板：当选中某个地景包时，此处会显示其详细信息，包括名称、作者、依赖库要求以及可能存在的冲突或问题描述。对于支持的地景，还会显示缩略图预览。
底部日志与状态栏：实时显示软件操作日志（如扫描、检查结果），并提供当前地景库状态的概览信息。

二、完整操作流程：从项目到导出

首次启动 XCOrganizer，或需要管理不同的 X-Plane 安装时，需指定其根目录。

具体方法：

启动 XCOrganizer。
在菜单栏点击 File -> Select X-Plane Folder...。
在弹出的 Finder 窗口中，导航并选择你的 X-Plane 安装根目录（即包含 X-Plane.app、Custom Scenery 等文件夹的目录）。
点击“打开”。软件将自动扫描 Custom Scenery 文件夹，并加载所有地景包。

位置：菜单栏 File 菜单。
快捷键：Command + O。

加载地景后，必须进行系统检查以发现潜在问题。

具体方法：

位置：顶部工具栏左侧第一个按钮。
快捷键：Command + R。

这是 XCOrganizer 的核心功能，确保地景按正确顺序加载。

具体方法：

启用/禁用：在左侧列表中，直接点击地景包名称前的复选框，可快速启用或禁用地景，无需移动文件。
手动排序：拖拽地景包条目上下移动，即可改变其在 scenery_packs.ini 文件中的顺序。通常规则是：机场最上，叠加地景次之，最后是基础网格地景。
自动排序建议：点击工具栏的 “Validate Scenery Order” 按钮，软件会根据最佳实践分析当前顺序，并在日志中给出调整建议（通常以“建议将 [地景A] 移动到 [地景B] 之上/下”的形式呈现）。用户可根据建议手动拖拽调整。

位置：通过拖拽手动排序；“Validate Scenery Order”按钮在工具栏。
快捷键：启用/禁用选中地景：Command + E。

根据步骤2的检查结果，逐一解决标识出的问题。

具体方法：

对于缺失库文件：信息面板会提示所需库名称。你需要自行获取并安装这些依赖库到 Custom Scenery 文件夹中，然后再次执行“检查”。
对于排序冲突（如两个地景覆盖同一区域）：按照步骤3的自动排序建议或遵循“机场优先，区域性地景其次”的原则，通过拖拽调整顺序。被覆盖的地景应放在更低的位置。
对于已禁用的地景包：如果你确认不再需要，可以右键点击该地景包，选择 Remove from list (not from disk) 将其从列表中移除（文件仍保留在磁盘）。

完成所有调整后，保存你的工作成果。

具体方法：

保存更改：XCOrganizer 的更改（启用状态和排序）是实时写入到 X-Plane 的 Custom Scenery/scenery_packs.ini 文件中的。关闭软件即意味着保存。
创建备份（推荐）：在菜单栏点击 File -> Backup scenery_packs.ini...，将当前稳定的配置文件保存到安全位置。
导出报告：点击 File -> Export Scenery List...，可以将当前的地景库列表和状态导出为文本文件，用于存档或分享。

位置：菜单栏 File 菜单。
快捷键：备份：Command + S；导出列表：Command + Shift + S。

批量操作：使用 Command + 点击 或 Shift + 点击 在左侧列表中选中多个地景包，然后右键或使用顶部工具栏按钮，可以批量启用、禁用或更改分组。
智能分组：右键点击地景列表，选择 Create Group...，可以将相关地景（如“欧洲机场”、“必备库文件”）放入自定义组中，便于折叠管理和整体移动。
快速分析日志：点击工具栏的 Open X-Plane Log 按钮，XCOrganizer 会直接调用控制台或文本编辑器打开 X-Plane 的最新日志文件，方便与软件内的检查结果对照排查复杂问题。
忽略特定警告：对于某些已知且无害的警告（如特定库文件的非关键提示），可以在该地景包的右键菜单中选择 Ignore this warning，使其在后续检查中不再显示。

问题现象	可能原因	解决方案
启动X-Plane后，部分地景未加载或显示错误。	1. 地景在XCOrganizer中被禁用。 2. 地景排序错误，被其他地景覆盖。 3. 依赖库缺失或未启用。	1. 在XCOrganizer中检查并启用该地景。 2. 使用“验证地景顺序”功能并调整排序，确保该地景（尤其是机场）位于覆盖它的区域地景之上。 3. 运行“检查自定义地景”，根据提示安装并启用所有必需的库文件。
XCOrganizer检查后显示大量“找不到纹理”或“无法读取”错误。	地景包文件损坏、下载不完整或版本与当前X-Plane不兼容。	尝试重新下载该地景包。如果问题依旧，请访问地景开发者页面查看是否支持当前X-Plane版本。
拖拽排序后，顺序在下次启动时似乎复原了。	可能未正确保存，或X-Plane在启动时因致命错误自动重置了`scenery_packs.ini`。	1. 确保在关闭XCOrganizer前已看到“操作完成”之类的日志提示。 2. 检查X-Plane根目录下`scenery_packs.ini`文件的修改时间是否已更新。 3. 使用XCOrganizer的备份功能恢复到一个已知良好的配置，然后重新调整。
软件无法识别我的X-Plane安装目录。	选择的目录不正确，或X-Plane版本过旧。	请确保选择的是包含`X-Plane.app`（或执行文件）、`Resources`、`Custom Scenery`等文件夹的最顶层根目录。确认你的X-Plane版本在11或以上。