触发点

目标读者：决定玩家从哪里打开反馈面板的开发者。

支持的触发来源来自 contracts 枚举：api、hotkey、button、menu、shake、error_prompt、qa_menu。P0 推荐优先使用明确的玩家操作，例如可见按钮、F8、游戏内菜单或 QA 菜单。

最小示例

func _on_pause_menu_feedback_pressed() -> void:
  EchoNebulaFeedback.open_feedback_panel({
    "trigger_source": "menu",
    "category": "bug"
  })

func report_from_code() -> void:
  EchoNebulaFeedback.open_feedback_panel({
    "trigger_source": "api",
    "category": "suggestion"
  })

内置快捷键会用 hotkey 作为 trigger_source 打开面板。

常见错误

• 不要从崩溃或异常路径自动提交反馈。echo-nebula 不是崩溃监控。
• 不要发明 contracts 枚举之外的触发名称。
• 即使来自 QA 入口，也不要隐藏隐私确认。

下一步

补充有用的场景和玩家 上下文。