Agent Skills
› ai-shifu/ai-shifu
› markdownflow-controlled-sync
markdownflow-controlled-sync
GitHub解决MarkdownFlowEditor在受控模式下因本地输入与外部同步冲突导致的中间态残留问题，通过隔离回显逻辑确保数据一致性。
Trigger Scenarios
编辑器出现临时变量或中间态错误保留
本地输入与远端草稿同步冲突
章节切换时上下文残留
Install
npx skills add ai-shifu/ai-shifu --skill markdownflow-controlled-sync -g -y
SKILL.md
Frontmatter
{
"name": "markdownflow-controlled-sync",
"description": "当 ai-shifu 以受控方式接入 MarkdownFlowEditor，并出现变量中间态、临时标签或本地输入回灌问题时使用本技能。"
}
MarkdownFlowEditor 受控同步
适用场景
MarkdownFlowEditor在ai-shifu中作为受控组件使用，父层会在onChange后立刻更新content。- 编辑器内部还带有基于
content的自动提取逻辑，导致本地输入中的中间态被错误保留，例如临时变量名进入变量列表。 - 章节切换、远端草稿同步、历史版本恢复等外部内容更新，仍然需要正确同步回编辑器。
处理原则
- 将“本地输入回显”和“外部 mdflow 同步”拆开，不要把每次本地键入都再次作为新的受控
content回灌给编辑器。 - 用
ref标记最近一次本地输入，只跳过对应的本地 echo；真正的外部更新仍然要同步到编辑器。 - 章节或课时切换时，优先用稳定的作用域 key 重置编辑器实例，避免上一个上下文的临时变量残留。
验证要点
- 在变量表达式中逐字输入时，下拉变量列表不会累积
123、1234这类中间态变量名。 - 本地输入后，自动保存和 store 中的 mdflow 仍然实时更新。
- 远端同步、历史恢复、脚本转换后的内容仍能正确刷新到编辑器中。
Version History
- e65aa77 Current 2026-08-20 15:14
