羁绊与感情线开发文档

目标：围绕《武林外传》群像关系，建立可长期扩展的“羁绊 / 感情线”系统。第一步先补内容库和开发方案，后续再开子会话按版本落地代码。

设计定位

• 系统名：同福羁绊
• 内容范围：客栈内人物关系、客栈外熟人关系、江湖旧识关系。
• 核心体验：玩家经营客栈时，人物关系会随着时间、事件、岗位、经营状态逐步推进，解锁剧情节点和轻量加成。
• 叙事原则：以原著人物关系为基础，写“可互动的群像关系”，避免复刻长台词。
• 玩法原则：羁绊不是单纯图鉴，而是会影响事件权重、员工加成、客流、治安、声望和特殊剧情。

系统目标

1. 让挂机过程中出现“人物关系在变化”的长期反馈。
2. 把随机事件从单次选择升级为可积累的关系线。
3. 让同一角色在不同关系中产生不同倾向，例如吕秀才在郭芙蓉线和祝无双线里承担不同选择压力。
4. 让非客栈人物也能进入长期关系网络，例如钱掌柜与钱夫人。
5. 后续可接入擂台赛、节令、联机助阵和稀有客人。

核心概念

羁绊 Bond

两名或多名角色之间的一条长期关系线。

示例：

• 郭芙蓉 × 吕秀才：吵闹相知
• 祝无双 × 吕秀才：温柔错位
• 白展堂 × 佟湘玉：旧江湖与新日子
• 钱掌柜 × 钱夫人：账房外的家务风波

羁绊值 bondValue

• 范围建议：0-100
• 0-24：陌生 / 紧张
• 25-49：熟悉 / 暧昧
• 50-74：互相信任
• 75-100：关键羁绊

羁绊阶段 stage

建议第一版固定 4 档：

• seed：种子事件
• friction：冲突或误会
• choice：关键抉择
• settled：阶段性稳定

羁绊标签 tags

用于事件权重和 UI 展示：

• romance：感情线
• family：家人 / 夫妻
• rivalry：竞争
• mentor：指导
• old_debt：旧账
• business：生意关系

建议数据结构

export type BondId =
  | 'guo_lu_romance'
  | 'wushuang_lu_unspoken'
  | 'bai_tong_life'
  | 'qian_couple_family';

export type BondStage = 'seed' | 'friction' | 'choice' | 'settled';

export interface BondState {
  id: BondId;
  value: number;
  stage: BondStage;
  unlocked: boolean;
  lastEventDay?: number;
  flags?: Record<string, boolean>;
}

export type BondStates = Record<BondId, BondState>;

兼容要求：

• 当前实现已将 BondStates 写入存档，且已按版本规则提升 SAVE_SCHEMA_VERSION。
• 后续若继续扩展羁绊字段，仍需同步提升 SAVE_SCHEMA_VERSION。
• 旧存档缺字段时，所有羁绊默认 unlocked: false、value: 0、stage: 'seed'。
• 已经存在的客栈员工和稀有客人不能因羁绊字段缺失导致读档失败。

首批羁绊内容库

1. 郭芙蓉 × 吕秀才：吵闹相知

定位：

• 客栈核心感情线之一。
• 关键词：嘴硬、斗嘴、护短、读书与拳脚。
• 玩法倾向：名声、清洁、治安之间的取舍。

阶段节点：

| 阶段 | 事件名 | 内容方向 | 玩家选择 | 结果方向 | | --- | --- | --- | --- | --- | | seed | 拌嘴从早饭开始 | 芙蓉嫌秀才念书碍事，秀才嫌芙蓉擦桌太粗 | 劝他们分工 / 让他们合作迎客 | 合作提高名声，分工提高效率 | | friction | 一掌拍碎账台边角 | 芙蓉急着镇场，秀才心疼账本 | 赔钱修账台 / 让秀才写检讨告示 | 修账台稳关系，告示涨名声但伤感情 | | choice | 谁来替谁出头 | 外地客人嘲笑秀才，芙蓉想上前理论 | 让芙蓉护人 / 让秀才自己应对 | 护人涨羁绊和治安，自证涨名声 | | settled | 文武双全待客法 | 两人找到搭档节奏：秀才说理，芙蓉镇场 | 固化为前堂组合 | 解锁前堂名声加成 |

可解锁效果：

• 羁绊 25：两人同在前堂时，名声收益小幅提高。
• 羁绊 50：随机事件中“冲突调解”类风险下降。
• 羁绊 75：触发“文武双全待客法”，顾客耐心小幅提高。

2. 祝无双 × 吕秀才：温柔错位

定位：

• 细腻感情线，重点不是三角冲突，而是“错过、体面、成长”。
• 关键词：温柔、克制、误会、成全。
• 玩法倾向：清洁、名声、员工心情、事件选择压力。

阶段节点：

| 阶段 | 事件名 | 内容方向 | 玩家选择 | 结果方向 | | --- | --- | --- | --- | --- | | seed | 无双替秀才收书 | 无双帮秀才整理账本和书页 | 接受帮忙 / 婉拒好意 | 接受涨清洁和羁绊，婉拒保距离 | | friction | 一碗热汤的误会 | 客人误以为二人关系更近 | 顺水推舟做宣传 / 立刻解释 | 宣传涨名声但制造误会，解释稳关系 | | choice | 迟来的心意 | 无双准备离开前堂帮工，秀才迟疑 | 鼓励秀才说清 / 让掌柜体面收场 | 说清涨羁绊但影响芙蓉线，收场稳客栈 | | settled | 各自安好 | 无双找到自己的位置，不再只围绕秀才 | 安排无双帮工路线 | 解锁清洁或服务加成 |

可解锁效果：

• 羁绊 25：祝无双帮工事件权重提高。
• 羁绊 50：卫生恢复事件效果提高。
• 羁绊 75：解锁“体面收场”事件，减少感情线冲突带来的名声损失。

冲突规则：

• 如果 guo_lu_romance 已进入 settled，无双线应偏向“成全与自我成长”。
• 如果郭芙蓉线仍处于 friction，无双线事件更容易触发误会。

三角线修正规则

• 不做“选错 CP”式惩罚，玩家推进任意一条线都应得到正向成长。
• 郭芙蓉线和祝无双线共享吕秀才焦点时，后推进的那条线只改变叙事方向，不直接扣除既有羁绊成果。
• 如果一条线进入 settled，另一条线自动转向“成全 / 自我成长 / 体面收场”，避免重复争抢同一结果。
• 系统只用阶段偏置、事件文案和解锁效果做修正，不用强制回退、锁死或反向扣值。

三角线阶段偏置表

| 已进入 settled 的线 | 另一条线当前阶段 | 自动转向 | 继续保留的正向收益 | 明确不做 | | --- | --- | --- | --- | --- | | 郭芙蓉 × 吕秀才 | seed / friction | 祝无双线转为“体面收场 / 自我成长”，优先触发帮工、自立和离岗规划文案 | 祝无双线已获得的帮工、清洁、卫生恢复收益全部保留 | 不扣 bondValue，不回退阶段 | | 祝无双 × 吕秀才 | seed / friction | 郭芙蓉线转为“互相成全 / 前堂搭档”，优先触发协作迎客和公开护短文案 | 郭吕线已获得的名声、冲突调解、待客法收益全部保留 | 不锁死后续事件，不做失败结局 | | 任一线 | choice | 未 settled 的另一线先结算为“说开 / 放下 / 体面收场”，再切入新叙事出口 | 已解锁日志、卡片、阶段奖励和数值收益继续生效 | 不制造“选错 CP”惩罚，不反向扣值 |

默认入口与派发口径

• 入口只挂在前堂冲突、帮工误会、傍晚谈心三类现有事件位，不新增专门的恋爱惩罚模块。
• 派发时只需要改阶段偏置、事件文案和解锁效果，不回头改角色深度模型，也不回退既有羁绊进度。
• 验收口径是“后推进的一条线会转向成长叙事，但玩家已经打出来的正向成果全部保留”。

3. 白展堂 × 佟湘玉：旧江湖与新日子

定位：

• 客栈精神核心感情线。
• 关键词：旧身份、新生活、互相兜底、掌柜与跑堂。
• 玩法倾向：治安、离线收益、夜间事件、江湖旧账。

阶段节点：

| 阶段 | 事件名 | 内容方向 | 玩家选择 | 结果方向 | | --- | --- | --- | --- | --- | | seed | 掌柜夜里留灯 | 湘玉担心老白夜巡太久 | 让老白继续巡夜 / 让他早点回堂 | 巡夜涨治安，回堂涨羁绊 | | friction | 旧名号又被提起 | 江湖客认出白展堂旧身份 | 公开否认 / 私下处理 | 否认保名声，私下处理保治安 | | choice | 走不走江湖路 | 有旧友邀请老白重出江湖 | 劝他留下 / 让他自己决定 | 留下涨羁绊和客栈稳定，自决涨名声但增风险 | | settled | 同福就是归处 | 老白确认把客栈当家 | 固化夜间守护 | 夜间治安和离线收益小幅提高 |

可解锁效果：

• 羁绊 25：夜间盗贼概率小幅下降。
• 羁绊 50：白展堂旧友事件负面结果降低。
• 羁绊 75：离线收益或夜间安全小幅提高。

4. 钱掌柜 × 钱夫人：账房外的家务风波

定位：

• 非客栈人物羁绊线，用于扩展七侠镇生活网络。
• 关键词：怕老婆、私房钱、家务账、外部关系。
• 玩法倾向：铜钱、声望、治安、外部商路。

阶段节点：

| 阶段 | 事件名 | 内容方向 | 玩家选择 | 结果方向 | | --- | --- | --- | --- | --- | | seed | 钱掌柜躲进柴房 | 钱掌柜来客栈躲钱夫人 | 掩护 / 劝回家 | 掩护得铜钱但降治安，劝回涨名声 | | friction | 私房钱账本 | 钱夫人追来查账 | 交出账本 / 替钱掌柜打圆场 | 交出涨秩序，打圆场涨商路关系 | | choice | 万利阁订货风波 | 夫妻吵架影响同福供货 | 站钱夫人规矩 / 站钱掌柜生意 | 规矩涨名声，生意涨铜钱 | | settled | 家务账也要平 | 二人达成账目规矩 | 建立稳定供货 | 后续采购事件收益提高 |

可解锁效果：

• 羁绊 25：钱掌柜求援事件负面治安降低。
• 羁绊 50：万利阁供货折扣，采购类事件成本降低。
• 羁绊 75：解锁“家务账也要平”事件，获得铜钱与名声双收益。

钱掌柜夫妻线经营联动口径

| 节点 | 默认入口 | 触发条件 | 经营联动结果 | | --- | --- | --- | --- | | seed | 白天 / 傍晚的街坊来访事件 | 声望达到基础门槛，或当日存在供货压力 | 掩护得到一次性铜钱收益，劝回家则换取街坊名声 | | friction | 柴房躲人后的追账事件 | 已触发 seed，且账房 / 治安类事件位可用 | 交出账本可以稳住秩序与治安，打圆场则给万利阁关系留口子 | | choice | 采购日或库存紧张日的订货风波 | 已触发 friction，且存在采购 / 供货决策 | 站钱夫人规矩可换后续供货稳定，站钱掌柜生意可换当次铜钱节省 | | settled | 账目说开后的回访事件 | choice 完成，且客栈进入下一次采购窗口 | 解锁稳定供货和采购折扣，降低后续缺货波动 |

• 这条线只影响采购折扣、供货稳定、铜钱 / 名声收益，不扩成独立的街坊家务系统。
• 默认入口优先挂在白天采购、傍晚查账和街坊来访事件位，避免单开一页平行玩法。
• 旧存档补字段时仍保持 unlocked: false、value: 0、stage: 'seed'，不影响既有角色读档。

后续可扩展羁绊

| 羁绊 | 类型 | 方向 | | --- | --- | --- | | 李大嘴 × 杨慧兰 | romance / rivalry | 厨艺、比武招亲、嘴硬痴情 | | 莫小贝 × 佟湘玉 | family | 管教、成长、衡山掌门身份 | | 白展堂 × 白三娘 | family / old_debt | 家人、旧江湖、治安线 | | 郭芙蓉 × 郭巨侠 | family / mentor | 父女、名门压力、成长 | | 佟湘玉 × 钱掌柜 | business | 街坊生意、万利阁供货 | | 邢捕头 × 燕小六 | mentor | 官府巡查、治安协作 |

触发规则

基础触发

• 羁绊事件不应完全随机，要由角色解锁、时段、当前经营状态共同决定。
• 白天偏前堂冲突和街坊关系。
• 傍晚偏误会、谈心、收场。
• 深夜偏旧账、守护、离别与选择。

状态触发

• 清洁低：更容易触发郭芙蓉、祝无双相关事件。
• 治安低：更容易触发白展堂、佟湘玉、钱掌柜求援事件。
• 声望高：更容易触发外部人物羁绊。
• 员工等级高：更容易进入关键抉择阶段。

冲突触发

• 郭芙蓉 × 吕秀才与祝无双 × 吕秀才共享 lu 角色焦点，不能无脑同时推进到高亲密。
• 系统需要支持互斥或修正：
  • 一个羁绊进入 settled 后，相关三角线转为“成全 / 成长”路线。
  • 不做惩罚性恋爱模拟，重点是群像关系的阶段变化。

UI 方案

第一版建议做轻量入口：

• 总览页新增“羁绊近况”卡片，展示 2-3 条最高进度。
• 帮助手册新增“羁绊”说明。
• 随机事件弹窗增加 bondId 或“羁绊线”标签。
• 日志输出关系变化，例如“郭芙蓉与吕秀才羁绊 +5”。

后续再做独立页：

• 羁绊图谱
• 角色头像节点
• 阶段事件回顾
• 解锁效果列表

版本拆分

App v1.8.0：羁绊内容最小闭环

目标：让首批羁绊在随机事件、存档和总览里形成闭环。

范围：

• 新增 BondState 类型和默认数据。
• 首批让 guo_lu_romance、wushuang_lu_unspoken、qian_couple_family、bai_tong_life 进入事件池。
• 随机事件选项能增加羁绊值，并支持阶段推进。
• 总览显示羁绊近况，帮助手册补系统说明。

验收：

• 旧存档能补默认羁绊状态。
• 至少 3 条羁绊能通过事件推进。
• 羁绊变化有日志反馈。
• npm run lint、npm run build 通过。

App v1.9.0：三角关系与外部夫妻线

目标：补齐三角修正规则与外部夫妻线，让关系网络不只围绕主角情侣。

范围：

• 增加三角线修正规则，避免 “选错 CP” 式惩罚。
• 加入互斥和修正规则。
• 外部人物羁绊影响采购、声望或治安。

验收：

• 祝无双线能根据郭芙蓉线阶段改变走向。
• 钱掌柜夫妻线能触发至少 3 个事件节点。
• 外部羁绊至少影响一个经营结果。

App v2.0.0：羁绊图谱与系统联动

目标：把羁绊作为长期内容系统接入更多玩法。

范围：

• 独立羁绊页或图谱。
• 羁绊影响擂台赛、节令事件、稀有客人。
• 联机互助可触发“好友见证”类羁绊事件。

验收：

• 玩家能查看每条羁绊阶段和已解锁效果。
• 羁绊对至少 2 个其他系统产生影响。
• 不影响旧存档读取。

子会话拆分建议

子会话 A：羁绊数据与存档

负责文件：

• src/types.ts
• src/utils/bonds.ts
• src/App.tsx 存档读写和基础事件结算
• docs/version-history.md

交付：

• BondState、默认羁绊表、归一化函数。
• 旧存档补齐。
• 如果持久化，提升 SAVE_SCHEMA_VERSION。

子会话 B：首批羁绊事件

负责文件：

• src/App.tsx
• src/components/RandomEventPopup.tsx
• docs/story-event-nodes-v1.md

交付：

• 郭芙蓉 × 吕秀才事件链。
• 祝无双 × 吕秀才事件链。
• 白展堂 × 佟湘玉事件链。
• 钱掌柜 × 钱夫人事件链。
• 事件选项能推进羁绊值和阶段。

子会话 C：总览与帮助手册 UI

负责文件：

• src/components/LedgerSummaryTab.tsx
• src/components/HelpManual.tsx
• 可能新增 src/components/BondSummaryCard.tsx

交付：

• 总览页展示羁绊近况。
• 帮助手册解释羁绊系统。
• 关系变化反馈不挤占已有资源信息。

子会话 D：三角线与外部人物

负责文件：

• src/App.tsx
• src/utils/bonds.ts
• docs/bond-storylines-design.md

交付：

• 三角线修正规则。
• 祝无双 × 吕秀才。
• 钱掌柜 × 钱夫人。
• 三角线修正规则和外部关系经营加成。

风险控制

• 不做成人向或沉重恋爱模拟，保持原作喜剧群像气质。
• 不让羁绊系统惩罚玩家“选错 CP”，所有路线都应产出不同类型的正向成长。
• 三角线要写成成长和体面收场，不写成恶意竞争。
• 外部夫妻线要服务经营网络，不要变成单纯家庭纠纷。
• 每次只落地 1-2 条羁绊线，完成验收后再扩展。

当前可复用基础

• 随机事件弹窗可展示事件系列和时辰标签。
• 当前已有多个角色事件，可改造为羁绊触发素材。
• 时间体系能提供清晨、白天、傍晚、深夜的触发语境。
• 版本化文档和子会话推进规则已经建立。