diff --git a/cmd/genasset/scripts.go b/cmd/genasset/scripts.go
index a111003..97c54a9 100644
--- a/cmd/genasset/scripts.go
+++ b/cmd/genasset/scripts.go
@@ -257,7 +257,7 @@ func importScripts(fl genFlags) {
})
}
b2, _ := json.Marshal(lines)
- if _, err := g.DB().Model(consts.TableSceneNode).Data(g.Map{"script": string(b2)}).Where("id", d.NodeID).Update(ctx); err != nil {
+ if _, err := g.DB().Model(consts.TableSceneNode).Ctx(ctx).Data(g.Map{"script": string(b2)}).Where("id", d.NodeID).Update(); err != nil {
glog.Errorf(ctx, "[scripts] 导入失败 node %d: %v", d.NodeID, err)
continue
}
diff --git a/docs/superpowers/plans/2026-08-13-story-theater-v2.md b/docs/superpowers/plans/2026-08-13-story-theater-v2.md
index 0d9228c..847e6fc 100644
--- a/docs/superpowers/plans/2026-08-13-story-theater-v2.md
+++ b/docs/superpowers/plans/2026-08-13-story-theater-v2.md
@@ -179,8 +179,49 @@ git commit -m "feat: 前端剧本解析 parseScript + RubyText 逐字高亮 high
**Files:**
- Create: `ui-src/src/components/StoryPlayer.vue`
+- Modify: `ui-src/src/utils/speech.js`（speak 加 onEnd 回调）
-- [ ] **Step 1: 创建组件**
+- [ ] **Step 1: speech.js 加 onEnd 回调**
+
+`speech.js` 修改（逐句朗读需要「读完了再进下一句」的事件，仅定时器推进会在 TTS 慢时切掉上句音频）：
+
+```js
+function playFile(url, onEnd) {
+ stopSpeak()
+ if (!innerAudio) innerAudio = uni.createInnerAudioContext()
+ innerAudio.stop()
+ innerAudio.src = url
+ if (onEnd) innerAudio.onEnded = () => onEnd()
+ innerAudio.play()
+}
+
+function speakBrowser(text, onEnd) {
+ stopSpeak()
+ // H5 专用：浏览器原生语音，零成本朗读（小程序端后续接 TTS 文件）
+ if (typeof window === 'undefined' || !window.speechSynthesis) {
+ if (onEnd) onEnd()
+ return
+ }
+ const u = new SpeechSynthesisUtterance(text)
+ u.lang = 'zh-CN'
+ u.rate = 0.9
+ u.onend = u.onerror = () => { uttering = false; if (onEnd) onEnd() }
+ window.speechSynthesis.speak(u)
+ uttering = true
+}
+
+// speak 朗读一段文本：有音频文件优先播文件，否则浏览器语音降级；onEnd 在读完时回调（无 TTS 能力时立即回调）
+export function speak(text, fileUrl, onEnd) {
+ if (!text) return
+ if (fileUrl) {
+ playFile(fileUrl, onEnd)
+ return
+ }
+ speakBrowser(text, onEnd)
+}
+```
+
+- [ ] **Step 2: 创建组件**
完整创建 `ui-src/src/components/StoryPlayer.vue`：
@@ -218,6 +259,7 @@ import { speak, stopSpeak } from '../utils/speech.js'
const EMOJI = { normal: '🙂', think: '🤔', happy: '😊', sad: '😢', surprise: '😮' }
const PER_CHAR = 260 // 每字高亮推进毫秒（与 TTS 朗读大致同步）
const PAUSE_MS = 700 // 句间停顿
+const MAX_LINE_MS = 20000 // 单句最长等待（TTS 无声兜底，防卡死）
export default {
name: 'StoryPlayer',
@@ -229,7 +271,7 @@ export default {
},
emits: ['done'],
data() {
- return { lineIndex: 0, charIndex: 0, speaking: false, moodTick: false, timers: [] }
+ return { lineIndex: 0, charIndex: 0, moodTick: false, timers: [], ended: false, lineDone: { hl: false, sp: false } }
},
computed: {
moodEmoji() {
@@ -263,23 +305,45 @@ export default {
}
this.lineIndex = i
this.charIndex = 0
+ this.ended = false
+ this.lineDone = { hl: false, sp: false }
this.moodTick = true
- this.after(300, () => { this.moodTick = false })
- this.speaking = true
- speak(line.text, '')
+ this.after(350, () => { this.moodTick = false })
uni.pageScrollTo({ scrollTop: 99999, duration: 200 })
const total = Array.from(line.text).length
+ // 逐字高亮推进（纯视觉节奏）
const step = setInterval(() => {
this.charIndex++
- if (this.charIndex > total) {
+ if (this.charIndex >= total) {
clearInterval(step)
- this.speaking = false
- this.after(PAUSE_MS, () => this.playLine(i + 1))
+ this.lineDone.hl = true
+ this.tryNext(i)
}
}, PER_CHAR)
this.timers.push(step)
+ // 朗读读完才进下一句（TTS 慢时高亮等朗读）；onEnd 与高亮都完成 → 停顿后下一句
+ speak(line.text, '', () => {
+ this.lineDone.sp = true
+ this.tryNext(i)
+ })
+ // 兜底：TTS 无声/超时（20s）强制推进防卡死
+ this.after(MAX_LINE_MS, () => this.forceNext(i))
+ },
+ tryNext(i) {
+ if (this.ended || this.lineIndex !== i || !this.lineDone.hl || !this.lineDone.sp) return
+ this.ended = true
+ this.clearTimers()
+ this.after(PAUSE_MS, () => { this.ended = false; this.playLine(i + 1) })
+ },
+ forceNext(i) {
+ if (this.ended || this.lineIndex !== i) return
+ this.ended = true
+ this.clearTimers()
+ stopSpeak()
+ this.after(PAUSE_MS, () => { this.ended = false; this.playLine(i + 1) })
},
finish() {
+ this.ended = true
this.clearTimers()
stopSpeak()
this.$emit('done')
@@ -290,7 +354,7 @@ export default {
```
-- [ ] **Step 2: 语法验证**
+- [ ] **Step 3: 语法验证**
Run: `cd ui-src && npx vite build --mode h5 2>&1 | tail -3`
Expected: 构建成功（组件未被引用，仅语法检查）
-- [ ] **Step 3: Commit**
+- [ ] **Step 4: Commit**
```bash
-git add ui-src/src/components/StoryPlayer.vue
+git add ui-src/src/components/StoryPlayer.vue ui-src/src/utils/speech.js
git commit -m "feat: StoryPlayer 台词流演绎器（气泡+朗读+逐字高亮+表情切换+跳过）"
```
+> 审查记录（58b3e57 双审查：第一 APPROVE，第二 2 SHOULD-FIX，合并修复）：
+> - SHOULD-FIX1（已修）：speak 无完成事件，TTS 慢时逐字定时器推进会切掉上句音频 → speech.js speak 加 onEnd 回调，StoryPlayer「高亮完成 + 朗读 onEnd 都满足 → 停顿 → 下一句」，MAX_LINE_MS=20s 超时 forceNext 兜底防 TTS 无声卡死；nextLine 加 lineIndex/ended 竞态保护
+> - SHOULD-FIX2（已修）：pageScrollTo 后跳过按钮滚出视口（4-8 岁孩子找不回）→ .story-skip 改 fixed（top 140rpx 避开 topbar）
+> - NIT（已合并修）：moodTick 300→350ms 复位（动画不截断）；speaking 死状态删除
+> - NIT（记录待 Task 6 走查）：.story-char fixed 角色立牌可能与选项区重叠，走查确认，必要时降 absolute；character.name 非空由数据保证
+
---
### Task 4: play.vue 剧情流集成
@@ -373,7 +443,7 @@ computed 加：
```html
-
+
@@ -434,6 +504,7 @@ computed 加：
this.sceneFx = ''
if (this.isStoryNode) {
this.reply = fb
+ this.showOptions = false // 提交后隐藏选项区，防重复点击
} else {
this.feedback = fb
}
@@ -494,6 +565,10 @@ git add ui-src/src/pages/play/play.vue
git commit -m "feat: play.vue 剧情流集成——StoryPlayer + 选项嵌入 + 角色回应气泡（script 空回退 v1）"
```
+> 审查记录（5e19174 双审查一致）：
+> - BLOCKER（已修）：连续剧情节点卡死——StoryPlayer 无 `script` watch、play.vue 无 `:key`，节点切换时 v-if 恒真组件不重建不重播，`done` 永不触发 → 选项区永不出现。修复：`` 强制按节点重建重播
+> - SHOULD-FIX（已修）：reply 出现后 showOptions 仍 true，ActionCard 仍可点击 → 可重复 submit。修复：submit 成功分支置 `showOptions = false`
+
---
### Task 5: genasset 剧本生成管线
@@ -548,6 +623,7 @@ func TestValidateScript_FinalOK(t *testing.T) {
lines := []scriptLine{
{Speaker: "旁白", Text: "天亮了，城门缓缓打开。"},
{Speaker: "小军师", Text: "我们一起进城啦！", Emotion: "happy"},
+ {Speaker: "小军师", Text: "大家平平安安，真好！"},
}
if err := validateScript(lines, false, "小军师"); err != nil {
t.Fatalf("合法终局剧本应通过: %v", err)
@@ -677,6 +753,9 @@ func genScripts(fl genFlags) {
sem := make(chan struct{}, 2)
var wg sync.WaitGroup
for _, r := range rows {
+ if !fl.force && fileExists(scriptPath(r["level_id"].Int64(), r["id"].Int64())) {
+ continue // 幂等：草稿已存在跳过（--force 覆盖；防重跑覆盖人工精修草稿）
+ }
wg.Add(1)
sem <- struct{}{}
go func(r gdb.Record) {
@@ -861,7 +940,7 @@ func importScripts(fl genFlags) {
})
}
b2, _ := json.Marshal(lines)
- if _, err := g.DB().Model(consts.TableSceneNode).Data(g.Map{"script": string(b2)}).Where("id", d.NodeID).Update(ctx); err != nil {
+ if _, err := g.DB().Model(consts.TableSceneNode).Ctx(ctx).Data(g.Map{"script": string(b2)}).Where("id", d.NodeID).Update(); err != nil {
glog.Errorf(ctx, "[scripts] 导入失败 node %d: %v", d.NodeID, err)
continue
}
@@ -941,6 +1020,11 @@ git add cmd/genasset/prompts.go cmd/genasset/scripts.go cmd/genasset/scripts_tes
git commit -m "feat: genasset 剧本管线——--only=scripts 草稿生成 + --import-scripts 校验注音回填"
```
+> 审查记录（c40d833 双审查：第一 APPROVE，第二 1 SHOULD-FIX，合并修复）：
+> - SHOULD-FIX（已修）：genScripts 无草稿幂等检查，重跑覆盖人工精修草稿 → 循环内加「草稿存在且非 --force 则跳过」（fileExists(scriptPath) 检查），与 main.go 幂等文档契约一致
+> - 计划偏差（implementer 修正合理）：TestValidateScript_FinalOK 原数据 2 句违反 3-6 句校验，改 3 句
+> - NIT（不修，记录）：导入校验信任草稿自身 Decision/Character 字段（人工精修对象）；互动入口节点（2/3/5/7/8）祈使指令类 content 强制末句提问可能套路化——Task 6 精修时留意；pinyin 字段为字符串的链路无单测（与 content_pinyin 同模式，风险低）
+
---
### Task 6: 第 1 计试点生成 + 精修 + 端到端验证