排查复制与交接警告
从剪贴板、助手、截图或查看器失败中恢复,而不丢失标注。
5 分钟本指南内容
1
剪贴板恢复
Pinar 首先通过离屏文档使用浏览器剪贴板 API,并在权限或焦点阻止时回退到隐藏文本选择。如果所有复制机制都失败,叠加层会恢复,以便您的图钉和评论仍可编辑。
2
降级并不等于失去关联
screenshot_missing 表示图像未能持久化。helper_unavailable 表示未联系到本地服务。viewer_unavailable 表示没有生成查看器 URL。请从评论、DOM 路径、选择器、图钉坐标、captureId 和 pinId 继续,然后只重试缺失的那一层。
3
工具栏报告失败时走一遍复制路径
复制需要已保存的评论和至少一个图钉。工具栏显示「正在保存标注…」,隐藏叠加层,捕获截图,然后请离屏文档写入 text/html 和 text/plain。离屏文档先尝试 navigator.clipboard.write,再回退到 copy 事件加 execCommand。如果这次写入未成功,内容脚本仍会对返回的纯文本载荷尝试 writePlainText:clipboard.writeText,然后是隐藏文本框选择。
当所有复制路径都失败时,页面会发送 overlays:hidden 且 hidden 为 false,闪现「复制失败」,并让图钉保持可编辑。成功复制会显示「复制成功!」,或「复制成功!」加上「无截图」、「助手不可用」或「无查看器」,然后结束会话。这些后缀对应 screenshot_missing、helper_unavailable 和 viewer_unavailable。screenshot_inline 不属于降级交接警告。没有闭合 pinar-visual-context 围栏的粘贴无法作为 JSON 解析。
- 如果工具栏显示「请先填写评论」或「请先添加图钉」,请完成该图钉并再次按
Command/Ctrl/Alt+Enter。 - 如果出现「复制失败」,请确认图钉仍在页面上,按提示授予剪贴板权限,然后重试复制。
- 阅读「复制成功!」后缀:「无截图」、「助手不可用」和「无查看器」会指出要重试的缺失层,而无需丢弃评论。
还需要更多背景?查看该分类全部内容