GF 扩展总览与扩展规范¶
GF 内置扩展是随框架分发的可选原子能力。它们提供可以独立启用的通用模块；项目组合、第三方 SDK、业务适配和跨扩展编排应放在项目代码或 addons/gf 外的独立 Godot 插件中。
扩展层位于 kernel <- standard <- extensions 的最外侧。扩展可以依赖 kernel，也可以按需依赖稳定的 standard 能力；kernel 和 standard 不能反向识别、探测或弱绑定具体扩展。
阅读入口¶
- 扩展目录结构：扩展根目录、扩展内部槽位和目录命名原则。
- Manifest 规范：
gf_extension.json字段、版本、依赖、路径贡献和 manifest 校验。 - 安装与装配：扩展启用状态、Installer、项目设置和运行时装配顺序。
- 编辑器扩展管理器：GF Workspace 扩展面板、编辑器贡献、引用审计和导出排除。
- 放置规则：新增能力进入
kernel、standard、内置扩展、项目代码或独立插件的判断方式。
使用边界¶
- GF 内置扩展彼此不互相依赖，不声明隐式协作关系，也不通过路径、扩展 ID、
class_name或动态加载探测其他内置扩展。 - 内置扩展 manifest 的
dependencies只表示硬依赖，只允许声明gf.kernel与gf.standard。不要把推荐、可选协作、加载顺序或 preset 组合写进 manifest。 - 需要多个扩展协作时，在项目 Installer、项目 System 或独立插件中组合，不把组合逻辑写回任一内置扩展。
- 标准库工具需要扩展数据时，由扩展侧通过标准库提供的通用注册入口主动贡献；标准库不写扩展路径、扩展 ID 或扩展内类型名。
- Preset 只是项目初始化时的一组启用 ID，属于项目 JSON、安装向导或外部插件配置，不改变扩展之间的依赖边界，也不写回 manifest。
默认启用策略¶
GF 内置扩展默认关闭。新项目启用 GF 后会获得 kernel 与 standard 基础能力；Save、Combat、Network、Flow、Domain 等可选扩展需要在 GF Workspace 的 GF Extensions 页面、项目 preset 或 GFExtensionSettings.set_enabled_extension_ids() 中显式选择。gf/extensions/selection_mode="default" 表示按 manifest 默认值派生；保存勾选结果会进入 explicit 模式。
扩展启用状态影响运行时 Installer 自动装配、编辑器扩展贡献和导出过滤，不代表扩展脚本从编辑器中消失。项目如果直接引用了某个扩展的 class_name、脚本路径、场景或资源，应保持该扩展启用，或在导出前移除对应引用。
扩展清单¶
- Capability：对象能力、动态属性、能力 Recipe、节点能力和访问器生成。
- Interaction：交互上下文、传感器、接收器和交互流程。
- Feedback：震动、闪烁、通知、拖放和指针反馈。
- Camera：2D/3D Rig、Director、Blend 和相机候选选择。
- Dialogue：对话资源、运行器、上下文和响应选择。
- Combat：战斗属性、技能、Buff、命中盒、投射物和统一命中结果。
- ActionQueue：可排队视觉动作、Tween 动作、拦截器和动作工厂。
- Asset Metadata：资产 metadata 读写、收集、导入扩展和报告。
- Network 与 TurnBased：网络消息、快照、后端协议、回合阶段和行动流。
- Flow：资源化流程图、节点、端口、运行器和编辑器模型。
- BehaviorTree：纯代码行为树节点、Runner、黑板和调试快照。
- Decision：黑板、上下文、效用评分、候选集合和非 LLM 决策服务。
- Content Package：内容包 manifest、依赖图诊断和资源键注册。
- Domain：关卡、任务、背包、装备和通用领域模型。
- Physics：Projectile、重力场、表面查询和运动策略。
- Save 场景存档图：Scope、Source、Pipeline、Slot 和存档图应用流程。
API Reference¶
各扩展入口页链接对应生成式 API Reference；总索引见 API Reference。