文件格式、导入与导出¶

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

格式说明¶

.gcbp：独立蓝图¶

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

从文件管理普通拖入或粘贴 .gcbp 时，软件会复制蓝图正文并生成新的包内身份，因此两边可以分别修改。“添加至预设”也会把所选普通本地蓝图的正文和资源复制进指定自动化，并分配新的本地 ID；即使目标包中已有同 ID，仍使用本次选择的文件内容。独立来源修改不会自动同步到包内。带签名或受保护的内容仍遵守原有签名与授权限制。同一自动化内的 Alt+V 关联粘贴共用当前包内正文，规则见自动化工作区。

.gcbps：自动化包¶

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

同一个 .gcbps 可以挂载到多个 App，也可以在同一 App 内重复挂载多个槽位。挂载一律是纯引用：所有挂载位置编辑的都是同一文件，一处修改处处同步。需要互不影响的独立版本时，使用“另存为 gcbps”生成新文件再挂载。挂载与加载的细节见自动化工作区。

.onnx：模型资源¶

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

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

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

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

本地 Debug 分类训练导出的模型还会把类别顺序及预处理配置写入 .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 普通拖入自动化时，会建立独立包内副本；“添加至预设”会把所选普通本地蓝图的完整正文和资源加入指定自动化并分配新 ID，取消目标选择不会写入。从文件管理挂载已经受管的 .gcbps 时，一律直接挂载同一文件，不再询问是否创建副本：同一文件可以挂在多个 App、也可以在同一 App 内占多个槽位（每页最多 8 个），所有挂载位置共享后续编辑。需要独立副本时，先“另存为 gcbps”再挂载新文件。

挂载本身不解析文件内容，因此操作即时完成；文件是否有效在第一次点击该挂载条目时才检查，失效文件会提示并自动摘槽。

从文件管理打包和解散¶

打包为蓝图包¶

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

解散蓝图包¶

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

另存与导出¶

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

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

数据影响速查¶

在文件管理内部重命名或移动 .gcbps 时，挂载路径会同步更新。若在系统资源管理器中绕过软件移动、改名或删除文件，对应挂载槽位会在下次点击时提示失效并自动摘槽。

限制¶

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

相关内容¶

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