合并 master：修复 CI comparison base 门禁

- 合入 origin/master（b12a81e9c「修复 AGC 自主运行时测试目录权限与任务目录加固」），使 PR 头包含当前 master tip，门禁 Resolve comparison base 不再拦
- 冲突零：自动合并成功
- 验证：npm run typecheck exit 0；npm run check:rustfmt exit 0

.gitea/workflows/project-ci.yml

@@ -232,6 +232,37 @@ jobs:
             done
           done
 
+      - name: Prepare standalone Rust crate dependencies
+        shell: bash
+        run: |
+          set -euo pipefail
+          # agent-runtime-core / agent-runtime-orchestration 被 server-rs/Cargo.toml 的
+          # exclude 排除，不参与上面的 workspace 锁文件，因此上面那次锁定 fetch 覆盖不到它们；
+          # 而 check:native-shells 会经 agent-runtime-*:check 用 `cargo test --manifest-path`
+          # 单独跑这两个 crate。不在这里预热的话，这两条测试会在测试阶段自己
+          # `Updating crates.io index`，crates.io 一抖动整条 native shell 作业就红
+          # （见 #327 / PR #316 run 1950）。
+          # 两个 crate 都没有提交 Cargo.lock，所以这里只能做不带锁标志的 fetch：
+          # 加锁标志会因为缺少锁文件直接失败。生成的 Cargo.lock 落在两个 crate 目录内，
+          # 已被各自的 .gitignore 忽略，只留在容器里；随后的测试阶段因此能用锁定版本
+          # 解析，不再触碰 registry index。
+          for manifest_path in \
+            server-rs/crates/agent-runtime-core/Cargo.toml \
+            server-rs/crates/agent-runtime-orchestration/Cargo.toml; do
+            for attempt in $(seq 1 5); do
+              if cargo fetch \
+                --target x86_64-unknown-linux-gnu \
+                --manifest-path "${manifest_path}"; then
+                break
+              fi
+              if [[ "${attempt}" -eq 5 ]]; then
+                echo "standalone crate dependency fetch failed after 5 attempts: ${manifest_path}" >&2
+                exit 1
+              fi
+              sleep $((attempt * 2))
+            done
+          done
+
       - name: Run native shell gates
         run: npm run check:native-shells
 

apps/ai-game-creator-shell/scripts/agent-swarm-test-chat.mjs

@@ -371,7 +371,15 @@ async function runMissingConfigWizard(setActiveChild, explicitConfigDir) {
   }
 }
 
-async function secureWindowsPrivateRuntimePath(targetPath, options) {
+async function secureWindowsPrivateRuntimePath(
+  targetPath,
+  options,
+  secureWindowsPath = null,
+) {
+  if (secureWindowsPath) {
+    await secureWindowsPath(targetPath, options);
+    return;
+  }
   const { secureWindowsGameCreatorPathForCurrentUser } = await import(
     './game-creator-config-wizard.mjs'
   );
@@ -383,6 +391,7 @@ async function copyPrivateRuntimeConfigEntry(
   runtimeConfigDir,
   fileName,
   required,
+  secureWindowsPath = null,
 ) {
   const sourcePath = path.join(sourceConfigDir, fileName);
   const sourceMetadata = await lstat(sourcePath).catch((error) => {
@@ -402,9 +411,11 @@ async function copyPrivateRuntimeConfigEntry(
     const sourceBytes = await readFile(sourcePath);
     const destinationFile = await open(destinationPath, 'wx', 0o600);
     try {
-      await secureWindowsPrivateRuntimePath(destinationPath, {
-        isDirectory: false,
-      });
+      await secureWindowsPrivateRuntimePath(
+        destinationPath,
+        { isDirectory: false },
+        secureWindowsPath,
+      );
       await destinationFile.writeFile(sourceBytes);
       await destinationFile.sync();
     } finally {
@@ -437,7 +448,11 @@ async function copyPrivateRuntimeConfigEntry(
   return true;
 }
 
-export async function prepareSwarmTestRuntimeConfig(sourceConfigDir, tempRoot) {
+export async function prepareSwarmTestRuntimeConfig(
+  sourceConfigDir,
+  tempRoot,
+  { secureWindowsPath = null } = {},
+) {
   if (!path.isAbsolute(sourceConfigDir)) {
     throw new Error('配置来源目录必须是绝对路径');
   }
@@ -457,9 +472,11 @@ export async function prepareSwarmTestRuntimeConfig(sourceConfigDir, tempRoot) {
   );
   try {
     if (process.platform === 'win32') {
-      await secureWindowsPrivateRuntimePath(runtimeConfigDir, {
-        isDirectory: true,
-      });
+      await secureWindowsPrivateRuntimePath(
+        runtimeConfigDir,
+        { isDirectory: true },
+        secureWindowsPath,
+      );
     } else {
       await chmod(runtimeConfigDir, 0o700);
     }
@@ -477,12 +494,14 @@ export async function prepareSwarmTestRuntimeConfig(sourceConfigDir, tempRoot) {
       runtimeConfigDir,
       configFileName,
       true,
+      secureWindowsPath,
     );
     await copyPrivateRuntimeConfigEntry(
       canonicalSourceConfigDir,
       runtimeConfigDir,
       localConfigFileName,
       false,
+      secureWindowsPath,
     );
     return {
       path: await realpath(runtimeConfigDir),

apps/ai-game-creator-shell/scripts/check-config.mjs

@@ -114,6 +114,7 @@ const allowedUncalledTauriCommands = [
   'open_game_creator_launcher_window',
   'open_game_creator_workspace_window',
   'read_direct_project_conversation',
+  'reset_design_agent_session',
   'stop_local_game_preview_if_matches',
   'start_game_creator_external_mcp',
   'stop_game_creator_external_mcp',
@@ -1285,6 +1286,9 @@ 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':
@@ -1300,16 +1304,33 @@ const expectedBundledCodexResources = {
   'resources/codex/win-x64/NOTICE.md': 'codex/win-x64/NOTICE.md',
   'resources/codex/win-x64/manifest.json': 'codex/win-x64/manifest.json',
 };
-if (tauriConfig.bundle?.resources !== undefined) {
-  throw new Error(
-    'AI game creator shell base Tauri config must not require Windows-only Codex resources',
-  );
+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',
+    );
+  }
 }
 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',

apps/ai-game-creator-shell/scripts/start-tauri-dev.mjs

@@ -20,6 +20,10 @@ import {
 const appRoot = fileURLToPath(new URL('..', import.meta.url));
 const repoRoot = resolve(appRoot, '../..');
 const tauriCliPath = resolve(repoRoot, 'node_modules/@tauri-apps/cli/tauri.js');
+const AGC_DESIGN_DEBUG_ENV = 'GENARRATIVE_AGC_DESIGN_DEBUG';
+const AGC_DESIGN_DEBUG_VITE_ENV = 'VITE_GENARRATIVE_AGC_DESIGN_DEBUG';
+const designDebugEnabled =
+  process.env[AGC_DESIGN_DEBUG_ENV]?.trim() === '0' ? '0' : '1';
 
 function buildTauriArguments(argv, devUrl = readAgcDevEndpoint().url) {
   const args = [...argv];
@@ -108,7 +112,11 @@ async function runTauriDev(
     if (!prepared || shutdownSignal) return 1;
     const tauriArguments = buildTauriArguments(argv, endpoint.url);
     child = spawnCli(tauriArguments, {
-      env: withAgcDevEndpointEnv(endpoint),
+      env: {
+        ...withAgcDevEndpointEnv(endpoint),
+        [AGC_DESIGN_DEBUG_ENV]: designDebugEnabled,
+        [AGC_DESIGN_DEBUG_VITE_ENV]: designDebugEnabled,
+      },
     });
     const childResult = waitForCli(child);
     const outcome = await Promise.race([
@@ -157,7 +165,13 @@ async function prepareFrontendDev(endpoint, { onChild, signal }) {
   const frontend = spawnChild(
     process.platform === 'win32' ? 'npm.cmd' : 'npm',
     ['run', 'agc:serve'],
-    { cwd: repoRoot, env: withAgcDevEndpointEnv(endpoint) },
+    {
+      cwd: repoRoot,
+      env: {
+        ...withAgcDevEndpointEnv(endpoint),
+        [AGC_DESIGN_DEBUG_VITE_ENV]: designDebugEnabled,
+      },
+    },
   );
   onChild(frontend);
   console.log(

apps/ai-game-creator-shell/src-tauri/capabilities/main.json

@@ -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"
   ]
 }

apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/architecture.md

@@ -0,0 +1 @@
+当前阶段：系统架构。明确系统清单、职责边界、依赖和数据归属。

apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/common-tail.md

@@ -0,0 +1,6 @@
+共享过程文件（如需维护，请使用这些相对路径）：
+- project/analysis.md
+- project/决策台账.md
+- project/dialog.md
+不要把正式产物写在工作区根目录，也不要等审批失败后再迁移。
+阶段审批工具：当你判断本阶段必需产物已完成时，必须提交阶段审批。用户批准后 Runtime 自动进入下一阶段；你不能自行切换阶段。

apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/concept.md

@@ -0,0 +1 @@
+当前阶段：概念设计。明确游戏是什么、不是什么，并形成概念设计产物。

apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/consultant-tail.md

@@ -0,0 +1,4 @@
+顾问阶段不需要继续自主推动项目或主动安排下一步；遵照用户的具体指示行动。
+根据用户指示回答问题、读取相关文档、修改工作区文件，并说明改动可能影响的已有产物。
+涉及方向性变化或多个可行方案时，先向用户说明影响并等待用户决定；不要替用户做决定。
+顾问阶段没有下一层，也不需要提交阶段审批。

apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/consultant.md

@@ -0,0 +1 @@
+当前阶段：项目顾问。五个策划阶段已经完成，后续由用户指示驱动协作。

apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/overview-card.md

@@ -0,0 +1,44 @@
+概念阶段定稿时，还必须创建或更新 `project/速览卡.md`。Runtime 只检查该文件是否存在，不检查内容。请使用下面的固定结构，不要加入审批操作说明或独立的决定状态段落：
+
+# 速览卡：《游戏名》
+
+## 1. 游戏名称
+
+## 2. 游戏分类
+
+## 3. 美术风格
+- 视觉类型：
+- 风格关键词：
+- 色彩与氛围：
+- MVP 美术边界：
+
+## 4. 一句话描述
+
+## 5. 游戏支柱
+| 支柱 | 玩家感受 | 实现机制 |
+|---|---|---|
+
+## 6. 核心循环
+
+## 7. 目标用户
+- 核心用户：
+- 游戏偏好：
+- 单次游玩时长：
+- 参考游戏与参考点：
+
+## 8. 平台事实
+
+## 9. 最小 MVP 系统
+| 系统 | 最小功能 | 为什么必须有 | 验证方法 |
+|---|---|---|---|
+
+## 10. 给创作者的关键提示
+- 先做：
+- 暂时不做：
+- 这样验证：
+- 达标再扩展：
+
+### 待原型验证项
+- 问题：
+- 原型：
+- 观察：

apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/systems.md

@@ -0,0 +1 @@
+当前阶段：系统文档。逐个完成已确定系统的内部规则、接口和验证标准。

apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/tdd.md

@@ -0,0 +1 @@
+当前阶段：技术文档。完成数据与配表、技术实现、美术圣经和总册。

apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/top_design.md

@@ -0,0 +1 @@
+当前阶段：顶层设计。明确玩家持续游玩的循环、资源流、节奏和系统范围。

apps/ai-game-creator-shell/src-tauri/design-agent/resources/catalog.json

@@ -0,0 +1,384 @@
+{
+  "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"
+    }
+  ]
+}

apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/decision-log.md

@@ -0,0 +1,66 @@
+# 决策台账：《星露谷物语》金样项目
+
+版本：v3　|　规则：台账放活队列——design 只放结论、分析只放论证、决定与开放问题住这里。编号连续不复用；被推翻的行标 overturned 挂新行，不删行。
+状态六态：`confirmed`（用户亲口/亲选）/ `auto_decided`（技术类代决，必带理由＋推翻条件，用户一键可翻）/ `default_pending`（默认建议兜底，用户未点头）/ `prototype_pending`（待原型验证）/ `pending_user`（等用户拍板）/ `overturned`（被推翻，挂旧行编号）。
+
+> 编号口径：D-01~D-13 与 exemplars/stardew-analysis.md 台账节选一致（D-04~D-06、D-08~D-10、D-12 原为"就地小权衡，直接登记未开条目"，此处按登记口径展开）；D-14 起为技术文档期新增，与 stardew-tdd-tech.md 开放问题回执互引。
+
+## 当前待办（活队列）
+
+### 等用户拍板（pending_user）
+
+| 编号 | 决定 | 层 | 谁 | 依据 | 推翻条件 | 状态 |
+|---|---|---|---|---|---|---|
+| D-14 | 体力与战斗共享单池 | TDD | user | 风险资源统一制造取舍（概念张力一）；**暂按共享实现，改单拆只需改 S02 成本入口** | 战斗参与率实测过低（玩家回避矿井） | pending_user（暂按共享实现） |
+| D-15 | 背包格子制 vs 重量制 | TDD | user | 格子制直觉、重量制焦虑感与 T5"休闲不打卡"冲突；暂按格子制实现、存档预留 capacity_type 字段 | 格子管理成为主要负面反馈 | pending_user（B 级阻断存档结构，暂按格子制） |
+
+### 待原型验证（prototype_pending）
+
+| 编号 | 决定 | 层 | 谁 | 依据 | 推翻条件 | 状态 |
+|---|---|---|---|---|---|---|
+| D-13b | 战斗判定窗口手感（前摇帧数/无敌帧 450ms 基准） | 系统 | user | 数值可定、手感不可纸面验证 | 原型显示节奏拖慢/玩家困惑 | prototype_pending（规则本体见 D-13 confirmed） |
+
+### 默认建议兜底（default_pending）
+
+| 编号 | 决定 | 层 | 谁 | 依据 | 推翻条件 | 状态 |
+|---|---|---|---|---|---|---|
+| D-19 | 天气权重表具体数值（晴/雨/风暴按季节） | TDD | agent | 概念层只定"雨免浇水"定性；数值推内容期填 | 前 5 日出现连续 3 日雨/全无雨 | default_pending（默认值已进数据表，带 designer_note） |
+
+## 已采用决定
+
+### 用户确认（confirmed）
+
+| 编号 | 决定 | 层 | 谁 | 依据 | 推翻条件 | 状态 |
+|---|---|---|---|---|---|---|
+| D-01 | 定调：牧场物语系参照、治愈慢节奏 | 概念 | user | 用户原始需求 | — | confirmed |
+| D-02 | 单人体验，无多人 | 概念 | user | 概念层非目标 | — | confirmed |
+| D-03 | 战斗保持伴生风险，不做装备驱动主轴 | 概念 | user | 概念期问题一 | 矿井流失率过半且归因战斗 | confirmed |
+| D-07 | 日目标自设，季节与社区提供低频牵引 | 顶层 | user | 顶层期问题一 | 新手周流失归因无方向 | confirmed |
+| D-11 | 采集/钓鱼/战斗统一"活动结果"接口 | 架构 | user | 架构期问题一 | 第三活动类型出现结构性差异 | confirmed |
+| D-13 | 战斗采用节奏/指令判定 | 系统 | user | S06 问题一 | 原型显示节奏拖慢/玩家困惑 | confirmed（手感部分拆 D-13b prototype_pending） |
+
+### 技术代决（auto_decided——带理由与推翻条件，用户一键可翻）
+
+| 编号 | 决定 | 层 | 谁 | 依据（理由） | 推翻条件 | 状态 |
+|---|---|---|---|---|---|---|
+| D-04 | 时间片制：700ms=10 游戏分钟 | 概念 | agent | 原作实证节拍；一天≈14 分钟真实时间贴合 T5"休闲" | 内测一天体感过短/过长 | auto_decided |
+| D-05 | 分区域切换（区域独立场景，非连续地图） | 概念 | agent | 概念层"不是什么：无边界开放世界"；区域小网络全部步行可达 | 场景切换成为移动负担反馈 | auto_decided |
+| D-06 | 28 日/季、四季/年 | 顶层 | agent | 季节窗口制造"本季计划"节奏（支柱二） | 换季频率在测试中被无视 | auto_decided |
+| D-09 | 商店营业时段走条件表 | 架构 | agent | 与配方/区域解锁共用 check(condition_id) 单一入口 | 条件表规模膨胀难维护 | auto_decided |
+| D-10 | 出货箱日终统一结算 | 架构 | agent | 收入集中进日终面板，强化"一天一结算"叙事；商店现卖保留即时通道 | 玩家普遍绕开出货箱 | auto_decided |
+| D-12 | 工具升级期间该工具不可用 | 系统 | agent | 升级=时间成本换效率（顶层张力二）；备用旧工具暂不做（开放问题） | 升级期挫败感集中爆发 | auto_decided |
+| D-16 | 矿井逐层生成本期不做（P2） | TDD | agent | GDD 已标"不做无限地牢"；首期按布局池 8~12 模板拼装 | 内测要求深度爬塔玩法 | auto_decided |
+| D-17 | 换装首期 5 层（基础体/裤/衣/发型/饰件），非 19 层 | TDD | agent | 外观自定义非首期卖点；层结构预留到 19 层 | 外观系统成核心诉求 | auto_decided |
+| D-18 | 作物品质三档：普通/银/金 | TDD | agent | 经济分层需要（即时变现 vs 等待升值的取舍） | 银金档无人区分、一律普通出售 | auto_decided |
+
+### 已推翻（overturned——旧行保留，挂新行）
+
+| 编号 | 决定 | 层 | 谁 | 依据 | 推翻条件 | 状态 |
+|---|---|---|---|---|---|---|
+| D-08 | 作物品质两档：普通/银 | TDD | agent | 早期小权衡：两档最简 | — | **overturned → D-18**（经济分层不足，改三档；铱档留 P1） |
+
+## 队列纪律（给 agent 的使用说明）
+
+- 新决定入队：拿下一号（当前最大 D-19，下一号 D-20）；就现代决可登记不开条目，但状态必须写 auto_decided 并带理由＋推翻条件。
+- 用户翻案：旧行标 overturned 挂新行，受影响文档节重写（本台账只记录，不代改）。
+- 概念层变更定稿后：速览卡"决定状态与原型验证项"字段随本文件最新版同步（prompt 级纪律）。

apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/fast-gdd.md

@@ -0,0 +1,124 @@
+# 脉冲荒原：节点争夺战
+
+> 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对手、移动瞄准射击、掩体碰撞、节点轮换、占领计分和胜负结算，确保一局可从开始玩到结束。
+- 暂缓：暂缓多人联机、商城、服务器、开放世界、赛季、复杂社交、完整剧情、多武器树和多地图内容。
+- 如何验证：用可操作原型观察玩家是否在首局主动驶向活跃节点、利用掩体交火、理解分数变化并完成一局；记录误读占领状态、无目标游走和胜负不明的情况。
+- 何时扩展：仅当试玩者能无讲解理解活跃节点、占领状态和领先来源，并主动移动反攻时，再增加第二种坦克特性、第二张地图或轻量成长选择。

apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/overview-card.md

@@ -0,0 +1,59 @@
+# 速览卡：《星露谷物语》金样项目
+
+> 12 字段版本；渲染器照旧出卡走审批。字段来源见每节尾注（概念层/定调记录/台账投影）。概念层变更定稿后本卡必须同步更新（prompt 级纪律）。
+
+## 1. 游戏名称
+《星露谷物语》（金样项目沿用案例名；新项目由概念层第 1 节定名）←概念层§1
+
+## 2. 一句话描述
+继承一座荒废农场的乡村生活 RPG：安排每天的时间与体力，种田、探索、交朋友，把日子过成自己想要的样子。（←概念层§1 一句话概念，45~90 字）
+
+## 3. 游戏分类
+乡村生活模拟 RPG（经营+探索+社交；参照系牧场物语）←概念层§1
+
+## 4. 美术风格（四件）←定调记录＋概念层§4
+- 视觉类型：手绘感像素风、俯视 45° 视角。
+- 风格关键词：温暖、田园、四季分明、生活感。
+- 色彩与氛围：暖土绿基底+季节信号色整体切换；治愈不压抑；无锐利科技感、无阴暗元素。
+- MVP 美术边界：首期 3 区域 tileset、8 位 NPC（行走+立绘）、约 120 物品图标、玩家换装 5 层；不做 19 层全量换装与全区域。
+
+## 5. 游戏支柱（3 条）←设计锚点提炼
+| 支柱 | 玩家感受 | 实现机制 |
+|---|---|---|
+| 自己的节奏 | "今天想干嘛就干嘛，明天一切更顺手。" | 自由日程+时间体力预算；无失败结局 |
+| 今天的选择让明天更从容 | "升级工具、攒钱扩建是有意义的。" | 长期投资线：工具升级/技能/设施 |
+| 社区让独居变成归属 | "镇上的人在等我。" | NPC 关系/任务/社区修复目标 |
+
+## 6. 核心循环（5 步）←锚点循环位展开
+安排一天的时间与体力 → 农/采/钓/矿/战/社交任选组合 → 获得资源·金钱·经验·关系 → 投资工具·设施·种子·物品 → 解锁更高效或更丰富的活动。
+
+## 7. 目标用户 ←概念层§5
+牧场物语系慢节奏成长玩家+动森式"无压力日常"需求；单人、可反复、每次一至数个游戏日；不要求预先掌握复杂数值。
+
+## 8. 平台事实 ←运行时注入，禁改
+自包含 Web · 双视口（桌面/移动）· 键鼠/触屏双输入 · 本地 HTTP 预览（金样项目按 HTML 演示路线锁定）。
+
+## 9. MVP 系统（5 个）←概念层"最小闭环粗清单"
+| 系统 | 最小功能 | 为什么必须有 | 验证方法 |
+|---|---|---|---|
+| 时间与日程 | 时钟/日终结算/季节天气 | 全局节拍器 | 一个游戏日全流程可完成并结算 |
+| 体力与状态 | 单池体力/昏倒惩罚 | 一切取舍的成本源 | 玩家主动在体力耗尽前收手 |
+| 农场经营 | 锄种浇收+加工队列 | 核心产出与规划场 | "买种→收获→出售"闭环成立 |
+| 物品与制作 | item_id/背包/配方解锁 | 资源身份与转化 | 拾取/堆叠/制作全链无回翻 GDD |
+| 经济与商店 | 基准价+价差+出货箱 | 投资回报换算 | 第 4 日现金流回正（前五日验算） |
+
+## 10. 制作边界 ←概念层"不是什么"表
+不做：硬核生存（无饥饿/债务/死亡惩罚）；效率至上的工厂经营；以战斗为核心的动作游戏；剧情驱动的任务链主线；多人竞争；无边界开放世界（区域小网络全步行可达）。
+
+## 11. 创作者提示（先做与验证）←概念层"先做与验证"节
+- 先做：第 1 日循环（买种→播种→浇灌→收获→出售→日终结算）＋一个可进入的矿井遭遇。
+- 暂不做：装备刷取、随机构筑、复杂剧情、节日全量、联机。
+- 这样验证：测试者玩完第 1 日后是否主动说"再玩一天"；能否说出"明天要先做什么"。
+- 达标再扩展：玩家能自述明日计划后，才加社交深度与矿井分层。
+
+## 12. 决定状态与原型验证项 ←台账投影（decision-log.md v3）
+- 已确认（confirmed）：定调 D-01 / 单人 D-02 / 战斗伴生 D-03 / 日目标自设 D-07 / 活动统一接口 D-11 / 战斗节奏判定 D-13。
+- 技术代决（auto_decided，可一键翻案）：D-04 时间片 / D-05 分区域切换 / D-06 28 日季 / D-09 营业条件 / D-10 出货箱日终 / D-12 工具占用 / D-16 矿井生成 P2 / D-17 换装 5 层 / D-18 品质三档（推翻 D-08 两档）。
+- 等拍板（pending_user）：D-14 体力战斗是否共享单池（暂按共享实现）；D-15 背包格子/重量（暂按格子制，B 级阻断存档结构）。
+- 待原型（prototype_pending）：D-13b 战斗判定窗口手感（前摇帧数/450ms 无敌帧基准）。
+- 默认兜底（default_pending）：D-19 天气权重数值（默认已入表，带 designer_note）。

apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-architecture.md

@@ -0,0 +1,200 @@
+# 系统架构：《星露谷物语》
+
+## 架构定位与目标
+本阶段确定"哪些系统支撑一轮玩法"，不展开单系统内部规则。
+划分原则：将生活模拟 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 日程、任务条件和节日事件之间采用统一条件格式还是各自维护？
+- 农场设施生产是否由农场系统统一管理，还是交给通用制作队列？
+- 采集、钓鱼和战斗是否共享统一的"活动结果"接口？
+- 哪些系统需要独立数据表，哪些小型配置应合并为一张内容表？

apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-concept.md

@@ -0,0 +1,63 @@
+# 概念设计：《星露谷物语》
+
+## 一句话概念
+《星露谷物语》是一款以经营农场为基础、融合探索、采集、制作、轻度战斗、角色成长与社区叙事的乡村生活模拟 RPG；玩家通过安排每日时间与体力，把荒废农场逐步建设成理想家园，并与周围居民建立关系。
+
+## 定调与设计锚点
+
+### 定调记录
+- 参照选择：以牧场物语系为主（无压力日常方面学动物森友会）；不参考任何高难动作与生存类游戏。
+- 调性滑杆：压力感 低 / 战斗比重 低 / 管理深度 中 / 叙事比重 中低 / 节奏 慢。
+- 调性锚：
+  T1 轻松治愈、自己的节奏（目标体验）；T2 不劝退、无唯一最优解（体验门槛）；T3 战斗轻度、非高难动作（非目标）；T4 以"游戏日"为单位、可反复的单人体验（情境）；T5 时间体力有限但休闲不打卡（跑偏风险）；T6 小团队可维护的规模（关键约束）；T7 日常叙事而非宏大主线，隐藏信息不迫使玩家查攻略（非目标/跑偏风险）。
+
+### 设计锚点
+- 核心幻想：离开令人疲惫的城市生活，继承一片荒废土地，在自己的节奏中经营、探索、成长，并成为社区的一员。
+  玩家念头："再玩一天就好——今天做完想做的事，明天的一切都会更顺手。"
+- 目标体验：治愈、自由规划、持续成长、发现秘密，以及"今天的选择会让未来更轻松"的掌控感。
+- 玩家动机：改善农场与生活条件；发现新区域和资源；完成社区目标；提升技能；与 NPC 建立关系；按照自己的偏好塑造生活方式。
+- 核心循环：安排一天的时间与体力 → 进行农业、采集、钓鱼、采矿、战斗或社交 → 获得资源、金钱、经验与关系进展 → 投资工具、设施、种子和物品 → 解锁更高效或更丰富的活动。
+- 跑偏风险：系统过多导致目标分散；时间与体力限制把休闲体验变成每日打卡；隐藏信息迫使玩家依赖外部攻略；经济成长过快使后期失去决策。
+- 非目标：不做多人竞争、高难度动作战斗、唯一最优效率经营、主线剧情取代日常（详见《不是什么》）。
+
+## 玩家身份与基调
+- 玩家身份：一名辞职逃离城市、继承祖父荒废农场的归乡人——不是拯救世界的英雄，是重新学会生活的人。季节与节日构成一年的节拍，日落结算构成每天的呼吸。
+- 情绪基调：温暖治愈，慢而踏实。可以有忙碌与轻度压力（时间、体力），不做生存焦虑（饥饿、债务倒计时）与黑暗题材；孤独感只作为被社区逐渐治愈的起点，不成为基调本身。
+
+## 风格与世界观
+复古像素风的温暖乡村世界。玩家来到一个正在现代化与传统生活之间摇摆的小镇，农场、商店、社区设施、自然区域和矿井共同构成可步行抵达的生活网络。世界观服务于生活模拟而非复杂设定解释：季节、天气、节日、居民日程和区域变化，让同一张地图随着时间产生生活感。叙事主要通过 NPC 日常对话、关系事件、任务和社区目标逐步展开。
+
+## 目标玩家与情境
+- 目标玩家：与牧场物语系受众高度重合——喜欢种田与小人际的慢节奏成长玩家；同时吸收动物森友会式"无压力日常整理"的需求（自定义、装饰、按自己的节奏玩）。但它不能变成纯装饰沙盒，因为农场经营的时间、体力与季节取舍，以及社区修复目标必须始终存在。
+- 适合情境：单人、可反复游玩、每次一个游戏日或几个游戏日；可以高效规划，也可以把时间用于装饰、社交或探索。
+- 体验门槛：需要理解基础资源转换和时间安排，不应要求预先掌握复杂数值或寻找唯一正确答案。
+
+## 不是什么
+| 不是 | 因为 |
+|---|---|
+| 硬核生存农场模拟 | 没有饥饿、债务、死亡惩罚；压力止于温和的时间与体力 |
+| 效率至上的工厂经营 | 不要求唯一最优解，装饰与闲逛是合法玩法而非浪费 |
+| 以战斗为核心的动作游戏 | 战斗只是采矿与探索的伴生风险，深度刻意受限 |
+| 剧情驱动的叙事游戏 | 社区叙事是日常的背景与情感回报，不是任务链主线 |
+| 多人社交平台 | 单人体验为前提，人际关系由 NPC 关系承载 |
+| 无边界开放世界 | 地图是功能明确的小区域网络，全部可步行抵达 |
+
+## 核心张力
+- 时间与体力有限，但想做的事情很多：玩家必须决定今天的优先级。
+- 立即变现与长期投资：出售资源能快速获得资金，制作设备和升级工具则能提高未来效率。
+- 稳定经营与未知探索：农场提供可预测收益，矿井、钓鱼和新区域提供风险与发现。
+- 个人效率与社区关系：把时间用于赚钱会挤压社交，但关系又会带来配方、剧情和新的情感目标。
+- 自由生活与阶段目标：玩家可以自由安排日常，同时受到季节、节日、任务和社区修复目标的轻度牵引。
+
+## 边界与约束
+- 概念层只定义核心幻想、目标用户、体验基调与排除方向；具体战斗公式、作物成长天数、礼物偏好、掉落率、系统清单和 MVP 内容，留给顶层及以后决定。
+- 设计规模以单人或小团队可理解、可维护为前提；地图采用多个功能明确的区域，而非无边界开放世界。
+- 所有系统都必须回流到"安排一天并获得长期改善"的核心循环；独立小游戏或装饰功能不能成为主要范围扩张来源。
+- 案例声明：本文以《星露谷物语》为案例展示设计的组织方式，不复制其具体角色、文本、美术、地图或数值。
+
+## 概念定稿
+《星露谷物语》的核心不是"种田赚钱"，而是：
+> 在自己的节奏里经营一片土地与一段生活——今天的选择让明天更从容，而社区让独居变成归属。
+
+交给下一层的约束：时间与体力必须构成温和而非焦虑的取舍；战斗、采矿、社交等支线必须回流农场生活循环；成长权重要允许玩家自定义（效率型与休闲型玩家都成立）。
+（调性已在第 2 节定死；顶层及以下一切开放问题先回定调记录的 T1~T7 级联。）

apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-s06-combat.md

@@ -0,0 +1,120 @@
+# 战斗与敌人系统：S06
+
+## 系统目的
+为危险区域提供轻度、可理解的战斗挑战，使玩家在探索中承担风险，并通过装备、补给和技能成长验证长期准备。战斗是生活模拟循环的支柱之一，不是游戏的唯一核心。
+
+## 支撑的玩家体验
+- 玩家能观察敌人行为，选择攻击、躲避、补给或撤退。
+- 战斗结果主要取决于准备、判断和适度操作，而不是高强度连招。
+- 深入危险区域会带来更高资源和成长回报，也会增加生命、时间和补给压力。
+- 失败有明确原因和可恢复成本，不应摧毁长期农场进度。
+
+## 进入与退出
+### 进入
+- 玩家进入允许战斗的危险区域或触发敌人遭遇。
+- 检查区域、时间、装备、生命、背包和任务条件。
+- 初始化当前战斗区域、敌人组合、战斗状态和可撤退条件。
+### 退出
+- 击败敌人并完成战斗奖励结算。
+- 玩家主动撤退或离开战斗区域。
+- 玩家生命归零，由体力与状态系统执行昏倒或失败惩罚。
+- 特殊事件、日终或区域状态强制结束战斗。
+
+## 玩家行动
+- 移动、观察敌人攻击范围和行为状态。
+- 普通攻击、重攻击或使用装备技能。
+- 防御、闪避、格挡或利用场景短暂规避伤害。
+- 使用食物、药剂等消耗品。
+- 拾取战利品、调查宝箱或选择继续深入。
+- 在满足条件时撤退，保留已结算的奖励。
+
+通用流程：
+`进入遭遇 → 读取敌人状态 → 玩家行动 → 敌人响应 → 结算伤害/效果 → 判断胜负或撤退`
+
+## 取舍表
+
+| 决策 | 立即收益 | 延迟收益 | 主要代价 |
+|---|---|---|---|
+| 继续深入还是安全撤退 | 更多资源 | 更高风险与返程压力 | 已得战利品可能损失 |
+| 消耗品现在用还是留着 | 维持当前探索 | 应对更强敌人 | 局部战况恶化 |
+| 快速击败还是稳健闪避 | 节省时间 | 降低受伤风险 | 补给与时间消耗 |
+| 高伤高耗装备还是基础攻击 | 更快击杀 | 稳定与低消耗 | 资源消耗大 |
+| 资金投武器防具还是农场设施 | 战斗能力 | 农场产能 | 另一侧进度放缓 |
+
+## 状态与规则
+### 玩家战斗状态
+- 当前生命、最大生命和状态效果。
+- 装备中的武器、防具、饰品和消耗品。
+- 攻击、防御、移动、闪避和技能冷却状态。
+- 当前战斗区域、遭遇编号和撤退状态。
+### 敌人状态
+敌人状态至少包括待机、警觉、攻击前摇、攻击中、受击、眩晕、死亡和撤退。
+每个敌人的实例数据（生命、位置、目标、状态效果、掉落引用）的字段定义由技术文档层承接。
+### 战斗规则
+- 只有满足攻击距离、方向、冷却和装备条件时，攻击才可结算。
+- 伤害由攻击来源属性、目标防御、技能倍率和状态效果共同决定。
+- 敌人攻击必须有可识别的前摇或预警，给予玩家反应与撤退机会。
+- 生命降至零时进入死亡或昏倒状态；具体惩罚由体力与状态系统处理。
+- 敌人死亡后只结算一次经验与战利品，并写入遭遇状态，避免重复领取。
+- 撤退后已完成的战斗奖励保留，未击败敌人按区域刷新规则处理。
+### 区域遭遇
+- 危险区域由敌人组、刷新规则、深度或阶段配置组成。
+- 进入更深区域可以提高敌人强度、资源价值和特殊遭遇概率。
+- 区域难度应通过可理解的装备、区域和任务条件表达，不依赖突然的数值墙。
+- 宝箱、精英敌人和首领可作为独立遭遇类型，但不在最小版本中同时扩张。
+
+## 数值与数据交接（→技术文档层）
+本系统交由技术文档层（数值策划）定义的数据类别：敌人配置、敌人行为配置、武器配置、技能配置、遭遇配置、战利品配置、状态效果配置。
+
+随交接附下的设计侧定性约束：
+- 敌人数据拆分为"是什么 / 怎么行动 / 掉什么"三类，使难度与经济可独立调节。
+- 普通敌人不应稳定掉落大量高价值物品；战斗收益主要由矿物、经验和区域发现组成。
+- 稀有材料是"有明确用途的探索奖励"，但必须保留任务、宝箱等补充渠道，避免战斗失败后无法推进。
+- 基础战斗允许玩家一日内完成少量遭遇并安全返程，不要求连续刷怪。
+- 失败保留已结算的普通战利品，主要损失是时间、位置或少量金钱，不清空背包。
+- 自动化收益节省日常体力，但不能让玩家跳过农场维护的全部决策。
+- 收益回流方向：区域 → 敌人 → 材料 → 加工 → 农场自动化；战斗不直接取代农场收入。
+
+## 反馈
+- 攻击命中、受击、闪避、格挡和暴击提供清晰的视觉与声音反馈。
+- 敌人显示生命、预警、当前状态和可攻击时机。
+- 玩家生命、补给、冷却和撤退可用性持续可见。
+- 战斗胜利显示经验、战利品和区域进度。
+- 失败说明主要原因，并明确损失、保留内容和可恢复路径。
+
+## 内部循环
+### 单次战斗循环
+`观察敌人 → 选择攻击或防御 → 处理敌人响应 → 造成或承受伤害 → 调整策略 → 击败或撤退`
+### 危险区域循环
+`准备装备与补给 → 进入区域 → 战斗与搜刮 → 判断继续深入或返程 → 带回资源 → 升级能力`
+### 长期循环
+`获得战斗经验与装备 → 提升生存能力 → 挑战更深区域 → 获得稀有资源 → 解锁新制作、任务或地图`
+
+## 输入、输出与依赖
+### 输入
+- 探索与地图系统提供战斗区域、位置和遭遇入口。
+- 时间系统提供当前时间、季节和日终信号。
+- 体力与状态系统提供生命、体力、状态效果和失败处理。
+- 物品系统提供武器、防具、消耗品和战利品接收入口。
+- 成长系统提供属性、技能和装备解锁。
+- 玩家通过核心玩法系统提交战斗行动。
+### 输出
+- 向物品系统提交战利品和消耗品变化。
+- 向成长系统提交战斗经验和能力进度。
+- 向地图系统提交敌人、宝箱和遭遇状态。
+- 向任务与社区系统提交击败、调查和区域进度。
+- 向 UI 输出战斗状态、反馈、胜负和撤退结果。
+
+## 边界与非目标
+- 不负责通用生命与昏倒惩罚，只提交状态变化。
+- 不负责武器物品的背包、耐久和售价主数据。
+- 不负责字段定义、数值配置与表格结构——归技术文档层（数值策划）。
+- 不做高难度动作连招、复杂多人战斗或精确帧竞速。
+- 不让战斗成为获得普通农场资源的唯一方式。
+- 不在本系统中定义全部敌人、武器和首领内容。
+
+## 开放问题
+- 战斗采用实时操作，还是更简化的节奏/指令判定？
+- 体力是否影响攻击与闪避，还是只影响探索和农务？
+- 武器是否有耐久度，还是通过升级与装备更换形成消耗？
+- 战斗失败的主要成本采用金钱、位置、时间，还是有限组合？

apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-art-bible.md

@@ -0,0 +1,82 @@
+# 美术圣经：《星露谷物语》（TDD 金样 · 美术圣经）
+
+> 状态：reviewed　|　定调锚：概念层@v1 第 2 节（定调记录：牧场物语系参照、压力低/节奏慢/治愈）　|　style_id：`stardew_warm_rural_pixel`
+> 实证规格来源：星露谷 1.6.15 解包知识库 v3（资产计数时点 2026-09-11，快照 stardew-1.6.15-7f1e5b8e）。写新项目时按本项目定调重译，数字仅作规模参照。
+
+## 视觉风格总览
+
+从定调记录翻译的视觉气质：**"被四季照亮的温暖小农场"**——手绘感像素、俯视 45° 视角，春夏绿意、秋日暖橙、冬季留白，颜色随季节整体切换而不是换贴图；物件轮廓圆润、无锐利科技感。玩家一看画面就该感到：这里节奏很慢，干活是安心的。参考图位 4 张（量产流程第 3 步产出锚点图）。
+
+## 视觉锚
+
+- 关键词：温暖、手绘像素、田园、四季分明、生活感。
+- 禁用关键词：阴暗压抑、血腥恐怖、高饱和霓虹、写实渲染、锐利科技风（承概念层 T3"战斗轻度"、T7"日常叙事"）。
+- 色板：主色 暖土绿系（草地/耕地基底）60% ／ 辅色 暖木棕+瓦顶红 30% ／ 点缀 季节信号色（春樱粉/夏浓绿/秋橙/冬蓝白）10%。昼夜·天气·季节表现：季节=色调与植被整体切换；天气=雨天全屏冷色叠加（原作 OrangeRed×0.45 实证）；昼夜=时刻线性插值环境光。
+- 形状语言：圆润矩形轮廓，物件以 16px 网格对齐；无 1px 高光乱线。
+- 比例与轮廓：物件 16px 一档；NPC 16×32（渲染放大 4 倍）；玩家可完全自定义外观。
+- 光照与材质：不做真实光照——低分辨率 lightmap 乘法混合；优先级链=矿井 tint＞室内 ambient＞室外 outdoor（时刻插值）；十种光源贴图常量够用。
+- 渲染口径：纯像素、无抗锯齿、整数倍缩放（程序侧能力边界同源）。
+
+## 角色模板
+
+- 基础规则：玩家=换装组合而非整图——19 个独立层（基础体/裤/衣/发型/饰件/配件…），每层独立图集，调色板像素 256-277 区域换色实现同图集多变色；层深=基准+层序×1e-6 保证叠加次序稳定。NPC=16×32 四方向小人+64×64 立绘（对话用）。
+- 方向数：4 方向（左=右镜像：是——行走图按方向分行布局，如 64×448=4 列×14 行）。
+- 动画状态：待机/走 walk=4 帧循环、每帧 200ms（帧表含毫秒级帧时长）；受击/使用工具按动作逐条登记帧表。玩家帧表量大（原作 500+ 动画参数为 switch 硬编码），本项目帧表走数据表不走硬编码。
+- 立绘表情：六表情索引 0-5（$neutral/$happy/$sad/$unique/$love/$angry），对话文本中 `$表情` 标记驱动切换。
+
+## 场景模板
+
+- tileset 规格：16px tile；TileSheets 级图集约 41 张+地形特征图集 38 张（作物/树）；padding 1px 防渗色。
+- 图层拆分：四层 Back/Buildings/Front/AlwaysFront（深度 -1/0.1/64+/-1）——地面/建筑/前景遮挡/最前；碰撞由 Buildings 层属性驱动；矿井布局池按模板拼装（原作 61 张模板，本项目首期 8~12 张）。
+- 场景对象规则：多帧素材禁当静态贴图（作物生长/角色必须走帧表）；单元素禁整图（区域由 tile 拼装，禁为每区域画整张立绘）；地图数参照：原作 259 tmx+304 预览，本项目首期 3 区域（农场/小镇/矿井）。
+
+## UI 视觉
+
+承 UI 系统文档界面清单（HUD/背包/商店/对话/日终结算五界面）。视觉语言：木质面板底+纸张质感对话框；信息分层——价格信息永远暖金、锁定/禁用永远灰蓝、日终收入单列。字体用位图字体（原作 5 fnt 位图字体实证）。触控版式热区 ≥44px 与程序侧输入表同源。特效走程序动画（按帧表播图集区域）+粒子，不逐特效画整图（原作 LooseSprites 156 张 UI/杂项图集规模参照；最大图集实测 1920×1376）。
+
+## 素材规格契约
+
+| 素材 | 规格（尺寸/帧数/方向数） | 命名规则 | atlas 格式 | 验收 | 绑定 |
+|---|---|---|---|---|---|
+| 物品图标 | 16×16，1 帧 | `icon_{item_id}` | JSON atlas | 技术+视觉 | `item_*` 全量（参照原作 807；本项目首期 ~120 行） |
+| 作物 | 16×32×相位帧（4~5 相位，每相位 1~2 帧） | `crop_{crop_id}` | JSON atlas | 技术+视觉 | `crop_*`（参照原作 50） |
+| 玩家换装层 | 每层独立图集，walk 4 帧×4 方向 | `farmer_{layer}_{state}_{dir}` | JSON atlas | 技术+视觉 | 豁免（角色非物品，登记于本表） |
+| NPC 行走+立绘 | 行走 16×32 四方向行布局；立绘 64×64×6 表情 | `npc_{id}_walk` / `npc_{id}_portrait_{expr}` | JSON atlas | 技术+视觉 | `npc_*`（参照原作 34 社交 NPC/101 立绘；本项目首期 8 位） |
+| tileset | 16px，边缘连接变体 | `tile_{theme}_{variant}` | JSON atlas | 技术+视觉 | 豁免（场景组件） |
+| UI 面板 | 9 宫格切片，3 态 | `ui_{element}_{state}` | JSON atlas | 技术+视觉 | 豁免（UI） |
+| BGM | ogg，-18LUFS，循环点标记 | `bgm_{season}` 4 首+矿井 1 首 | — | 响度+循环 | 豁免（音频契约） |
+| SFX | wav 单发 | `sfx_{event}`（事件↔音效映射表登记） | — | 同帧触发 | 豁免（音频契约） |
+
+- 绘制工艺：陶泥儿 MCP 像素绘制路径逐类写参数（作物/图标/角色三类的封装流程）；施工环境无产出通道时规格先行锁定、状态如实登记"缺失"。
+- 音频契约说明：原作 XACT cue 名 435 候选/代码引用 230 个——本项目首期 SFX 事件 20 只起步，按事件总线 `sfx_event` 映射表登记，不逐 cue 复刻。
+- 豁免类型仅限：程序化生成（矿井布局由表驱动拼装）/ UI 文本 / 本期不需要——每项豁免在契约行写明。
+
+## 资产状态表（asset manifest）
+
+| asset_id | 规格 | 绑定 | 状态 | 验收记录 | contract_version |
+|---|---|---|---|---|---|
+| icon_item_*（首期 ~120 行，逐 item_id 一行） | 16×16 | `item_*` | 缺失 | — | 1 |
+| crop_*（50 行） | 16×32 相位帧 | `crop_*` | 缺失 | — | 1 |
+| farmer_*（19 层图集） | 4 帧×4 方向 | 豁免 | 缺失 | — | 1 |
+| npc_*_walk / _portrait（8 位×7 件） | 16×32 / 64×64×6 | `npc_*` | 缺失 | — | 1 |
+| tile_*（3 主题变体组） | 16px 变体 | 豁免 | 缺失 | — | 1 |
+| ui_*（5 界面套件） | 9 宫格 3 态 | 豁免 | 缺失 | — | 1 |
+| bgm_*（5 首） | ogg -18LUFS | 豁免 | 缺失 | — | 1 |
+| sfx_*（20 只） | wav | 豁免 | 缺失 | — | 1 |
+
+- 状态单向流转：缺失 → 草稿 → 已交付 → 已验收 → 已接入；驳回退回草稿并记原因。
+- 验收两维：技术（尺寸/透明/帧数/命名）+ 视觉（对照视觉锚）；两维都过才进"已验收"。
+- **每个 gameplay 可见对象必有一行或显式豁免——没有第三种状态**：物品图标逐 item_id 与数据侧物品表逐行对账（参照规模：原作 Characters 215 png/Portraits 101/TileSheets 41/TerrainFeatures 38/LooseSprites 156）。
+- 程序接入后填消费点（哪个模块加载、事件映射），`contract_version` 变更须重验收。
+
+## 量产流程与验证
+
+1. 概念候选 4 张（农场一角/角色/物品图标/UI 面板各 1 方向稿）→ 2. 人选方向（用户确认）→ 3. 锚点图 4 张 → 4. 锁圣经 → 5. 写契约（本文件已锁）→ 6. 小批 8 张（icon_item 子集：防风草种子/防风草/木材/石头/铜矿/锄头/水壶/出货箱）→ 7. 技术检查（尺寸/透明/命名/atlas 解析）→ 8. 接入程序（v0.1 里程碑）→ 9. 运行时截图验收（桌面/移动双视口下 16×16 图标与作物相位可辨、四季色调正确）→ 10. 扩产（8→120→全量）。
+
+## 开放问题回执
+
+| # | 问题 | 去向 |
+|---|---|---|
+| 1 | 换装系统首期是否做全 19 层（或缩到 5 层） | → 台账代决（建议首期 5 层：基础体/裤/衣/发型/饰件；台账 D-17） |
+| 2 | 锚点图方向需用户确认 | → 施工期提案卡 |
+| 3 | 位图字体 vs 矢量像素风字体 | → 小批阶段随 UI 套件定 |

apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-data.md

@@ -0,0 +1,98 @@
+# 数据与配表：《星露谷物语》（TDD 金样 · 数据与配表）
+
+> 状态：accepted（结构定稿＋首期全量填充验算通过）　|　基于：各系统文档交接节汇总 ＋ 归 TDD 素材两份提取件（S06 数值结构／架构字段字典）　|　验收：check@C-2026-09-11-v1 结论 无 blocker
+> 实证计数来源：星露谷 1.6.15 解包知识库 v3（13 张数据表，提取脚本断言通过；快照 stardew-1.6.15-7f1e5b8e）。写新项目时按本项目系统交接节重建，计数仅作规模参照。
+
+## 数据表总清单
+
+| 表格组 | 建议表名 | 主要维护系统 | 实证规模（原作 1.6.15） |
+|---|---|---|---|
+| 物品与经济 | 物品表、品质表、商店表、商店库存表、价格表 | 物品与制作、经济与商店 | 物品 807×29 类；商店 77 店 897 条库存（含店级 PriceModifiers） |
+| 农场内容 | 作物表、动物表、设施表、加工配方表 | 农场经营 | 作物 50 全字段；机器 39 台全 OutputRules |
+| 活动内容 | 采集点表、钓鱼点表、鱼类表、敌人表、敌人行为表、遭遇表、战利品表 | 采集/钓鱼/战斗 | 怪物 51 条配置；怪物 AI 矩阵 30 类移动原型 |
+| 物品制作 | 通用配方表、配方解锁表 | 物品与制作 | 配方 231（烹饪 81+工艺 150，全原料/产出/解锁） |
+| 玩家成长 | 技能表、等级经验表、能力节点表、工具升级表、效果表 | 成长与技能 | 职业 30 全效果钩子（51 钩子+6 数据驱动）；附魔 34 逐项数值；经验曲线代码常量 |
+| NPC 与任务 | NPC 表、关系等级表、礼物偏好表、任务表、奖励表、事件条件表 | NPC/任务/事件 | NPC 送礼 34NPC×4 档+全局 5 档；事件 258/条件码 39 |
+| 时间与世界 | 日期季节表、天气表、节日表、营业时段表 | 时间与日程、事件与节日 | —（代码常量+日程数据驱动） |
+| 文本与展示 | 文本表、UI 提示表 | UI 与文本呈现及各内容系统 | 11 语言按后缀拆分（含 zh-CN） |
+
+（表格拆分是生产组织方式，不改变主数据归属。原作同套模型同时服务本体与模组生态——静态表为结构化 JSON-in-XNB，由 DataLoader 按需缓存。）
+
+## 字段字典与 ID 命名规范
+
+- ID 命名：小写 snake_case，`对象类型_名称_必要时加阶段`（如 `item_turnip`）；全局唯一、废弃不复用。（原作实证：1.6 起用限定 ID 如 `(O)123` 统一引用 807 物品——原理同源：ID 不含人话、不随语言变。）
+- 通用字段：`*_id` / `display_name_text_id` / `description_text_id` / `condition_id` / `enabled_state`（active·draft·disabled·deprecated）/ `sort_order` / `designer_note` / `unit`（数值字段必填：time_slice·game_day·currency·stamina·exp）。
+- 常用后缀：`_amount`（配单位）/ `_cost` / `_rule_id` / `_condition` / `_time` / `_duration` / `_state` / `_text_id`。
+- 类型与空值：数值栏禁"约/无/待定"；空值=不适用≠0≠无限（无限制库存用 `stock_type=unlimited`，不用 999999）；布尔 true/false；多值一律关系子表（多材料配方禁拼一格）。
+- 引用完整性：`item_id`→物品表；`location_id`→区域表；`npc_id`→NPC表；`quest_id`→任务表；`recipe_id`→配方表；`condition_id`→条件表；`text_id`→文本表。删除先置 `deprecated` 并查引用。
+- 枚举实证注意：品质枚举值为 0/1/2/4（银=1、金=2、铱=4）——所有 `(1+0.25×quality)` 型公式乘数因此是 1.25/1.5/2.0；枚举值是语义约定，禁止想当然重排。
+
+## 公共条件表
+
+| condition_id | condition_type | target_id | operator | required_value | enabled_state | 备注 |
+|---|---|---|---|---|---|---|
+| `condition_day_2` | `date_day` | `season_spring` | `>=` | 2 | `active` | 春季第 2 日后可触发 |
+| `condition_shop_unlocked` | `progress_flag` | `flag_general_store_open` | `==` | 1 | `active` | 杂货店已开放 |
+| `condition_skill_farming_1` | `skill_level` | `skill_farming` | `>=` | 1 | `active` | 农务技能达到 1 级 |
+| `condition_blacksmith_open` | `schedule_open` | `schedule_blacksmith_default` | `==` | 1 | `active` | 铁匠铺当前处于营业时段 |
+| `condition_recipe_repair_path` | `quest_completed` | `quest_repair_path` | `==` | 1 | `active` | 修路任务完成后解锁基础洒水器配方 |
+
+（复杂条件拆条件组+条件行；全项目只此一个条件入口，程序实现一次 `check(condition_id)`。实证参照：原作 258 事件共用 39 个条件码——条件收敛是可达到的规模。）
+
+## 工作簿组织与建表顺序
+
+| 工作簿 | 工作表 |
+|---|---|
+| `世界与地图.xlsx` | 日期季节、天气、日程、区域、区域连接、活动入口 |
+| `农场与制作.xlsx` | 地块、作物、动物、设施、加工配方、通用配方 |
+| `物品与经济.xlsx` | 物品、品质、装备、价格、商店、商店库存、货币 |
+| `活动与战斗.xlsx` | 采集点、掉落、钓鱼点、鱼类、敌人、行为、遭遇 |
+| `成长与任务.xlsx` | 技能、等级经验、能力节点、工具升级、NPC、关系、任务、目标、奖励 |
+| `事件与文本.xlsx` | 节日事件、事件阶段、事件条件、文本、UI 提示、教程 |
+
+建表顺序：①物品表（公共 item_id）→ ②作物表 → ③区域与连接表 → ④NPC 表 → ⑤配方表 → ⑥价格与商店库存表 → ⑦任务/目标/奖励表 → ⑧敌人/掉落/技能/事件表。
+每完成一组查三件事：引用 ID 存在 / 条件有负责系统 / 同一数值只有一个系统维护。
+
+## 表格-程序契约
+
+1. 加载顺序按引用拓扑：主数据 → 关系 → 条件 → 文本（最后）。
+2. 启动期全量校验（外键/枚举/单位）；运行期全部 id→对象字典 O(1) 查找。（实证参照：原作按需缓存加载+`ContentHashes.json` 逐文件 MD5 校验拒损坏。）
+3. 条件求值统一 `check(condition_id)`，全部系统复用。
+4. enabled_state 生命周期：active 加载；draft 调试可见；disabled 不加载；deprecated 不加载但留 ID 占位。
+5. 单位类型化（time_slice/game_day/currency/stamina/exp 进类型系统，同列禁混单位）。实证锚点：`700ms=10 游戏分钟`为运行时常量，配表侧时间单位统一 time_slice，禁现实秒混入。
+6. 多值一律关系子表；运行期无"解析逗号拼接"代码路径。
+7. 改表 → 验收过检（blocker=CI 红灯）→ 进包；`data_version` 为迁移依据（实证参照：原作存档迁移器按版本处理旧字段）。
+8. 随机契约：影响掉落/品质的 roll 绑定「世界日+存档 ID+位置/主体」种子（防读档刷结果；原作行为级种子实证：收获 `CreateRandom(x×7, y×11, DaysPlayed, uniqueID)`）。
+
+## 数值填充与验算
+
+- 填充代决台账：
+
+| 表 | 字段 | 默认值 | 依据 | 推翻条件 |
+|---|---|---|---|---|
+| 等级经验表 | skill_cumulative_xp | 100/380/770/1300/2150/3300/4800/6900/10000/15000 | 代码常量（Farmer.cs 实证） | 原型期曲线过陡/过缓 |
+| 作物表 | 防风草 price/days/xp | 35 金/4 日/8 xp | 原作作物表实证（crop 472：phases 1-1-1-1，xp_per_harvest 8） | 前 5 日验算不闭合 |
+| 经济表 | 买卖价差 | 商店价=2×基价×品质系数；出售所得=其半 | 原作一对出售方法实证 | 新手期现金流断裂 |
+| 战斗表 | 受击无敌帧 | 450ms（按武器类型 2/3 除） | 原作 takeDamage 实证 | 手感测试受击连按 |
+
+- 前五日闭环验算（防风草路线，起始 500 金实证口径）：
+
+| 日期 | 主目标 | 关键行动 | 主要成本 | 主要获得 | 结果 |
+|---|---|---|---|---|---|
+| 第 1 日 | 建立基础生产 | 购防风草种子×15（20 金/包）、开垦播种浇灌、采集少量木材 | 300 金；约 30 体力；约 8 时间片 | 15 块已播种地；少量木材；农务经验 | 进入等待成长阶段 |
+| 第 2 日 | 接社区引导 | 浇灌、采集木材、与工匠对话推进修路任务 | 约 25 体力；约 8 时间片 | 任务材料进度；少量经验 | 任务明确指向自然区域 |
+| 第 3 日 | 补足任务材料 | 浇灌、采集木材与铜矿、返回小镇 | 约 35 体力；约 12 时间片 | 木材 20、铜矿 5（或进度）；采集/战斗经验 | 可提交修路任务 |
+| 第 4 日 | 收获+解锁 | 收 15 防风草（35 金×15=525 金、8 xp×15=120 xp→农务 1 级）、提交任务领奖 | 任务材料；约 10 时间片 | 525 金；基础洒水器配方；林间区域开放 | 现金流回正＋新活动选择 |
+| 第 5 日 | 验证扩展循环 | 浇灌、赴林间采集或钓鱼、出售部分产物 | 约 30~45 体力；约 14 时间片 | 新资源、活动经验、可售物品 | 循环从单一农务扩展为农场+探索 |
+
+- 收益链校验：`item_seed_parsnip(20金) → crop_parsnip(4 日) → item_parsnip(35 金) → 出货箱日终结算 → 种子复购（单包毛利 15 金）`（逐环引 ID，全链存在）。
+- 验算结论：第 1 日不要求做完，播种即进展；第 4 日奖励同时给资金/配方/区域三样；第 5 日出现农场与探索取舍但两条路线都可行。
+
+## 验收
+
+- 验收记录：check_id / workbook / sheet / data_version / check_type（primary_key·reference·enum·unit·range·business_rule·duplicate_ownership）/ severity（blocker·warning·note）/ result / issue / owner / resolution。
+- 五查必过：主键唯一不空；外键存在且目标非弃用；枚举有清单（品质枚举 0/1/2/4 单独登记）；单位可判且同列不混；无违规负数、`duration=0` 仅即时。
+- 两查复核：业务规则（季节窗口相容、目标有验证系统、奖励一次、配方输入可达——防风草种子→收获→出售链全通）；重复归属（价格只由经济表维护、品质只由收获规则维护）。
+- 三级处置：blocker 禁止扩内容；warning 记负责人与计划；note 不阻断。
+- 工具化实证口径（参照知识库做法）：提取脚本逐表断言（行数/字段/枚举）；对账器做表间交叉对账（代表资产级 50 键全对账）；反例套件 5/5 拒绝。
+- 最近验收结论：check@C-2026-09-11-v1——五查全过、两查复核通过、blocker 清零（结构、规则或字段语义一变，受影响链路全部重验）。

apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-master.md

@@ -0,0 +1,59 @@
+# 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 存档实现前必须收口，否则冻结存档模块。