v0.14: 放置系统 (Idle Operations) — 采矿无人机舰队 + 6放置工程 + 永久产能加成 + idle徽章

2026-06-24 10:19:40 +00:00
parent 1701a908c9
commit 17820b1f28
189 changed files with 2718 additions and 35 deletions
@@ -0,0 +1,139 @@
+# Task ID: v0.14-reimpl
+# Agent: full-stack-developer
+# Task: 放置系统 (Idle Operations) — 采矿无人机舰队 + 6放置工程 + 永久产能加成 + idle徽章
+
+## Work Log
+
+### 1. 类型扩展 (`src/lib/game/types.ts`)
+- 新增 `IdleProjectDef` 接口（id/name/desc/durationSec/reward/minAscensions/minCrystalsPerSec/icon/color/order）
+- 新增 `IdleProjectSlot` 接口（projectId/startedAt/finishesAt/remainingSec/completed）
+- 在 `GameState` 接口 `pendingAttrPoints` 后新增 4 个字段：
+  - `idleProjectSlots: (IdleProjectSlot | null)[]`
+  - `idleProjectHistory: { projectId: string; finishedAt: number }[]`
+  - `idlePermanentBonus: number`
+  - `idleStats: { projectsCompleted: number; crystalsFromIdle: number }`
+
+### 2. 新建 `src/lib/game/idle.ts` (~290 行)
+- 定义 6 个放置工程（按 order 排序）：
+  | id | name | duration | reward | icon | color | unlock |
+  |----|------|----------|--------|------|-------|--------|
+  | idle_scan | 深空勘探扫描 | 60s | insights +8 | 🛰️ | emerald | cps≥0.5 |
+  | idle_refine | 晶体精炼阵列校准 | 180s | permBonus +0.3/s | ⚙️ | rose | cps≥1 |
+  | idle_archive | 遗迹碎片整理 | 600s | randomFragment + insights +20 | 📜 | amber | asc≥1 OR cps≥5 |
+  | idle_anchor | 维度锚点部署 | 1200s | energy +2 + contact +5 | ⚓ | fuchsia | asc≥1 |
+  | idle_drones | 无人机群扩编 | 1800s | permBonus +2/s + crystals +500 | 🛸 | emerald | cps≥10 |
+  | idle_resonance | 跨维度谐振标定 | 3600s | permBonus +8/s + contact +15 + insights +100 | 🌌 | fuchsia | asc≥2 |
+- 导出：`IDLE_PROJECTS`, `IDLE_SLOT_COUNT=3`, `getIdleProject`, `getUnlockedIdleProjects`, `getLockedIdleProjects`, `isIdleProjectUnlocked` (OR 逻辑：满足任一已设置条件即可解锁), `formatRemaining` (12s/3m 45s/1h 12m), `formatDuration`, `formatReward`, `deriveMinerFleet` (派生 min_1..min_5 采矿无人机，无任何采矿技术时返回休眠 min_1)
+- 导出颜色映射 `IDLE_COLOR_CLASSES` (text/border/bg/bgSoft/glow/ring/dot) + `COLOR_HEX` (用于 inline style，绕过 Tailwind 动态类限制)
+
+### 3. 引擎集成 (`src/lib/game/engine.ts`)
+- `recomputeStats()` 末尾 `crystalsPerSec += state.idlePermanentBonus ?? 0` (放置永久加成叠加到产能)
+- `performPrestige()` 在返回对象中：
+  - 清空 `idleProjectSlots: [null, null, null]` (飞升中断当前周目放置工程)
+  - 保留 `idleProjectHistory`, `idlePermanentBonus`, `idleStats` (跨周目永久)
+  - `recomputeStats` 调用传入 `idlePermanentBonus` 以确保飞升后立即应用永久加成
+- `createInitialState()` 新增 4 字段默认值
+
+### 4. Store actions (`src/store/gameStore.ts`)
+- 新增 4 个 action：
+  - `startIdleProject(slotIndex, projectId)`: 校验槽位空 + 项目已解锁 + 未在他处运行；写入 `{ projectId, startedAt, finishesAt, remainingSec, completed:false }`
+  - `cancelIdleProject(slotIndex)`: 置槽位为 null
+  - `claimIdleProject(slotIndex)`: 校验已完成 → 应用奖励（crystals 限 crystalCap，energy 限 energyMax，contact 限 100；permBonus 累加到 idlePermanentBonus + 重算 stats；randomFragment 从未解锁碎片中随机一个）→ 追加 history (slice -50) → idleStats.projectsCompleted++ → Toast 提示
+  - `tickIdleProjects(now)`: 遍历非空非完成槽位，更新 remainingSec，归零时标记 completed
+- **persist migrate 函数**：persist 配置增加 `version: 1` + `migrate` 函数，自动补全 idleProjectSlots/idleProjectHistory/idlePermanentBonus/idleStats 4 字段，旧存档加载不崩溃
+- 全部 14 处 syncStats 调用更新为传入 `idlePermanentBonus: s.idlePermanentBonus ?? 0`，确保 recomputeStats 计算时纳入永久加成
+- `init()` 中也补全 4 个 idle 字段（defense in depth）
+
+### 5. 主循环 (`src/hooks/useGameLoop.ts`)
+- 新增 `tickIdleProjects` 选择器
+- setInterval 回调中 `autoDecodeTick()` 后调用 `tickIdleProjects(now)`
+- visibilitychange 回调中也调用 `tickIdleProjects(now)`
+
+### 6. 新建 `src/components/game/IdleOperationsPanel.tsx` (~490 行)
+- 主「放置」标签内容，4 个 section 在 `max-h-[520px] overflow-y-auto` 容器中：
+  1. **放置收益概览**：3 stat tiles (放置产能 / 永久加成 / 完成工程) + 离线效率 progress bar + 累计放置晶体统计
+  2. **采矿无人机舰队**：grid 展示 deriveMinerFleet(state)，每张卡：emoji + name + Lv + output/s + 状态点（active=emerald ping 脉冲，dormant=灰）
+  3. **放置工程槽位**：3 张槽位卡（空槽=虚线占位，运行中=大字号倒计时+自定义进度条+取消按钮，已完成=奖励预览+领取按钮带 glow 辉光）
+  4. **可派遣工程**：2 列 grid 展示已解锁工程（icon+name+duration+desc+reward+3 个数字派遣按钮 1/2/3），下方列出未解锁工程及解锁条件
+- 使用 `useShallow` 订阅多个 store 字段
+- 本地 `now` state 每 1s 刷新倒计时
+- 严格 4 色全息（emerald/rose/amber/fuchsia），无蓝/靛
+- 自定义滚动条样式 (fuchsia 主题)
+
+### 7. 新建 `src/components/game/IdleStatusBadge.tsx` (~100 行)
+- 紧凑徽章：脉冲点 (emerald 若 cps>0，否则灰) + "放置中 +X/s" (或 "休眠中")
+- Tooltip 悬停展示分解：基础产能 / 永久加成 / 运行中工程 / 待领取工程数
+- `h-8 px-2.5 text-[11px]`，点击切换到放置标签
+- `data-tut="idle-status-badge"` 锚点
+
+### 8. 新建 `src/components/game/IdleProjectBar.tsx` (~90 行)
+- 晶体球下方的细长进度条
+- 显示最多 3 个运行/已完成工程为 mini pill：`[icon] name 12s ▓▓▓░░`
+- 完成时显示 "✓ 待领取" + glow 辉光
+- 无工程时返回 null
+- 本地 `now` state 每 1s 刷新倒计时
+- 进度条颜色用 inline style 控制（COLOR_HEX 映射）
+
+### 9. 主页面集成 (`src/app/page.tsx`)
+- 引入 3 个新组件 + `Clock` 图标 + `getUnlockedIdleProjects`
+- 新增 `idleProjectSlots` / `createdAt` store 订阅
+- 新增 `activeTab` / `tabInited` state，controlled Tabs：`<Tabs value={activeTab} onValueChange={setActiveTab}>`
+- 挂载后 useEffect 一次性设置默认 tab：hasActiveExpedition → "expedition"，hasPendingPerk → "constellation"，否则 → "idle"
+- 版本号 v0.8 → v0.14
+- Header 在 StarTideIndicator 后加 IdleStatusBadge
+- 左侧 CrystalOrb 后加 IdleProjectBar
+- TabsList grid-cols-8 → grid-cols-9，新增 `value="idle"` 的 TabsTrigger 作为第一个 tab（Clock 图标，emerald 主题，待领取时显示数量红点）
+- 新增 TabsContent value="idle" 渲染 IdleOperationsPanel
+- 新增 idle 相关 goal 提示（高优先级）：
+  - 待领取 > 0 → "✦ 放置工程已完成 X 项，请前往「放置」标签领取奖励"
+  - 全空 + 有解锁 + 时长 > 60s → "「放置」标签可派遣工程项目，离线自动产出"
+- StatsPanel 新增 3 行：放置永久加成 / 完成放置工程 / 放置产出晶体
+
+### 10. 教程更新 (`src/lib/game/tutorial.ts`)
+- TUTORIAL_STEPS 在 decode 与 tech 之间插入新步骤：
+  - id: "idle", target: "tab-idle", placement: "top"
+  - 标题 "③ 放置工程 · 离线产出"
+  - 介绍放置标签的工程派遣 + 顶部徽章 + 晶体球下方进度条
+- 原 tech/expedition/prestige 步骤编号顺延为 ④⑤⑥
+
+## QA 验证
+
+### Lint
+- `bun run lint` → 零错误零警告 ✅
+
+### HTTP
+- `curl http://localhost:3000/` → 200 OK ✅
+
+### Dev log
+- 全程无 runtime error，所有请求 200 OK，编译 < 250ms ✅
+
+### agent-browser 烟雾测试
+1. ✅ 版本标签 "v0.14" 可见
+2. ✅ 默认 tab 是 "放置"（data-state="active" 在第一个 tab）
+3. ✅ 头部 idle 徽章可见（"放置中 +0.4/s" 或 "休眠中"）
+4. ✅ IdleOperationsPanel 4 个 section 全部可见（放置收益概览 / 采矿无人机舰队 / 放置工程槽位 / 可派遣工程 / 未解锁工程）
+5. ✅ 采矿无人机舰队在无采矿技术时显示休眠 min_1（emoji ⛏️ + 灰色状态点）
+6. ✅ 设置 insights=50 → buyTech('min_1') → crystalsPerSec 0.4→1.0 → 解锁 idle_scan + idle_refine
+7. ✅ 点击 idle_scan 派遣按钮 → 槽位 0 写入 { projectId: "idle_scan", finishesAt: now+60000 } → 倒计时正确递减
+8. ✅ 60s 后自动标记 completed=true → 槽位卡显示 "✓ 完成" + 领取按钮
+9. ✅ 点击领取 → Toast "✦ 工程奖励已领取 · 深空勘探扫描 · +8 洞见" → insights 8→16 → history 追加 → idleStats.projectsCompleted 0→1
+10. ✅ 派遣 idle_refine (180s) → 强制完成 → 领取 → crystalsPerSec 1.0→1.3 → idlePermanentBonus 0→0.3 ✅ 永久产能加成正确应用
+11. ✅ IdleProjectBar 在晶体球下方显示：`🛰️ 深空勘探扫描 55s ▓▓▓░░`
+12. ✅ Footer goal 文字根据状态动态切换为放置相关提示
+13. ✅ Footer 产能显示 "产能 1.3/s" (含 idle 永久加成)
+
+### Migration 测试
+- 旧存档（无 idle 字段）通过 migrate 函数自动补全为默认值，加载不崩溃 ✅
+
+## Stage Summary
+- ✅ 类型层：新增 IdleProjectDef + IdleProjectSlot + 4 GameState 字段
+- ✅ 逻辑层：新建 idle.ts (~290 行)，6 工程定义 + 派生函数 + 颜色映射
+- ✅ 引擎层：recomputeStats / performPrestige / createInitialState 全部接入 idle 永久加成
+- ✅ Store 层：4 新 action + persist migrate (version 1) + 14 处 syncStats 调用全部传 idlePermanentBonus
+- ✅ 主循环：tickIdleProjects 接入 setInterval + visibilitychange
+- ✅ UI 层：3 新组件 (IdleOperationsPanel ~490 行 / IdleStatusBadge ~100 行 / IdleProjectBar ~90 行)
+- ✅ 主页面：默认放置 tab + 头部徽章 + 晶体球下方进度条 + 版本 v0.14 + 9 标签页
+- ✅ 教程：新增 idle 步骤 (③ 放置工程)
+- ✅ 严格 4 色全息 (emerald/rose/amber/fuchsia)，零蓝/靛
+- ✅ lint 零错误 + HTTP 200 + agent-browser 全流程烟雾测试通过
+- ✅ 5 秒内可见三要素：头部徽章 + 默认放置 tab + 晶体球下方进度条（派遣后）