任务线失败终局接线技术文档

# 任务线失败终局接线技术文档

最近更新：2026-06-26 16:06:26 +08:00

作用：把角色压力、任务进度、江湖简报和终局运行时串成同一条接线，让失败能从任务线和阅读入口里被看见。

边界：只做接线，不扩新玩法表，不新建失败类型，不改存档结构。

设计目标

• 任务线的失败不是凭空出现，而是从角色压力和任务进度里长出来。
• 江湖简报、任务追踪和终局运行时要看同一组压力来源。
• 玩家能从简报或任务追踪直接跳到对应的终局解释层。
• 只补接线和边界，不把这些入口写成新的玩法表。

需要接的三条线

| 线路 | 输入 | 输出 | | --- | --- | --- | | 角色压力线 | tong.stress、tong.health、bai.integrity、guo.familyPressure、lu.accountingMistakes 等现有压力字段 | 任务线压力来源、预警标签、终局触发条件 | | 任务进度线 | 任务节点完成度、任务延误、关键资源缺口、重复失败 | 压力加成、失败种子、阶段推进 | | 阅读与追踪线 | 江湖简报、任务追踪面板、终局面板 | 可读提示、可跳转入口、回看路径 |

接线规则

• 任务线进度落后时，先写压力来源，再写阶段推进，不允许直接跳到终局。
• 角色压力上升时，只复用现有压力字段，不另起新属性表。
• 江湖简报只负责把“今天会坏什么”说清楚，不负责创造新的终局规则。
• 任务追踪面板只负责把当前任务线和失败种子串起来，不负责重算终局。
• 如果某条任务线已经进入失败收束，简报可以显示高优先级提示，但不覆盖复盘页。

推荐映射

| 来源 | 进入点 | 说明 | | --- | --- | --- | | 任务线节点延误 | 运行时压力来源 | 任务没走完时，压力开始抬头 | | 关键资源短缺 | 失败种子或预警 | 铜钱、食材、清水、声望等可直接转成风险标签 | | 角色状态恶化 | 压力加成 | 忠诚、正直、健康、心情等仍沿用既有字段 | | 江湖简报 | 预警展示 | 把高风险任务线提前播报给玩家 | | 任务追踪面板 | 跳转入口 | 直接跳到对应任务线或终局说明 |

与简报的关系

• 简报是入口层，不是判定器。
• 简报可以提示某条任务线正在接近失败终局，但不能独立决定终局。
• 简报中显示的风险条目要能追溯到任务线和压力来源。
• 如果同一条线已经进入终局收束，简报只显示概览，不重复展开全部复盘内容。

与任务追踪的关系

• 任务追踪显示当前任务线状态、压力标签和可见风险。
• 任务追踪可以提供跳到终局运行时或复盘页的入口。
• 任务追踪不新增新的失败类型，不另起一张任务结算表。
• 任务追踪和简报共享同一批来源标签，避免两边说法不一致。

建议交付接口

• pressureSourceTags：任务线的压力来源标签。
• failureSeedTags：与当前任务线绑定的失败种子。
• briefingRefs：江湖简报引用的任务线 id 或风险 id。
• trackingJumpTarget：任务追踪可跳转的终局或复盘入口。

验收标准

• 每条任务线都能说明压力从哪里来。
• 简报能看懂当前任务线的风险，不会和任务追踪打架。
• 任务追踪能直接把玩家带到对应的终局解释层或复盘页。
• 不新增玩法表，不新建失败类型，不改存档结构。

关联文档

• docs/design/completed/systems/jianghu-briefing-design.md
• docs/design/completed/systems/failure-endgame-design.md
• docs/design/completed/systems/endgame-save-load-design.md