登录流程

同福客栈 · 掌柜府第

登录流程梳理 v1.1 · 2026-06-27 · 10 项决策全部锁定，待落地

每次刷新 → 必过"掌柜府第"主菜单 → 玩家显式选择"继续 / 重玩 / 换档 / 切账本" → 进游戏

不静默续档 · 不强绑单账本（上限 8 个）· 开新周目玩家手动挑 slot

壹锁定的 5 个核心决策

是否锁屏开局

每次刷新强制回③掌柜府第

仪式感优先；无静默续档路径

账本策略

多账本并存

切换 = 切换 active profileId，建议上限 8 个

slot 分配 [v1.1 翻转]

玩家手动挑 slot

开新周目时弹 slot 选择器（只列空槽），玩家挑哪个就哪个；全满时提示归档

FirstRunGuide 触发

每次开新周目重讲，可跳过

"我熟，跳过"按钮按周目记（key 带 playthroughNo），下周目重弹

续档询问

每次刷新强制问"继续/重玩/换档"

即使只有 1 个 active slot 也要问，不默认勾选

贰完整登录流程

① 打开网页DOMContentLoaded

② 读账本索引（tongfu_account_index_v1）

③ 有账本吗？

无任何账本

④a 新手落籍
"建立您的账本"

输入掌柜名 → 写入默认账本 → 写入索引

有 ≥ 1 个账本

④b 落籍选档
"用哪个掌柜的身份进入？"

展示账本列表 → 玩家点选 active profile

⑤ 进入掌柜府第（主菜单）

玩家点击动作

继续上次的周目

触发"强制问"弹窗（决策 5）

重开新周目

弹 <SlotPickerModal> 玩家挑空 slot
→ 弹 FirstRunGuide（决策 4）

选历史存档

列出 3 个 slot，玩家挑

切换账本 / 新建账本

回到 ④b / ④a

⑥ 进入游戏 App.tsx 主场景

叁掌柜府第布局

┌─ 掌柜府第 ─────────────────────────────────┐ ┌──────────────────┬─────────────────────────────────────────────────┐ │ 左：账本身份 │ 中：快捷动作（按优先级） │ │ │ │ │ · 头像徽记 │ ① 继续上次的周目 (recentActiveSlot) │ │ · 掌柜名 │ └─ 显示"周目 #N · 第 X 天 · Y 铜钱"摘要 │ │ · 江湖传承点 │ │ │ · 总周目统计 │ ② 重开新周目（系统分配 slot） │ │ · 最近活跃 │ └─ "自动使用第一个空槽 [1/2/3]" │ │ │ │ │ │ ③ 选历史存档（3 slot 完整列表） │ │ │ │ │ │ ④ 切换账本 / ⑤ 新建账本 │ │ │ │ ├──────────────────┴─────────────────────────────────────────────────┤ │ 下：slot 缩略卡（3 张横排，最常用 slot 高亮） │ │ [Slot1: 周目#5 · Day 30 · 1240🪙] [Slot2: 空] [Slot3: 空] │ └────────────────────────────────────────────────────────────────────┘

肆续档确认弹窗（决策 5 落地形态）

伍边界情况处理

▎账本层

情况	行为
localStorage 不可用（隐私模式）	提示"请关闭隐私模式游玩"，不让进游戏（不静默降级）
global profile 解析失败 / 签名校验失败	备份原始 raw 到 `tongfu_global_profile_corrupted_v1`，生成全新默认账本，顶部 toast 提示
schema 版本过旧	自动 migrate 到当前 schema，toast "已自动升级"
创建第 9 个账本	弹"掌柜府第已满（8/8），请先归档一个账本"，列出账本列表

▎slot 层

情况	行为
3 个 slot 全空 + 开新周目	弹 <SlotPickerModal>，3 个空槽全亮，玩家挑一个 → FirstRunGuide
3 个 slot 全满 + 开新周目	弹"槽位已满，请先归档一个"，列出 3 个 slot 让玩家选
有 recentActiveSlot 但实际已被归档/清空	降级显示"无最近活跃周目"，"继续"按钮置灰
选历史存档时某 slot 记录损坏	红色标"损坏"标签，可点"重置该 slot"，不阻塞其他 slot

▎FirstRunGuide

触发情况	行为
开新周目（玩家挑 slot 后）	✅ 触发 FirstRunGuide
续档、换档、切账本	❌ 不触发
点"我熟，跳过"	⏭ 按周目记（key 带 playthroughNo），本周目内不重弹

陆落地顺序

数据层

扩 accountProfileStorage 支持多账本 + 加 tongfu_account_index_v1

路由层

<WelcomeGate> 顶层分流（落籍页 / 选账本页 / 掌柜府第 / 主游戏）

主菜单

<InnKeeperHall> + <SlotCard> 拼装

强制询问

<ResumeConfirmModal> 实现"继续/重玩/换档"三选一

slot 选择器 🆕

<SlotPickerModal> — 开新周目时弹，玩家手动挑空 slot

导出/删除 🆕

<AccountExportDialog> — 删账本前弹导出备份，带"不导出直接删"按钮

FirstRunGuide 改造

增加"我熟，跳过"按钮 + 周目级跳过标记（tongfu_first_run_skip_{playthroughNo}_v1）

边界打磨

损坏归档 / 槽满 / 隐私模式 toast / 数据迁移提示

视觉

掌柜府第的"古风大堂"氛围（左屏风 / 中灯笼 / 下条案）

柒已锁定的 5 个边角决策

① 切账本时

自动保存当前 active slot → 切完后写入新 active profile 的 recentActiveSlot

已锁定

② 删除账本

弹 <AccountExportDialog>：默认导出 JSON，提供"不导出，直接删"红色按钮

已锁定

③ 跳过按钮

按周目记（key = tongfu_first_run_skip_{playthroughNo}_v1），跨账本不串

已锁定

④ 多账本上限

限 8 个；超出上限时弹"掌柜府第已满，请先归档一个账本"

已锁定

⑤ slot 分配

玩家手动挑 — 开新周目走 <SlotPickerModal>，不再自动分配

已锁定

捌仍待拍板（v1.2 候选，不阻塞）

进度概览

切账本 / 开新周目时弹"上次进度概览"？（我的倾向：切账本弹，新周目不弹）

待确认

归档账本

软删除 vs 硬删除？（我的倾向：软删除，30 天后清理，列表里标灰）

待确认

账本导入

是否支持 JSON 导入/导出？（我的倾向：支持，备份/分享/换设备）

待确认

成就墙归属

成就跟账本绑 vs 跟设备绑？（我的倾向：跟账本绑，符合武侠叙事）

待确认