القائمة
为 `markdown-flow-ui` 的 `ContentRender` 新增或更新“后端整句到达、前端按固定节奏做打字机输出”的 story 时使用本技能。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
当调整 `markdown-flow-ui` 的 `Slide` 移动端播放器控制栏，尤其涉及 `playerCustomActions` 的桥接型节点、占位空槽和 more icon 入口时使用本技能。
当 `markdown-flow-ui` 中新增用于复现问题的本地测试数据文件，但这些文件扩展名与真实内容格式不一致、导致 pre-commit 或 Prettier 校验失败时使用本技能。
保持 `markdown-flow-ui` 中基于 iframe 的幻灯片（`Slide`）步骤常驻挂载，通过 CSS `display` 切换可见性。当幻灯片导航需要降低 iframe 重载耗时、要把 `is_renderable` 驱动的卸载渲染改为“隐藏但已挂载”策略、或在预加载改造中保持 `is_new`、`diff`、交互步骤语义不变时使用本技能。
修复或排查 `markdown-flow-ui` 的 `ContentRender` 在关闭打字机效果时首屏空白、helper 行先于正文出现等首次渲染时序问题时使用本技能。
修改 `markdown-flow-ui` 的 `MarkdownFlowEditor` 国际化语言时使用本技能，尤其适用于新增 locale、补充编辑器文案资源、以及让上游项目传入的语言配置安全落到编辑器内部的场景。
为 `markdown-flow-ui` 的幻灯片（`Slide`）新增或更新可模拟流式播放的 `story` 时使用本技能，尤其适用于通过 `StreamingSlidePreview` 渲染、且为单元素 iframe 承载 `html` 的幻灯片场景。
| name | content-render-typewriter-stream-story |
| description | 为 `markdown-flow-ui` 的 `ContentRender` 新增或更新“后端整句到达、前端按固定节奏做打字机输出”的 story 时使用本技能。 |
当目标是验证阅读模式里的流式文本体验时，优先把打字机能力沉淀为 ContentRender 的可选配置项，并保持默认关闭；story 只负责复现“源流到达”，不要让未传配置的 ContentRender 偏离原有即时渲染行为。
测试数据.json 这类 SSE fixture，优先通过 ?raw 导入原始文本，再按 data: 行解析成事件并抽取真实 text 元素内容，不要手写一份近似文案。ContentRender 上增加类似 typewriter 的可选 prop，至少包含开关和节奏参数；默认不传时应继续直接渲染 content。ContentRender 配置项接管。typewriter 或 streaming 语义。ai-shifu 学习页，优先按真实 element 事件流逐条回放，而不是把所有文本先拼成一个大字符串；text、html 等 block 要分别渲染。text 要等打字机结束，html/其他静态块要等该 element 不再继续收到流式更新后再显示。element”时，要区分“后端事件当前流到的 element”与“前端界面当前仍未完成的 element”；前者可基于 target_element_bid 追踪，后者要结合每个 text block 的打字机完成态与 element 级流结束态共同判断。element 已经从流里到达，但前一个 text block 仍在打字时，后续 element 只能进入缓存态，不能立即进入可见列表；可见列表应按前一个 block 的 renderComplete 状态逐个放行。ContentRender 的 markdown 解析逻辑，除非已经确认是组件级缺陷。2、120ms 这类节奏值散落在 JSX 或 effect 内部。content 依赖统一清空 story 自身的 source 状态，并让组件内部自行处理 typewriter 状态重建。utils，不要在 story 文件里各自复制一份解析器。