docs: 添加修仙境界与突破系统设计文档

- README 补充时间系统/用户设置完成状态，更新目录标注
- 开发计划表标记 D1 完成并新增状态列

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "godotTools.editorPath.godot4": "d:\\game\\Godot\\Godot_v4.7.1-stable_win64.exe\\Godot_v4.7.1-stable_win64.exe"
+}

README.md

@@ -1,6 +1,8 @@
-# 模拟宗门 — 项目目录结构
+# 模拟宗门
 
-## 结构总览
+基于 Godot 4.7（GDScript）的宗门经营模拟游戏。
+
+## 项目结构
 
 ```
 模拟宗门/
@@ -9,11 +11,13 @@
 │   ├── 修仙宗门设计文档.md
 │   ├── 宗门行政体系.md
 │   ├── 宗门礼仪建筑.md
-│   └── 游戏模块总览.md
+│   ├── 游戏模块总览.md
+│   ├── 存档界面UI设计.md
+│   └── 开发计划表.md          #   开发排期与进度跟踪
 │
 ├── addons/                    # Godot 插件
 │
-├── assets/                    # 原始资源文件（导入前素材）
+├── assets/                    # 资源文件
 │   ├── sprites/               #   精灵图
 │   │   ├── buildings/
 │   │   ├── characters/
@@ -22,141 +26,136 @@
 │   ├── audio/                 #   音频
 │   │   ├── bgm/
 │   │   └── sfx/
-│   └── fonts/                 #   字体
+│   └── fonts/                 #   字体（中文字体已导入）
 │
-├── resources/                 # Godot 资源文件 (.tres / .res)
-│   ├── settings/              #   全局配置
-│   ├── buildings/             #   建筑配置表
-│   ├── characters/            #   角色模板
-│   ├── skills/                #   功法/技能数据
-│   ├── items/                 #   物品/装备数据
-│   └── events/                #   事件配置
+├── resources/                 # 配置数据 (.tres / .res)
+│   ├── settings/
+│   ├── buildings/
+│   ├── characters/
+│   ├── skills/
+│   ├── items/
+│   └── events/
 │
-├── src/                       # 源码 + 场景（按功能模块组织）
-│   │                          #   （.tscn 和 .cs 放在一起）
+├── src/                       # 源码 + 场景（.gd 与 .tscn 同目录）
 │   │
 │   ├── Core/                  # 核心框架
-│   │   ├── GameManager.cs     #   游戏主循环
-│   │   ├── GameManager.tscn
-│   │   ├── TimeSystem.cs      #   时间系统
-│   │   ├── EventBus.cs        #   事件总线
-│   │   ├── SaveSystem.cs      #   存档/读档
-│   │   └── ConfigLoader.cs    #   配置加载
+│   │   ├── MainGame.gd        #   [已实现] 主游戏入口，注册游戏场景分组
+│   │   ├── MainGame.tscn
+│   │   ├── GameState.gd       #   [已实现] Autoload，场景参数 + 游戏时间
+│   │   ├── TimeSystem.gd      #   [已实现] Autoload，时间推进/暂停/流速/信号
+│   │   └── Settings.gd        #   [已实现] Autoload，用户设置持久化 (user://)
 │   │
 │   ├── Data/                  # 数据层
-│   │   ├── Models/            #   数据模型（DTO）
-│   │   └── SO/                #   ScriptableObject 定义
-│   │       ├── BuildingSO.cs
-│   │       ├── SkillSO.cs
-│   │       ├── DiscipleSO.cs
-│   │       └── EventSO.cs
+│   │   ├── Models/
+│   │   └── SO/
 │   │
-│   ├── Sect/                  # 宗门管理
-│   │   ├── SectManager.cs     #   宗门主管理器
-│   │   ├── PowerSystem.cs     #   权力结构
-│   │   ├── FinanceManager.cs  #   财政经济
-│   │   ├── DiplomacySystem.cs #   外交
-│   │   ├── ContributionSystem.cs  # 贡献系统
-│   │   ├── buildings/         #   建筑系统
-│   │   │   ├── BuildingSystem.cs
-│   │   │   ├── BuildingBase.cs
-│   │   │   ├── BuildingBase.tscn
-│   │   │   └── buildings/     #     具体建筑（按分类子目录）
-│   │   │       ├── admin/     #       行政类
-│   │   │       ├── education/ #       教育类
-│   │   │       ├── workshop/  #       工坊类
-│   │   │       ├── storage/   #       物资类
-│   │   │       ├── resource/  #       资源类
-│   │   │       ├── living/    #       生活类
-│   │   │       ├── ritual/    #       礼仪类
-│   │   │       └── utility/   #       功能类
+│   ├── Sect/                  # 宗门管理（规划）
+│   │   ├── buildings/
+│   │   │   └── buildings/
+│   │   │       ├── admin/     #     行政类
+│   │   │       ├── education/ #     教育类
+│   │   │       ├── workshop/  #     工坊类
+│   │   │       ├── storage/   #     物资类
+│   │   │       ├── resource/  #     资源类
+│   │   │       ├── living/    #     生活类
+│   │   │       ├── ritual/    #     礼仪类
+│   │   │       └── utility/   #     功能类
 │   │   ├── halls/             #   各堂管理
-│   │   │   ├── MissionHall.cs #     功德堂/任务堂
-│   │   │   ├── TeachHall.cs   #     传功堂
-│   │   │   ├── LawHall.cs     #     执法堂
-│   │   │   └── ForeignHall.cs #     外事堂
-│   │   └── panels/            #   宗门管理面板场景
+│   │   └── panels/
 │   │
-│   ├── Character/             # 角色系统
-│   │   ├── Disciple.cs        #   弟子类
-│   │   ├── Disciple.tscn      #   弟子预制场景
-│   │   ├── DiscipleGenerator.cs   # 弟子生成器
-│   │   ├── DisciplePool.cs    #   弟子对象池
-│   │   ├── Stats.cs           #   属性系统
-│   │   ├── CultivationSystem.cs   # 境界/突破
-│   │   ├── SkillSystem.cs     #   功法/技能
-│   │   ├── EquipmentSystem.cs #   装备系统
-│   │   ├── RelationshipSystem.cs  # 社交关系
-│   │   └── AI/                #   弟子AI
-│   │       ├── DiscipleAI.cs
-│   │       └── BehaviorNodes.cs
+│   ├── Character/             # 角色系统（规划）
+│   │   └── AI/
 │   │
-│   ├── Production/            # 生产制造
-│   │   ├── AlchemySystem.cs   #   炼丹
-│   │   ├── ForgeSystem.cs     #   炼器
-│   │   ├── TalismanSystem.cs  #   符箓
-│   │   ├── ArraySystem.cs     #   阵法
-│   │   ├── PuppetSystem.cs    #   傀儡
-│   │   ├── FarmingSystem.cs   #   种植
-│   │   └── BeastSystem.cs     #   养殖
+│   ├── Production/            # 生产制造（规划）
 │   │
-│   ├── Combat/                # 战斗系统
-│   │   ├── BattleManager.cs   #   战斗管理器
-│   │   ├── BattleField.cs     #   战场
-│   │   ├── BattleField.tscn
-│   │   ├── TurnController.cs  #   回合控制
-│   │   ├── DamageCalculator.cs  # 伤害计算
-│   │   ├── SkillEffect.cs     #   技能效果
-│   │   ├── TeamFormation.cs   #   阵型
-│   │   └── enemies/           #   敌方配置
+│   ├── Combat/                # 战斗系统（规划）
+│   │   └── enemies/
 │   │
-│   ├── World/                 # 世界/地图
-│   │   ├── MapManager.cs      #   地图管理器
-│   │   ├── WorldMap.cs        #   大地图
-│   │   ├── WorldMap.tscn
-│   │   ├── SectSite.cs        #   宗门驻地
-│   │   ├── SectSite.tscn
-│   │   ├── ExplorationSystem.cs  # 探索系统
-│   │   ├── SecretRealm.cs     #   秘境
-│   │   └── MarketSystem.cs    #   市场/交易
+│   ├── World/                 # 世界/地图（规划）
 │   │
-│   ├── Events/                # 事件/叙事
-│   │   ├── EventManager.cs    #   事件管理器
-│   │   ├── RandomEvent.cs     #   随机事件
-│   │   ├── StorySystem.cs     #   主线/支线
-│   │   ├── TribulationSystem.cs  # 天劫系统
-│   │   └── SeasonEvent.cs     #   赛季活动
+│   ├── Events/                # 事件/叙事（规划）
 │   │
 │   ├── UI/                    # 用户界面
-│   │   ├── HUD/               #   主界面 HUD
-│   │   ├── Panels/            #   功能面板
-│   │   │   ├── SectPanel.cs   #     宗门总览
-│   │   │   ├── DisciplePanel.cs  #  弟子列表/详情
-│   │   │   ├── BuildingPanel.cs  #  建筑详情
-│   │   │   ├── FinancePanel.cs   #  财政面板
-│   │   │   └── EventDialog.cs    #  事件弹窗
-│   │   ├── Controls/          #   自定义控件
-│   │   └── Common/            #   通用UI组件
+│   │   ├── HUD/               #   [已实现] 顶部信息栏（灵石/时间/声望 + 速度控制）
+│   │   │   ├── TopBarHUD.tscn
+│   │   │   └── top_bar_hud.gd
+│   │   └── Panels/            #   功能面板
+│   │       ├── MainMenu/      #   [已实现] 主菜单（新游戏/读取存档/设置/退出）
+│   │       ├── SavePanel.gd   #   [已实现] 存档选择面板
+│   │       ├── SavePanel.tscn
+│   │       ├── SaveSlot.gd    #   [已实现] 存档槽位（载入/删除/新建）
+│   │       └── SaveSlot.tscn
 │   │
-│   └── Utils/                 # 工具类
-│       ├── MathUtils.cs
-│       ├── RandomUtils.cs
-│       ├── StringUtils.cs
-│       └── Extensions.cs
+│   └── Utils/                 # 工具类（规划）
 │
 ├── icon.svg
 └── project.godot
 ```
 
+> `[已实现]` = 当前已有代码/场景；未标注目录为规划结构，随开发逐步填充。
+
+## 当前功能进度
+
+| 功能 | 状态 | 说明 |
+| ---- | ---- | ---- |
+| 主菜单 | 已完成 | 新游戏/读取存档/设置/退出，中文字体 |
+| 场景切换 | 已完成 | MainMenu ↔ MainGame，经 GameState 传参 |
+| 存档界面 | 已完成 | 槽位动态生成 + 空槽新建，信号驱动 |
+| 时间系统 | 已完成 | 12月×30天历法，暂停/1x/5x/20x 流速，日/月/年信号 |
+| 用户设置 | 已完成 | 默认流速持久化 (user://settings.cfg) |
+| 顶部 HUD | 已完成 | 灵石/时间/声望显示，速度按钮组（toggle 高亮） |
+| 画面质量 | 已完成 | 1920x1080 视口，MSAA 2D/3D + TAA，文字抗锯齿 |
+| 宗门数据模型 | **进行中** | SectManager：灵石/灵气/声望（D2） |
+| 弟子系统 | 规划中 | 生成/入宗分流/修炼（D3-D5） |
+| 建筑系统 | 规划中 | 建造/产出/升级（D6） |
+| 存档接入 | 规划中 | SaveSystem 序列化（D8） |
+
+> 进度跟踪见 `Doc/开发计划表.md`，里程碑：M1(8/12) 核心闭环 → M2(9/6) 丰富玩法 → M3(10/11) 正式版本。
+
+## 开发计划
+
+### 下一步：核心循环闭环（P1）
+
+目标：跑通"时间推进 → 资源产出 → 弟子修炼"最小循环，让游戏可玩。
+
+| # | 任务 | 说明 | 依赖 |
+| - | ---- | ---- | ---- |
+| 1 | TimeSystem | 天/月/年推进，挂载 GameState，UI 显示当前日期 | — |
+| 2 | 宗门数据模型 | SectManager 单例：灵石/灵气浓度/声望/建筑列表 | — |
+| 3 | 建筑系统基础 | 建筑放置、建造/升级耗时、基础产出（灵石/药材） | 1,2 |
+| 4 | 弟子系统基础 | 弟子生成（资质/灵根）、入宗分流（亲传/内门/外门/杂役） | 2 |
+| 5 | 修炼循环 | 弟子按资质/灵气浓度自动修炼涨修为，境界突破 | 3,4 |
+| 6 | 存档接入 | SaveSystem 序列化宗门/弟子/时间数据，替换 SavePanel 测试数据 | 全部 |
+
+### 之后（P2）
+
+| 任务 | 说明 |
+| ---- | ---- |
+| 财政经济 | 收支明细、俸禄发放、市场价格 |
+| 任务系统 | 宗门任务发布、贡献值、兑换 |
+| 生产制造 | 炼丹/炼器/符箓工坊 |
+| 战斗系统 | 弟子组队、外敌入侵事件 |
+
+### 里程碑
+
+- **M1（P1 完成）**：新游戏 → 招弟子 → 挂机产出 → 存档读档，完整闭环
+- **M2（P2 完成）**：可体验宗门经营的丰富玩法
+- **M3**：战斗/秘境/外交，正式版本
+
+## 运行方式
+
+1. 用 Godot 4.7 打开 `project.godot`
+2. F5 运行，主场景为 `MainMenu.tscn`
+3. "新游戏"直接进入；"读取存档"在存档面板中选择
+4. 游戏内顶部 HUD 可暂停/调速（1x/5x/20x），返回按钮回主菜单
+
 ## 命名规范
 
-| 类别     | 格式               | 示例                    |
-| -------- | ------------------ | ----------------------- |
-| C# 类    | PascalCase         | `SectManager.cs`        |
-| 场景文件 | PascalCase         | `BuildingBase.tscn`     |
-| 资源文件 | snake_case         | `iron_sword.tres`       |
-| 精灵图   | snake_case         | `building_office.png`   |
-| 变量     | camelCase          | `currentGold`           |
-| 私有变量 | _camelCase         | `_discipleList`         |
-
-> **注意**：C# 脚本的 `namespace` 使用 `项目名.模块名`，例如 `SectSim.Sect`、`SectSim.Character`。在 Godot 4 中，脚本路径决定了自动生成的默认命名空间，保持路径与命名空间一致可避免手动配置。
+| 类别     | 格式       | 示例                |
+| -------- | ---------- | ------------------- |
+| GDScript | snake_case | `top_bar_hud.gd`    |
+| 场景文件 | PascalCase | `MainGame.tscn`     |
+| 信号     | snake_case | `back_pressed`      |
+| 回调方法 | `_on_` 前缀 | `_on_button_pressed` |
+| 资源文件 | snake_case | `iron_sword.tres`   |
+| 精灵图   | snake_case | `bg1.png`           |

assets/fonts/dingliezhuhaifont-20240831GengXinBan)-2.ttf.import

@@ -0,0 +1,36 @@
+[remap]
+
+importer="font_data_dynamic"
+type="FontFile"
+uid="uid://drt448qncx27p"
+path="res://.godot/imported/dingliezhuhaifont-20240831GengXinBan)-2.ttf-7b6c32418ce639305b17af2723dddc58.fontdata"
+
+[deps]
+
+source_file="res://assets/fonts/dingliezhuhaifont-20240831GengXinBan)-2.ttf"
+dest_files=["res://.godot/imported/dingliezhuhaifont-20240831GengXinBan)-2.ttf-7b6c32418ce639305b17af2723dddc58.fontdata"]
+
+[params]
+
+Rendering=null
+antialiasing=1
+generate_mipmaps=false
+disable_embedded_bitmaps=true
+multichannel_signed_distance_field=false
+msdf_pixel_range=8
+msdf_size=48
+allow_system_fallback=true
+force_autohinter=false
+modulate_color_glyphs=false
+hinting=3
+subpixel_positioning=4
+keep_rounding_remainders=true
+oversampling=0.0
+Fallbacks=null
+fallbacks=[]
+Compress=null
+compress=true
+preload=[]
+language_support={}
+script_support={}
+opentype_features={}

assets/sprites/ui/BG1.png.import

@@ -0,0 +1,40 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://caeqoc6wx8toy"
+path="res://.godot/imported/BG1.png-6bf4b9c36da6bbdf71bd2c8203f4cb53.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://assets/sprites/ui/BG1.png"
+dest_files=["res://.godot/imported/BG1.png-6bf4b9c36da6bbdf71bd2c8203f4cb53.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1

doc/design/UI/StartMenu.md

@@ -0,0 +1,124 @@
+# 开始菜单设计
+
+## 一、场景结构
+
+采用**单场景 + 子节点切换**方案，仅一个 `MainMenu.tscn`。
+
+```
+MainMenu.tscn
+├── BG (TextureRect)
+│   └── 背景图片
+├── Logo (TextureRect)
+│   └── 游戏 Logo
+├── ButtonGroup (VBoxContainer)
+│   ├── 新游戏按钮 → 显示 NewGamePanel
+│   ├── 读取存档按钮 → 显示 LoadGamePanel
+│   ├── 设置按钮 → 显示 SettingsPanel
+│   └── 退出按钮 → get_tree().quit()
+├── NewGamePanel (Panel, 默认隐藏)
+│   ├── 宗门名称输入框 (LineEdit)
+│   ├── 难度选择 (OptionButton)
+│   │   ├── 简单
+│   │   ├── 普通
+│   │   └── 困难
+│   ├── 确认按钮 → 进入游戏
+│   └── 返回按钮 → 隐藏自身
+├── LoadGamePanel (Panel, 默认隐藏)
+│   ├── 存档列表 (ItemList)
+│   ├── 加载按钮
+│   └── 返回按钮
+└── SettingsPanel (Panel, 默认隐藏)
+    ├── 音量滑块 (HSlider)
+    ├── 全屏切换 (CheckBox)
+    └── 返回按钮
+```
+
+## 二、场景节点属性说明
+
+### MainMenu（根节点 — Control）
+
+| 属性 | 值 | 说明 |
+|------|----|------|
+| `anchors_preset` | 15（Full Rect） | 四角锚定父节点边界 |
+| `anchor_right` | 1.0 | 右边缘锚定到父节点右边界 |
+| `anchor_bottom` | 1.0 | 下边缘锚定到父节点下边界 |
+| `grow_horizontal` | 2 | 控件缩小时向右收缩 |
+| `grow_vertical` | 2 | 控件缩小时向下收缩 |
+| `size_flags_horizontal` | 3 | Fill + Expand，水平填充可用空间 |
+| `size_flags_vertical` | 3 | Fill + Expand，垂直填充可用空间 |
+
+### BG（TextureRect — 背景）
+
+| 属性 | 值 | 说明 |
+|------|----|------|
+| `anchors_preset` | 15（Full Rect） | 铺满父节点 |
+| `anchor_right` / `anchor_bottom` | 1.0 | 锚定右下边界 |
+| `stretch_mode` | 0（Scale） | 拉伸图片铺满，保持原始比例 |
+
+### Logo（TextureRect — 游戏 Logo）
+
+| 属性 | 值 | 说明 |
+|------|----|------|
+| `anchors_preset` | 1（Top Center） | 顶部居中锚点 |
+| `anchor_left` / `anchor_right` | 0.5 | 水平居中 |
+| `offset_left` | -200 | 左偏移，使宽度为 400 |
+| `offset_right` | 200 | 右偏移 |
+| `offset_top` | 60 | 距顶部 60px |
+| `offset_bottom` | 260 | 距顶部 260px（高 200） |
+| `grow_horizontal` | 2 | 向左收缩 |
+
+### ButtonGroup（VBoxContainer — 按钮组）
+
+| 属性 | 值 | 说明 |
+|------|----|------|
+| `anchors_preset` | 8（Center） | 居中锚定 |
+| `anchor_left / top / right / bottom` | 0.5 | 中心点对齐 |
+| `offset_left` | -100 | 向左扩展 100px（总宽 200） |
+| `offset_right` | 100 | 向右扩展 100px |
+| `offset_top` | -80 | 向上扩展 80px（总高 160） |
+| `offset_bottom` | 80 | 向下扩展 80px |
+| `grow_horizontal` | 2 | 向左收缩 |
+| `grow_vertical` | 2 | 向上收缩 |
+| `theme_override_constants/separation` | 16 | 按钮间距 16px |
+
+### Button（子按钮）
+
+| 属性 | 值 | 说明 |
+|------|----|------|
+| `custom_minimum_size` | Vector2(200, 48) | 按钮最小尺寸，宽 200 高 48 |
+| `text` | "新游戏" 等 | 按钮显示文字 |
+
+---
+
+## 三、面板切换逻辑
+
+所有面板放在同一场景内，通过 `visible` 属性切换。
+
+```gdscript
+func _on_new_game_pressed():
+    button_group.hide()
+    new_game_panel.show()
+
+func _on_back_pressed():
+    new_game_panel.hide()
+    button_group.show()
+```
+
+## 四、进入游戏流程
+
+新游戏确认后调用：
+
+```gdscript
+func _on_confirm_new_game():
+    var sect_name = $NewGamePanel/NameInput.text
+    var difficulty = $NewGamePanel/Difficulty.selected
+    # 初始化游戏数据
+    GameData.start_new_game(sect_name, difficulty)
+    get_tree().change_scene_to_file("res://src/main/MainGame.tscn")
+```
+
+## 五、注意事项
+
+- 面板切换使用 `show()` / `hide()`，不销毁节点，保留输入状态
+- 背景和 Logo 可加淡入动画（AnimationPlayer）
+- 存档列表数据来源：`ResourceSaver` 序列化的存档文件

doc/design/修仙资料_境界与突破.md

@@ -0,0 +1,120 @@
+# 修仙资料 — 境界与突破
+
+> 本文档收集、整理修仙体系中与修炼、突破相关的设定资料，供游戏设计参考。
+
+---
+
+## 一、境界总览
+
+| 大境界 | 小境界划分 | 寿元上限 | 修炼参考时长 | 大境界突破需求 |
+|--------|-----------|----------|-------------|---------------|
+| 凡人 | — | ~80岁 | — | 引气入体即入练气 |
+| 练气期 | 一层～十三层 | ~150岁 | 每层 1～3 年 | 筑基丹 + 灵气充沛之地 |
+| 筑基期 | 初期 / 中期 / 后期 / 圆满 | ~250岁 | 每小境 10～20 年 | 结丹灵物 + 雷劫（小） |
+| 金丹期 | 初期 / 中期 / 后期 / 圆满 | ~600岁 | 每小境 30～50 年 | 元婴丹 / 化婴丹 + 心魔劫 |
+| 元婴期 | 初期 / 中期 / 后期 / 圆满 | ~1500岁 | 每小境 50～100 年 | 化神灵物 + 五行劫 |
+| 化神期 | 初期 / 中期 / 后期 / 圆满 | ~3000岁 | 每小境 100～200 年 | 炼虚感悟 + 天劫 |
+| 炼虚期 | 初期 / 中期 / 后期 / 圆满 | ~8000岁 | 每小境 200～500 年 | 合体契机 + 道心劫 |
+| 合体期 | 初期 / 中期 / 后期 / 圆满 | ~15000岁 | 每小境 500～1000 年 | 大乘机缘 |
+| 大乘期 | 初期 / 中期 / 后期 / 圆满 | ~30000岁 | 每小境 1000～3000 年 | 飞升之劫 |
+| 渡劫期（真仙劫） | — | 极长 | — | 渡过即飞升 |
+
+---
+
+## 二、大境界突破详情
+
+### 2.1 凡人 → 练气期
+
+- **突破方式**：引天地灵气入体，打通经脉。门槛较低，有灵根者皆可。
+- **所需资源**：灵气充裕的环境、基础引气口诀。
+- **失败后果**：轻微内伤，修养后可重试。
+
+### 2.2 练气期 → 筑基期
+
+- **突破方式**：压缩灵力、铸就道基，是踏入修仙正途的关键一步。
+- **所需资源**：
+  - 筑基丹（必备，提升成功率 ~30% → ~60%）
+  - 灵石 500～1000（用于布聚灵阵）
+  - 灵气充沛之地（灵脉节点）
+- **突破难度**：高。散修筑基失败率极高。
+- **失败后果**：灵力反噬，修为跌落 2～3 层，半年内不可再次尝试。
+
+### 2.3 筑基期 → 金丹期
+
+- **突破方式**：丹田凝聚金丹，需渡过小型雷劫。
+- **所需资源**：
+  - 结丹灵物（如千年灵乳、天火液等，依主修方向而定）
+  - 灵石 3000～5000
+  - 渡劫阵旗 / 防御法器（应对雷劫）
+- **突破难度**：极高。三成筑基修士止步于此。
+- **失败后果**：金丹碎裂，跌落至筑基初期，或身死道消。
+
+### 2.4 金丹期 → 元婴期
+
+- **突破方式**：金丹碎裂、元婴诞生，需对抗心魔劫。
+- **所需资源**：
+  - 元婴丹 / 化婴丹（必备）
+  - 灵石 10000+
+  - 清心类法宝（抵御心魔）
+  - 护法弟子或长老
+- **突破难度**：极高。心魔劫最为凶险。
+- **失败后果**：元婴无法凝聚，修为锐减至金丹初期，或道心崩溃疯癫。
+
+### 2.5 元婴期 → 化神期
+
+- **突破方式**：元婴与天地法则初步融合，渡过五行天劫。
+- **所需资源**：
+  - 化神灵物（五行精华各一份）
+  - 灵石 50000+
+  - 渡劫大阵
+- **失败后果**：天劫之下魂飞魄散，或元婴受创沉睡百年。
+
+### 2.6 化神期及之后
+
+- 化神以上境界所需资源极为稀有，多为天地奇宝，非人力可量产。
+- 每层大境界突破均伴随天劫，强度递增。
+- 合体期以上几乎只存在于传说中。
+
+---
+
+## 三、小境界修炼与突破
+
+### 3.1 小境界是否需要突破？
+
+| 大境界 | 小境界突破方式 | 说明 |
+|--------|---------------|------|
+| 练气期 | 积累为主，每三层一个小瓶颈 | 1→2→3 顺畅；3→4 有小瓶颈需冲关；4→5→6 顺畅；6→7 有小瓶颈……依此类推 |
+| 筑基期 | 积累 + 小瓶颈突破 | 初期→中期、中期→后期有小瓶颈，需丹药辅助；后期→圆满为积累 |
+| 金丹期 | 积累 + 小瓶颈突破 | 同上 |
+| 元婴及以上 | 以感悟为主，积累为辅 | 越小境突破依赖法则领悟，资源需求退居次要 |
+
+### 3.2 设计建议
+
+- **练气期**：设为 13 层，部分层数需要"小突破"（消耗少量灵石或丹药），设计为引导玩家熟悉突破机制的教程阶段。
+- **筑基及以上**：每个大境界 4 个小境（初期/中期/后期/圆满），均需小突破。小突破资源消耗远低于大境界突破，但失败也会有小幅修为折损。
+- **修炼时间**：小境内积累可设为随时间自动增长（类似挂机产出），瓶颈处需要玩家手动"冲关"。
+
+---
+
+## 四、修炼速度影响因素
+
+| 因素 | 影响程度 | 说明 |
+|------|---------|------|
+| 灵根数量 | ★★★★★ | 灵根越少（如单灵根/天灵根），修炼速度越快 |
+| 灵气浓度 | ★★★★ | 灵脉之地 > 普通区域 > 灵气稀薄之地 |
+| 丹药辅助 | ★★★★ | 修炼类丹药可大幅加速 |
+| 功法品阶 | ★★★★ | 高品功法提升灵力转化效率 |
+| 名师指点 | ★★★ | 高阶修士传道可加速感悟 |
+| 心境/道心 | ★★★ | 影响瓶颈突破概率 |
+| 年龄 | ★★ | 接近寿元上限时修炼效率递减 |
+
+---
+
+## 五、参考资料
+
+- 凡人修仙传（忘语）：练气→筑基→金丹→元婴→化神→炼虚→合体→大乘→渡劫
+- 遮天（辰东）：轮海→道宫→四极→化龙→仙台
+- 完美世界（辰东）：搬血→洞天→化灵→铭纹→列阵→尊者→神火→真一→圣祭→天神→虚道→斩我→遁一→至尊
+- 仙逆（耳根）：凝气→筑基→结丹→元婴→化神→婴变→问鼎→阴虚阳实→碎涅→第二步/第三步
+
+> 本作建议采用**凡人修仙传体系**作为基础框架，境界数量适中、认知度高。

doc/design/核心设计理念.md

@@ -0,0 +1,222 @@
+# 核心设计理念
+
+## 一、游戏概述
+
+### 1.1 游戏性质
+
+一款独立单机模拟经营游戏，管理修仙宗门从零起步。玩法参考《造化仙门》。
+
+## 二、弟子系统
+
+### 2.1 核心循环
+
+**修炼循环（个人成长）**
+
+资源投入（灵气、丹药、时间） → 修为提升 → 突破瓶颈 → 境界晋升 → 属性/能力提升 → 解锁更高效的资源获取方式。
+
+**宗门循环（组织成长）**
+
+弟子晋升 → 分配至高阶生产建筑 → 产出更高级资源（灵石、丹药、材料） → 资源反哺弟子修炼 → 培养更多高阶弟子。
+
+**关键约束**
+
+境界必须与生产效率强绑定（如筑基期才能炼丹，金丹期才能教导他人），形成无法跳过的正向螺旋。
+
+### 2.2 弟子设计要点
+
+1. **职能**（任选 1 至 2 个）：种植（灵米、灵蔬、灵草）、养殖（灵兽、灵禽）、炼丹、阵法、符箓、炼器
+2. **主修方向**：炼丹、符箓、阵法、炼器、练剑、炼体、御兽、法术
+3. **灵根属性**：影响修习方向和生产效率。例如木灵根适合种植灵草，火灵根适合炼丹。多种灵根会有更多选择（类似《缺氧》中的人物词条）
+4. **属性匹配**：弟子属性与职能/建筑的匹配度决定产出品质和效率，这是生产系统的核心深度，替代复杂的多级生产链
+5. **灵根数量**：影响修炼速度（灵根越多修炼越慢）
+
+## 三、宗门发展
+
+### 3.1 宗门财政
+
+灵石的收支平衡。
+
+### 3.2 宗门影响力
+
+影响招收弟子的资质和备选弟子的数量。
+
+## 四、经济系统
+
+### 4.1 经济波动系统
+
+- **"活"的市场**：物价随事件、季节、玩家大宗交易而波动
+- **安全阀设计**：价格上下限、战略库存、替代资源、自给自足等工具，防止经济崩溃
+
+### 4.2 收支结构
+
+**收入来源**
+- 开采灵石矿
+- 出售基础药材、丹药等
+- 部分事件提供
+
+**支出项目**
+- 弟子修炼开销
+- 购买修炼资源
+- 部分事件消耗
+
+**价格波动**
+修炼资源的价格有一定波动，大型事件来临前会有预兆性变化。
+
+## 五、事件与命运设计
+
+### 5.1 事件发生流程
+
+单个事件分四个阶段逐步展开：
+
+1. **传闻阶段**：弟子闲聊、商人对话、日志记录埋下伏笔。玩家闻到风声但不清楚细节
+2. **波动阶段**：相关物资价格异常涨跌，作为事件的"脉搏"。玩家可据此预判并提前准备（囤货/抛售）
+3. **事件发生**：传闻成真，弹出选择界面，玩家做出决策，世界状态改变，价格进入新平衡
+4. **恢复阶段**：事件影响随时间消退，物价回归正常区间，损伤建筑修复，异常状态解除。事件是临时波动而非永久改变
+
+**事件可操作的子系统**
+- 宗门灵石增减、声望涨跌
+- 建筑耐久损伤或强化
+- 弟子状态变更（中毒、受伤、顿悟、突破概率增减）
+- 资源物价波动、物资库存增减
+- 新任务/新地点解锁
+- 后续事件标记（设置延迟触发的连锁事件）
+
+### 5.2 事件链
+
+单个事件的选择不只是"这次的结果"，还会影响后续会触发什么事件。
+
+```
+事件A
+├── 选择1 → 标记事件B1（如"妖兽入侵"）
+│   ├── B1中选择1 → 事件C1（"结盟"）
+│   └── B1中选择2 → 事件C2（"决战"）
+├── 选择2 → 标记事件B2（如"魔修来访"）
+│   └── B2中……
+└── 选择3 → 无后续事件（该分支终止）
+```
+
+**延迟后果的数据结构**
+
+```
+事件标记 = {
+    解锁的事件ID,
+    触发条件：固定时间（如"10年后"）或条件触发（如"声望>500且已有灵石矿"），
+    来自前序事件的选择ID（用于判断是否该触发此分支），
+    是否必须触发（主线）还是可错过（支线）
+}
+```
+
+事件调度器不只按日历时间触发，也检查前置条件是否满足。分支树建议控制在 **2-3 层深度**，避免组合爆炸和制作成本失控。
+
+### 5.3 选择设计
+
+**短期利益 vs 长期代价**
+
+将重大事件设计为"借贷未来"的选择，而非随机奖惩。
+
+**概率与确定的分配**
+- **确定的选择**：用于决定"路线与代价"（道途、契约），构建个人传奇
+- **概率的波动**：用于日常运营的"效率与节奏"（炼丹品质、挖矿暴击），提供惊喜与心跳
+
+**化解 SL 冲动的设计**
+- **后果是自选的**：重大失败源于贪婪或战略误判，而非运气
+- **失败是另一种开始**：为失败设计后续事件，使其成为故事转折点
+- **沉没成本真实存在**：几十年的经营记忆，让玩家舍不得用读档抹去
+- **外部世界的因果**：见证"邻居的兴衰"，获得超越个人得失的叙事满足感
+
+### 5.4 示例：天道契约
+
+天道契约非一次性的二元选择，而是横跨数十年的多阶段决策链。
+
+**触发**
+
+某年某日，天道降下契约，宗主面临抉择：接受恩赐或拒绝。
+
+**接受恩赐路径**
+
+自此每隔数年，玩家可向天道索取一次恩赐（修为暴涨、灵石暴增、天材地宝等），但每次索取都会增加隐藏的"代价"值。代价值越高，最终清算越猛烈。玩家也可主动选择"克制不索取"以控制代价积累速度。清算的时间与规模皆由历次索取的总和决定，而非预设的固定死期。反击的准备窗口也由玩家此前的积累（弟子、经济、盟友）决定。
+
+**拒绝恩赐路径**
+
+拒绝后，邻居逐渐崛起成为威胁。每隔数年触发一次互动事件：
+- 选择打压 → 削弱邻居，但消耗自身资源
+- 选择合作 → 短期互利，但邻居成长更快
+- 选择袖手 → 不投入成本，但邻居威胁加大
+数十年来，每一次选择的叠加决定邻居的最终命运和玩家为此付出的代价。即使邻居最终崩溃，玩家可能也因长期打压而元气大伤。
+
+**共通原则**
+- 不存在"攒足资源一次通关"的完美策略，每次决策都是短期收益与长期代价的权衡
+- 最终结局由数十次决策而非一次选择决定
+- 每个决策本身都有即时后果（获得/失去），不需等待最终清算才有反馈
+
+## 六、境界体系
+
+*（待补充）*
+
+修为境界的层级划分（练气→筑基→金丹→元婴→化神→……），各境界的突破条件、属性阈值、寿命上限、能力解锁。
+
+## 七、建筑系统
+
+*（待补充）*
+
+宗门建筑的分类（生产类、修炼类、功能类、防御类），建造条件与升级路线。生产链较短（原料 → 成品），深度由弟子属性与建筑的匹配度决定，参考《造化仙门》。
+
+## 八、物品与资源体系
+
+*（待补充）*
+
+资源分类（灵石、丹药、材料、法器、功法等），品质分级。生产链较短，原料直接加工为成品，品质受弟子属性影响。
+
+## 九、功法与技能树
+
+*（待补充）*
+
+功法类型与品阶，弟子修习条件与成长路线，技能解锁机制。
+
+## 十、时间系统
+
+*（待补充）*
+
+时间流速单位（年/月/日），季节变化对生产与事件的影响，建筑生产周期，事件触发频率。
+
+## 十一、玩家角色
+
+*（待补充）*
+
+宗主的修炼路线，专属能力与限制，决策范围与操作边界。
+
+## 十二、人际关系
+
+*（待补充）*
+
+弟子间的羁绊与矛盾（师徒、道侣、同门），好感度机制，社交事件对效率与事件的影响。
+
+## 十三、外部势力
+
+*（待补充）*
+
+其他宗门、散修、妖兽势力、商会的系统化设计，外交、贸易、竞争关系。
+
+## 十四、战斗系统
+
+*（待补充）*
+
+是否包含战斗模块，战斗形式（自动结算 / 战术操作），PVE（妖兽、秘境），无 PVP 内容。
+
+## 十五、秘境与探索
+
+*（待补充）*
+
+弟子外出历练的机制，可探索区域的地图/节点设计，收益与风险。
+
+## 十六、任务系统
+
+*（待补充）*
+
+日常任务、宗门任务、奇遇任务的触发机制与奖励结构。
+
+## 十七、胜利与失败条件
+
+*（待补充）*
+
+游戏终局条件（跻身顶级宗门 / 飞升 / 被灭门 / 无限经营），多结局分支。

doc/design/通用资源分析.md

@@ -0,0 +1,117 @@
+# 通用资源分析
+
+根据展示方式，资源分为两大类：
+
+- **通用资源** → 顶部栏（TopBarHUD）常驻显示
+- **稀有资源** → 打开资源面板（ResourcePanel）查看
+
+---
+
+## 一、通用资源（顶部栏常驻显示）
+
+日常使用频繁、数值变化快的核心资源。
+
+| 资源 | 说明 | 用途 |
+|------|------|------|
+| 灵石 | 修仙界通用货币 | 交易、发俸禄、购买物资 |
+| 食物 | 弟子日常消耗 | 农场、种植、采购 |
+| 木材 | 基础建材 | 伐木场、探索 |
+| 石材 | 基础建材 | 采石场、探索 |
+
+---
+
+## 二、稀有资源（面板查看）
+
+无需常驻显示，打开面板浏览。
+
+| 分类 | 资源 | 说明 |
+|------|------|------|
+| 修炼 | 灵草、丹药、功法卷轴 | 炼丹、突破、学习 |
+| 锻造 | 凡矿、灵矿、兽皮/骨 | 打造法器、制甲制符 |
+| 特殊 | 声望、气运、功德 | 外交、事件、渡劫 |
+
+> **贡献度** 不属于全局资源，属于**弟子个人属性**，在弟子详情面板中查看。
+
+---
+
+## 三、资源分类
+
+### 1. 货币类（Currency）
+| 资源 | 说明 | 用途 |
+|------|------|------|
+| 灵石 | 修仙界通用货币 | 交易、发俸禄、购买物资 |
+
+### 2. 基础资源（Basic）
+| 资源 | 说明 | 来源 |
+|------|------|------|
+| 食物 | 弟子日常消耗 | 农场、种植、采购 |
+| 木材 | 基础建材 | 伐木场、探索 |
+| 石材 | 基础建材 | 采石场、探索 |
+| 水源 | 生活必需 | 灵泉、水渠 |
+
+### 3. 修炼资源（Cultivation）
+| 资源 | 说明 | 用途 |
+|------|------|------|
+| 灵气 | 环境灵气浓度 | 修炼速度加成 |
+| 灵草 | 低阶草药 | 炼丹材料 |
+| 丹药 | 成品丹药 | 突破、恢复、增益 |
+| 功法卷轴 | 修炼功法 | 弟子学习 |
+
+### 4. 锻造资源（Crafting）
+| 资源 | 说明 | 用途 |
+|------|------|------|
+| 凡矿 | 普通矿石 | 打造基础器具 |
+| 灵矿 | 蕴含灵力的矿石 | 炼制法器 |
+| 兽皮/骨 | 妖兽材料 | 制甲、制符 |
+
+### 5. 特殊资源（Special）
+| 资源 | 说明 | 用途 |
+|------|------|------|
+| 声望 | 宗门知名度 | 收徒吸引力、外交 |
+| 气运 | 宗门气运值 | 影响随机事件 |
+| 功德 | 天道功德 | 渡劫加成、天材地宝 |
+
+---
+
+## 四、资源属性设计
+
+每个资源实例应包含以下属性：
+- `id`: 唯一标识
+- `name`: 显示名称
+- `icon`: 图标路径
+- `max_stack`: 最大堆叠
+- `display_type`: 展示方式（`TOPBAR` / `PANEL`）
+- `category`: 所属分类
+- `rarity`: 稀有度（普通/稀有/传说）
+
+```gdscript
+enum DisplayType {
+	TOPBAR,  # 顶部栏常驻
+	PANEL    # 面板查看
+}
+
+enum ResourceCategory {
+	CURRENCY,      # 货币
+	BASIC,         # 基础
+	CULTIVATION,   # 修炼
+	CRAFTING,      # 锻造
+	SPECIAL        # 特殊
+}
+```
+
+---
+
+## 五、资源管理系统建议
+
+- 使用 `ResourceData` 资源文件（Scriptable Object 模式）定义每个资源
+- 使用 `ResourceManager` 单例统一管理增减
+- 支持 emit 信号，UI 自动响应数值变化
+
+---
+
+## 六、后续可扩展资源
+
+- 灵兽蛋 / 灵兽材料
+- 阵法材料（阵旗、符石）
+- 秘境钥匙 / 地图碎片
+- 宗门特产（专属资源）

doc/开发计划表.md

@@ -0,0 +1,72 @@
+# 开发计划表
+
+> 开始日期：2026-08-03（周一）　每日有效开发约 2 小时
+> 进度更新：2026-08-05 　D1、D2 完成，D3 进行中
+
+## 一、每日作息模板（工作日）
+
+| 时间 | 事项 | 备注 |
+| ---- | ---- | ---- |
+| 20:30 | 下班 | |
+| 20:30–21:00 | 通勤 / 晚饭 | |
+| 21:00–21:10 | 热身 | 回顾昨日进度，明确今晚目标 |
+| 21:10–22:40 | **开发黄金段** | 90 分钟，写代码/搭场景 |
+| 22:40–22:50 | 休息 | 离开屏幕 |
+| 22:50–23:20 | 收尾 | 跑通验证、git 提交、写明日 TODO |
+| 23:20–24:00 | 洗漱放松 | 睡前不刷代码 |
+
+## 二、第 1–2 周（8/3–8/12）：P1 核心循环
+
+| 日期 | 天 | 任务 | 拆解 | 交付标准 | 状态 |
+| ---- | -- | ---- | ---- | -------- | ---- |
+| 8/3 一 | D1 | TimeSystem | ① 日期变量(年月日) ② tick 推进 ③ 暂停/加速 | HUD 显示年月日，可调速度 | ✅ 完成（含月/年信号、Settings 持久化） |
+| 8/4 二 | D2 | SectManager 数据模型 | ① 单例 ② 灵石/灵气/声望 ③ 增减接口 | 控制台可读写资源 | ✅ 完成（灵石/声望增减+信号，HUD 实时绑定） |
+| 8/5 三 | D3 | 弟子生成 + 入宗分流 | ① 随机名字/资质/灵根 ② 按资质分四类 ③ 招募按钮 | 点按钮生成弟子入列表 | ⬜ |
+| 8/6 四 | D4 | 弟子列表 UI | ① 列表条目场景 ② 姓名/资质/境界显示 ③ 点击详情 | 列表可浏览弟子 | ⬜ |
+| 8/7 五 | D5 | 修炼循环 | ① 修为随时间增长(资质×灵气) ② 境界门槛 ③ 突破判定 | 弟子自动修炼，可突破 | ⬜ |
+| 8/8 六 | D6 | 建筑系统基础 | ① 灵石矿场景 ② 建造→每时辰产出 ③ 升级 | 建筑产灵石，升级加速 | ⬜ |
+| 8/9 日 | D7 | 休息 / 补漏 | 修本周 bug，整理代码 | git 干净 | ⬜ |
+| 8/10 一 | D8 | 存档接入 | ① SaveSystem JSON 序列化 ② 存/读接口 ③ 替换 SavePanel 测试数据 | 读档后数据还原 | ⬜ |
+| 8/11 二 | D9 | 打磨 | 数值平衡初调，玩 10 分钟验证 | 无致命 bug | ⬜ |
+| 8/12 三 | D10 | **M1 验收** | 完整跑一遍：新游戏→招弟子→挂机→存→退→读 | 闭环可玩 | ⬜ |
+
+## 三、第 3–5 周（8/17–9/6）：P2 扩展
+
+| 日期 | 周 | 任务 | 拆解 | 交付 |
+| ---- | -- | ---- | ---- | ---- |
+| 8/17–8/23 | W3 | 财政经济 | ① 收支流水 ② 俸禄发放 ③ 价格波动 | 财政面板 |
+| 8/24–8/30 | W4 | 任务系统 | ① 任务生成 ② 贡献值 ③ 兑换商店 | 任务面板 |
+| 8/31–9/6 | W5 | 生产制造 + 战斗基础 | ① 炼丹工坊 ② 弟子组队 ③ 外敌入侵事件 | **M2 验收** |
+
+## 四、第 6–10 周（9/7–10/11）：P3 扩展
+
+| 周 | 任务 | 交付 |
+| -- | ---- | ---- |
+| W6 | 秘境系统 | 探索/副本 |
+| W7 | 外交系统 | 宗门关系/联盟 |
+| W8 | 剧情事件 | 主线/随机事件 |
+| W9 | 打磨平衡 | 数值/UI 优化 |
+| W10 | **M3 验收** | 正式版本 |
+
+## 五、里程碑
+
+```
+M1 (8/12)   ── 核心循环闭环，可玩
+M2 (9/6)    ── 经营玩法丰富
+M3 (10/11)  ── 秘境/外交/剧情，正式版本
+```
+
+## 六、每日开工检查单
+
+- [ ] 昨晚 TODO 完成？
+- [ ] git status 干净（有改动先提交）
+- [ ] F5 能正常运行
+- [ ] 今晚只做 1 个主目标（拆解为 30 分钟小步）
+
+## 七、纪律规则
+
+1. 每晚只设 1 个主目标，完成后不贪多
+2. 卡壳超过 30 分钟 → 简化方案，不硬磕
+3. 每步可运行验证，禁止写一大段不跑通的代码
+4. 每天必须 git 提交（哪怕只有一行）
+5. 周末至少半天完全休息，防倦怠

export_presets.cfg

@@ -0,0 +1,75 @@
+[runnable_presets]
+
+"Windows Desktop"="Windows Desktop"
+
+[preset.0]
+
+name="Windows Desktop"
+platform="Windows Desktop"
+dedicated_server=false
+custom_features=""
+export_filter="scenes"
+export_files=PackedStringArray()
+include_filter=""
+exclude_filter=""
+export_path="../aaa.exe"
+patches=PackedStringArray()
+patch_delta_encoding=false
+patch_delta_compression_level_zstd=19
+patch_delta_min_reduction=0.1
+patch_delta_include_filters="*"
+patch_delta_exclude_filters=""
+encryption_include_filters=""
+encryption_exclude_filters=""
+seed=0
+encrypt_pck=false
+encrypt_directory=false
+script_export_mode=2
+
+[preset.0.options]
+
+custom_template/debug=""
+custom_template/release=""
+debug/export_console_wrapper=1
+binary_format/embed_pck=true
+texture_format/s3tc_bptc=true
+texture_format/etc2_astc=false
+shader_baker/enabled=true
+binary_format/architecture="x86_64"
+codesign/enable=false
+codesign/timestamp=true
+codesign/timestamp_server_url=""
+codesign/digest_algorithm=1
+codesign/description=""
+codesign/custom_options=PackedStringArray()
+application/modify_resources=true
+application/icon=""
+application/console_wrapper_icon=""
+application/icon_interpolation=4
+application/file_version=""
+application/product_version=""
+application/company_name=""
+application/product_name=""
+application/file_description=""
+application/copyright=""
+application/trademarks=""
+application/export_angle=0
+application/export_d3d12=0
+application/d3d12_agility_sdk_multiarch=true
+ssh_remote_deploy/enabled=false
+ssh_remote_deploy/host="user@host_ip"
+ssh_remote_deploy/port="22"
+ssh_remote_deploy/extra_args_ssh=""
+ssh_remote_deploy/extra_args_scp=""
+ssh_remote_deploy/run_script="Expand-Archive -LiteralPath '{temp_dir}\\{archive_name}' -DestinationPath '{temp_dir}'
+$action = New-ScheduledTaskAction -Execute '{temp_dir}\\{exe_name}' -Argument '{cmd_args}'
+$trigger = New-ScheduledTaskTrigger -Once -At 00:00
+$settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries
+$task = New-ScheduledTask -Action $action -Trigger $trigger -Settings $settings
+Register-ScheduledTask godot_remote_debug -InputObject $task -Force:$true
+Start-ScheduledTask -TaskName godot_remote_debug
+while (Get-ScheduledTask -TaskName godot_remote_debug | ? State -eq running) { Start-Sleep -Milliseconds 100 }
+Unregister-ScheduledTask -TaskName godot_remote_debug -Confirm:$false -ErrorAction:SilentlyContinue"
+ssh_remote_deploy/cleanup_script="Stop-ScheduledTask -TaskName godot_remote_debug -ErrorAction:SilentlyContinue
+Unregister-ScheduledTask -TaskName godot_remote_debug -Confirm:$false -ErrorAction:SilentlyContinue
+Remove-Item -Recurse -Force '{temp_dir}'"

project.godot

@@ -11,18 +11,34 @@ config_version=5
 [application]
 
 config/name="模拟宗门"
+run/main_scene="uid://d1odycoaqhhyg"
 config/features=PackedStringArray("4.7", "Forward Plus")
-config/icon="res://icon.svg"
+
+[autoload]
+
+GameState="*res://src/Core/GameState.gd"
+TimeSystem="*res://src/Core/TimeSystem.gd"
+Settings="*res://src/Core/Settings.gd"
+SectManager="*res://src/Core/SectManager.gd"
 
 [display]
 
-window/stretch/mode="canvas_items"
-window/stretch/aspect="expand"
+window/size/viewport_width=1920
+window/size/viewport_height=1080
+window/stretch/mode="viewport"
+window/size/window_mode=2
 
 [dotnet]
 
 project/assembly_name="模拟宗门"
 
+[internationalization]
+
+locale/locale_filter_mode=1
+locale/script_filter=["Hans"]
+locale/country_filter=["CN"]
+locale/language_filter=[]
+
 [physics]
 
 3d/physics_engine="Jolt Physics"
@@ -30,3 +46,7 @@ project/assembly_name="模拟宗门"
 [rendering]
 
 rendering_device/driver.windows="d3d12"
+anti_aliasing/quality/msaa_2d=3
+anti_aliasing/quality/msaa_3d=3
+anti_aliasing/quality/screen_space_aa=2
+anti_aliasing/quality/use_taa=true

src/Core/GameState.gd

@@ -0,0 +1,30 @@
+## 全局游戏状态（Autoload 单例）。
+## 负责场景间参数传递与会话状态管理，不持有游戏内数据。
+extends Node
+
+## 进入游戏的方式。
+enum GameMode { NEW_GAME, LOAD_GAME }
+
+## 当前进入游戏的方式。
+var mode: GameMode = GameMode.NEW_GAME
+## 要加载的存档 ID（仅 LOAD_GAME 时有效）。
+var save_id: String = ""
+
+# 游戏内时间（12 月 × 30 天 = 360 天/年），实际推进由 TimeSystem 负责
+var year: int = 1
+var month: int = 1
+var day: int = 1
+
+## 请求开始新游戏：重置模式与时间。
+func request_new_game() -> void:
+	mode = GameMode.NEW_GAME
+	save_id = ""
+	year = 1
+	month = 1
+	day = 1
+
+## 请求加载指定存档。
+## @param id: 存档 ID
+func request_load_game(id: String) -> void:
+	mode = GameMode.LOAD_GAME
+	save_id = id

src/Core/GameState.gd.uid

@@ -0,0 +1 @@
+uid://d1ajv537oir2l

src/Core/MainGame.gd

@@ -0,0 +1,13 @@
+## 主游戏世界场景入口（挂载于 MainGame.tscn）。
+## 进入游戏时根据 GameState 模式初始化，并连接顶部 HUD 信号。
+extends Node
+
+func _ready() -> void:
+	# 注册为游戏世界场景（供 TimeSystem 判断是否推进时间）
+	add_to_group("game_scene")
+	# 应用用户设置中的默认流速
+	TimeSystem.apply_default_speed()
+
+## 顶部 HUD 的返回主菜单请求。
+func _on_top_bar_hud_sign_return_mainmenu() -> void:
+	get_tree().change_scene_to_file("res://src/UI/Panels/MainMenu/MainMenu.tscn")

src/Core/MainGame.gd.uid

@@ -0,0 +1 @@
+uid://centrk8l54j7c

src/Core/MainGame.tscn

@@ -0,0 +1,12 @@
+[gd_scene format=3 uid="uid://box7tj5iyiopq"]
+
+[ext_resource type="Script" uid="uid://centrk8l54j7c" path="res://src/Core/MainGame.gd" id="1_8bu23"]
+[ext_resource type="PackedScene" uid="uid://dl0tb68vsw3c6" path="res://src/UI/HUD/TopBarHUD.tscn" id="1_g6xmk"]
+
+[node name="MainGame" type="Node" unique_id=2053561265]
+groups = ["game_scene"]
+script = ExtResource("1_8bu23")
+
+[node name="TopBarHud" parent="." unique_id=1115394694 instance=ExtResource("1_g6xmk")]
+
+[connection signal="sign_return_mainmenu" from="TopBarHud" to="." method="_on_top_bar_hud_sign_return_mainmenu"]

src/Core/SectManager.gd

@@ -0,0 +1,25 @@
+## 宗门资源管理器（Autoload 单例）。
+extends Node
+
+signal spirit_stones_changed(new_value: int, delta: int)
+signal reputation_changed(new_value: int, delta: int)
+
+var spirit_stones := 0      # 灵石
+var reputation := 0         # 声望
+
+
+func add_spirit_stones(amount: int) -> void:
+	spirit_stones += amount
+	emit_signal("spirit_stones_changed", spirit_stones, amount)
+
+func remove_spirit_stones(amount: int) -> void:
+	spirit_stones -= amount
+	emit_signal("spirit_stones_changed", spirit_stones, -amount)
+
+func add_reputation(amount: int) -> void:
+	reputation += amount
+	emit_signal("reputation_changed", reputation, amount)
+
+func remove_reputation(amount: int) -> void:
+	reputation -= amount
+	emit_signal("reputation_changed", reputation, -amount)

src/Core/SectManager.gd.uid

@@ -0,0 +1 @@
+uid://c25eic5uquo2o

src/Core/Settings.gd

@@ -0,0 +1,21 @@
+## 用户设置（Autoload 单例）。
+## 负责个人偏好设置的持久化，保存于 user:// 目录，与游戏存档分离。
+extends Node
+
+## 设置文件的保存路径。
+const SAVE_PATH := "user://settings.cfg"
+
+## 新游戏开局时的默认流速档位索引（1 = 5x）。
+var default_speed_index := 1
+
+## 从磁盘加载设置（不存在则保持默认值）。
+func load_settings() -> void:
+	var cfg := ConfigFile.new()
+	if cfg.load(SAVE_PATH) == OK:
+		default_speed_index = cfg.get_value("time", "speed_index", 1)
+
+## 将当前设置写入磁盘。
+func save_settings() -> void:
+	var cfg := ConfigFile.new()
+	cfg.set_value("time", "speed_index", default_speed_index)
+	cfg.save(SAVE_PATH)

src/Core/Settings.gd.uid

@@ -0,0 +1 @@
+uid://exwk46qy4x6t

src/Core/TimeSystem.gd

@@ -0,0 +1,139 @@
+## 全局时间系统（Autoload 单例）。
+## 负责游戏时间的推进与播报，仅在世界场景中运行。
+## 历法：12 月 × 30 日 = 360 日/年。
+extends Node
+
+## 每当推进一日后发出。
+## @param year: 当前年份
+## @param month: 当前月份（1-12）
+## @param day: 当前日（1-30）
+signal day_passed(year: int, month: int, day: int)
+## 每当进入新月份时发出（同一天内 day_passed 之后）。
+## @param year: 当前年份
+## @param month: 当前月份（1-12）
+signal month_passed(year: int, month: int)
+## 每当进入新年份时发出（同一天内 month_passed 之后）。
+## @param year: 当前年份
+signal year_passed(year: int)
+## 时间流速档位变化时发出。
+## @param speed_index: 新档位在 SPEEDS 中的索引
+signal speed_changed(speed_index: int)
+## 暂停状态变化时发出。
+## @param paused: 是否已暂停
+signal pause_changed(paused: bool)
+
+## 可选的时间流速倍率档位。
+const SPEEDS := [1.0, 5.0, 20.0]
+## 每月的天数。
+const DAYS_PER_MONTH := 30
+## 每年的月数。
+const MONTHS_PER_YEAR := 12
+## 现实世界每 1 天对应的时长（秒）。
+const DAY_LENGTH := 0.5
+
+## 当前流速档位在 SPEEDS 中的索引。
+var speed_index := 0
+## 当前流速倍率（与 SPEEDS[speed_index] 保持一致）。
+var speed := 1.0
+## 是否暂停时间推进。
+var paused := false
+## 已累积的现实时间（秒），未满 1 天。
+var _elapsed := 0.0
+
+
+func _process(delta: float) -> void:
+	if paused or not _is_in_game():
+		return
+	_elapsed += delta * speed
+	if _elapsed >= DAY_LENGTH:
+		_elapsed -= DAY_LENGTH
+		_advance()
+
+
+## 判断当前场景是否为游戏世界场景（主菜单/存档界面不推进时间）。
+## 通过 "game_scene" 分组识别，而非场景名。
+func _is_in_game() -> bool:
+	var scene := get_tree().current_scene
+	return scene != null and scene.is_in_group("game_scene")
+
+
+## 推进一日并广播对应信号，跨月/跨年时补发 month_passed / year_passed。
+func _advance() -> void:
+	var new_month := false
+	var new_year := false
+	GameState.day += 1
+	if GameState.day > DAYS_PER_MONTH:
+		GameState.day = 1
+		GameState.month += 1
+		new_month = true
+		if GameState.month > MONTHS_PER_YEAR:
+			GameState.month = 1
+			GameState.year += 1
+			new_year = true
+	day_passed.emit(GameState.year, GameState.month, GameState.day)
+	if new_month:
+		month_passed.emit(GameState.year, GameState.month)
+	if new_year:
+		year_passed.emit(GameState.year)
+
+
+## 循环切换下一档流速，返回新倍率。
+func cycle_speed() -> float:
+	speed_index = (speed_index + 1) % SPEEDS.size()
+	speed = SPEEDS[speed_index]
+	speed_changed.emit(speed_index)
+	return speed
+
+
+## 应用用户设置中的默认流速档位（新游戏开局调用）。
+func apply_default_speed() -> void:
+	set_speed_index(Settings.default_speed_index)
+
+
+## 直接设置流速档位（越界自动钳制）。
+## @param index: 目标档位索引
+func set_speed_index(index: int) -> void:
+	speed_index = clampi(index, 0, SPEEDS.size() - 1)
+	speed = SPEEDS[speed_index]
+	speed_changed.emit(speed_index)
+
+
+## 切换暂停状态，返回切换后的暂停状态。
+func toggle_pause() -> bool:
+	paused = not paused
+	pause_changed.emit(paused)
+	return paused
+
+
+## 显式设置暂停状态（幂等，状态未变化时不发信号）。
+## @param value: 目标暂停状态
+func set_paused(value: bool) -> void:
+	if paused == value:
+		return
+	paused = value
+	pause_changed.emit(paused)
+
+
+## 当前流速的显示文本，如 "x5"。
+func get_speed_label() -> String:
+	return "x%d" % int(speed)
+
+
+## 当前日期数组 [年, 月, 日]。
+func get_current_date() -> Array:
+	return [GameState.year, GameState.month, GameState.day]
+
+
+## 当前日期文本，如 "3年 5月 12日"。
+func get_date_text() -> String:
+	return "%d年 %d月 %d日" % [GameState.year, GameState.month, GameState.day]
+
+
+## 直接设置日期（供读档/测试使用）。
+## @param y: 年
+## @param m: 月（1-12）
+## @param d: 日（1-30）
+func set_date(y: int, m: int, d: int) -> void:
+	GameState.year = y
+	GameState.month = m
+	GameState.day = d

src/Core/TimeSystem.gd.uid

@@ -0,0 +1 @@
+uid://c13ljuiktgrgw

src/UI/HUD/TopBarHUD.tscn

@@ -0,0 +1,176 @@
+[gd_scene format=3 uid="uid://dl0tb68vsw3c6"]
+
+[ext_resource type="FontFile" uid="uid://drt448qncx27p" path="res://assets/fonts/dingliezhuhaifont-20240831GengXinBan)-2.ttf" id="1_pa2rn"]
+[ext_resource type="Script" uid="uid://d3o1ssph7ca58" path="res://src/UI/HUD/top_bar_hud.gd" id="1_vm4eo"]
+
+[sub_resource type="LabelSettings" id="LabelSettings_bn2o5"]
+font = ExtResource("1_pa2rn")
+font_size = 32
+
+[node name="TopBarHud" type="Control" unique_id=1115394694]
+layout_mode = 3
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+script = ExtResource("1_vm4eo")
+
+[node name="HBoxContainer" type="HBoxContainer" parent="." unique_id=1608257100]
+layout_mode = 1
+anchors_preset = 10
+anchor_right = 1.0
+offset_bottom = 23.0
+grow_horizontal = 2
+
+[node name="Label_Currency" type="Label" parent="HBoxContainer" unique_id=766096596]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 8
+text = "灵石"
+label_settings = SubResource("LabelSettings_bn2o5")
+
+[node name="Value_Currency" type="Label" parent="HBoxContainer" unique_id=1150573727]
+unique_name_in_owner = true
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 8
+label_settings = SubResource("LabelSettings_bn2o5")
+
+[node name="Label_Time" type="Label" parent="HBoxContainer" unique_id=671872515]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 8
+text = "时间"
+label_settings = SubResource("LabelSettings_bn2o5")
+
+[node name="Value_Time" type="Label" parent="HBoxContainer" unique_id=1229577188]
+unique_name_in_owner = true
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 8
+size_flags_stretch_ratio = 2.0
+label_settings = SubResource("LabelSettings_bn2o5")
+
+[node name="Label_Reputation" type="Label" parent="HBoxContainer" unique_id=985110673]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 8
+text = "声望"
+label_settings = SubResource("LabelSettings_bn2o5")
+
+[node name="Value_Reputation" type="Label" parent="HBoxContainer" unique_id=2011931119]
+unique_name_in_owner = true
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 8
+label_settings = SubResource("LabelSettings_bn2o5")
+
+[node name="SpeedGroup" type="HBoxContainer" parent="HBoxContainer" unique_id=2144893126]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_stretch_ratio = 3.0
+theme_override_constants/separation = 4
+
+[node name="Button_Pause" type="Button" parent="HBoxContainer/SpeedGroup" unique_id=2144893127]
+unique_name_in_owner = true
+custom_minimum_size = Vector2(64, 0)
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_stretch_ratio = 3.0
+theme_override_fonts/font = ExtResource("1_pa2rn")
+theme_override_font_sizes/font_size = 32
+text = "暂停"
+
+[node name="Button_Speed1" type="Button" parent="HBoxContainer/SpeedGroup" unique_id=2144893128]
+unique_name_in_owner = true
+custom_minimum_size = Vector2(48, 0)
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_stretch_ratio = 2.0
+theme_override_fonts/font = ExtResource("1_pa2rn")
+theme_override_font_sizes/font_size = 32
+text = "1x"
+
+[node name="Button_Speed5" type="Button" parent="HBoxContainer/SpeedGroup" unique_id=2144893129]
+unique_name_in_owner = true
+custom_minimum_size = Vector2(48, 0)
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_stretch_ratio = 2.0
+theme_override_fonts/font = ExtResource("1_pa2rn")
+theme_override_font_sizes/font_size = 32
+text = "5x"
+
+[node name="Button_Speed20" type="Button" parent="HBoxContainer/SpeedGroup" unique_id=2144893130]
+unique_name_in_owner = true
+custom_minimum_size = Vector2(48, 0)
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_stretch_ratio = 2.0
+theme_override_fonts/font = ExtResource("1_pa2rn")
+theme_override_font_sizes/font_size = 32
+text = "20x"
+
+[node name="placeholder_1" type="Label" parent="HBoxContainer" unique_id=1042446504]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 8
+label_settings = SubResource("LabelSettings_bn2o5")
+
+[node name="placeholder_2" type="Label" parent="HBoxContainer" unique_id=1526548351]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 8
+label_settings = SubResource("LabelSettings_bn2o5")
+
+[node name="placeholder_3" type="Label" parent="HBoxContainer" unique_id=1170426663]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 8
+label_settings = SubResource("LabelSettings_bn2o5")
+
+[node name="placeholder_4" type="Label" parent="HBoxContainer" unique_id=1878816574]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 8
+label_settings = SubResource("LabelSettings_bn2o5")
+
+[node name="placeholder_5" type="Label" parent="HBoxContainer" unique_id=491155620]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 8
+label_settings = SubResource("LabelSettings_bn2o5")
+
+[node name="placeholder_6" type="Label" parent="HBoxContainer" unique_id=1738250574]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 8
+label_settings = SubResource("LabelSettings_bn2o5")
+
+[node name="Button_StaffManagement" type="Button" parent="HBoxContainer" unique_id=568204305]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 4
+theme_override_fonts/font = ExtResource("1_pa2rn")
+theme_override_font_sizes/font_size = 32
+text = "管理"
+
+[node name="Button_ResourcesManagement" type="Button" parent="HBoxContainer" unique_id=1424251140]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 4
+theme_override_fonts/font = ExtResource("1_pa2rn")
+theme_override_font_sizes/font_size = 32
+text = "资源"
+
+[node name="Button_Return" type="Button" parent="HBoxContainer" unique_id=867839141]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 4
+theme_override_fonts/font = ExtResource("1_pa2rn")
+theme_override_font_sizes/font_size = 32
+text = "返回"
+
+[connection signal="button_up" from="HBoxContainer/SpeedGroup/Button_Pause" to="." method="_on_button_pause_button_up"]
+[connection signal="button_up" from="HBoxContainer/Button_Return" to="." method="_on_button_return_button_up"]

src/UI/HUD/top_bar_hud.gd

@@ -0,0 +1,65 @@
+## 顶部信息栏 HUD（挂载于 TopBarHUD.tscn）。
+## 显示灵石/时间/声望，提供时间流速控制与返回主菜单入口。
+extends Control
+
+## 请求返回主菜单。
+signal sign_return_mainmenu
+
+@onready var time_label: Label = %Value_Time
+@onready var currency_label: Label = %Value_Currency
+@onready var reputation_label: Label = %Value_Reputation
+@onready var pause_button: Button = %Button_Pause
+@onready var speed_buttons: Array[Button] = [%Button_Speed1, %Button_Speed5, %Button_Speed20]
+
+func _ready() -> void:
+	for i in speed_buttons.size():
+		var btn := speed_buttons[i]
+		btn.toggle_mode = true
+		btn.button_up.connect(_on_speed_button_up.bind(i))
+	# 时间：每日推进时刷新日期
+	TimeSystem.day_passed.connect(_on_day_passed)
+	# 资源数值：信号仅在变化时触发，初始值需手动设置一次
+	SectManager.spirit_stones_changed.connect(_on_spirit_stones_changed)
+	SectManager.reputation_changed.connect(_on_reputation_changed)
+	currency_label.text = str(SectManager.spirit_stones)
+	reputation_label.text = str(SectManager.reputation)
+	time_label.text = TimeSystem.get_date_text()
+	_update_speed_ui()
+
+## 每日推进时刷新日期显示。
+func _on_day_passed(_year: int, _month: int, _day: int) -> void:
+	time_label.text = TimeSystem.get_date_text()
+
+## 灵石数量变化时刷新显示。
+## @param new_value: 变化后的灵石总量
+func _on_spirit_stones_changed(new_value: int, _delta: int) -> void:
+	currency_label.text = str(new_value)
+
+## 声望变化时刷新显示。
+## @param new_value: 变化后的声望总量
+func _on_reputation_changed(new_value: int, _delta: int) -> void:
+	reputation_label.text = str(new_value)
+
+## 点击"返回"按钮。
+func _on_button_return_button_up() -> void:
+	sign_return_mainmenu.emit()
+
+## 点击暂停/继续按钮，切换后刷新按钮状态。
+func _on_button_pause_button_up() -> void:
+	TimeSystem.toggle_pause()
+	_update_speed_ui()
+
+## 点击流速档位按钮。
+## @param index: 目标档位索引（由 _ready 中 bind 传入）
+func _on_speed_button_up(index: int) -> void:
+	TimeSystem.set_speed_index(index)
+	_update_speed_ui()
+
+## 刷新速度组 UI：暂停按钮文字与各档位按下状态。
+## 选中档位用 toggle 的 pressed 状态表达（原生高亮），暂停时禁用档位按钮。
+func _update_speed_ui() -> void:
+	pause_button.text = "继续" if TimeSystem.paused else "暂停"
+	for i in speed_buttons.size():
+		var btn := speed_buttons[i]
+		btn.set_pressed_no_signal(i == TimeSystem.speed_index)
+		btn.disabled = TimeSystem.paused

src/UI/HUD/top_bar_hud.gd.uid

@@ -0,0 +1 @@
+uid://d3o1ssph7ca58

src/UI/Panels/MainMenu/MainMenu.gd

@@ -0,0 +1,25 @@
+## 主菜单场景（挂载于 MainMenu.tscn）。
+extends Control
+
+## 点击"新游戏"：重置 GameState 后进入游戏世界。
+func MainMenu_NewGame_ButtonUp() -> void:
+	GameState.request_new_game()
+	get_tree().change_scene_to_file("res://src/Core/MainGame.tscn")
+
+## 点击"读取存档"：隐藏主按钮组并显示存档面板。
+func MainMenu_LoadGame_ButtonUp() -> void:
+	$ButtonGroup.hide()
+	$SavePanel.show()
+
+## 点击"设置"（TODO：接入设置面板）。
+func MainMenu_Settings_ButtonUp() -> void:
+	pass
+
+## 点击"退出"。
+func MainMenu_Quit_ButtonUp() -> void:
+	get_tree().quit()
+
+## 存档面板请求返回。
+func _on_save_panel_back_pressed() -> void:
+	$SavePanel.hide()
+	$ButtonGroup.show()

src/UI/Panels/MainMenu/MainMenu.gd.uid

@@ -0,0 +1 @@
+uid://drfyh36my6gj2

src/UI/Panels/MainMenu/MainMenu.tscn

@@ -0,0 +1,83 @@
+[gd_scene format=3 uid="uid://d1odycoaqhhyg"]
+
+[ext_resource type="Script" uid="uid://drfyh36my6gj2" path="res://src/UI/Panels/MainMenu/MainMenu.gd" id="1_cwvg5"]
+[ext_resource type="Texture2D" uid="uid://caeqoc6wx8toy" path="res://assets/sprites/ui/BG1.png" id="1_hrti0"]
+[ext_resource type="FontFile" uid="uid://drt448qncx27p" path="res://assets/fonts/dingliezhuhaifont-20240831GengXinBan)-2.ttf" id="3_q7typ"]
+[ext_resource type="PackedScene" uid="uid://dj7b5vssydifa" path="res://src/UI/Panels/SavePanel.tscn" id="3_wrf65"]
+
+[node name="MainMenu" type="Control" unique_id=1416317040]
+layout_mode = 3
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+script = ExtResource("1_cwvg5")
+
+[node name="BG" type="TextureRect" parent="." unique_id=2104369666]
+layout_mode = 1
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+texture = ExtResource("1_hrti0")
+
+[node name="Logo" type="TextureRect" parent="." unique_id=1485724026]
+layout_mode = 1
+anchors_preset = 5
+anchor_left = 0.5
+anchor_right = 0.5
+offset_left = -200.0
+offset_top = 60.0
+offset_right = 200.0
+offset_bottom = 260.0
+grow_horizontal = 2
+
+[node name="ButtonGroup" type="VBoxContainer" parent="." unique_id=569064410]
+layout_mode = 1
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+theme_override_constants/separation = 16
+alignment = 1
+
+[node name="NewGame" type="Button" parent="ButtonGroup" unique_id=835084060]
+custom_minimum_size = Vector2(200, 48)
+layout_mode = 2
+theme_override_fonts/font = ExtResource("3_q7typ")
+theme_override_font_sizes/font_size = 32
+text = "新游戏"
+
+[node name="LoadGame" type="Button" parent="ButtonGroup" unique_id=2093610529]
+custom_minimum_size = Vector2(200, 48)
+layout_mode = 2
+theme_override_fonts/font = ExtResource("3_q7typ")
+theme_override_font_sizes/font_size = 32
+text = "读取存档"
+
+[node name="Settings" type="Button" parent="ButtonGroup" unique_id=2045302694]
+custom_minimum_size = Vector2(200, 48)
+layout_mode = 2
+theme_override_fonts/font = ExtResource("3_q7typ")
+theme_override_font_sizes/font_size = 32
+text = "设置"
+
+[node name="Quit" type="Button" parent="ButtonGroup" unique_id=818112870]
+custom_minimum_size = Vector2(200, 48)
+layout_mode = 2
+theme_override_fonts/font = ExtResource("3_q7typ")
+theme_override_font_sizes/font_size = 32
+text = "退出"
+
+[node name="SavePanel" parent="." unique_id=619488443 instance=ExtResource("3_wrf65")]
+visible = false
+layout_mode = 1
+
+[connection signal="button_up" from="ButtonGroup/NewGame" to="." method="MainMenu_NewGame_ButtonUp"]
+[connection signal="button_up" from="ButtonGroup/LoadGame" to="." method="MainMenu_LoadGame_ButtonUp"]
+[connection signal="button_up" from="ButtonGroup/Settings" to="." method="MainMenu_Settings_ButtonUp"]
+[connection signal="button_up" from="ButtonGroup/Quit" to="." method="MainMenu_Quit_ButtonUp"]
+[connection signal="back_pressed" from="SavePanel" to="." method="_on_save_panel_back_pressed"]

src/UI/Panels/SavePanel.gd

@@ -0,0 +1,10 @@
+## 存档选择面板（挂载于 SavePanel.tscn）。
+## 显示存档列表与"新建存档"入口，通过信号通知外部结果。
+extends PanelContainer
+
+## 请求关闭面板（返回上级界面）。
+signal back_pressed
+
+## 点击"返回"按钮。
+func _on_button_esc_button_up() -> void:
+	back_pressed.emit()

src/UI/Panels/SavePanel.gd.uid

@@ -0,0 +1 @@
+uid://boao04d7accm

src/UI/Panels/SavePanel.tscn

@@ -0,0 +1,61 @@
+[gd_scene format=3 uid="uid://dj7b5vssydifa"]
+
+[ext_resource type="Script" uid="uid://boao04d7accm" path="res://src/UI/Panels/SavePanel.gd" id="1_oi6jj"]
+[ext_resource type="PackedScene" uid="uid://dk7ggyngkyt18" path="res://src/UI/Panels/SaveSlot.tscn" id="2_uloko"]
+
+[node name="SavePanel" type="PanelContainer" unique_id=619488443]
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+script = ExtResource("1_oi6jj")
+
+[node name="VBoxContainer" type="VBoxContainer" parent="." unique_id=1850400883]
+layout_mode = 2
+theme_override_constants/separation = 16
+
+[node name="Header" type="HBoxContainer" parent="VBoxContainer" unique_id=2020722155]
+layout_mode = 2
+
+[node name="TitleLabel" type="Label" parent="VBoxContainer/Header" unique_id=784512345]
+layout_mode = 2
+theme_override_font_sizes/font_size = 24
+text = "选择存档"
+
+[node name="Spacer" type="Control" parent="VBoxContainer/Header" unique_id=784512346]
+layout_mode = 2
+size_flags_horizontal = 3
+
+[node name="Button_Esc" type="Button" parent="VBoxContainer/Header" unique_id=866430190]
+layout_mode = 2
+text = "返回"
+
+[node name="ScrollContainer" type="ScrollContainer" parent="VBoxContainer" unique_id=500577526]
+layout_mode = 2
+size_flags_vertical = 3
+size_flags_stretch_ratio = 9.0
+
+[node name="HBoxContainer" type="HBoxContainer" parent="VBoxContainer/ScrollContainer" unique_id=596966633]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_vertical = 3
+
+[node name="VBoxContainer" type="VBoxContainer" parent="VBoxContainer/ScrollContainer/HBoxContainer" unique_id=844163531]
+layout_mode = 2
+size_flags_horizontal = 3
+
+[node name="SaveGroup" type="Button" parent="VBoxContainer/ScrollContainer/HBoxContainer/VBoxContainer" unique_id=150349711]
+layout_mode = 2
+text = "存档1"
+
+[node name="SlotList" type="VBoxContainer" parent="VBoxContainer/ScrollContainer/HBoxContainer" unique_id=674823582]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_stretch_ratio = 5.0
+
+[node name="SaveSlot" parent="VBoxContainer/ScrollContainer/HBoxContainer/SlotList" unique_id=214547620 instance=ExtResource("2_uloko")]
+layout_mode = 2
+size_flags_vertical = 1
+
+[connection signal="button_up" from="VBoxContainer/Header/Button_Esc" to="." method="_on_button_esc_button_up"]

src/UI/Panels/SaveSlot.gd

@@ -0,0 +1,52 @@
+## 存档槽位条目（挂载于 SaveSlot.tscn）。
+## 展示单个存档信息；空槽位用于新建存档。
+extends PanelContainer
+
+## 槽位被点击时发出，save_id 为空表示点击了新建槽位。
+## @param save_id: 存档 ID
+signal slot_pressed(save_id: String)
+
+@onready var slot_index_label: Label = %SlotIndexLabel
+@onready var save_name_label: Label = %SaveNameLabel
+@onready var meta_line1: Label = %MetaLine1
+@onready var meta_line2: Label = %MetaLine2
+@onready var delete_button: Button = %DeleteButton
+@onready var arrow_button: Button = %ArrowIcon
+
+## 本槽位对应的存档 ID。
+var save_id: String = ""
+## 是否已有存档数据（false 表示新建槽位）。
+var has_data: bool = false
+
+## 填充为已有存档槽位。
+## @param id: 存档 ID
+## @param name_text: 存档名称
+## @param meta1: 第一行元数据
+## @param meta2: 第二行元数据
+func setup(id: String, name_text: String, meta1: String, meta2: String) -> void:
+	save_id = id
+	has_data = true
+	slot_index_label.text = id.get_slice("save_", 1)  # "save_001" -> "001"
+	save_name_label.text = name_text
+	meta_line1.text = meta1
+	meta_line2.text = meta2
+	delete_button.visible = true
+	arrow_button.visible = true
+
+## 填充为"新建存档"空槽位。
+func setup_empty() -> void:
+	has_data = false
+	slot_index_label.text = "+"
+	save_name_label.text = "新建存档"
+	meta_line1.text = "点击创建新的存档"
+	meta_line2.text = ""
+	delete_button.visible = false
+	arrow_button.visible = false
+
+## 槽位本体被点击。
+func _on_pressed() -> void:
+	slot_pressed.emit(save_id)
+
+## 点击删除按钮（TODO：接入确认弹窗）。
+func _on_delete_button_button_up() -> void:
+	print("删除存档: ", save_id)

src/UI/Panels/SaveSlot.gd.uid

@@ -0,0 +1 @@
+uid://b0uq6cg05y428

src/UI/Panels/SaveSlot.tscn

@@ -0,0 +1,57 @@
+[gd_scene format=3 uid="uid://dk7ggyngkyt18"]
+
+[ext_resource type="Script" uid="uid://b0uq6cg05y428" path="res://src/UI/Panels/SaveSlot.gd" id="1_ss0t"]
+
+[node name="SaveSlot" type="PanelContainer" unique_id=214547620]
+anchors_preset = 14
+anchor_top = 0.5
+anchor_right = 1.0
+anchor_bottom = 0.5
+offset_top = -4.0
+offset_bottom = 4.0
+grow_horizontal = 2
+grow_vertical = 2
+size_flags_horizontal = 3
+size_flags_vertical = 3
+script = ExtResource("1_ss0t")
+
+[node name="HBoxContainer" type="HBoxContainer" parent="." unique_id=2068970062]
+layout_mode = 2
+
+[node name="SlotIndexLabel" type="Label" parent="HBoxContainer" unique_id=945932834]
+unique_name_in_owner = true
+custom_minimum_size = Vector2(40, 0)
+layout_mode = 2
+size_flags_horizontal = 3
+vertical_alignment = 1
+
+[node name="VBoxContainer" type="VBoxContainer" parent="HBoxContainer" unique_id=94051654]
+layout_mode = 2
+size_flags_horizontal = 3
+size_flags_stretch_ratio = 15.0
+
+[node name="SaveNameLabel" type="Label" parent="HBoxContainer/VBoxContainer" unique_id=131729571]
+unique_name_in_owner = true
+layout_mode = 2
+
+[node name="MetaLine1" type="Label" parent="HBoxContainer/VBoxContainer" unique_id=1955990569]
+unique_name_in_owner = true
+layout_mode = 2
+
+[node name="MetaLine2" type="Label" parent="HBoxContainer/VBoxContainer" unique_id=1454183959]
+unique_name_in_owner = true
+layout_mode = 2
+
+[node name="DeleteButton" type="Button" parent="HBoxContainer" unique_id=1697002131]
+unique_name_in_owner = true
+layout_mode = 2
+size_flags_horizontal = 3
+text = "删除"
+
+[node name="ArrowIcon" type="Button" parent="HBoxContainer" unique_id=540783971]
+unique_name_in_owner = true
+layout_mode = 2
+size_flags_horizontal = 3
+text = "▶"
+
+[connection signal="button_up" from="HBoxContainer/DeleteButton" to="." method="_on_delete_button_button_up"]