Skip to content

feat(C-3): 旁白/章節切分模型遷 gemini-3.5-flash(A/B 驗過後切換)#80

Merged
dofliu merged 1 commit into
mainfrom
claude/c-3-narration-switch-resolve
Jun 15, 2026
Merged

feat(C-3): 旁白/章節切分模型遷 gemini-3.5-flash(A/B 驗過後切換)#80
dofliu merged 1 commit into
mainfrom
claude/c-3-narration-switch-resolve

Conversation

@dofliu

@dofliu dofliu commented Jun 15, 2026

Copy link
Copy Markdown
Owner

做什麼

劉老師本機跑 C-3 A/B(PR #79tools/ab_narration.py,材力/自控 Chap08-PID控制器設計 三頁)驗過品質後拍板遷移。把 slide_ingest.py 的旁白 + 章節切分從寫死 gemini-2.5-flash(將淘汰)切到 M 軸角色登錄表 text.fast(= gemini-3.5-flash)。

A/B 結論(為什麼切)

面向 結果
正確性 兩邊都乾淨無誤(review gate 真正守的底線)✅
通順度 3.5 更自然的老師口吻 ✅
長度/時間預算 3.5 命中 ~75s/頁(295–375 字);2.5 偏長(516–556 字)易被 _truncate_at_sentence 截 ✅
成本 3.5 輸出約 64%(省 ~36% 字)✅
涵蓋 3.5 偶爾壓縮會漏列點(學習目標頁少帶一項)→ 本 PR 補 prompt 糾正

怎麼改

  1. slide_ingest.py:寫死 MODEL = "gemini-2.5-flash"narration_model() = resolve_id(TEXT_FAST)呼叫時解析(設定頁 text.fast 覆寫即時生效)。旁白 + 章節切分一起遷(共用同一模型常數,章節切分也得離開 2.5)。計帳如實落 resolved id。
  2. NARRATION_PROMPT_DETAILED 補第 7 條:「條列項目每項至少帶一句、可精簡不可整項遺漏」——補上 3.5 唯一弱點(漏列點)。
  3. docs/PRODUCT_READINESS.md C-3 → [x]

範圍與 rollback

  • solve.py(解題)模型不在此遷移範圍——正確性更敏感、未 A/B,另議。
  • Rollback 免改 code:設定頁把 text.fast 覆寫回 gemini-2.5-flash 即時退(M-3 model_roles 最高優先)。

怎麼測

narration_model() 解析 = gemini-3.5-flash(驗證過)。本機全套 2702 passed(剩 1 QR 像素為容器缺 Noto CJK 字型假象,CI 權威)。不碰 review gate / 狀態機 / render 入口 assert——只換「旁白用哪個模型生」(硬規則 #1)。

Reviewer 決策點

無——A/B 已由劉老師驗過、範圍與 rollback 如上。後續若要連 solve.py 解題模型也遷,需另跑 A/B(正確性敏感)。


Generated by Claude Code

劉老師本機 A/B(PID 控制器三頁)驗過品質後拍板遷移:正確性兩邊乾淨、3.5
口吻更自然且長度更貼 75s/頁、成本約 64%;唯一弱點是偶爾漏列點,已補 prompt 糾正。

- slide_ingest.py:寫死 MODEL=gemini-2.5-flash → narration_model()=resolve_id(TEXT_FAST)
  (呼叫時解析,設定頁 text.fast 覆寫即時生效)。旁白 + 章節切分一起遷(共用模型常數)。
- NARRATION_PROMPT_DETAILED 補第 7 條:條列項目每項至少帶一句、可精簡不可整項遺漏。
- rollback 免改 code:設定頁把 text.fast 覆寫回 2.5 即可。
- solve.py(解題)不在此遷移範圍(正確性更敏感、未 A/B)。

本機全套 2702 passed(剩 1 QR 像素為容器缺 Noto CJK 字型假象,CI 權威)。
@dofliu dofliu marked this pull request as ready for review June 15, 2026 09:53
@dofliu dofliu merged commit 8c09852 into main Jun 15, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants