№ · 活跃计划 CH.07.02
主页 · 📅 活跃计划 · 5 日计划 v1.1 · 剧情追踪 UI 字段净化 · 修改意见稿 v1

5 日计划 v1.1 · 剧情追踪 UI 字段净化 · 修改意见稿 v1

📅 2026-07-02 · 📦 13.0 KB · 📅 活跃计划 · 📝 MD 文档 🏷️ 装备🏷️ Buff🏷️ 剧情🏷️ 联机🏷️ 计划🏷️ 时间

整理时间:2026-07-02 15:05 +08:00 整理人:Mavis(PM 视角) 状态:草案,待 P1 用户拍板 —— 本文档不直接修改 2026-07-06-5日开发计划-v1.md,仅作为 v1.2 的补丁提案 触发源:

  • docs/design/active/剧情追踪-字段净化与输出规则-v1.md(2026-07-02 落盘)
  • 截图显示 StoryTrackingCard 把开发者字段(tax_reported、brief=risk-tax_reported、主语：...・压 ...・种 ...・引 ...、6 段验收阶段平铺)直接当玩家文案渲染

0. TL;DR(60 秒版)

  • 修改意见:5 日计划新增 R6 lane · 剧情追踪 UI 字段净化(工作量 3-4h,优先级 P0)
  • 为什么 P0:玩家在主界面顶部直接看到开发者 ID 和 tag,体验问题不是"好看不好看",是"读不懂 + 误导"
  • 为什么新增 lane 不合并:
    • R1(装备)正交 —— 16 件装备数据/色板/词条与剧情追踪无关
    • R3(联机 P2P)独立 —— Day 4 主任务已占用
    • R4(剧情预研)只出文档,不动 UI
  • 安置建议:Day 4 主任务挪用半天 (3-4h) —— Day 4 现状已是"相对独立日"+ "缓冲日"(参见 v1.1 § 6 Day 4 风险行),挪用机制现成
  • 工期影响:
    • Day 4 主任务工作量从 6-8h(纯 P2P)变 9-12h(P2P 半天 + 字段净化半天)
    • Day 4 P2P 状态机收口延后到 Day 5 上午(原计划已写"Day 4 可不收口",留作下周继续)
  • 风险增量:Day 4 总工作量增 3-4h,在 5 日 40-55h 工时预算内有 6-21h 余量,可行
  • 拍板点:见 § 4

1. 修改总览(对 v1.1 的影响)

1.1 § 1.2 5 条核心需求 → 6 条

| # | 需求 | 来源决策点 | 为什么选 | v1.1 → v1.2 变化 | | :-: | --- | --- | --- | --- | | R1 | Phase 1 道具 T3-T8 收口 | D2 | 关键路径断点 | 不变 | | R2 | 胜利终局 truth source 拍板 | D3 | 卡 Year 1 收束 | 不变 | | R3 | Phase 5 联机 P2P 房间骨架 | D4 | 设计已就位 | 不变(收口延后 Day 5 上午) | | R4 | 剧情线 3+ 预研 | D5 | 内容池前置 | 不变 | | R5 | 5 日整体回归 + 收口 | 自带 | 防止 build 红 | 不变 | | R6(新增) | 剧情追踪 UI 字段净化 | D6(本提案) | 玩家直接看到开发者 ID,体验问题 | 新增 1 条 P0 lane |

1.2 § 2 每日任务调整

| Day | 原计划 | v1.2 调整 | | :-: | --- | --- | | Day 1 (7.6) | 主 R2 拍板 + 辅 R1.0 type | 不变 | | Day 2 (7.7) | 主 R1.1 数据迁移 + 辅 R1.2 色板 | 不变 | | Day 3 (7.8) | 主 R1.3 组件 + 辅 R1.4 UI 升级 | 不变 | | Day 4 (7.9) | 主 R3 P2P 全天 + 辅 R4 剧情预研 | 主任务拆分:R3 P2P 半天(6-8h → 3-4h)+ R6 字段净化半天(3-4h,新增);辅 R4 剧情预研不变 | | Day 5 (7.10) | 主 R1.5 roll + 46 测试 + 辅 R1.6 + R5 回归 | 不变(P2P 收口挪到 Day 5 上午,跟 R3 联调合并;字段净化收口验证合并进 R1.6 视觉对照 checklist) |

1.3 § 1.3 不在本 5 日的事(增量 1 条)

| 增量项 | 原因 | 留到 | | :-: | --- | --- | | ❌ 剧情追踪面板整体重做(新组件架构 / 新数据流) | 本 5 日只做"字段净化"——最小创伤修复;整体重做设计 v1.1 拍 | W28+ |

1.4 § 3 跨日依赖图(新增 1 条边)

Day 3: R1.3(T5 组件,带 fallback) + R1.4(T6 UI 升级,接 T5)
                                                ↓
Day 4: R3(P2P 房间,半天) + R4(剧情预研) + R6(剧情追踪字段净化,半天,新增)
                                                ↓
Day 5: R1.5(T7 roll + 46 组测试) + R1.6 + R5(回归 + 字段净化视觉对照)
                                              ↑
Day 4: R3 P2P 收口 + R6 字段净化收口  ────┘ (相对独立,可并入下波)

新增边:

  • 剧情追踪-字段净化与输出规则-v1.md(R6 truth source,2026-07-02 落盘)→ R6 lane 落地
  • R6 ↔ R5:R6 收口纳入 Day 5 辅任务 R1.6 视觉对照 checklist

1.5 § 5.1 不算收口情形(增量 4 条)

| # | 不算收口情形 | | :-: | --- | | 17 | ❌ StoryTrackingCard 主链紫色小条仍渲染 mainchainLine(开发者桥接日志) | | 18 | ❌ YEAR1 规划区仍平铺 4 个属性(属性：服务 / 厨艺 / 账房 / 巡防) | | 19 | ❌ YEAR1 规划验收区仍平铺 6 段验收阶段(验收：xxx -> xxx -> xxx -> xxx -> xxx -> xxx) | | 20 | ❌ AGENTS.md 没新增"玩家文案 vs 开发者字段"输出规则段落(本 R6 配套规则) |

1.6 § 6 风险与回退(增量 1 行)

| Day | 主要风险 | 触发条件 | 回退方案 | | :-: | --- | --- | --- | | 4 | R6 字段净化改动打回归,撞 R1.3/R1.4 UI | StoryTrackingCard 改 JSX 影响 tasklineFailureJump 跳转按钮 | 回退 StoryTrackingCard JSX 改动 + 保留 bridge 数据层重构;R6 拆成两段:Day 4 只改数据层(归一化 bridge),Day 5 改 UI 层 |

1.7 § 8 参考入口(增量 1 行)

| 想看什么 | 去这里 | | :-: | --- | | ★ v1.2 新增 | | | 剧情追踪字段净化与输出规则(R6 truth source) | docs/design/active/剧情追踪-字段净化与输出规则-v1.md |

1.8 § 9 版本与变更记录(增量 1 行 v1.2 条目)

| 版本 | 时间 | 整理人 | 关键变更 | | :-: | :-: | --- | --- | | (待定)v1.2 | 2026-07-02 15:05 | Mavis(PM 视角) | 应用 R6 lane 提案:5 处实质修订 —— ① § 1.2 R6 新增;② § 2 Day 4 主任务拆分 + § 2 Day 5 P2P 收口延后半天;③ § 3 跨日依赖图新增 R6 边;④ § 5.1 增 4 条不算收口情形;⑤ § 6 风险表增 R6 回退方案;⑥ § 8 增 R6 truth source 引用 |

2. R6 详细规格(可直接派生短工)

2.1 R6 主任务:StoryTrackingCard 字段净化

| 项 | 内容 | | --- | --- | | 产出物 | (a) src/components/StoryTrackingCard.tsx JSX 清理(删除 mainchainLine / attributeLine / checklistLine 渲染)
(b) src/data/year1Plan.ts getYear1PlanSnapshot() 简化为只返回 player-facing 字段
(c) src/App.tsx storyTrackingSnapshot 构造加 nextHint 长度截断(≤24 字)+ 叙事化过滤
(d) AGENTS.md 第 4 节新增「玩家文案 vs 开发者字段」段落 | | 文件边界 | 只动这 4 个文件;不动 src/utils/failureEndgame.ts 既有规则;不动 src/utils/jianghuBriefing.ts(bridge 跨模块状态共享机制保留,只 UI 层不渲染);不动 16 件装备数据 | | 内容 | ① 删除 StoryTrackingCard.tsx:501-505 bridge?.mainchainLine 渲染块
② 删除 StoryTrackingCard.tsx:516 属性：{attributeLine} 行
③ 改写 StoryTrackingCard.tsx:519-521 验收区:只显示 checklistStage.label + passSignal + mustNodes 进度(✓/○)
④ 简化 year1Plan.ts:357 itemLine 只保留 focus,丢掉 storyItems 切片
⑤ App.tsx:3044-3050 nextHint 加长度截断 + 叙事化过滤(详见下方代码片段)
⑥ AGENTS.md 第 4 节按 剧情追踪-字段净化与输出规则-v1.md § 4 落段落 | | 验收 | (a) npm run build 通过 + npm run lint 无新增错误
(b) 截图对照:剧情追踪面板不再有 tax_reported、brief=risk-tax_reported、主语：...・压 ...、属性：服务 / 厨艺...、验收：xxx -> xxx -> 等开发者字段
(c) bridge 跨模块跳转(tasklineFailureJump)功能未受影响(测试一次终局解释层跳转 + 一次江湖简报跳转)
(d) AGENTS.md 新段落落盘 | | 不做 | ❌ 不实现 ?dev=1 调试入口(留 v1.1)
❌ 不重做 StoryTrackingCard 整体组件架构(留 W28+)
❌ 不动 failureEndgame.ts 任何既有 ID/规则
❌ 不动 jianghuBriefing.ts mainchainLine 构造逻辑(UI 层不用即可,逻辑保留给调试)
❌ 不动 16 件装备数据
❌ 不动 5 日计划核心路径(R2 → R1.0 → R1.1 → R1.3 → R1.4 → R1.5 → R1.6) | | 工作量 | 3-4h(代码 ~50 行 + 文档 1 段 + build + 截图对照) | | 角色 | [短工]#剧情追踪-字段净化@v1.2 |

2.2 App.tsx:3044-3050 nextHint 长度截断代码片段(直接落地的伪代码)

const nextHint = (() => {
  const raw =
    primaryBond?.unlockEffects[0] ??
    briefingLead?.detail ??
    briefingLead?.summary ??
    (yearTracking ? `下一章：${yearTracking.nextChapterTitle}` : undefined) ??
    jianghuBriefingReport.sections.upcoming[0]?.summary ??
    "先触发剧情事件或打开江湖简报。";
  // ★ v1.2 R6:截断到 24 字 + 去掉 `：` 后超过 20 字的列表段
  const cleaned = raw.replace(/[:：][^:：]{20,}/g, "").trim();
  return cleaned.length > 24 ? `${cleaned.slice(0, 22)}…` : cleaned;
})();

2.3 风险与回退(独立列出)

| 风险 | 触发 | 回退 | | --- | --- | --- | | bridge 跨模块状态被 UI 层断链,导致跳转按钮失效 | 删除 mainchainLine 误碰 bridge 数据结构 | 回退 JSX 改动,只删 attributeLine / checklistLine;mainchainLine 改为 devMode 才显示(if (import.meta.env.DEV) 包裹) | | checklistStage 进度计算缺失 mustNodes 完成状态 | Year1PlanSnapshot 没有 mustNodesProgress 字段 | 简化:只显示 checklistStage.label + passSignal,不做 ✓/○ 高亮 | | AGENTS.md 新段落措辞被用户否决 | 段落太长 / 规则太严 | 简化为 1 段 5 行,只保留核心判断标准 |

3. 与本周(7.1)双轴的关系

| 本周(7.1 双轴) | 本 5 日(7.6-7.10) | 关系 | | :-: | --- | --- | | Year 1 主线闭环(骨架 + 属性 + 道具 + 验收) | R1 Phase 1 道具 T3-T8 收口 | 接续,共同服务第一年 4 段投放节奏 | | — | R6 剧情追踪字段净化(新增) | 正交:剧情追踪 UI 跟 Year 1 主线数据(year1Plan.ts)共用,但修复方向是 UI 文案,不动 Year 1 主线逻辑 | | — | R2 D3 胜利终局拍板 | 关键衔接,不变 | | — | R3 P2P 房间 + R4 剧情预研 | 前瞻,R3 收口延后到 Day 5 上午 |

4. 拍板点(P1 用户)

| 编号 | 决策项 | 选项 | | :-: | --- | --- | | Q1 | R6 是否纳入 v1.2? | a) 纳入(推荐);b) 推迟到下波 W28+;c) 只做 AGENTS.md 段落、不动 UI | | Q2 | 哪个 Day 安排? | a) Day 4 主任务挪用半天(推荐,P0 + Day 4 已有缓冲机制);b) Day 3 辅任务扩展(R1.4 + R6,共 5-6h);c) Day 5 辅任务扩展(R1.6 + R6,共 5-6h,挤回归) | | Q3 | AGENTS.md 新段落措辞? | a) 全量落(剧情追踪-字段净化与输出规则-v1.md § 4 两段,推荐);b) 简化版只落核心判断标准 5 行;c) 暂不落 | | Q4 | ?dev=1 调试入口是否一并做? | a) 不做(留 v1.1,推荐);b) Day 4 一并做(+1h 工作量) |

PM 默认推荐:Q1=a / Q2=a / Q3=a / Q4=a(全套方案,3-4h 总工作量,Day 4 主任务 9-12h,在工时预算内)

5. 与既有反需求清单的关系

docs/design/active/5日反需求清单-v1.md § 1.4 类 ④「UI 漂移信号」明确把剧情追踪字段净化列为漂移信号的一部分(虽然没有显式提及 StoryTrackingCard):

4.2 不实现 Year1 计划运行时接线正式 lane — data/year1Plan.ts docs-only lane,无 task

R6 落地后,类 ④ 4.2 应该从漂移清单移到正式 lane(R6),反需求清单需要同步更新:

v1.2 待更新:
- 4.2 删除「Year1 计划运行时接线」(吸收进 R6)
- 4.3-4.5 保留(红点 / Art / 剧情编辑器 / story-video 仍漂移)

6. 不在本修改意见稿的事(明确划走)

  • ❌ 剧情追踪面板整体重做(新组件架构、新数据流、新视觉规范) — 留 W28+ / Phase 5
  • ❌ ?dev=1 调试面板 — 留 v1.1,本 R6 不实现
  • ❌ bridge 跨模块状态机重构 — UI 层不渲染即可,逻辑层保留
  • ❌ failureEndgame.ts 规则变更 — AGENTS.md 第 5 节明确划走
  • ❌ jianghuBriefing.ts mainchainLine 构造逻辑修改 — 只 UI 层不渲染,逻辑不动
  • ❌ 16 件装备数据 — 5 日计划 R1 不动数据条目
  • ❌ types.ts:137 旧 rarity 字段 — AGENTS.md + 5 日计划 R3 不变量 N2
  • ❌ App.tsx 编排层(257KB)重构 — 5 日计划 § 1.3 已划走

7. 参考入口

| 想看什么 | 去这里 | | :-: | --- | | R6 truth source(本次落盘) | docs/design/active/剧情追踪-字段净化与输出规则-v1.md | | 5 日计划 v1.1(本意见稿针对的母文档) | docs/plans/active/2026-07-06-5日开发计划-v1.md | | 5 日反需求清单(本意见稿同步更新) | docs/design/active/5日反需求清单-v1.md | | 5 日 lane 依赖图(v1.2 同步加 R6 边) | docs/design/active/5日lane依赖图-v1.md | | StoryTrackingCard 现状(代码位置) | src/components/StoryTrackingCard.tsx:501-523 | | App.tsx 构造位置 | src/App.tsx:2997-3128 | | Year1PlanSnapshot 构造位置 | src/data/year1Plan.ts:348-371 | | AGENTS.md 三层架构 + 输出规则 | AGENTS.md § 1 + § 4 |

8. 版本与变更记录

| 版本 | 时间 | 整理人 | 关键变更 | | :-: | :-: | --- | --- | | v1 | 2026-07-02 15:05 | Mavis(PM 视角) | 首版:基于 剧情追踪-字段净化与输出规则-v1.md 落盘,提议在 5 日计划 v1.1 增 R6 lane(剧情追踪 UI 字段净化,P0,3-4h),安置于 Day 4 主任务挪用半天;列出对 v1.1 的 7 处实质修订 + 4 个拍板点 |

(End of file, ~9KB,193 lines)