AGC 输入区三处观感修复：AI 润色归位、@ 面板筛选条单行、引用 chip 原子化

- styles.css：把 direct-codex composer 下广播式的 `.project-supervisor-composer button` 规则收窄到 `.project-supervisor-submit-button`（含 svg 那条与 media query 里那条），并给 `.resource-reference-input-actions` 补 `grid-column: 1 / -1` 让输入区操作排独占一行 - styles.css：`.resource-reference-input-actions` / `.resource-reference-input-at` 撤掉绝对定位，操作排回到网格文档流，与输入框右下角对齐，不再浮在文本区中间 - styles.css：`.resource-reference-input-polish` 与 `.resource-reference-input-restore` 并入 `@` 按钮同一条尺寸规则（28px 方钮、8px 圆角、同 hover/disabled 观感） - styles.css：输入区状态行（润色中/润色失败）改为与应用排同一行，不再单独占一行顶高 22.8px - styles.css：direct-codex 输入框 padding 收为 `12px 15px 6px`，窄屏 `10px 12px 6px` - styles.css：`.resource-reference-chip` 的 `×` 删除按钮不再被 broadcast 规则摘出 chip - PlatformSegmentedTabs.tsx：分段页签 item 加 `whitespace-nowrap`，中文不再逐字竖排 - packages/shared/styles.css：补 `.scrollbar-hide` 实现（该类名一直被 `layout="scroll"` 引用但仓库未定义） - ResourceReferenceNode.tsx：`getTextContent()` 改为单个 U+FFFC 占位符并显式实现 `getTextContentSize()`，引用成为真正的原子内联节点（1 个引用 = 1 个字符） - tests/resourceReferenceInput.test.tsx：新增「1 个引用 = 1 个字符」与「chip 自带删除、一次删净」两条断言 - tests/appSurface/project-development.suite.ts：把 composer 按钮样式断言收窄到提交按钮，并新增一条反向断言，钉住「广播到 composer 下所有 button」的规则不再出现
修正 AGC 快速编辑 4xx 失败原因取值：优先 details.message 并附 provider 与素材类型上下文
2026-09-10 19:05:57 +08:00 · 2026-09-10 19:01:09 +08:00 · 2026-09-10 19:01:04 +08:00 · 2026-09-10 19:00:52 +08:00 · 2026-09-10 19:00:44 +08:00 · 2026-09-10 18:59:33 +08:00
251 changed files with 25142 additions and 43866 deletions
@@ -1285,9 +1285,6 @@ if (tauriConfig.identifier !== 'world.genarrative.ai-game-creator') {
  throw new Error('AI game creator shell identifier drifted');
 }

-const expectedBundledDesignAgentResources = {
-  'design-agent': 'design-agent',
-};
 const expectedBundledCodexResources = {
  'resources/codex/win-x64/bin/codex.exe': 'codex/win-x64/bin/codex.exe',
  'resources/codex/win-x64/bin/codex-code-mode-host.exe':
@@ -1303,33 +1300,16 @@ const expectedBundledCodexResources = {
  'resources/codex/win-x64/NOTICE.md': 'codex/win-x64/NOTICE.md',
  'resources/codex/win-x64/manifest.json': 'codex/win-x64/manifest.json',
 };
-assert.deepEqual(
-  tauriConfig.bundle?.resources,
-  expectedBundledDesignAgentResources,
-  'AI game creator shell base Tauri config must bundle the design-agent resource pack',
-);
-for (const key of Object.keys(tauriConfig.bundle?.resources ?? {})) {
-  if (String(key).includes('codex')) {
-    throw new Error(
-      'AI game creator shell base Tauri config must not require Windows-only Codex resources',
-    );
-  }
+if (tauriConfig.bundle?.resources !== undefined) {
+  throw new Error(
+    'AI game creator shell base Tauri config must not require Windows-only Codex resources',
+  );
 }
 assert.deepEqual(
  windowsTauriConfig.bundle?.resources,
  expectedBundledCodexResources,
  'AI game creator shell Windows Tauri config must bundle the complete pinned Codex resource set',
 );
-if (
-  Object.prototype.hasOwnProperty.call(
-    windowsTauriConfig.bundle?.resources ?? {},
-    'design-agent',
-  )
-) {
-  throw new Error(
-    'design-agent resource pack must not be mixed into the Windows Codex sidecar bundle',
-  );
-}
 if (windowsTauriConfig.bundle?.useLocalToolsDir !== true) {
  throw new Error(
    'AI game creator shell Windows Tauri config must cache bundling tools in the project target directory',
@@ -1,7 +1,7 @@
 {
  "$schema": "../gen/schemas/desktop-schema.json",
  "identifier": "main",
-  "description": "AI 游戏创作主窗口允许读取系统剪贴板图片，用于粘贴素材附件。",
+  "description": "AI 游戏创作主窗口允许读取系统剪贴板图片，用于粘贴素材附件；允许弹出原生打开/保存对话框用于素材上传与导出。",
  "windows": ["client"],
  "permissions": [
    "clipboard-manager:allow-read-image",
@@ -21,6 +21,7 @@
      ]
    },
    "opener:default",
-    "dialog:allow-open"
+    "dialog:allow-open",
+    "dialog:allow-save"
  ]
 }
@@ -1 +0,0 @@
-当前阶段：系统架构。明确系统清单、职责边界、依赖和数据归属。
@@ -1,6 +0,0 @@
-共享过程文件（如需维护，请使用这些相对路径）：
- project/analysis.md
- project/决策台账.md
- project/dialog.md
-不要把正式产物写在工作区根目录，也不要等审批失败后再迁移。
-阶段审批工具：当你判断本阶段必需产物已完成时，必须提交阶段审批。用户批准后 Runtime 自动进入下一阶段；你不能自行切换阶段。
@@ -1 +0,0 @@
-当前阶段：概念设计。明确游戏是什么、不是什么，并形成概念设计产物。
@@ -1,4 +0,0 @@
-顾问阶段不需要继续自主推动项目或主动安排下一步；遵照用户的具体指示行动。
-根据用户指示回答问题、读取相关文档、修改工作区文件，并说明改动可能影响的已有产物。
-涉及方向性变化或多个可行方案时，先向用户说明影响并等待用户决定；不要替用户做决定。
-顾问阶段没有下一层，也不需要提交阶段审批。
@@ -1 +0,0 @@
-当前阶段：项目顾问。五个策划阶段已经完成，后续由用户指示驱动协作。
@@ -1,44 +0,0 @@
-概念阶段定稿时，还必须创建或更新 `project/速览卡.md`。Runtime 只检查该文件是否存在，不检查内容。请使用下面的固定结构，不要加入审批操作说明或独立的决定状态段落：
-
-# 速览卡：《游戏名》
-
-## 1. 游戏名称
-
-## 2. 游戏分类
-
-## 3. 美术风格
- 视觉类型：
- 风格关键词：
- 色彩与氛围：
- MVP 美术边界：
-
-## 4. 一句话描述
-
-## 5. 游戏支柱
-| 支柱 | 玩家感受 | 实现机制 |
-|---|---|---|
-
-## 6. 核心循环
-
-## 7. 目标用户
- 核心用户：
- 游戏偏好：
- 单次游玩时长：
- 参考游戏与参考点：
-
-## 8. 平台事实
-
-## 9. 最小 MVP 系统
-| 系统 | 最小功能 | 为什么必须有 | 验证方法 |
-|---|---|---|---|
-
-## 10. 给创作者的关键提示
- 先做：
- 暂时不做：
- 这样验证：
- 达标再扩展：
-
-### 待原型验证项
- 问题：
- 原型：
- 观察：
@@ -1 +0,0 @@
-当前阶段：系统文档。逐个完成已确定系统的内部规则、接口和验证标准。
@@ -1 +0,0 @@
-当前阶段：技术文档。完成数据与配表、技术实现、美术圣经和总册。
@@ -1 +0,0 @@
-当前阶段：顶层设计。明确玩家持续游玩的循环、资源流、节奏和系统范围。
@@ -1,384 +0,0 @@
-{
-  "version": 1,
-  "resources": [
-    {
-      "path": "skills/concept.md",
-      "id": "skills.concept",
-      "summary": "概念阶段写作规则。",
-      "category": "skills",
-      "title": "概念设计分册",
-      "inject_phases": [
-        "concept"
-      ]
-    },
-    {
-      "path": "skills/top_design.md",
-      "id": "skills.top_design",
-      "summary": "顶层设计阶段写作规则。",
-      "category": "skills",
-      "title": "顶层设计分册",
-      "inject_phases": [
-        "top_design"
-      ]
-    },
-    {
-      "path": "skills/architecture.md",
-      "id": "skills.architecture",
-      "summary": "系统架构阶段写作规则。",
-      "category": "skills",
-      "title": "系统架构分册",
-      "inject_phases": [
-        "architecture"
-      ]
-    },
-    {
-      "path": "skills/systems.md",
-      "id": "skills.systems",
-      "summary": "系统文档阶段写作规则。",
-      "category": "skills",
-      "title": "系统文档分册",
-      "inject_phases": [
-        "systems"
-      ]
-    },
-    {
-      "path": "skills/tdd.md",
-      "id": "skills.tdd",
-      "summary": "技术文档阶段写作规则。",
-      "category": "skills",
-      "title": "技术文档分册",
-      "inject_phases": [
-        "tdd"
-      ]
-    },
-    {
-      "id": "templates.analysis",
-      "category": "templates",
-      "title": "analysis",
-      "summary": "策划文档结构模板。",
-      "path": "templates/analysis.md"
-    },
-    {
-      "id": "templates.architecture",
-      "category": "templates",
-      "title": "architecture",
-      "summary": "策划文档结构模板。",
-      "path": "templates/architecture.md"
-    },
-    {
-      "id": "templates.concept_design",
-      "category": "templates",
-      "title": "concept-design",
-      "summary": "策划文档结构模板。",
-      "path": "templates/concept-design.md"
-    },
-    {
-      "id": "templates.stardew_analysis",
-      "category": "templates",
-      "title": "stardew-analysis",
-      "summary": "策划文档结构模板。",
-      "path": "templates/stardew-analysis.md"
-    },
-    {
-      "id": "templates.tdd_art_bible",
-      "category": "templates",
-      "title": "tdd-art-bible",
-      "summary": "策划文档结构模板。",
-      "path": "templates/tdd-art-bible.md"
-    },
-    {
-      "id": "templates.tdd_data",
-      "category": "templates",
-      "title": "tdd-data",
-      "summary": "策划文档结构模板。",
-      "path": "templates/tdd-data.md"
-    },
-    {
-      "id": "templates.tdd_master",
-      "category": "templates",
-      "title": "tdd-master",
-      "summary": "策划文档结构模板。",
-      "path": "templates/tdd-master.md"
-    },
-    {
-      "id": "templates.tdd_tech",
-      "category": "templates",
-      "title": "tdd-tech",
-      "summary": "策划文档结构模板。",
-      "path": "templates/tdd-tech.md"
-    },
-    {
-      "id": "templates.top_design",
-      "category": "templates",
-      "title": "top-design",
-      "summary": "策划文档结构模板。",
-      "path": "templates/top-design.md"
-    },
-    {
-      "id": "exemplars.decision_log",
-      "category": "exemplars",
-      "title": "decision-log",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/decision-log.md"
-    },
-    {
-      "id": "exemplars.fast_gdd",
-      "category": "exemplars",
-      "title": "fast-gdd",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/fast-gdd.md"
-    },
-    {
-      "id": "exemplars.overview_card",
-      "category": "exemplars",
-      "title": "overview-card",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/overview-card.md"
-    },
-    {
-      "id": "exemplars.stardew_architecture",
-      "category": "exemplars",
-      "title": "stardew-architecture",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/stardew-architecture.md"
-    },
-    {
-      "id": "exemplars.stardew_concept",
-      "category": "exemplars",
-      "title": "stardew-concept",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/stardew-concept.md"
-    },
-    {
-      "id": "exemplars.stardew_s06_combat",
-      "category": "exemplars",
-      "title": "stardew-s06-combat",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/stardew-s06-combat.md"
-    },
-    {
-      "id": "exemplars.stardew_tdd_art_bible",
-      "category": "exemplars",
-      "title": "stardew-tdd-art-bible",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/stardew-tdd-art-bible.md"
-    },
-    {
-      "id": "exemplars.stardew_tdd_data",
-      "category": "exemplars",
-      "title": "stardew-tdd-data",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/stardew-tdd-data.md"
-    },
-    {
-      "id": "exemplars.stardew_tdd_master",
-      "category": "exemplars",
-      "title": "stardew-tdd-master",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/stardew-tdd-master.md"
-    },
-    {
-      "id": "exemplars.stardew_tdd_tech",
-      "category": "exemplars",
-      "title": "stardew-tdd-tech",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/stardew-tdd-tech.md"
-    },
-    {
-      "id": "exemplars.stardew_top_design",
-      "category": "exemplars",
-      "title": "stardew-top-design",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/stardew-top-design.md"
-    },
-    {
-      "id": "exemplars.tdd_art_bible_SKILL",
-      "category": "exemplars",
-      "title": "tdd-art-bible-SKILL",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/tdd-art-bible-SKILL.md"
-    },
-    {
-      "id": "exemplars.tdd_data_SKILL",
-      "category": "exemplars",
-      "title": "tdd-data-SKILL",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/tdd-data-SKILL.md"
-    },
-    {
-      "id": "exemplars.tdd_tech_SKILL",
-      "category": "exemplars",
-      "title": "tdd-tech-SKILL",
-      "summary": "策划文档范例或需求附件。",
-      "path": "exemplars/tdd-tech-SKILL.md"
-    },
-    {
-      "id": "system_types.核心玩法编排.skill",
-      "category": "system_types",
-      "title": "01_核心玩法编排 skill",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/01_核心玩法编排/SKILL.md"
-    },
-    {
-      "id": "system_types.核心玩法编排.template",
-      "category": "system_types",
-      "title": "01_核心玩法编排 template",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/01_核心玩法编排/模板.md"
-    },
-    {
-      "id": "system_types.时间与日程.skill",
-      "category": "system_types",
-      "title": "02_时间与日程 skill",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/02_时间与日程/SKILL.md"
-    },
-    {
-      "id": "system_types.时间与日程.template",
-      "category": "system_types",
-      "title": "02_时间与日程 template",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/02_时间与日程/模板.md"
-    },
-    {
-      "id": "system_types.生产种植经营.skill",
-      "category": "system_types",
-      "title": "03_生产种植经营 skill",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/03_生产种植经营/SKILL.md"
-    },
-    {
-      "id": "system_types.生产种植经营.template",
-      "category": "system_types",
-      "title": "03_生产种植经营 template",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/03_生产种植经营/模板.md"
-    },
-    {
-      "id": "system_types.地图与探索.skill",
-      "category": "system_types",
-      "title": "04_地图与探索 skill",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/04_地图与探索/SKILL.md"
-    },
-    {
-      "id": "system_types.地图与探索.template",
-      "category": "system_types",
-      "title": "04_地图与探索 template",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/04_地图与探索/模板.md"
-    },
-    {
-      "id": "system_types.采集与支线活动.skill",
-      "category": "system_types",
-      "title": "05_采集与支线活动 skill",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/05_采集与支线活动/SKILL.md"
-    },
-    {
-      "id": "system_types.采集与支线活动.template",
-      "category": "system_types",
-      "title": "05_采集与支线活动 template",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/05_采集与支线活动/模板.md"
-    },
-    {
-      "id": "system_types.战斗与敌人.skill",
-      "category": "system_types",
-      "title": "06_战斗与敌人 skill",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/06_战斗与敌人/SKILL.md"
-    },
-    {
-      "id": "system_types.战斗与敌人.template",
-      "category": "system_types",
-      "title": "06_战斗与敌人 template",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/06_战斗与敌人/模板.md"
-    },
-    {
-      "id": "system_types.物品背包与制作.skill",
-      "category": "system_types",
-      "title": "07_物品背包与制作 skill",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/07_物品背包与制作/SKILL.md"
-    },
-    {
-      "id": "system_types.物品背包与制作.template",
-      "category": "system_types",
-      "title": "07_物品背包与制作 template",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/07_物品背包与制作/模板.md"
-    },
-    {
-      "id": "system_types.成长与技能.skill",
-      "category": "system_types",
-      "title": "08_成长与技能 skill",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/08_成长与技能/SKILL.md"
-    },
-    {
-      "id": "system_types.成长与技能.template",
-      "category": "system_types",
-      "title": "08_成长与技能 template",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/08_成长与技能/模板.md"
-    },
-    {
-      "id": "system_types.NPC关系与任务.skill",
-      "category": "system_types",
-      "title": "09_NPC关系与任务 skill",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/09_NPC关系与任务/SKILL.md"
-    },
-    {
-      "id": "system_types.NPC关系与任务.template",
-      "category": "system_types",
-      "title": "09_NPC关系与任务 template",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/09_NPC关系与任务/模板.md"
-    },
-    {
-      "id": "system_types.经济与商店.skill",
-      "category": "system_types",
-      "title": "10_经济与商店 skill",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/10_经济与商店/SKILL.md"
-    },
-    {
-      "id": "system_types.经济与商店.template",
-      "category": "system_types",
-      "title": "10_经济与商店 template",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/10_经济与商店/模板.md"
-    },
-    {
-      "id": "system_types.事件与节日.skill",
-      "category": "system_types",
-      "title": "11_事件与节日 skill",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/11_事件与节日/SKILL.md"
-    },
-    {
-      "id": "system_types.事件与节日.template",
-      "category": "system_types",
-      "title": "11_事件与节日 template",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/11_事件与节日/模板.md"
-    },
-    {
-      "id": "system_types.UI与文本呈现.skill",
-      "category": "system_types",
-      "title": "12_UI与文本呈现 skill",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/12_UI与文本呈现/SKILL.md"
-    },
-    {
-      "id": "system_types.UI与文本呈现.template",
-      "category": "system_types",
-      "title": "12_UI与文本呈现 template",
-      "summary": "系统类型写法规则或模板。",
-      "path": "modules/system-types/12_UI与文本呈现/模板.md"
-    }
-  ]
-}
@@ -1 +0,0 @@
-此文档已在需求中声明，但附件内容尚未实现。
@@ -1,124 +0,0 @@
-# 脉冲荒原：节点争夺战
-
-> Fast GDD v1 · 状态：ready\_for\_approval
-> gddId：`gdd-a5309290-edd4-4232-9c7c-d99024e0fa42`
-> fingerprint：`sha256-serde-json-v2:1d34b0cbee5f623a224102e4d832ad6ecc10ffbf27b876d9bc1e24a5483f06a3`
-> approvalRequestId：`gdd-approval-6f5de673-553d-499f-8ca1-8c32f4841bc0`
-
-## 决定状态
-
- **初始需求**（confirmed，user\_freeform，第 0 轮）：用户提出制作原创、可落地的2D坦克大战MVP。
- **坦克对战的胜负目标**（confirmed，user\_option，第 1 轮）：采用区域争夺作为每局主要胜负目标。
- **区域争夺的占领方式**（confirmed，user\_option，第 2 轮）：采用少量多节点轮换占领，迫使双方在路线间转移争夺。
- **轮换节点的结束规则**（confirmed，user\_option，第 3 轮）：控制当前节点持续得分，任一方先达到目标分即获胜。
- **目标用户**（default\_pending，default，第 0 轮）：默认面向喜欢短局、直接操控、位置博弈和可重复挑战的休闲动作玩家。
- **美术方向**（default\_pending，default，第 0 轮）：默认采用风格化、轮廓清晰的原创战场与占位资产，优先验证可读性。
- **成长范围**（default\_pending，default，第 0 轮）：默认设置一条轻量成长线，仅提供少量战后选择，不影响单局闭环。
- **MVP内容边界**（default\_pending，default，第 0 轮）：默认首个版本只做单人对抗一名基础AI、单张地图和一套坦克配置。
-
-## 一句话描述
-
-驾驶原创装甲穿越掩体，在轮换能量节点间交火夺分，先达目标分者赢得一局紧凑的2D坦克区域争夺战。
-
-## 游戏分类与美术
-
- 主类型：2D坦克区域争夺
- 融合类型：无
- 视觉类型：风格化俯视2D
- 关键词：轮廓清晰、几何掩体、弹道高亮、原创装甲
- 色彩氛围：冷青灰战场衬托橙蓝阵营高亮；节点被占领时产生清晰的环形脉冲，命中、受击和得分使用短促高对比反馈。
- MVP 美术边界：MVP 使用可复用的几何占位资产：一张俯视战场、两种原创装甲外形、节点与掩体模块；先保证阵营、弹道、占领状态在桌面和移动视口均清楚。
-
-## 游戏支柱
-
-### 移动夺势
-
- 玩家感受：始终知道下一处冲突在哪里，移动本身就是争夺优势而非赶路。
- 机制：节点位置与活跃状态持续改变，玩家必须在占领、转移、驻守和反攻之间做出即时选择。
- 决定状态：confirmed
-
-### 掩体交火
-
- 玩家感受：每次探头、绕侧和开火都带来可读的风险回报。
- 机制：几何掩体阻挡弹道，玩家通过角度、射击窗口和绕行路线逼退对手，再进入节点控分。
- 决定状态：confirmed
-
-### 清晰逆转
-
- 玩家感受：局势紧张但不迷惑，玩家理解自己为何领先或落后并愿意再开一局。
- 机制：目标分、活跃节点和控制状态持续可视化；落后方可通过夺回当前节点改变局势。
- 决定状态：confirmed
-
-## 核心循环
-
-1. 进入战场并观察当前活跃节点与敌方位置
-2. 驾驶“棱虎机”在几何掩体间移动，瞄准并发射脉冲炮
-3. 抵达活跃节点并在敌方干扰下完成占领或夺回
-4. 控制节点持续积累“脉冲分”，节点轮换后转移路线
-5. 先达到目标分的一方获胜，结算后可立即重开
-
-## 目标用户
-
- 核心用户：偏好短局即时动作、方向操控、躲避射击和争夺空间的休闲玩家；可接受单人对抗基础AI。
- 偏好：喜欢规则一眼可懂、操作反馈直接、每局约十几分钟内完成，并能通过走位和时机而非复杂配装取胜。
- 单局时长：默认每局约10～20分钟；首个可玩闭环优先做到一局可完整开始、争夺、决胜和重开。
- 参考游戏：无
-
-## Runtime 平台事实
-
- Runtime：self-contained-web
- 视口：desktop / mobile
- 输入：keyboard / touch
- 预览：local-http
-
-## MVP 系统
-
-### 坦克操控与射击
-
- 最小功能：提供八方向移动、旋转瞄准、单一脉冲炮射击、受击反馈与短暂失活重生，支持键盘和触控操作。
- 必要原因：直接构成坦克对战手感，也是区域争夺发生的主要冲突手段。
- 验证方式：试玩者能在一分钟内完成移动、瞄准、射击和躲入掩体，并能用射击驱离节点附近敌人。
- 决定状态：confirmed
-
-### 轮换节点占领
-
- 最小功能：以少量节点组成单张战场，仅一个节点在任一时刻活跃；进入后按占优方推进占领，活跃节点轮换并提供清晰状态提示。
- 必要原因：落实用户确认的多节点轮换占领，并制造移动、停留和反攻决策。
- 验证方式：玩家无需额外说明即可找到活跃节点，读懂中立、己方和敌方控制状态，并在轮换后改变路线。
- 决定状态：confirmed
-
-### 目标分胜负
-
- 最小功能：活跃节点由控制方持续获得脉冲分；任一方先达到目标分即胜，显示双方分数、当前节点和胜负结算。
- 必要原因：把占领行为闭合成清晰、可验证的单局目标。
- 验证方式：试玩者能预测哪方领先、理解如何逆转，并在达到目标分时明确知道对局结束。
- 决定状态：confirmed
-
-### 俯视战场结构
-
- 最小功能：布置可绕行的几何掩体、节点路径与出生区域；掩体阻挡弹道并形成接近、驻守和侧袭路线。
- 必要原因：让位置博弈支撑区域争夺，避免节点规则沦为单纯站桩计分。
- 验证方式：观察玩家是否主动利用掩体接近节点或规避火力，而非只在开阔地互射。
- 决定状态：confirmed
-
-### 基础对手AI
-
- 最小功能：提供一名基础AI对手：追踪活跃节点、靠近争夺、在射程内攻击并在失活后返回战场。
- 必要原因：在无多人条件下完成完整的对抗闭环并验证核心玩法。
- 验证方式：连续试玩中，AI应持续争夺节点并制造可理解的反攻机会，不出现长时间卡住或无目标游走。
- 决定状态：default\_pending
-
-## 制作边界
-
- 多人联机与服务器
- 商城、赛季和复杂社交
- 开放世界与完整剧情
- 多地图、多武器树与复杂成长
- 可编辑关卡和排行榜
-
-## 创作者提示
-
- 先做：先做单张紧凑俯视战场、玩家坦克、基础AI对手、移动瞄准射击、掩体碰撞、节点轮换、占领计分和胜负结算，确保一局可从开始玩到结束。
- 暂缓：暂缓多人联机、商城、服务器、开放世界、赛季、复杂社交、完整剧情、多武器树和多地图内容。
- 如何验证：用可操作原型观察玩家是否在首局主动驶向活跃节点、利用掩体交火、理解分数变化并完成一局；记录误读占领状态、无目标游走和胜负不明的情况。
- 何时扩展：仅当试玩者能无讲解理解活跃节点、占领状态和领先来源，并主动移动反攻时，再增加第二种坦克特性、第二张地图或轻量成长选择。
@@ -1 +0,0 @@
-此文档已在需求中声明，但附件内容尚未实现。
@@ -1,200 +0,0 @@
-# 系统架构：《星露谷物语》
-
-## 架构定位与目标
-本阶段确定"哪些系统支撑一轮玩法"，不展开单系统内部规则。
-划分原则：将生活模拟 RPG 拆成职责清晰、可独立讨论的规则系统，同时保留少量跨系统入口，避免"每个功能都能互相调用"造成架构失控。系统划分服务于顶层循环：安排一天、执行活动、获得进展、投入成长、解锁新选择。
-
-一句话架构：
-> 玩家在有限的时间与体力下，通过农场、探索与社交三组活动系统产出资源与关系，经物品与经济系统转化为投资，由时间系统推进日终，把一天的成果变成下一天的选择。
-
-变更记录：
- 2026-09-05：战斗与敌人系统定为伴生风险定位，深度刻意受限，不进入最小闭环核心链（依据：概念分析 D-03）。
-
-## 系统地图
-
-| 编号 | 系统 | 一句话职责 | 优先级 |
-|---|---|---|---|
-| S01 | 时间与日程 | 推进游戏时间、日期、季节、天气、营业时间、NPC 日程和日终结算 | P0 |
-| S02 | 体力与状态 | 管理体力、负面状态、恢复、昏倒和行动成本 | P0 |
-| S03 | 农场经营 | 管理土地、作物、畜牧、农场设施和生产状态 | P0 |
-| S04 | 探索与地图 | 管理区域、出入口、可交互资源点、地图解锁和移动 | P0（基础） |
-| S05 | 采集与钓鱼 | 管理野外采集、钓鱼活动、资源品质和获得物 | P1 |
-| S06 | 战斗与敌人 | 管理矿区或危险区域中的战斗、伤害、敌人行为和战利品 | P1 |
-| S07 | 物品、背包与制作 | 管理物品实例、堆叠、工具、装备、配方和制作队列 | P0 |
-| S08 | 成长与技能 | 管理技能经验、等级、工具升级、职业选择和能力解锁 | P0（基础） |
-| S09 | 经济与商店 | 管理货币、买卖、价格、商店库存、订单和资金流 | P0 |
-| S10 | NPC 与关系 | 管理 NPC 日程、对话、好感度、礼物偏好和关系事件 | P1 |
-| S11 | 任务与社区目标 | 管理任务状态、阶段目标、奖励、社区修复和区域解锁条件 | P1 |
-| S12 | 事件与节日 | 管理季节事件、节日活动、条件触发和特殊奖励 | P1 |
-
-支撑层（不拥有核心规则）：
- 存档与进度系统：保存跨日、跨季节和跨阶段的持久状态。
- UI 与文本呈现层：展示状态、提供操作入口、呈现反馈与文本。
-
-P0 段：
-
-| 系统 | 目的 | 输入 | 输出 | P0 原因 |
-|---|---|---|---|---|
-| S01 时间与日程 | 全局时钟与日终 | 各系统行动完成信号、日终触发 | 日期/季节/天气变化、日终结算、跨天 tick | 没有"一天"，规划与取舍失去标尺 |
-| S02 体力与状态 | 全局行动成本 | 各系统行动请求、食物与休息 | 体力变化、昏倒、状态效果 | 没有它，"想做的事多于做得到的"不成立 |
-| S03 农场经营 | 核心产出与规划场 | 时间 tick、种子与工具、体力 | 作物畜产品、设施生产状态 | 概念核心承诺的载体 |
-| S04 探索与地图 | 活动场景与空间约束 | 移动指令、区域解锁条件 | 位置、区域状态、资源点入口 | 没有空间结构，农/矿/镇一体失去意义 |
-| S07 物品与制作 | 资源身份与转化 | 各系统获得物、配方请求 | 物品实例、制作结果 | 所有系统产出的公共语言 |
-| S08 成长与技能 | 长期回报层 | 各活动经验提交 | 等级、能力与配方解锁 | 长期动机的最小载体 |
-| S09 经济与商店 | 投资与回报换算 | 物品、金钱 | 价格、交易、库存 | 没有它，"变现 vs 投资"张力无载体 |
-
-## 系统职责
-
-| 系统 | 主要职责 | 不负责 → 移交谁 |
-|---|---|---|
-| S01 时间与日程 | 时间推进、日期、季节、天气、营业与日终 | 直接决定某项活动的奖励 → 各活动系统 |
-| S02 体力与状态 | 行动消耗、恢复、昏倒、状态效果 | 农作物或敌人的具体配置 → S03/S06 |
-| S03 农场经营 | 土地、作物、畜牧、设施生产 | 商店买卖规则和角色技能 → S09/S08 |
-| S04 探索与地图 | 区域连接、进入条件、资源点位置、移动 | 具体掉落概率和战斗公式 → S05/S06 |
-| S05 采集与钓鱼 | 采集和钓鱼行为、成功条件、获得物 | 物品价格和任务奖励 → S09/S11 |
-| S06 战斗与敌人 | 战斗流程、敌人状态、伤害与战利品请求 | 角色长期成长和商店价格 → S08/S09 |
-| S07 物品与制作 | 背包、物品、配方、制作与工具装备 | 物品最终经济价值的平衡目标 → S09 |
-| S08 成长与技能 | 经验、等级、技能分支、能力解锁 | 单次行动的基础奖励 → 各活动系统 |
-| S09 经济与商店 | 货币、交易、库存、订单、价格 | 任务剧情与 NPC 情感变化 → S10/S11 |
-| S10 NPC 与关系 | 日程、互动、好感、关系事件 | 全局季节推进和商店库存 → S01/S09 |
-| S11 任务与社区 | 目标、前置、奖励、社区进度和解锁 | NPC 的日常行为表现 → S10 |
-| S12 事件与节日 | 周期事件、特殊流程和限定内容 | 常规日常行动的基础规则 → 各活动系统 |
-
-职责说明：
-
-### S01 时间与日程系统
-负责一天制的节奏规则：什么时候推进日期、哪些系统收到跨天 tick、日终结算何时发生。它不负责奖励结算，也不负责作物成长规则——只负责"什么时候"和"谁被通知"。
-
-### S06 战斗与敌人系统
-负责战斗内状态、敌人行为与战利品请求。它不直接修改商店价格或 NPC 好感，不负责角色长期成长；战利品只提交请求，由 S07 物品系统入账。定位是矿井探索的风险与节奏变化，不是成长主轴（D-03）。
-
-### S07 物品、背包与制作系统
-负责物品身份、容器、堆叠与配方队列。它是全项目的公共语言层——任何系统的产出都以 `item_id` 入账；它不负责物品的经济价值平衡，价格只由 S09 维护。
-
-## 依赖与数据流
-
-```mermaid
-flowchart TD
-  S1[S01 时间与日程] --> S2[S02 体力与状态]
-  S1 --> S3[S03 农场经营]
-  S1 --> S4[S04 探索与地图]
-  S1 --> S10[S10 NPC 与关系]
-  S1 --> S12[S12 事件与节日]
-  S3 --> S7[S07 物品与制作]
-  S4 --> S5[S05 采集与钓鱼]
-  S4 --> S6[S06 战斗与敌人]
-  S5 --> S7
-  S6 --> S7
-  S7 --> S9[S09 经济与商店]
-  S7 --> S8[S08 成长与技能]
-  S8 --> S7
-  S10 --> S11[S11 任务与社区]
-  S12 -.读取日期季节.-> S1
-  UI[UI 与文本呈现] -.读取状态.-> S1
-  UI -.读取状态.-> S3
-  UI -.读取状态.-> S7
-  SAVE[存档与进度] -.订阅持久状态.-> S1
-```
-
-```mermaid
-flowchart LR
-  T[时间/体力] --> ACT[玩家行动]
-  ACT --> GAIN[物品·金钱·经验·关系·任务进度]
-  GAIN --> INV[制作·交易·升级·解锁]
-  INV --> NEW[新的行动选择]
-  NEW --> ACT
-```
-
-主要状态：
- 全局状态：日期、季节、天气、当前时间、已解锁区域、社区进度。
- 玩家状态：位置、体力、生命、技能等级、工具、装备、背包和金钱。
- 场景状态：土地、作物成长、设施生产、资源点、敌人和宝箱。
- 社会状态：NPC 位置、关系值、已触发事件、任务阶段和节日参与状态。
-
-主数据归属规则：
- 规则文档描述"如何计算"和"何时发生"；数据表描述"有哪些对象"和"每个对象的配置"。
- 系统之间通过稳定 ID 关联（物品 ID、NPC ID、区域 ID、任务 ID、配方 ID）。
- 任何系统都不复制另一系统的主数据；任务只引用物品 ID，不重新定义物品价格。
-
-## 核心循环覆盖检查
-
-| 顶层循环环节 | 认领系统 |
-|---|---|
-| 查看天气、日程与目标 | S01、S11、S12、UI |
-| 选择活动并移动 | S04、S02 |
-| 农务与生产 | S03、S07、S02 |
-| 采集、钓鱼与战斗 | S04、S05、S06、S07 |
-| 出售、购买与投资 | S09、S07、S03 |
-| 社交与委托 | S10、S11、S07 |
-| 日终结算与保存 | S01、S12、存档、UI |
-
-## 目录映射
-
-| 目录 | 本阶段定位 |
-|---|---|
-| 03_systems/S01_time_schedule/ | 时间推进、日期季节天气、营业时段、日终结算 |
-| 03_systems/S02_stamina_status/ | 体力、状态效果、昏倒与恢复 |
-| 03_systems/S03_farm_management/ | 土地、作物、畜牧、设施生产 |
-| 03_systems/S04_exploration_map/ | 区域、连接、资源点、解锁与移动 |
-| 03_systems/S05_foraging_fishing/ | 采集、钓鱼、品质与获得物 |
-| 03_systems/S06_combat_enemies/ | 战斗、敌人行为、伤害与战利品请求 |
-| 03_systems/S07_items_inventory_crafting/ | 物品、背包、配方与制作队列 |
-| 03_systems/S08_progression_skills/ | 技能经验、等级、工具升级、能力解锁 |
-| 03_systems/S09_economy_shop/ | 货币、买卖、价格、库存与订单 |
-| 03_systems/S10_npc_relationship/ | NPC 日程、对话、好感与关系事件 |
-| 03_systems/S11_quests_community/ | 任务、社区目标、奖励与解锁条件 |
-| 03_systems/S12_events_festivals/ | 季节事件、节日、条件触发 |
-| 支撑层不单开系统文档 | 存档与 UI 随实现层组织，规则不独立成文 |
-
-## MVP 最小闭环
-1. 玩家在一个游戏日内完成开垦、播种、浇灌，并看到成长状态反馈。
-2. 在时间与体力约束下选择当日主目标（农场劳动或外出）。
-3. 外出采集（或矿井轻度战斗）带回资源。
-4. 通过出售或加工获得金钱，投资种子或工具。
-5. 日终结算展示当日变化并保存。
-6. 次日作物状态变化，玩家据此形成新计划。
-7. 数个游戏日内出现第一次技能提升与配方解锁。
-
-如果这条闭环不成立，不应继续增加钓鱼深度、节日、社区目标或更多区域。
-
-## 统一数值基准
-本案例采用"宽松治愈型"数值风格。全局单位：时间片、游戏日、货币、体力、经验；所有数值字段必须注明单位。
- 时间节奏基准：单次常规行动控制在短时间片内；玩家一天应能完成农务、一个主要外出目标和少量顺路活动；早期玩家不应因一次路线失误失去整天进度。
- 货币量级基准：主要货币只有一种；初期基础种子可用少量日常产出购买；一次普通收获不应立刻买下最高阶升级；任务奖励以补足短期资金为主，不替代生产交易。
- 成长回报基准：前几级在正常尝试一种活动的数个游戏日内出现；升级奖励优先采用节省时间体力、扩大选择和解锁配方，而非单纯提高伤害售价；专长分支宽松可恢复。
- 体力与风险基准：体力是规划提示不是严苛倒计时；普通农务与移动成本低，战斗、钓鱼和重型工具才产生明显取舍；失败成本采用时间、少量金钱或位置变化，不损毁进度。
-
-（具体换算数值与前五日验算由技术文档层·数值策划承接。）
-
-## 系统边界
- 农场经营只管理农场内的生产状态，不负责所有资源的通用背包逻辑。
- 探索与地图只管理"在哪里"和"能否进入"，不管理每种活动的具体奖励。
- 战斗只管理战斗内状态和战利品请求，不直接修改商店价格或 NPC 好感。
- NPC 与关系负责互动和关系变化；任务与社区负责可验证目标，二者通过事件和条件连接。
- UI、文本和表现不反向承载核心规则；所有关键变化必须由规则系统确认。
- 本案例不拆出独立多人、拍卖、复杂天气模拟、动态市场或高复杂度叙事工具系统。
-
-## 优先级与范围
- P0（最小可玩闭环）：时间与日程、体力、农场、物品背包、经济、基础地图、基础成长和日终结算。
- P1（形成完整案例）：采集、钓鱼、轻度战斗、NPC 关系、任务、社区目标、制作、商店、季节和节日。
- P2（扩展内容）：更多区域、敌人、作物、配方、关系事件、节日小游戏和终局后的自由活动。
-
-拆分系统不等于所有系统都要在最小版本同时实现；系统独立性是为了便于协作和后续裁剪。
-
-## 风险与校验
-
-| 风险 | 校验方式 |
-|---|---|
-| 农场变成例行公事，失去规划感 | 玩家是否在目标选择阶段出现真实取舍与计划调整 |
-| 矿井战斗反客为主 | 战斗收益是否仍以"农场难以产出的材料"为主，而非直接金钱 |
-| 时间压力变成打卡义务 | 休闲型玩家能否自由调低日程重量而不被惩罚 |
-| 经济成长过快，后期失去决策 | 升级价格是否持续制造"效率 vs 规模"的选择 |
-| UI 泄题，探索失去意义 | 关键信息是否保留为探索发现而非全量直读 |
-| 系统间主数据重复维护 | 交叉检查：同一事实是否只有一个系统拥有写权 |
-
-## 开放的结构问题
- 体力与生命是否保持为两个状态，还是在轻度战斗中共享一套风险资源？
- NPC 日程、任务条件和节日事件之间采用统一条件格式还是各自维护？
- 农场设施生产是否由农场系统统一管理，还是交给通用制作队列？
- 采集、钓鱼和战斗是否共享统一的"活动结果"接口？
- 哪些系统需要独立数据表，哪些小型配置应合并为一张内容表？
@@ -1,63 +0,0 @@
-# 概念设计：《星露谷物语》
-
-## 一句话概念
-《星露谷物语》是一款以经营农场为基础、融合探索、采集、制作、轻度战斗、角色成长与社区叙事的乡村生活模拟 RPG；玩家通过安排每日时间与体力，把荒废农场逐步建设成理想家园，并与周围居民建立关系。
-
-## 定调与设计锚点
-
-### 定调记录
- 参照选择：以牧场物语系为主（无压力日常方面学动物森友会）；不参考任何高难动作与生存类游戏。
- 调性滑杆：压力感 低 / 战斗比重 低 / 管理深度 中 / 叙事比重 中低 / 节奏 慢。
- 调性锚：
-  T1 轻松治愈、自己的节奏（目标体验）；T2 不劝退、无唯一最优解（体验门槛）；T3 战斗轻度、非高难动作（非目标）；T4 以"游戏日"为单位、可反复的单人体验（情境）；T5 时间体力有限但休闲不打卡（跑偏风险）；T6 小团队可维护的规模（关键约束）；T7 日常叙事而非宏大主线，隐藏信息不迫使玩家查攻略（非目标/跑偏风险）。
-
-### 设计锚点
- 核心幻想：离开令人疲惫的城市生活，继承一片荒废土地，在自己的节奏中经营、探索、成长，并成为社区的一员。
-  玩家念头："再玩一天就好——今天做完想做的事，明天的一切都会更顺手。"
- 目标体验：治愈、自由规划、持续成长、发现秘密，以及"今天的选择会让未来更轻松"的掌控感。
- 玩家动机：改善农场与生活条件；发现新区域和资源；完成社区目标；提升技能；与 NPC 建立关系；按照自己的偏好塑造生活方式。
- 核心循环：安排一天的时间与体力 → 进行农业、采集、钓鱼、采矿、战斗或社交 → 获得资源、金钱、经验与关系进展 → 投资工具、设施、种子和物品 → 解锁更高效或更丰富的活动。
- 跑偏风险：系统过多导致目标分散；时间与体力限制把休闲体验变成每日打卡；隐藏信息迫使玩家依赖外部攻略；经济成长过快使后期失去决策。
- 非目标：不做多人竞争、高难度动作战斗、唯一最优效率经营、主线剧情取代日常（详见《不是什么》）。
-
-## 玩家身份与基调
- 玩家身份：一名辞职逃离城市、继承祖父荒废农场的归乡人——不是拯救世界的英雄，是重新学会生活的人。季节与节日构成一年的节拍，日落结算构成每天的呼吸。
- 情绪基调：温暖治愈，慢而踏实。可以有忙碌与轻度压力（时间、体力），不做生存焦虑（饥饿、债务倒计时）与黑暗题材；孤独感只作为被社区逐渐治愈的起点，不成为基调本身。
-
-## 风格与世界观
-复古像素风的温暖乡村世界。玩家来到一个正在现代化与传统生活之间摇摆的小镇，农场、商店、社区设施、自然区域和矿井共同构成可步行抵达的生活网络。世界观服务于生活模拟而非复杂设定解释：季节、天气、节日、居民日程和区域变化，让同一张地图随着时间产生生活感。叙事主要通过 NPC 日常对话、关系事件、任务和社区目标逐步展开。
-
-## 目标玩家与情境
- 目标玩家：与牧场物语系受众高度重合——喜欢种田与小人际的慢节奏成长玩家；同时吸收动物森友会式"无压力日常整理"的需求（自定义、装饰、按自己的节奏玩）。但它不能变成纯装饰沙盒，因为农场经营的时间、体力与季节取舍，以及社区修复目标必须始终存在。
- 适合情境：单人、可反复游玩、每次一个游戏日或几个游戏日；可以高效规划，也可以把时间用于装饰、社交或探索。
- 体验门槛：需要理解基础资源转换和时间安排，不应要求预先掌握复杂数值或寻找唯一正确答案。
-
-## 不是什么
-| 不是 | 因为 |
-|---|---|
-| 硬核生存农场模拟 | 没有饥饿、债务、死亡惩罚；压力止于温和的时间与体力 |
-| 效率至上的工厂经营 | 不要求唯一最优解，装饰与闲逛是合法玩法而非浪费 |
-| 以战斗为核心的动作游戏 | 战斗只是采矿与探索的伴生风险，深度刻意受限 |
-| 剧情驱动的叙事游戏 | 社区叙事是日常的背景与情感回报，不是任务链主线 |
-| 多人社交平台 | 单人体验为前提，人际关系由 NPC 关系承载 |
-| 无边界开放世界 | 地图是功能明确的小区域网络，全部可步行抵达 |
-
-## 核心张力
- 时间与体力有限，但想做的事情很多：玩家必须决定今天的优先级。
- 立即变现与长期投资：出售资源能快速获得资金，制作设备和升级工具则能提高未来效率。
- 稳定经营与未知探索：农场提供可预测收益，矿井、钓鱼和新区域提供风险与发现。
- 个人效率与社区关系：把时间用于赚钱会挤压社交，但关系又会带来配方、剧情和新的情感目标。
- 自由生活与阶段目标：玩家可以自由安排日常，同时受到季节、节日、任务和社区修复目标的轻度牵引。
-
-## 边界与约束
- 概念层只定义核心幻想、目标用户、体验基调与排除方向；具体战斗公式、作物成长天数、礼物偏好、掉落率、系统清单和 MVP 内容，留给顶层及以后决定。
- 设计规模以单人或小团队可理解、可维护为前提；地图采用多个功能明确的区域，而非无边界开放世界。
- 所有系统都必须回流到"安排一天并获得长期改善"的核心循环；独立小游戏或装饰功能不能成为主要范围扩张来源。
- 案例声明：本文以《星露谷物语》为案例展示设计的组织方式，不复制其具体角色、文本、美术、地图或数值。
-
-## 概念定稿
-《星露谷物语》的核心不是"种田赚钱"，而是：
-> 在自己的节奏里经营一片土地与一段生活——今天的选择让明天更从容，而社区让独居变成归属。
-
-交给下一层的约束：时间与体力必须构成温和而非焦虑的取舍；战斗、采矿、社交等支线必须回流农场生活循环；成长权重要允许玩家自定义（效率型与休闲型玩家都成立）。
-（调性已在第 2 节定死；顶层及以下一切开放问题先回定调记录的 T1~T7 级联。）
@@ -1,120 +0,0 @@
-# 战斗与敌人系统：S06
-
-## 系统目的
-为危险区域提供轻度、可理解的战斗挑战，使玩家在探索中承担风险，并通过装备、补给和技能成长验证长期准备。战斗是生活模拟循环的支柱之一，不是游戏的唯一核心。
-
-## 支撑的玩家体验
- 玩家能观察敌人行为，选择攻击、躲避、补给或撤退。
- 战斗结果主要取决于准备、判断和适度操作，而不是高强度连招。
- 深入危险区域会带来更高资源和成长回报，也会增加生命、时间和补给压力。
- 失败有明确原因和可恢复成本，不应摧毁长期农场进度。
-
-## 进入与退出
-### 进入
- 玩家进入允许战斗的危险区域或触发敌人遭遇。
- 检查区域、时间、装备、生命、背包和任务条件。
- 初始化当前战斗区域、敌人组合、战斗状态和可撤退条件。
-### 退出
- 击败敌人并完成战斗奖励结算。
- 玩家主动撤退或离开战斗区域。
- 玩家生命归零，由体力与状态系统执行昏倒或失败惩罚。
- 特殊事件、日终或区域状态强制结束战斗。
-
-## 玩家行动
- 移动、观察敌人攻击范围和行为状态。
- 普通攻击、重攻击或使用装备技能。
- 防御、闪避、格挡或利用场景短暂规避伤害。
- 使用食物、药剂等消耗品。
- 拾取战利品、调查宝箱或选择继续深入。
- 在满足条件时撤退，保留已结算的奖励。
-
-通用流程：
-`进入遭遇 → 读取敌人状态 → 玩家行动 → 敌人响应 → 结算伤害/效果 → 判断胜负或撤退`
-
-## 取舍表
-
-| 决策 | 立即收益 | 延迟收益 | 主要代价 |
-|---|---|---|---|
-| 继续深入还是安全撤退 | 更多资源 | 更高风险与返程压力 | 已得战利品可能损失 |
-| 消耗品现在用还是留着 | 维持当前探索 | 应对更强敌人 | 局部战况恶化 |
-| 快速击败还是稳健闪避 | 节省时间 | 降低受伤风险 | 补给与时间消耗 |
-| 高伤高耗装备还是基础攻击 | 更快击杀 | 稳定与低消耗 | 资源消耗大 |
-| 资金投武器防具还是农场设施 | 战斗能力 | 农场产能 | 另一侧进度放缓 |
-
-## 状态与规则
-### 玩家战斗状态
- 当前生命、最大生命和状态效果。
- 装备中的武器、防具、饰品和消耗品。
- 攻击、防御、移动、闪避和技能冷却状态。
- 当前战斗区域、遭遇编号和撤退状态。
-### 敌人状态
-敌人状态至少包括待机、警觉、攻击前摇、攻击中、受击、眩晕、死亡和撤退。
-每个敌人的实例数据（生命、位置、目标、状态效果、掉落引用）的字段定义由技术文档层承接。
-### 战斗规则
- 只有满足攻击距离、方向、冷却和装备条件时，攻击才可结算。
- 伤害由攻击来源属性、目标防御、技能倍率和状态效果共同决定。
- 敌人攻击必须有可识别的前摇或预警，给予玩家反应与撤退机会。
- 生命降至零时进入死亡或昏倒状态；具体惩罚由体力与状态系统处理。
- 敌人死亡后只结算一次经验与战利品，并写入遭遇状态，避免重复领取。
- 撤退后已完成的战斗奖励保留，未击败敌人按区域刷新规则处理。
-### 区域遭遇
- 危险区域由敌人组、刷新规则、深度或阶段配置组成。
- 进入更深区域可以提高敌人强度、资源价值和特殊遭遇概率。
- 区域难度应通过可理解的装备、区域和任务条件表达，不依赖突然的数值墙。
- 宝箱、精英敌人和首领可作为独立遭遇类型，但不在最小版本中同时扩张。
-
-## 数值与数据交接（→技术文档层）
-本系统交由技术文档层（数值策划）定义的数据类别：敌人配置、敌人行为配置、武器配置、技能配置、遭遇配置、战利品配置、状态效果配置。
-
-随交接附下的设计侧定性约束：
- 敌人数据拆分为"是什么 / 怎么行动 / 掉什么"三类，使难度与经济可独立调节。
- 普通敌人不应稳定掉落大量高价值物品；战斗收益主要由矿物、经验和区域发现组成。
- 稀有材料是"有明确用途的探索奖励"，但必须保留任务、宝箱等补充渠道，避免战斗失败后无法推进。
- 基础战斗允许玩家一日内完成少量遭遇并安全返程，不要求连续刷怪。
- 失败保留已结算的普通战利品，主要损失是时间、位置或少量金钱，不清空背包。
- 自动化收益节省日常体力，但不能让玩家跳过农场维护的全部决策。
- 收益回流方向：区域 → 敌人 → 材料 → 加工 → 农场自动化；战斗不直接取代农场收入。
-
-## 反馈
- 攻击命中、受击、闪避、格挡和暴击提供清晰的视觉与声音反馈。
- 敌人显示生命、预警、当前状态和可攻击时机。
- 玩家生命、补给、冷却和撤退可用性持续可见。
- 战斗胜利显示经验、战利品和区域进度。
- 失败说明主要原因，并明确损失、保留内容和可恢复路径。
-
-## 内部循环
-### 单次战斗循环
-`观察敌人 → 选择攻击或防御 → 处理敌人响应 → 造成或承受伤害 → 调整策略 → 击败或撤退`
-### 危险区域循环
-`准备装备与补给 → 进入区域 → 战斗与搜刮 → 判断继续深入或返程 → 带回资源 → 升级能力`
-### 长期循环
-`获得战斗经验与装备 → 提升生存能力 → 挑战更深区域 → 获得稀有资源 → 解锁新制作、任务或地图`
-
-## 输入、输出与依赖
-### 输入
- 探索与地图系统提供战斗区域、位置和遭遇入口。
- 时间系统提供当前时间、季节和日终信号。
- 体力与状态系统提供生命、体力、状态效果和失败处理。
- 物品系统提供武器、防具、消耗品和战利品接收入口。
- 成长系统提供属性、技能和装备解锁。
- 玩家通过核心玩法系统提交战斗行动。
-### 输出
- 向物品系统提交战利品和消耗品变化。
- 向成长系统提交战斗经验和能力进度。
- 向地图系统提交敌人、宝箱和遭遇状态。
- 向任务与社区系统提交击败、调查和区域进度。
- 向 UI 输出战斗状态、反馈、胜负和撤退结果。
-
-## 边界与非目标
- 不负责通用生命与昏倒惩罚，只提交状态变化。
- 不负责武器物品的背包、耐久和售价主数据。
- 不负责字段定义、数值配置与表格结构——归技术文档层（数值策划）。
- 不做高难度动作连招、复杂多人战斗或精确帧竞速。
- 不让战斗成为获得普通农场资源的唯一方式。
- 不在本系统中定义全部敌人、武器和首领内容。
-
-## 开放问题
- 战斗采用实时操作，还是更简化的节奏/指令判定？
- 体力是否影响攻击与闪避，还是只影响探索和农务？
- 武器是否有耐久度，还是通过升级与装备更换形成消耗？
- 战斗失败的主要成本采用金钱、位置、时间，还是有限组合？
@@ -1 +0,0 @@
-此文档已在需求中声明，但附件内容尚未实现。
@@ -1 +0,0 @@
-此文档已在需求中声明，但附件内容尚未实现。
@@ -1,59 +0,0 @@
-# TDD 总册：《星露谷物语》
-
-> 状态：active（v0.1 里程碑期）　|　基于 GDD：架构层@v3 + 各系统交接节
-
-## 自足性检查（2026-09-06 生产态复评）
-
-| # | 施工 agent 的问题 | 答案在哪 | 状态 |
-|---|---|---|---|
-| 1 | 七个 P0 系统怎么行为？ | 01 收编章（P0 七系统规则全文已收编@v1；S06 P1 要点已收） | **过** |
-| 2 | 表里有多少行内容、文本全填了吗？ | 03 全量填充（作物8/敌人3/NPC12/文本40/物品46/配方14 全填，第八查全绿） | **过** |
-| 3 | 每个界面长什么样、怎么走？ | 01 UI 交互规格（HUD/背包/商店/对话/结算五界面全） | **过** |
-| 4 | 每份素材什么规格、谁验收过？ | 02 资产状态表 42 行全登记（完成度 12/42，缺口=量产排期非规格缺口） | **过（规格）**／量产进行中 |
-| 5 | 代码怎么组织、跑在哪？ | 01 代码组织+能力边界（三态全落位） | **过** |
-| 6 | 怎么算做完？ | 01 里程碑三判据+三件验收 | **过** |
-
-**结论：六问全过——TDD 规格已自足，施工 agent 可只凭本 TDD 开工。**
-剩余非规格缺口（不阻塞开工，按里程碑推进）：①P1 四系统（S05/S10/S11/S12）施工前补文档并收编；②资产表 30 行量产（按十步流程排期）；③B 级两项（背包容量、生命体力共享）在 v0.1 存档实现前收口。
-
-## 三件状态
-
-| 件 | 状态 | 版本 | 读者 | 一句话结论 |
-|---|---|---|---|---|
-| 01 技术实现 | reviewed | v0.2 | 程序 | P0 铁底七件全部落位（native 4/emulated 3），无 gated；v0.1 判据=一个游戏日全流程 |
-| 02 美术圣经 | locked（锚点已锁） | v1 | 美术 | 视觉锚七件套从 T1~T7 翻译完毕；资产表 ~40 行全登记，农夫已接入、芜菁已验收 |
-| 03 数据与配表 | accepted | ck-001 | 数值+程序 | 七查过、无 blocker、2 warning（公共索引表未建、背包容量未定案）；前五日验算通过 |
-
-## 跨件契约速查
-
-| 缝 | 契约 | 权威在 |
-|---|---|---|
-| 素材绑定 | 作物绑 `crop_{id}`、工具绑 `item_`、敌人绑 `enemy_{id}`、NPC 绑 `npc_{id}`（ID 全部查 03 字段字典指向的表） | 03 字段字典 |
-| 视觉翻译链 | `cozy-pixel-countryside` 溯源概念层 T1/T4/T7；四季色板=日单位与季节推动的视觉形态 | 概念层@v3 第 2 节 |
-| 加载顺序 | 主数据（物品/敌人）→ 关系（掉落/配方）→ 条件（condition 表）→ 文本（text 表最后） | 03 契约七条① |
-| 帧表格式 | `farmer_{anim}_{dir}_{frame}` JSON 帧表：圣经契约列的格式=程序侧帧动画节直接解析的格式 | 01 §能力边界 |
-| 交互热区 | 触控热区 ≥44px；圣经 UI 节与 01 输入表同源（热区按钮规格一字不差） | 01 输入表 |
-| 音频规格 | BGM ogg 循环+循环点标记 -18LUFS、SFX wav 单发——圣经契约与 01 音频表触发实现一致 | 02 音频契约 |
-| 昼夜色调 | `tint_{phase}` 四档程序色值表，豁免绑定、拥有者=美术圣经资产表 | 02 资产状态表 |
-| 拥有者总则 | 数值事实归 03（价格只在经济表）；生产状态归 02（素材验收记录）；技术事实归 01（缩放档位） | 架构层@v3 |
-
-## 开放问题回执汇总
-
-| # | 来源件 | 问题 | 去向 | 状态 |
-|---|---|---|---|---|
-| 1 | **01** | 背包格子还是重量容量（阻断：影响存档与 UI） | 概念层决策卡 | **待用户（B 级置顶）** |
-| 2 | 02 | NPC 对话立绘 +12 张（影响 UI 结构与工时） | 决策卡 | 待用户（B 级） |
-| 3 | 01 | 矿井逐层生成是否本期 | 台账代决（建议 P2） | 待登记 |
-| 4 | 02 | 节日专属装饰 P1/P2 | 台账代决（建议 P2） | 待登记 |
-| 5 | 02 | 矿井色板 1 套 vs 3 套 | 台账代决（建议 1 套+亮度递减） | 待登记 |
-| 6 | 03 | condition/text/station/behavior 公共索引表 | 03 warning（记负责人） | 进行中 |
-
-## 验收总状态
-
-| 件 | 最近验收 | blocker | 结论 |
-|---|---|---|---|
-| 01 | 构建通过+静态检查全绿；双视口验证待 v0.1 联调 | 0 | 结构合格 |
-| 02 | ck-a01~a03：农夫接入✓、芜菁两维过（1 warning）、春瓦技术过视觉待锚点 | 0 | 小批已过闸，允许扩产 |
-| 03 | ck-001 七查全跑 | 0（2 warning） | 允许内容扩充 |
-
-当前无任何 blocker：填数（03）、扩产（02）、v0.1 联调（01）三线并行合法。B 级第 1 条（背包容量）在 v0.1 存档实现前必须收口，否则冻结存档模块。
@@ -1 +0,0 @@
-此文档已在需求中声明，但附件内容尚未实现。
@@ -1,182 +0,0 @@
-# 顶层设计：《星露谷物语》
-
-## 顶层定位与规模锚点
-顶层不是做长线农场生产线，也不是做以探索战斗为主的活动清单，而是让玩家每天都在想：
-> "今天做什么？——下雨天不用浇水，正好下矿井；回来的路上把罗宾的生日礼物送了。"
-
-| 项 | 定义 |
-|---|---|
-| 循环单位 | 一个游戏日（约 10~20 分钟） |
-| 段落构成 | 日初规划 → 白天执行（农务/探索/社交）→ 日落结算 |
-| 操作复杂度 | 低——单人键鼠交互，无动作门槛 |
-| 经营复杂度 | 中——时间、体力、资金三约束下的日程规划；不做生产线布局优化 |
-| 长期主轴 | 第一：农场与生活方式成型；第二：社区修复与技能成长；角色数值只做辅助 |
-
-## 设计目标
-让玩家在一个没有唯一正确答案的乡村生活循环中，同时获得三种回报：
- 轻松生活：可以按自己的兴趣安排一天，通过农场、装饰、收集和社交获得稳定的正反馈。
- 规划掌控：时间、体力、季节和资金构成可理解的取舍，提前准备会让未来更高效。
- 探索成长：探索区域、战斗和资源发现提供变化与风险，并将成果转化为农场与角色的长期改善。
-
-三者的关系不是并列小游戏，而是互相供给：农场提供稳定资源与恢复空间，探索提供稀有资源和发现，社交与社区目标提供方向和情感回报。
-
-## 核心推动力
-玩家每天拥有有限的时间与体力，但可以在一天结束后保留成果，并把收益投入到工具、设施、种子、装备和关系中。短期的"今天做什么"决策，持续转化为长期的"我的生活变得怎样"。
-
-主要推动力按层次排列：
-1. **即时推动**：完成一次采集、收获、战斗或对话，立即得到物品、金钱、经验、信息或关系进展。
-2. **日程推动**：在日落或体力耗尽前完成今天最重要的目标。
-3. **季节推动**：抓住作物、鱼类、节日和任务的时间窗口，准备下一阶段。
-4. **长期推动**：改善农场、解锁区域和设施、完成社区目标、掌握技能，并建立属于自己的生活方式。
-
-## 大循环
-**规划一天 → 执行活动 → 获得资源与关系进展 → 出售、加工或投资 → 解锁更高效率与新内容 → 进入下一天。**
-
-在更长周期中：**完成一个季节目标 → 调整生产与探索计划 → 迎接新季节 → 修复社区或解锁区域 → 扩大玩家可选择的生活方式。**
-
-```mermaid
-flowchart LR
-  A[规划一天] --> B[执行农务/探索/社交]
-  B --> C[获得资源·金钱·经验·关系]
-  C --> D[出售/加工/投资]
-  D --> E[解锁效率与新内容]
-  E --> F[进入下一天]
-  F --> A
-```
-
-## 小循环
-
-### 农务循环
-清理土地、播种或饲养 → 每日维护 → 等待成长 → 收获 → 出售或加工 → 将收益投入下一轮生产。
-
-### 探索循环
-选择目的地与携带物资 → 在有限体力和时间内采集、钓鱼或战斗 → 判断继续深入还是返程 → 带回资源 → 用于升级、制作或出售。
-
-### 社交循环
-寻找 NPC → 观察其日程与需求 → 对话、赠礼或完成委托 → 提升关系 → 解锁新对话、事件、配方或功能。
-
-### 成长循环
-重复使用某类能力 → 获得经验并提升技能 → 获得效率、工具或职业选择 → 以更低成本完成同类活动，并接触更高阶内容。
-
-## 资源流与输入输出
-
-```mermaid
-flowchart LR
-  F[农场生产] -->|作物·畜产品| S[出售与加工]
-  E[采集·钓鱼·采矿·战斗] -->|原料·鱼类·矿物·战利品| S
-  S -->|金钱| I[工具·设施·种子·装备]
-  I -->|效率提升| F
-  E -->|经验| K[技能成长]
-  K -->|效率·配方| F
-  G[社交] -->|关系进展| R[新对话·事件·配方]
-  R --> G
-```
-
- 主要输入：时间与体力；金钱、种子、原材料和消耗品；工具、装备和技能；NPC 关系、任务状态和社区进度；天气、季节、地图位置和活动开放状态。
- 主要输出：农产品、采集物、鱼类、矿物、战利品和加工品；金钱、技能经验、工具/设施升级；地图区域、配方、任务、事件和 NPC 关系解锁；农场外观、生产能力和社区状态变化。
- 反馈四层：
-  - 立即反馈：动画、音效、图标、数字、资源变更和状态变化。
-  - 短期反馈：背包、金钱、任务和技能面板更新。
-  - 中期反馈：设施完成、工具升级、关系事件和新区域开放。
-  - 长期反馈：农场自动化、社区恢复、生活方式成型和终局目标完成。
-
-## 最小体验单位
-一个约 10~20 分钟的"游戏日"：查看状态 → 选一个主目标与一两个顺路次目标 → 执行 → 在时间或体力约束下结束 → 结算并获得当日反馈，决定明天是否继续当前计划或转换方向。
-
-单个行动必须至少提供一种清晰反馈：资源增加、进度推进、能力提升、关系变化、地图信息或视觉状态变化。
-
-## 核心活动流程
-
-| 阶段 | 玩家行为 | 设计目的 |
-|---|---|---|
-| 日初 | 查看天气、季节、农场状态、商店或任务提示 | 给当天决策提供完整状态 |
-| 目标选择 | 从生产、赚钱、探索、成长、社交和社区目标中确定优先级 | 制造当日取舍（张力兑现处） |
-| 准备与出发 | 整理背包，携带工具、消耗品和必要装备 | 投入成本前置，增强方向感 |
-| 执行活动 | 完成一组有空间关系或时间关系的行动 | 核心玩法发生地 |
-| 中途调整 | 根据体力、时间、掉落和突发事件，决定继续、转向或返程 | 张力的实时兑现 |
-| 结算与投资 | 出售或加工资源，购买材料，安排设施和下一轮生产 | 回流与长期化 |
-| 日终反馈 | 记录技能、关系、任务、生产和解锁变化，进入下一天 | 闭合并钩住明天 |
-
-## 取舍表
-
-| 决策 | 立即收益 | 延迟收益 | 主要代价 |
-|---|---|---|---|
-| 出售原料还是加工（张力2） | 快速获得资金 | 更高价值或新用途 | 占用设备与等待时间 |
-| 留在农场还是外出探索（张力3） | 稳定推进生产 | 稀有资源与发现 | 错过维护或消耗补给 |
-| 深入探索还是及时返程（张力3） | 更多资源与经验 | 更高风险和返程压力 | 可能损失当日效率或物资 |
-| 购买工具升级还是扩大生产（张力2） | 提高行动效率 | 增加产量与收入 | 当前资金减少 |
-| 赚钱还是社交（张力4） | 直接经济进展 | 关系、剧情和配方回报 | 消耗可用于生产的时间 |
-| 追求效率还是装饰与兴趣（张力5） | 更快成长 | 个性化与放松体验 | 放弃部分短期收益 |
-
-（张力1"时间与体力有限"由目标选择阶段整体承载。）设计原则：这些选择应产生不同的合理生活方式，而不是把玩家逼向唯一最优路线。
-
-## 节奏结构
- **日内节奏**：信息确认 → 连续行动 → 资源或发现反馈 → 体力/时间压力 → 日终结算。
- **周内节奏**：工作日进行生产与探索，商店营业、NPC 日程和周期事件制造计划变化。
- **季节节奏**：季初准备，季中稳定经营，季末收获与总结；季节变化带来资源、作物、天气和目标变化。
- **长期节奏**：从手工劳动起步，逐步获得工具升级、自动化设施、新区域和更复杂的关系目标。
-
-整体情绪应在"安定的重复"和"偶尔的发现"之间摆动：农场与城镇提供恢复，探索与事件提供变化。
-
-## 失败与回收
-失败主要表现为"少拿与顺延"，不毁掉既有积累。
-
-| 情况 | 结果 |
-|---|---|
-| 当日计划未完成 | 成果顺延到明天，无惩罚；次日优先级重排 |
-| 深夜未归昏倒 | 当日行动终止，次日体力受限，轻度损失 |
-| 矿井中倒下 | 损失部分金钱或物品，保留大部分积累 |
-| 季节更替未收获 | 该季作物枯萎——日历压力的主要形式 |
-| 错过节日或窗口期 | 顺延至下个周期，制造轻度遗憾而非惩罚 |
-
-## 系统范围
-
-| 系统 | 顶层目的 | 边界（本层不做什么） |
-|---|---|---|
-| 农场经营 | 承载规划与回报的核心场 | 不做布局优化向的生产线 |
-| 时间与体力 | 全局硬约束、日程的标尺 | 不做饥饿等生存需求式衰减 |
-| 探索与采集（矿井/钓鱼/采集） | 提供风险与发现 | 不做程序生成的无限地牢 |
-| 轻度战斗 | 矿井探索的风险与节奏变化 | 不做装备驱动的成长主轴 |
-| 物品与制作 | 资源的转化与长期投资 | 不做复杂配方树管理 |
-| 技能成长 | 使用即成长的回报层 | 不做技能树构筑 |
-| NPC 关系与任务 | 社区叙事与情感回报 | 不做分支剧情引擎 |
-| 经济与商店 | 连接产出与投资 | 不做玩家间交易市场 |
-| 季节天气与节日 | 时间压力与变化来源 | 不做动态天气模拟 |
-| 日终结算 | 闭合一天并钩住下一天 | — |
-
-## 范围与非目标
-最小完整版本包含：
- 一个可经营农场
- 一个小镇与若干功能区域
- 基础农务、采集、钓鱼、制作、轻度战斗和探索
- 有日程的 NPC、关系值、任务和社区目标
- 工具/技能成长、商店经济与基础加工链
- 季节、天气、节日和日终结算
-
-不做清单：
- 不做无缝大型开放世界
- 不做复杂实时多人或玩家交易市场
- 不做以操作精度为核心的高难度战斗
- 不为每个系统都添加独立小游戏
- 不在本阶段确定具体数值、完整内容数量或实现方案
-
-## 验证标准
-
-| 验证点 | 成功标准 |
-|---|---|
-| 一天循环成立 | 玩家能复述"今天做了什么、为什么、明天想做什么" |
-| 取舍真实存在 | 玩家在目标选择阶段出现可观察的犹豫或计划调整 |
-| 时间压力温和 | 玩家感到"今天做不完"而不是"今天被逼着做" |
-| 回流成立 | 玩家能把当日收益明确投入到下一轮计划 |
-| 长期钩子成立 | 玩家能说出自己"在为什么长期目标积累" |
-
-## 开放问题
- 休闲玩家与规划玩家的时间/体力压力如何共存？
- 战斗在整体游戏中的最低必要深度是什么，如何避免压过生活模拟？
- 社区目标应采用线性章节、可选收集，还是两者结合？
- 终局是明确的阶段性结算，还是允许玩家在结算后继续自由生活？
- 哪些信息必须通过 UI 直接展示，哪些信息可以保留为探索发现？
-
-## 顶层定稿
-顶层当前定稿为：以一个游戏日为循环单位，时间与体力构成温和硬约束，农场、探索、社交三线互相供给的慢节奏生活循环；矿井战斗保持伴生风险定位，失败只造成少拿与顺延。
-后续架构必须围绕"一天"拆系统（时间/农场/探索/社交/经济/成长/结算）；不得把战斗、制作或任何支线做成独立主轴，不得引入生存焦虑型惩罚。
@@ -1 +0,0 @@
-此文档已在需求中声明，但附件内容尚未实现。
--- a/Show More
+++ b/Show More
				`@@ -1 +0,0 @@`
				`当前阶段：系统架构。明确系统清单、职责边界、依赖和数据归属。`
				`@@ -1 +0,0 @@`
				`当前阶段：概念设计。明确游戏是什么、不是什么，并形成概念设计产物。`
				`@@ -1 +0,0 @@`
				`当前阶段：项目顾问。五个策划阶段已经完成，后续由用户指示驱动协作。`
				`@@ -1 +0,0 @@`
				`当前阶段：系统文档。逐个完成已确定系统的内部规则、接口和验证标准。`
				`@@ -1 +0,0 @@`
				`当前阶段：技术文档。完成数据与配表、技术实现、美术圣经和总册。`
				`@@ -1 +0,0 @@`
				`当前阶段：顶层设计。明确玩家持续游玩的循环、资源流、节奏和系统范围。`
				`@@ -1 +0,0 @@`
				`此文档已在需求中声明，但附件内容尚未实现。`