文件格式、导入与导出¶

GhostClickAI 当前使用 .gcbp 保存独立蓝图，使用 .gcbps 保存可挂载的自动化包，并在文件管理中统一管理 .onnx 模型。选择格式时，先判断要移动的是“一张蓝图”“一整套有顺序的自动化”，还是“供节点选择的模型”。

格式说明¶

.gcbp：独立蓝图¶

.gcbp 保存一张蓝图的节点、连线、变量和随蓝图持久化的数据。它没有自动化工作区中的蓝图顺序，也不代表一个 App 分页。

从文件管理普通拖入或粘贴 .gcbp 时，软件会复制蓝图正文并生成新的包内身份，因此两边可以分别修改。使用“添加到预设”或“粘贴引用”时则保留原蓝图身份，来源修改会影响引用步骤。

.gcbps：自动化包¶

.gcbps 保存自动化名称、蓝图正文、步骤顺序、步骤级设置以及包内资源关系。自动化工作区左侧的自动化条目本质上是对一个 .gcbps 文件的挂载。

同一个 .gcbps 可以挂载到多个位置。选择“直接挂载”时，这些位置编辑的是同一文件；选择“创建副本并挂载”时，会生成一个新 ID 的独立包，两边之后互不影响。

.onnx：模型资源¶

.onnx 是供支持模型输入的识图类节点选择的资源。文件管理可以创建、导入、重命名、移动和重新识别模型类型，但 ONNX 本身不是蓝图或自动化，不能作为步骤挂载。

把 ONNX 导入文件管理只表示模型进入本机资源库。节点真正选择模型后，蓝图才会建立对应的资源引用；更换选择后应检查内嵌资源状态和运行提示。

模型标记、第三方状态与本地缓存¶

软件自己生成或经“识别 / 重新识别”成功处理的模型，会把 GhostClickAI 的类型标记写入 .onnx 本体。旁边的 <模型名>.onnx.json 只是可删除、可重建的本地加载缓存，不是模型身份，也不会作为资源或云盘文件上传；在文件管理删除模型时，这份缓存会一起删除。

没有本体标记的外部模型不会仅凭文件名猜类型。支持 ONNX 的节点仍可在下拉菜单中把它显示为“第三方”，由用户自行尝试；已经带有明确类型标记但不符合当前节点能力的模型会被过滤。实际能否运行还取决于该节点需要的输入、输出和运行时兼容性。

上传 ONNX 前，软件会检查本体标记；未标记的模型会先尝试识别、写入并复核，失败时不会上传。节点选择文件管理中的模型后，会把模型复制进根蓝图的 ONNX 资源池并建立引用；改选模型后，旧模型按已使用、未使用或受保护状态进入同一资源生命周期。

从外部导入到文件管理¶

拖入单个文件¶

把 .gcbp、.gcbps 或 .onnx 拖到文件管理区域：

1. 软件读取并检查文件。
2. .gcbp 和 .gcbps 会复制到当前选中或展开的标签；没有明确目标时使用默认标签。
3. .onnx 会作为模型资源复制到目标标签。
4. 导入完成后，文件管理选中刚创建的项目或显示导入数量。

导入是复制到软件管理目录，不会继续引用外部原路径。之后修改外部原文件，不会自动更新已经导入的资源。

拖入文件夹¶

在文件管理页面拖入文件夹，会以文件夹名称创建或复用标签，并导入该文件夹第一层中的 .gcbp 和 .gcbps。子文件夹不会递归导入，ONNX 也不通过文件夹批量导入；模型请使用“导入 ONNX 模型”或逐个拖入。

使用右键菜单导入 ONNX¶

在目标标签上右键选择“导入 ONNX 模型”，可一次选择多个 .onnx。导入后的模型可以右键执行“识别 / 重新识别”；识别结果用于帮助节点筛选和提示，但模型能否执行仍取决于节点要求和运行时兼容性。

从外部文件加入自动化工作区¶

• 把外部 .gcbp 直接拖到已经挂载自动化的画布，软件会先在文件管理中建立受管副本，再创建引用该副本的步骤；后续不再读取外部原路径。
• 把外部 .gcbps 拖到自动化工作区，软件会先在文件管理的默认标签建立受管副本，再把这份副本作为自动化挂载；外部原文件不会被直接编辑。
• 一次挂载一个 .gcbps；不要把 .gcbps 和 .gcbp 混在同一次拖放中。
• 当前没有 App 分页时不能挂载；当前 App 没有自动化时，.gcbp 也没有可接收的目标。

从文件管理把已经受管的 .gcbp 普通拖入自动化时，会建立独立包内副本；使用“添加到预设”时则建立引用。从文件管理挂载已经受管的 .gcbps 时，工作区直接使用该文件。如果同一 .gcbps 已经挂载，软件会让你选择：

• 不创建副本，直接挂载：新旧位置共享同一文件，任何一处编辑都会影响另一处。
• 创建副本并挂载：生成独立 .gcbps，后续编辑互不影响。

勾选“下次不再询问”后，软件会记住这项挂载偏好。需要避免误共享时，优先选择创建副本。

从文件管理打包和解散¶

打包为蓝图包¶

在同一批选择中至少选中两个普通 .gcbp，右键选择“打包为蓝图包”。软件创建新的 .gcbps，并按文件管理中的当前排列顺序写入蓝图；来源 .gcbp 不会被删除。

解散蓝图包¶

对允许编辑的 .gcbps 选择“解散蓝图包”，软件会把包内蓝图复制为独立 .gcbp，随后删除原 .gcbps 并解除其挂载。解散不是只隐藏一个工作区条目；执行前应确认不再需要共享该包文件。

另存与导出¶

自动化工作区提供两类容易混淆的操作：

文件管理中的 .gcbp、.gcbps 和 .onnx 已经是本机文件。需要取得原文件时，使用“在文件资源管理器中显示”后复制到目标位置；不要把“移动到另一个标签”当作导出，因为那仍在软件管理目录内移动。

数据影响速查¶

在文件管理内部重命名或移动 .gcbps 时，挂载路径会同步更新。若在系统资源管理器中绕过软件移动、改名或删除文件，现有挂载可能显示为缺失。

限制¶

• 文档只描述当前 .gcbp、.gcbps 和 .onnx 工作流；不要通过修改扩展名在三者之间转换。
• 导入前会检查文件结构与兼容性；损坏或不兼容文件不会被正常加入。
• 商品、账号权限或热更新状态可能限制复制、解散、重命名和导出。
• 文件进入自动化后可能包含包内资源，文件大小不再只由节点数量决定。

相关内容¶

• 文件管理
• 自动化工作区
• 蓝图编辑器
• 故障排查