SuperAPI AI 工具集

contenteditable-selection-contracts

通用与其它

查看项目

更新于 10-16 06:44

技能介绍

用途:诊断并修复 contenteditable 或富文本编辑宿主的选区与编辑事务问题,例如光标跳到错误位置、选区反向、一次意图产生零次或多次编辑、撤销/重做无法往返、粘贴或拖放插入位置错误、合成输入被宿主变更破坏等。

主要能力:要求先记录契约:最近的编辑宿主、所有权模式(原生 DOM 或模型驱动)、以锚点/焦点节点与偏移加方向表示的选区、beforeinput/input 事件事务字段(inputType、data、cancelable、defaultPrevented、isComposing、getTargetRanges()),以及选区捕获与恢复之间发生的所有 DOM 替换、框架提交与焦点移动。主张一次编辑只由一个所有者处理:模型驱动需取消可取消的 beforeinput、应用一次模型事务、渲染一次并恢复逻辑选区;原生 DOM 模式先让浏览器编辑再序列化结果。DOM Range 仅用于同步操作,跨重渲染、innerHTML 替换或宿主重挂载时应序列化为逻辑书签(稳定块/文本标识加偏移与方向)。合成输入期间将 isComposing 视为事务边界,延迟规范化与选区重映射。撤销/重做需明确唯一所有者,historyUndo/historyRedo 目标范围为空的限制。粘贴/拖放按 insertFromPaste/insertFromDrop 单次所有者处理,覆盖时先取消默认动作。焦点移动视为用户意图,仅在命令有意返回同一活跃宿主时恢复书签;宿主销毁时移除文档级监听器并使书签失效。

使用方式:先复现用户编辑并记录事件与选区时间线,计数 DOM 变更,比较原生 DOM 路径与被取消的模型驱动路径以定位双所有者,再进行键入、边界删除、段落插入、撤销/重做、粘贴、拖放、焦点离开等回归测试。该技能不负责 CJK 输入法细节、HTML 安全策略、无障碍语义、文件校验或其他编辑器框架内部映射,这些问题应移交相应技能。

限制:资料未提供具体安装命令、价格或平台要求;修复需以可复现的编辑序列和可观察的契约失败为前提,否则应拒绝或转交。