Kernel IDE 类型提示与编辑器访问器

这一页说明为什么 GF 推荐获取对象后立即用 as Type 断言，并概述脚本模板、访问器生成、编辑器类型索引和相关开发期工具。

IDE 智能语法提示机制

GF Framework 特意设计为不需要向任何基类中注入具体的类型，所有的组件获取统一通过明确的入口方法（Gf.get_system(...) 等）完成。

结合 Godot 4 的静态类型特性，强烈建议在获取任何对象后立即使用 as 进行类型断言，这能激活完整的 IDE 代码补全：

# 在 Controller 中获取数据并更新UI
var player_model := Gf.get_model(PlayerModel) as PlayerModel
health_label.text = str(player_model.current_health)

# 触发业务逻辑
var battle_system := Gf.get_system(BattleSystem) as BattleSystem
battle_system.start_encounter()

启用插件后，编辑器菜单还会提供 GF 脚本模板生成、访问器生成、能力 Inspector 和节点状态机 Inspector；独立 GF Workspace 会提供状态、输入、存储、保存、流程、信号诊断、诊断和扩展等页面，并在编辑器打开时默认弹出，必要时可用“置顶”让工作区保持在其他窗口上方。启用插件会在缺少默认 GF ProjectSettings 时写入并保存 project.godot，禁用插件会移除指向 GF 的 Gf AutoLoad；如果项目临时关闭插件但仍要运行 GF，需要手动恢复 AutoLoad。插件主脚本只负责生命周期编排，ProjectSettings、AutoLoad、工具菜单、菜单动作、工作区窗口、Inspector/导出插件装配分别由 addons/gf/kernel/editor/gf_plugin_*.gd 内部辅助脚本承载。扩展级菜单动作、脚本模板、工作区页面、Inspector、导出插件和访问器生成扩展都通过 gf_extension.json 声明，核心插件只按启用状态动态装载，不在 kernel 中硬编码可选扩展 ID 或扩展内类型名。标准库自带的编辑器增强和标准库模板集中声明在 addons/gf/standard/editor/gf_standard_editor_extensions.gd，由根插件收集后传给 kernel/editor 辅助脚本装载，kernel 不直接 preload 标准库脚本，也不硬编码标准库类型名。脚本模板生成遇到已有文件会拒绝覆盖；访问器生成由 GFAccessGenerator 负责，可输出框架访问器或项目访问器脚本，减少手写 get_model() / get_system() 包装代码，默认会覆盖生成路径，工具调用方可通过 overwrite_existing = false 禁止覆盖。访问器只收集声明了 class_name 的脚本，Command/Query 没有 factory 时会走无参 new() fallback；需要构造参数的类型应注册 factory。项目常量访问器只采集命名层、项目保存的 InputMap 动作和 GF ProjectSettings 键；编辑器专用动作不会进入 GFProjectAccess.InputActions。编辑器侧生成脚本的缩进、section、文档注释和空行格式由 GFSourceBuilder 统一处理，项目自定义 generator 或扩展级访问器扩展也可以复用它来降低格式漂移风险。

类型扫描工具内部会复用 GFEditorTypeIndex 收集 class_name 脚本和能力场景；复用同一个 index 实例时，如果文件系统或继承关系变更，需要调用 clear_cache()，大型项目也可以用 collect_scene_roots_extending(..., root_paths) 限定场景扫描范围，并通过 max_scan_depth / max_scanned_scenes 调整默认扫描上限。需要在项目自定义编辑器工具里生成 3D 资源预览时，可以复用 GFThumbnailRenderer 渲染 Node3D、Mesh 或 MeshLibrary 条目缩略图；渲染尺寸会钳制到至少 1 像素，批量 MeshLibrary 预览可通过 cancel_preview_generation 中断。render_node3d() 会复制节点并加入内部 SubViewport，适合纯展示节点或 Mesh；带运行时脚本副作用的场景应提供预览专用节点。开发期还可以直接调用 GFSceneSignalAudit.audit_directory("res://") 扫描 .tscn 中保存的编辑器信号连接，报告缺失节点、缺失信号、缺失方法和参数数量不匹配；目录扫描默认限制深度与场景数量，可通过 max_scan_depth / max_scene_paths 调整。运行时或调试工具可用 GFSceneSignalAudit.build_signal_graph(root) 生成当前节点树的信号连接图快照，默认也会限制节点深度和节点数，截断时报告中会标记 truncated。GF 工作区中的 Storage Viewer 页面使用本地文件系统访问，适合开发机排查存档，不应暴露给玩家 UI 或读取不可信路径。它们都是编辑器辅助能力，不参与运行时 GFArchitecture 生命周期。