From fbf8d34f45bf1ebc5856fa98203cff7b661832cd Mon Sep 17 00:00:00 2001
From: Linghong <ink29535@proton.me>
Date: Tue, 15 Sep 2026 12:14:03 +0800
Subject: [PATCH 1/2] =?UTF-8?q?=E6=96=B0=E5=A2=9E=20AGC=20=E9=A6=96?=
 =?UTF-8?q?=E9=A1=B5=E7=AD=96=E5=88=92=E8=A1=A5=E5=85=A8=E5=85=A5=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

首页做游戏入口增加策划补全勾选项

勾选后复用 planning Agent Runtime 启动模式

补充首页启动模式回归测试与实施计划
---
 .../src/view/home/homeStartMode.ts            | 12 +++++++
 .../src/view/home/index.tsx                   | 31 ++++++++++++++++---
 .../tests/homeStartMode.test.ts               | 18 +++++++++++
 ...实施计划】AGC首页策划补全入口-2026-09-15.md | 16 ++++++++++
 ...��里程碑】AGC首页策划补全入口-2026-09-15.md | 20 ++++++++++++
 5 files changed, 93 insertions(+), 4 deletions(-)
 create mode 100644 apps/ai-game-creator-shell/src/view/home/homeStartMode.ts
 create mode 100644 apps/ai-game-creator-shell/tests/homeStartMode.test.ts
 create mode 100644 docs/project-memory/plans/【实施计划】AGC首页策划补全入口-2026-09-15.md
 create mode 100644 docs/project-memory/plans/【里程碑】AGC首页策划补全入口-2026-09-15.md

diff --git a/apps/ai-game-creator-shell/src/view/home/homeStartMode.ts b/apps/ai-game-creator-shell/src/view/home/homeStartMode.ts
new file mode 100644
index 000000000..4724c1066
--- /dev/null
+++ b/apps/ai-game-creator-shell/src/view/home/homeStartMode.ts
@@ -0,0 +1,12 @@
+import type { ProjectStartMode } from '../../app/types';
+import type { HomeCreationType } from './useHomeDraftStore';
+
+export function resolveHomeStartMode(
+  creationType: HomeCreationType,
+  planningCompletionEnabled: boolean,
+): ProjectStartMode {
+  return creationType === 'doc' ||
+    (creationType === 'game' && planningCompletionEnabled)
+    ? 'planning'
+    : 'direct-build';
+}
diff --git a/apps/ai-game-creator-shell/src/view/home/index.tsx b/apps/ai-game-creator-shell/src/view/home/index.tsx
index d1470cb25..74f596b64 100644
--- a/apps/ai-game-creator-shell/src/view/home/index.tsx
+++ b/apps/ai-game-creator-shell/src/view/home/index.tsx
@@ -20,6 +20,7 @@ import {
   richTextToAttachments,
   richTextToPrompt,
 } from './components/RichInputArea/richTextToPrompt';
+import { resolveHomeStartMode } from './homeStartMode';
 import InspirationGallery from './InspirationGallery';
 import {
   type HomeCreationType,
@@ -145,14 +146,18 @@ export default function HomeView({
     (state) => state.setRichText,
   );
   const [homeCreationBusy, setHomeCreationBusy] = useState(false);
+  const [planningCompletionEnabled, setPlanningCompletionEnabled] =
+    useState(false);
   const homeCreationBusyRef = useRef(false);
   const activeCreationType =
     HOME_CREATION_TYPE_ITEMS.find(
       (item) => item.creationType === homeCreationType,
     ) ?? HOME_CREATION_TYPE_ITEMS[0]!;
   // 做方案走立项策划链路，做游戏 / 做素材维持既有的直接开建路由。
-  const startMode: ProjectStartMode =
-    homeCreationType === 'doc' ? 'planning' : 'direct-build';
+  const startMode = resolveHomeStartMode(
+    homeCreationType,
+    planningCompletionEnabled,
+  );
 
   async function createFromHome() {
     if (homeCreationBusyRef.current || creationBusy) {
@@ -241,7 +246,12 @@ export default function HomeView({
                 type="button"
                 key={item.creationType}
                 aria-pressed={isActive}
-                onClick={() => setHomeCreationType(item.creationType)}
+                onClick={() => {
+                  setHomeCreationType(item.creationType);
+                  if (item.creationType !== 'game') {
+                    setPlanningCompletionEnabled(false);
+                  }
+                }}
               >
                 <CreationTypeIcon size={14} aria-hidden="true" />
                 {item.label}
@@ -262,8 +272,21 @@ export default function HomeView({
             }}
           >
             <div className="grid grid-cols-[1fr_auto] items-center gap-2.5 text-[12px] text-(--platform-text-soft)">
-              <div className="flex min-w-0 items-center gap-1.5">
+              <div className="flex min-w-0 items-center gap-3">
                 <UploadButton />
+                {homeCreationType === 'game' ? (
+                  <label className="inline-flex cursor-pointer items-center gap-1.5 whitespace-nowrap">
+                    <input
+                      type="checkbox"
+                      checked={planningCompletionEnabled}
+                      onChange={(event) =>
+                        setPlanningCompletionEnabled(event.target.checked)
+                      }
+                      disabled={homeCreationBusy || creationBusy}
+                    />
+                    <span>策划补全</span>
+                  </label>
+                ) : null}
               </div>
               <div className="flex shrink-0 items-center gap-1.5">
                 <ConversationModelSelect
diff --git a/apps/ai-game-creator-shell/tests/homeStartMode.test.ts b/apps/ai-game-creator-shell/tests/homeStartMode.test.ts
new file mode 100644
index 000000000..3050522a2
--- /dev/null
+++ b/apps/ai-game-creator-shell/tests/homeStartMode.test.ts
@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest';
+
+import { resolveHomeStartMode } from '../src/view/home/homeStartMode';
+
+describe('AGC 首页启动模式', () => {
+  it('做游戏勾选策划补全时进入策划 runtime', () => {
+    expect(resolveHomeStartMode('game', true)).toBe('planning');
+  });
+
+  it('做游戏未勾选策划补全时保持直接创作', () => {
+    expect(resolveHomeStartMode('game', false)).toBe('direct-build');
+  });
+
+  it('做方案始终进入策划 runtime，其他入口不受影响', () => {
+    expect(resolveHomeStartMode('doc', false)).toBe('planning');
+    expect(resolveHomeStartMode('art', true)).toBe('direct-build');
+  });
+});
diff --git a/docs/project-memory/plans/【实施计划】AGC首页策划补全入口-2026-09-15.md b/docs/project-memory/plans/【实施计划】AGC首页策划补全入口-2026-09-15.md
new file mode 100644
index 000000000..8f9ca580c
--- /dev/null
+++ b/docs/project-memory/plans/【实施计划】AGC首页策划补全入口-2026-09-15.md
@@ -0,0 +1,16 @@
+Version: 1
+Status: active
+Date: 2026-09-15
+Parent Spec: 【里程碑】AGC首页策划补全入口-2026-09-15.md
+
+## 修改顺序
+
+1. 在 `view/home/index.tsx` 增加本地复选框状态与入口切换清理。
+2. 将游戏勾选状态映射到既有 `ProjectStartMode`。
+3. 增加首页组件测试覆盖模式分流和显示边界。
+
+## 验证
+
+- AGC 首页相关定向测试。
+- AGC 前端 typecheck。
+- `npm run check:encoding` 与 `git diff --check`。
diff --git a/docs/project-memory/plans/【里程碑】AGC首页策划补全入口-2026-09-15.md b/docs/project-memory/plans/【里程碑】AGC首页策划补全入口-2026-09-15.md
new file mode 100644
index 000000000..04197703c
--- /dev/null
+++ b/docs/project-memory/plans/【里程碑】AGC首页策划补全入口-2026-09-15.md
@@ -0,0 +1,20 @@
+Version: 1
+Status: active
+Date: 2026-09-15
+Parent Spec: AGC 首页与 Agent Runtime 入口
+
+## 范围
+
+在首页“做游戏”输入框下增加“策划补全”复选框；勾选后复用现有 `planning` 启动模式进入策划 Agent Runtime。
+
+## 验收标准
+
+- 仅“做游戏”显示复选框。
+- 勾选时提交 `planning`，未勾选时提交 `direct-build`。
+- “做方案”原有 `planning` 行为保持不变。
+- 切换到其它创作类型时清除游戏专属勾选状态。
+
+## 不做项
+
+- 不新增 runtime 类型、后端接口或持久化字段。
+- 不改变现有策划 runtime 内部流程。
-- 
2.52.0


From 9389c7fff8d197505f2993c249eddf866752aa61 Mon Sep 17 00:00:00 2001
From: Linghong <ink29535@proton.me>
Date: Tue, 15 Sep 2026 12:26:57 +0800
Subject: [PATCH 2/2] =?UTF-8?q?=E4=BF=AE=E6=AD=A3=20AGC=20=E7=AD=96?=
 =?UTF-8?q?=E5=88=92=E8=A1=A5=E5=85=A8=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

更新首页启动模式注释以覆盖游戏策划补全分支

同步实施计划与当前测试覆盖边界
---
 apps/ai-game-creator-shell/src/view/home/index.tsx          | 2 +-
 .../plans/【实施计划】AGC首页策划补全入口-2026-09-15.md     | 6 +++++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/apps/ai-game-creator-shell/src/view/home/index.tsx b/apps/ai-game-creator-shell/src/view/home/index.tsx
index 74f596b64..4310caee6 100644
--- a/apps/ai-game-creator-shell/src/view/home/index.tsx
+++ b/apps/ai-game-creator-shell/src/view/home/index.tsx
@@ -153,7 +153,7 @@ export default function HomeView({
     HOME_CREATION_TYPE_ITEMS.find(
       (item) => item.creationType === homeCreationType,
     ) ?? HOME_CREATION_TYPE_ITEMS[0]!;
-  // 做方案走立项策划链路，做游戏 / 做素材维持既有的直接开建路由。
+  // 做方案始终走立项策划链路；做游戏勾选“策划补全”时复用该链路，做素材保持直接开建。
   const startMode = resolveHomeStartMode(
     homeCreationType,
     planningCompletionEnabled,
diff --git a/docs/project-memory/plans/【实施计划】AGC首页策划补全入口-2026-09-15.md b/docs/project-memory/plans/【实施计划】AGC首页策划补全入口-2026-09-15.md
index 8f9ca580c..c2d0fbf4f 100644
--- a/docs/project-memory/plans/【实施计划】AGC首页策划补全入口-2026-09-15.md
+++ b/docs/project-memory/plans/【实施计划】AGC首页策划补全入口-2026-09-15.md
@@ -7,10 +7,14 @@ Parent Spec: 【里程碑】AGC首页策划补全入口-2026-09-15.md
 
 1. 在 `view/home/index.tsx` 增加本地复选框状态与入口切换清理。
 2. 将游戏勾选状态映射到既有 `ProjectStartMode`。
-3. 增加首页组件测试覆盖模式分流和显示边界。
+3. 增加启动模式纯函数测试，覆盖模式分流；首页显示边界和切换清理作为后续组件测试补充项。
 
 ## 验证
 
 - AGC 首页相关定向测试。
 - AGC 前端 typecheck。
 - `npm run check:encoding` 与 `git diff --check`。
+
+## 当前验证边界
+
+本次已交付测试覆盖 `planning` / `direct-build` 模式分流；“策划补全”复选框的显示边界及切换创作类型后的状态清理尚未有组件级自动化测试，需后续补充 `HomeView` 测试时完成。
-- 
2.52.0