用途:实现稳健的文档渲染、定位符提取与批注锚定。在集成文档渲染库或修改 reader-core、目录、定位符、高亮/评论锚定逻辑,以及调试批注漂移或文档加载回归时启用。
主要能力与工作流:先定义数据模型,确认多信号定位符需求(位置+文本+章节+DOM 回退);设计锚点,将 DOM 选区映射为 { position, selectedText, chapterRef, elementIndex, charOffset };使用渲染库 API 实现批注与导航,并确保异步清理;加入重锚定策略(精确匹配→模糊文本→章节回退→用户提示);性能上懒加载文档资源、复用单个 rendition、清理监听器避免泄漏;为定位符序列化与重锚定辅助函数补充测试用例并捕获回归。
检查清单:位置、文本摘录与 chapterRef 一起持久化;锚点序列化使用稳定大小写与 schema;回退时向用户提示;卸载时移除事件处理器;加载失败记录带 trace ID 的遥测事件。
限制与说明:资料未提供具体安装命令、代码示例、平台或收费信息。