# Gameplay Dialogue Presentation

> 当逐字对话、标点节奏、情绪强调或重显后的文字进度不清时组织文本显示与动画生命周期；区分显隐、句子进度和真正继续操作，不接管剧情分支与 NPC 交互规则。

- Skill: `ziyou-lu/gameplay-dialogue-presentation` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx get-skill add ziyou-lu/gameplay-dialogue-presentation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ziyou-lu/gameplay-dialogue-presentation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ziyou-lu (https://skillmd.com/u/ziyou-lu)
- Updated: 2026-11-19
- Page: https://skillmd.com/skills/ziyou-lu/gameplay-dialogue-presentation

---


# 对话文字进度与强调

## 效果预览

整句突然出现，没有完成提示；逐字展开，完成才显示句末提示；文字辅助｜先管理显示进度，再给句末提示。

左侧为使用前，右侧为使用后；斜视 2.5D 短循环，用途示意（非引擎实测；音频相关预览仅示意触发关系，不含声音）。

![话说到哪了，读完了没有？：使用前后对比](assets/before-after.webp)

## 触发条件

- 玩家看不出一句话是否显示完，或情绪抖动/颜色妨碍识读。
- NPC 提示反复进入、退出或换句时，文字显隐与本轮显示进度需要明确管理；不是新增 NPC 交互规则或完整剧情系统。

## 输入与前置条件

完整句子、标点、强调范围、头像/结束指示、语言排版、当前显示进度、触发显示/隐藏的既有事件，以及项目已有继续/跳过规则。按项目确定隐藏时继续、暂停还是终止这一轮显示，不能从节点 visible 状态推断动画生命周期。

## 实施步骤

1. 先显示完整静态文本检查目标语言的换行、字形和强调范围，再建立独立的显隐状态与文本进度。
2. 为每次显示分配当前句子/显示轮次，只有当前轮次可以写进度。按渲染器真实支持的可见字形或比例驱动 reveal；用目标语言校准计数单位，空文本直接进入完成态。
3. 选择隐藏策略：继续、暂停或终止。终止/换句时取消旧动画并使旧完成回调失效；重新开始先设定新文本和初始进度，再启动一轮动画，不让旧 Tween 写新句。
4. 基础逐字显示稳定后增加标点停顿、关键词色或轻微波动；不改变原文本，不依赖颜色和运动传递唯一含义。
5. 句末指示读取本轮完成状态；继续输入读取真实交互许可。若支持跳过，第一次补全当前句，何时允许下一句按项目规则显式区分，防重复输入误越句。
6. 关闭、换说话者、切场时清理旧头像、强调和回调；减少运动模式保留全文与完成提示。

## 调参顺序

分别调基础字速、不同标点停顿和强调幅度；先按目标语言长短句试读再定值，不以字符串长度乘固定常数覆盖所有语言。显隐动画和 reveal 时长分开调。

## 失败处理

快速重入跳进度时查轮次所有权及旧动画取消；句尾指示提前出现时查完成事件；复杂字形被拆开时改用渲染器字形计数或全文显示回退，不继续缩短字速。

## 验收

- [ ] 长短文本、不同标点与目标语言下无截断，强调效果不遮住关键信息。
- [ ] 句末指示与真实显示完成一致；快速换句/关闭后不残留旧字或头像。
- [ ] 逐字进行中退出、快速重入和切换文本时，只有约定的一轮动画能更新当前进度；隐藏、暂停/取消和重置分别按设计核对，逐项记录结果。
- [ ] 空文本、短长文本及目标语言下终值正确；时长计算的计数单位与实际 reveal 一致，不把示例乘数固定成所有语言字速。
- [ ] 若支持跳过，重复输入不越过未读句或误选项；减少运动时全文与进度仍可读。

## 组合与边界

- [交互状态](../gameplay-contextual-ui/SKILL.md)：继续或选项输入若项目提供时遵循真实许可

需要核对案例、参数出处或证据边界时，读取[来源参考](references/sources.md)。

