方寸仙門

🪟總覽

一句話定位 + 五個賣點 + 五個不做

✨五個賣點

🚫五個不做

🎮玩法設計

五界 / 弟子 / 配方 / 道學 / 飛升 / 自動化 / 天機 / 潮汐 / quest / 設計鐵律

⚖️五大設計哲學

⚙️雙軸對等視覺化

📜16 條設計鐵律完整表(M0-M78 累積)

⏱️8 反饋頻率(M27 設計)

每頻率「sub-target」缺了,玩家就覺得 dead time 太長 → 棄。

📈進度曲線 8 時段(NUMBERS_DESIGN)

🎓新手引導 · 6 階段

設計目標:讓「沒玩過放置」的人在 5 分鐘內入坑、30 分鐘前不退、7 天內第一次飛升。

🛣️新手黃金路徑 SOP(第一小時)

第一小時結束時,你應該有 5 座殿堂 · 3 名弟子 · 1 條道學 · 1 條自動化規則 · 約 500 靈氣 + 50 靈石

🛡️5 個避免新手挫折的設計

🌌世界觀 · 五界

天地之初,混沌一炁。一炁分而為陰陽,陰陽錯而為五行,五行紊而生萬類。萬類各有其數,而數之上者,謂之「道」。
仙者,人字旁加山 — 是把人放到山裡,而不是把人練成刀。這是一個關於「目送」的故事。

📿六道學流派

🧘弟子系統

🏆七階稀有度

🎁起手 3 弟子(免費 · 固定)

🌀25 種靈根 · 五行單(rateBonus 基準)

🌳10 種五行雙靈根(罕見,天才以上)

✨3 種罕見三靈根(仙才以上)

🌟1 種天靈根(道祖+ 保底)

🌌30 異靈根(極稀,1000 連保底,範例 8 種)

五行單 5 + 五行雙 10 + 罕見三靈 3 + 天靈根 1 + 異靈根 30 = 49 完整池

🎴境界突破 cost(M65 大幅下修)

🌳60 節點 8 分支個人樹

📊主力陣容 vs 後備庫 vs 仙史閣

切換主力 ↔ 後備:1 小時冷卻。主力位擴張:1-10 散修 5 / 11-30 凡品 6 / 31-50 三流 7 / 51-70 二流 8 / 71-100 一流 10 / 升仙界後 12。

📊五圍屬性

🌱突破 7 段境界

每段 9 重 = 63 段。突破 cost 1e2 / 1e4 / 1e6 / 1e9 / 1e13 / 1e18 / 1e25 (M65 大幅下修)。realmMul = 1.5^REALM_INDEX。

🎯派別匹配三層

派別深度由 M62 / M67 / M68 三個 milestone 構成,形成單卡 affinity → 道學 bonus → 同建築 stacking 的層次系統。

🏭生產系統

📦T0-T9 物品 tier

🏯12 凡界殿堂

📿道學樹 · 230 節點

致敬《星際工業國》的雙階段成本 + 多種點互鎖。200 條 MVP + 後續每界 +30 條 = 完整 ~300 條。

📊雙階段成本

☁️飛升與升界

🎴弟子飛升(週期 1-3 天)

觸發:弟子達化神境 + 渡劫 9 重。保留與重置 — 殘影 = prestige 的浪漫名,代表「曾經走過的路,都會化作未來的光」。

🏛️仙史閣 4 子系統(飛升弟子永遠在的家)

💫50 種飛升殘影池(範例 12 種)

每次飛升從池抽 1-3 種殘影。永不重置、永遠強化下一輪。

餘 38 種包含 攻擊向 / 採集向 / 防禦向 / lore-flavor 等多種類別,5000 連保底「傳奇殘影」獨家。

🌌世界升界(週期 1-2 月)

cosmicMul ladder · 升界不是 reset,是擴展 — 凡界殿堂繼續運轉,新界內容疊加在上。

🎴抽卡系統 · 七階池(無 FOMO)

🎯大保底(各池獨立)

• 10 連:次階+
• 60 連:主階
• 200 連:該池最高一般階
• 1000 連:高階
• 5000 連:傳奇弟子(獨家立繪 / 5 句告別詞 / 5 個獨有節點)

🤖自動化 · 15 機制 + idle pilot

15 機制由 M8 (1-7) + M9 (8-15) 分批 ship。每機制獨立 flag,預設全 false(M18 漸進解鎖)。

🔮天機 · 潮汐 · 螢幕生態系

🎰天機 8 子系統(平均 4-7 分鐘觸發一套)

8 套相互疊加可做「全套天機暴走」秒殺事件 — 玩家為下一次撞臉繼續開遊戲。

🎲4 個 RNG 老虎機系統

🕐12 时辰潮汐完整表(對齊真實作息)

潮汐 FOMO:每天 2-3 個 30 分鐘高產時段(辰 / 午 / 戌)。不是限定登入,是「錯過就少賺」。

🖥️螢幕生態系(讀前景視窗,不上傳)

📜Quest 系統 · 88 任務

M74 ship · 88 任務跨 stage 0-7(平均 10-12 / stage)。任務 = 教學實操驗證(M60 step 完成 → 觸發對應 quest)。每 stage 2-3 個 ⭐ 里程碑必做、其他可選。

🎣七個 Hook 設計

🔄回流設計

避免「我都不知道在幹嘛了」的核心策略 — 永不重置承諾 + 桌寵擬人化問候 + 重點提示縮短 + 長期目標看板。

📅斷線 1 天

師尊您回來了。
您離開了 1 天 8 小時。
弟子們累積靈氣:124 萬
陳青松完成了 2 次小突破。
發生了 1 次紫雲事件,代您收下了。

[領取並繼續]   [檢視詳情]

📆斷線 1 週 — 「歸來儀式」

📔斷線 1 個月 — 「回首儀式」(最危險時刻)

🧭避免「我都不知道在幹嘛」5 條策略

👥三種玩家旅程

🏗️技術架構

模組層 · 狀態 · tick 引擎 · IPC · 存檔 · 測試 · 開發流程

⚙️技術棧(已鎖)

📁模組分層

src/
├── 🖥️  main/               Electron 主行程 — windows / IPC / tray / save manager
├── 🌉  preload/            contextBridge — renderer 唯一對 main 的入口
├── ⚛️  renderer/           React UI + PixiJS canvas + 14 系統頁
│   ├── components/         共用元件
│   ├── views/              14 系統頁
│   ├── progression/        階段性 UI(PerformanceModal / NumberDisplay)
│   └── styles/             theme.css(M75-M78 美術線維護)
├── 🧮  core/               純函數遊戲邏輯(無 store 副作用)
│   ├── bignumber.ts
│   ├── production-loop.ts  生產 tick 主迴圈
│   ├── auto-*.ts           9 個自動化機制
│   ├── disciple/           bonus-calc / recruitment / ascension / stacking
│   ├── building/           升級 / 升級節點
│   ├── dao/                research / 230 節點
│   ├── realm/              境界 / 升界
│   ├── balance/            simulator / player-profile / auto-playtest
│   ├── fortune/            天機 8 子系統
│   ├── seasonal/           季節事件
│   ├── tide/               12 时辰潮汐
│   ├── local-social/       弟子羈絆 + 6 NPC
│   ├── mystic-realm/       秘境派遣
│   └── tribulation/        天劫戰鬥
├── 📋  data/               純資料常數(無 logic)
├── 🐻  store/              Zustand state(sect + 5 sub)
├── 💾  save-system/        持久化 + cloud stub
├── 🤝  shared/             type 共用
├── 🌐  i18n/locales/       3 語
└── 📊  telemetry/          PostHog / Mixpanel stub

➡️依賴方向鐵律

data → core → store → renderer
              ↑
              save-system
              ↑
              shared (types only)

main ←→ preload (via contextBridge) → renderer
main → save-system (directly, FS access)

core/ 絕不依賴 store/ 或 renderer/,所有遊戲邏輯都是純函數,輸入 state → 輸出新 state。讓 simulator 可無 UI 跑 1000 小時模擬。

🐻State 管理(Zustand)

📦主 store + 5 sub-stores

📋SectState 完整接口

interface SectState {
  // === 資源 ===
  inventory: Record<ItemId, string>   // BigNumber 序列化為 string

  // === 弟子 ===
  disciples: Record<DiscipleId, Disciple>
  recruitCounts: Record<Rank, number>  // 5 階各買過幾次
  bonds: Record<BondId, number>        // 羈絆強度

  // === 建築 ===
  buildings: Record<BuildingId, BuildingState>
    // BuildingState = { level, slots: SlotAssignment[] }
    // SlotAssignment = { recipeId, discipleId, progress, recipeQueue }

  // === 道學 ===
  unlockedNodes: NodeId[]
  daoPoints: Record<DaoBranch, string> // 6 流派各自累計
  researchedTechs: TechId[]
  activeEchoes: ActiveEcho[]            // 飛升殘影 啟用槽

  // === 境界 / 飛升 ===
  realm: 'mortal' | 'immortal' | 'divine' | 'true_divine' | 'dao'
  realmAscensionAt: number | null
  ascendedCount: number
  ascensionRecords: AscensionRecord[]
  ascensionPoints: number               // 仙緣點(M43)
  ascensionShopPurchases: Record<ShopItemId, number>

  // === 自動化 — 11 個 auto-* flag(全 false default)===
  autoAssignEnabled: boolean
  autoBreakthroughEnabled: boolean
  autoResearchEnabled: boolean
  autoRulesEnabled: boolean
  autoByproductsEnabled: boolean
  autoQualityEnabled: boolean
  autoRecipeQueueEnabled: boolean
  autoTeleportEnabled: boolean
  autoRefineEnabled: boolean
  autoDispatchEnabled: boolean
  autoPriorityChainEnabled: boolean
  autoRules: AutoRule[]
  autoResearchPriority: DaoBranch[]

  // === M79 新增(規劃中)===
  idlePilotEnabled: boolean             // master toggle, default true
  lastIdlePilotTickAt: number | null    // 節流計時

  // === 天機 / 季節 / 秘境 / NPC ===
  fortune: FortuneState
  seasonalState: SeasonalState
  mysticRealmDispatches: MysticRealmDispatch[]
  equipmentRefinement: Record<ItemId, RefinementState>
  teleportTransfers: TeleportTransfer[]
  discipleDispatch: Record<DiscipleId, DispatchState>

  // === 其他增益 ===
  recipeProficiency: Record<RecipeId, number>
  synergyEnhancements: Record<SynergyKind, number>
  spawnedPetIds: PetId[]                // 桌寵狀態

  // === Meta ===
  rngSeed: string                       // 進存檔保 replay
  lastTickAt: number                    // wall clock
  timeSpeed: 1 | 2 | 4 | 8              // v1.0.6 時間流速
  ftueCompleted: boolean
  unlockedAchievementIds: AchievementId[]
  eventLog: EventLogEntry[]
  notificationMode: 'ambient' | 'silent' | 'dnd24h'
  notificationBadgeCount: number
  pendingOfflineReport: OfflineReport | null
}

⚠️BigNumber × Zustand 陷阱

// UI subscribe 時取 .toString() 字串比較
const power = useSectStore(s => s.power.toString())

// 真要算的時候才 bn(power).mul(...)

⏱️Tick 引擎 + M62 公式

🔄主迴圈

// useSectStore.tick(deltaSec) action
tick(deltaSec) {
  const state = get()
  const rng = createSeededRng(state.rngSeed)

  // 1. production-loop tick(主生產)
  const afterProduction = productionLoopTick(state, deltaSec, rng)

  // 2. M79 idle pilot tick(若 idlePilotEnabled)
  const afterIdlePilot = applyIdlePilotTick(afterProduction, rng, elapsedSec)

  // 3. autoRules / autoByproducts 等獨立 auto- 邏輯
  const afterAutos = applyAutos(afterIdlePilot, rng)

  // 4. fortune / seasonal / tide tick
  const afterMeta = tickMetaSystems(afterAutos, deltaSec, rng)

  // 5. 提交
  set(afterMeta)
}

📐M62 Coupling 公式

rateMultiplier =
    buildingLevelMul                  // UPGRADE_RATE_MULTIPLIER^(level-1)
  × additiveBaseline                  // 1.0 + max(0,(avgAttr-20)/100) × 0.5
  × (1 + discipleMultBonus)           // cultivation + category attr + 靈根
  × affinityMatchCoef                 // 1.5 主派 / 1.2 副派 / 0.8 不匹配
  × realmMultiplier                   // 1.5^REALM_INDEX (M62 verdict v2)

• 弟子缺席:additiveBaseline = 1.0,建築獨立可跑
• safeMul clamp 到 [0.01, 1e9] 防運算溢出
• Tick 頻率:requestAnimationFrame → 邏輯 tick 固定 100ms
• 離線封頂 24 小時(M23 設計,M71 校準)

💾Save / Load 系統

🪟IPC + 雙視窗架構

👆點擊穿透

// 桌寵預設「穿透模式」
petWindow.setIgnoreMouseEvents(true, { forward: true })

// 滑鼠進入 hitbox → forward 事件偵測 → 切「互動模式」
petWindow.setIgnoreMouseEvents(false)

// 離開 hitbox 0.5 秒後 → 切回穿透

🔌完整 IPC channel(contextBridge)

Renderer 永遠用 window.api.* 而非 ipcRenderer(contextIsolation: true + nodeIntegration: false)。

🔄Migration Chain 詳細

v0.x baseline
  → migrate_v0_6_secondary_dao             // M62 自動算 secondaryDao
  → migrate_v0_7_dao_node_reorder          // M67 道學節點重排
  → migrate_v0_8_stacking_bonus_field      // M68 stacking bonus 新欄位
  → migrate_v0_9_quest_store_init          // M74 quest store 預設值
  → v1.0 ship time(2026-05-11)凍結

  → migrate_v1_0_to_v1_1_affinity          // 派別匹配係數
  → migrate_v1_1_breakthrough_cost         // M65 突破 cost 下修
  → migrate_v1_1_cosmic_mul                // M65 cosmicMul ladder

  → migrate_v1_1_to_v1_2_idle_pilot        // M79 idlePilotEnabled + lastIdlePilotTickAt
  → v1.2 (M79 規劃中)

每個 migration idempotent + 保留未知欄位(轉發給下個 migration)。重跑同 save 結果完全一致。Migration runner 在 src/save-system/migrations.ts 內 chain 順序執行。

♾️大數字系統(三層體驗)

📊Balance Simulator + Auto-Playtest

M61 / M66 ship · 4 個 player profile × 240 分鐘無 UI 模擬,verify anchors。

⏰Anchors(M66-auto 驗收條件)

• firstBreakthrough ≤ 2 min
• firstNewBuilding ≤ 3 min
• fifthDisciple ≤ 15 min
• firstAscension ≤ 5 hour
• stage5 ≤ 5 hour / stage7 ≤ 24 hour
• feedbackDensity30m ≥ 5 events/window
• spiritQiMinute60Cap ∈ [3x, 10x] baseline

⚡效能 Budget(M25)

✅測試策略 · 4 層

當前 168 test files,M79 +22 case + happy-dom 補裝後 5 個假性綠燈會真實跑。

👥開發流程 · 三層分工

📋OpenSpec 四件組(每 milestone)

openspec/changes/M<n>-<name>/
├── proposal.md     為什麼 / 改什麼 / 商業價值 / 範圍 / 不動
├── design.md       技術方案 + Step 1-N 程式碼骨架 + MUST NOT
├── specs/<area>.md GIVEN/WHEN/THEN + SHALL/MUST NOT
└── tasks.md        Done When 1:1 對應

🔧Q1-Q10 常見技術問題解法

🚫不可動清單(MUST NOT)

🤝多 AI 並行協議

兩條 Claude Code session 並行運作 · 邏輯線主導 · 美術線 implementation arm

🚨為什麼有這份協議

2026-05-13 同一天 repo 發生過三次撞車:

🔀兩條活躍 session

🚧美術線可動 / 不可動範圍

📝commit message 慣例

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

🔄開機 SOP(每條 session 進入工作前)

cd <repo>
git fetch origin main
git log --oneline HEAD..origin/main  # 看對方推了什麼
git log --oneline origin/main..HEAD  # 看我已 commit 沒 push 的
git status --short                    # 看 working tree

詳細請見 docs/CROSS_SESSION_COORDINATION.md。

📊開發進度

M0 - M79 全進度概覽

⚠️已知問題(v1.1.0 release notes)

🛤️下一步路線(REMAINING_TASKS)

🎯M80 OVERTURN 決議

2026-05-13 M80 Ship-Readiness Audit Iter2(96/100)· 17 位專家 · 16 條 OVERTURN · 2026-05-14 使用者全 review · 15 採納 / 1 不採納

⚡7 條強烈採納(設計重大改善)

✅8 條採納(各有 timing)

❌1 條不採納

🛤️11 週 Critical Path → EA 2026-07-29

💰Pre-Ship Budget(USD,精算)

不算開發者自家時薪:$17-49k USD。需要 7-10k wishlist 才能 sustainable(12 個月個人 runway 含生活費 +$30k = $73k total)。

📈Revenue 4 情境(扣 30% Steam fee 後)

⚡本週必啟動 6 件事