Jyotisha/docs/tasks/TASK-rectification-code-split-20260926.md

TASK · 生时校正代码拆分（只搬不改）+ 增长上限（2026-09-26）

基线

• 排在 TASK-rectification-fewer-probes-card-20260926 与 TASK-rectification-telemetry-20260926 都合入之后的 origin/staging。分支 codex/rectification-code-split-20260926。

事故实证（09-26 盘点，origin/staging 3ce11ee0）

文件	行数	说明
frontend/src/components/rectification-agentic-chat.tsx	2043	组件本体约 1620 行；useState 35、useRef 16、useEffect 7、useLayoutEffect 2、useCallback 12
frontend/src/app/api/rectification/agent/route.ts	1077	POST 约 926 行
frontend/src/lib/rectification-agentic/v9/agent-run.ts	1400	runV9AgentTurn 约 1047 行

• 无任何行数 / hook 数增长上限（对比首页 home-shell-growth-contract.test.ts）。
• 79 个测试文件把这些文件当源码文本读，其中 42 个用 indexOf / sourceBetween 共 269 处切片；这类测试多次让门禁翻红（BUG-308、342、736、933、940、975、1014、692、748）。

决策记录（产品 2026-09-26）

• D1 只搬代码不改行为（同首页拆分 TASK-home-page-split-20260925 的做法）：
  • 聊天组件：按职责拆出 hook（快照同步、提交与流、选择题、时间轴 / 范围）与展示组件；参数式 lib 函数内部不调用 React hook。
  • POST：按分支拆成独立处理函数（打字回答、选择题、开场、只读、交付），route.ts 只做装配。
  • runV9AgentTurn：按阶段拆（准备、单次尝试、收尾、重跑），行为逐行一致。
• D2 目标：聊天组件本体 ≤ 900 行、useState ≤ 20；POST ≤ 250 行；runV9AgentTurn ≤ 300 行（达不到按让步写明）。
• D3 加增长合同测试（与首页同型：行数基线 + 150 余量、hook 数上限），锁住成果。
• D4 切源码字符串的测试改为调用被抽出的函数（行为断言等价或更强）；不得删除测试来"解决"断言；每条改写三栏。

硬红线

1. 行为零变化：全量前端测试（Node 22）失败名单与开工基线逐条一致、新增 0；Python 快速门通过；首页 / 各页 ○ Static、gzip ±2%。
2. 不改接口、数据库、Skill、文案、打分。
3. 不得用挤行 / 删注释凑行数（AGENTS §6）。
4. 分阶段提交（组件、路由、agent-run 各自可单独回滚），每阶段都跑全量。

任务分解

• T1 聊天组件拆分 + 增长合同。
• T2 路由拆分 + 增长合同。
• T3 agent-run 拆分 + 增长合同。
• T4 切片测试改调用函数（随各阶段进行）。
• T5 记录：CHANGELOG（无用户可见变化）、PROGRESS（每阶段行数 / hook 数 / 测试对比）；不开 BUG 号。