跳转至

GF Workspace

GF Workspace 是核心插件固定提供的独立编辑器窗口。它把 GF 自带的扩展管理、输入映射、存档文件查看、场景存档图、信号诊断和诊断快照等面板收束到一个响应式工作区，避免多个 GF 面板挤占 Godot 底部栏，也给 Flow 这类复杂工具保留足够横向空间。

窗口右上角的“置顶”开关可让独立工作区保持在其他窗口上方，便于一边操作编辑器或运行窗口一边观察调试页面。

打开与布局

插件启用或编辑器打开项目时，GF 会默认弹出工作区窗口；关闭窗口后，可从 工具 > GF > 打开 GF 工作区 再次打开。

工作区顶部提供自动换行的短页面入口，完整页面名保留在 tooltip；内置页面默认按“状态、输入、保存、流程、存储、信号、诊断、扩展”的产品顺序展示。标准库页面通过记录里的 order 和 short_label 声明顺序与短标签，扩展页面通过 manifest 的 editor_dock_order 和 editor_dock_short_label 声明对应信息，核心插件只按记录排序。

内容区仍只显示当前页面，避免多个工具同时挤压。每个页面都会放进无最小高度的裁剪容器，页面内容不会把窗口撑坏。右上角的“关于”按钮会打开 GF Framework 简介，并提供项目地址、正式文档地址、Issues、Releases、维护者联系方式和手动最新版本检测入口。

内置页面共享 GFEditorWorkspaceUI 提供的页面根、工具栏、摘要、空状态和详情输出构建方式。新增页面应优先复用这些通用控件，再把真正的业务无关编辑逻辑放在页面自身脚本中，这样工作区的密度、状态颜色、空态文案和只读详情区会保持一致。

Extensions 页面

GF Extensions 页面用于查看 gf_extension.json、启用或禁用扩展、检查 manifest 状态、扫描禁用扩展引用并保存扩展相关设置。

面板里的三个开关含义不同：

  • 自动装配启用扩展 Installer：Gf.init() / Gf.set_architecture() 时执行启用扩展 manifest 声明的 installer_paths。
  • 导出时排除禁用扩展：导出阶段跳过禁用扩展根目录下的文件。
  • 引用禁用扩展时阻止导出：导出审计发现项目仍引用禁用扩展时，以错误形式报告，适合发布前或 CI 使用。

扩展启用状态不会让编辑器中的脚本或 class_name 立刻消失。它影响的是扩展 Installer 是否自动参与运行时装配，以及导出时是否排除禁用扩展目录。禁用或删除扩展前，应先清理项目脚本、场景、资源、preload 和已生成访问器中的直接引用。