UI 界面清单

本文档按"前端只管显示，数据从后端 Manager 获取"原则（见 doc/P1模块拆分.md）整理全部界面规划。已有界面标注现状，规划界面按 P1 与中后期分列。

1. 目录结构约定

src/UI/
├── HUD/                      顶栏/底部条状 HUD（常驻）
│   ├── MainSceneHud.tscn
│   └── MainGameButtomHud.tscn
└── Panels/                   全屏/大面积面板（弹层式）
    ├── MainMenu/             主菜单（已有）
    ├── Management/           管理主操作面板（P1 新增）
    │   ├── DisciplePanel/    弟子面板
    │   ├── FieldPanel/       建筑/灵田面板
    │   ├── AlchemyPanel/     炼丹面板
    │   ├── OrderPanel/       订单面板
    │   └── InventoryPanel/   库存面板
    └── SavePannel.tscn       存档面板（已有，+SaveGroup/SaveSlot）

约定：HUD 放常驻条状 UI；面板一律进 Panels/，同组面板建子文件夹（参照 MainMenu 先例）。弹窗类（事件/确认/通知）后续放 Panels/ 下或单独 Popups/。

2. 已有界面（现状）

界面	文件	状态
主菜单	`src/UI/Panels/MainMenu/MainMenu.tscn`	已有：新游戏/读档
存档面板	`src/UI/Panels/SavePannel.tscn`（+ SaveGroup/SaveSlot）	已有：两级存档列表
顶栏 HUD	`src/UI/HUD/MainSceneHud.tscn`	已有：时间/灵石/声望/灵气 + 管理/保存/返回/下一回合按钮
底部 HUD	`src/UI/HUD/MainGameButtomHud.tscn`	已有但未接入 MainGame 场景（仅"继续"按钮）

3. 主场景布局结构

MainGame（场景）
├── 顶栏 HUD（全局信息 + 入口按钮）
│    ├── 时间 / 灵石 / 声望 / 灵气
│    ├── 管理按钮（打开主操作面板）   [灵田/炼丹/弟子/订单/库存 入口]
│    └── 保存 / 返回
├── 主操作区（当前主面板，全屏覆盖）  ← 弹层式切换
└── 弹窗层（事件/确认/通知，最高层）

原则：一次只显示一个主操作面板，面板间通过顶栏"管理"按钮切换；弹窗层供事件、确认框、提示用。

4. P1 界面清单（对应各 Manager）

界面	数据源（后端）	内容	操作
弟子面板	DiscipleManager	弟子列表：姓名/境界/技艺/忠诚/修为进度；详情区	查看；分配劳作类型（种田/炼丹/空闲）
灵田面板	FieldManager	内外田地块网格：作物/生长进度/品质	种植（选作物+分配弟子）、收获
炼丹面板	AlchemyManager	丹方列表（材料需求/技艺要求）+ 可选炼丹弟子	炼制（扣材料→入库存）
订单面板	OrderManager	当前订单：客户/物品/数量/品质要求/期限/奖励	交货（校验库存→加灵石）
库存面板	InventoryManager	物品列表：灵药/丹药/凡粮数量与品质	只读展示（可并入其他面板）
顶栏灵石/口粮	EconomyManager / FoodManager	灵石余额、口粮结余	只读

P1 简化：库存并入炼丹/订单面板分栏显示，不单开面板；弟子劳作分配暂只影响生产（对应弟子技艺），不做单独"空闲/忙碌"状态 UI。

5. 中后期界面规划（P2~P5）

P2 经营深度

界面	数据源	内容
收徒面板	DiscipleManager(工厂)	可收弟子候选：资质/拜师礼
委托面板	委托系统	随机委托列表：奖励/风险，派遣弟子执行
忠诚度视图	DiscipleManager	弟子忠诚/满意度，抽成政策调节（并入弟子面板）
香火/供奉	声望系统	村庄供奉信息

P3 外交层

界面	数据源	内容
外交面板	客户/宗门关系系统	大宗门列表：好感/附庸等级/订单偏好
附庸管理	附庸系统	当前附庸等级、义务、宗主裁决记录

P4 秘境事件

界面	数据源	内容
勘探/发掘面板	秘境系统	后山勘探按钮、秘境层进度、功法获取
警戒/封锁	走漏系统	消息封锁操作、泄露风险提示
战报	冲突系统	小规模冲突事件、战斗自动结算结果

P5 终局

界面	数据源	内容
宗门史记/结算	评分系统	传奇度评分、结局文本、自由沙盒入口
天灾面板	天灾系统	天灾进度、各方势力动态

6. UI 与后端绑定规则

每个面板对应一个 Manager 或一组 Manager 的只读视图 + 操作方法。
面板 _ready() 时调 Manager getter 拉全量数据渲染，再连接信号增量刷新（观察者）。
玩家操作 → 调 Manager 方法 → Manager 发信号 → 面板刷新（UI 不写数据）。
弹窗（事件/确认）由事件系统驱动，可复用通用弹窗场景（标题/正文/按钮组）。

7. 待补充

通用弹窗场景、面板切换容器（P1 起步时实现）
具体面板视觉风格（沿用现有 theme 体系：resources/ 下按钮/Label theme）
中后期面板在各自里程碑实现时细化（本文档只列清单）

5.2 KiB Raw Blame History Unescape Escape