排查复制与交接警告

Pinar 首先通过离屏文档使用浏览器剪贴板 API，并在权限或焦点阻止时回退到隐藏文本选择。如果所有复制机制都失败，叠加层会恢复，以便您的图钉和评论仍可编辑。

screenshot_missing 表示图像未能持久化。helper_unavailable 表示未联系到本地服务。viewer_unavailable 表示没有生成查看器 URL。请从评论、DOM 路径、选择器、图钉坐标、captureId 和 pinId 继续，然后只重试缺失的那一层。

复制需要已保存的评论和至少一个图钉。工具栏显示「正在保存会话…」，隐藏叠加层，捕获截图，然后请离屏文档写入 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+Enter / Alt+Enter。
• 如果出现「复制失败」，请确认图钉仍在页面上，按提示授予剪贴板权限，然后重试复制。
• 阅读「复制成功！」后缀：「无截图」、「助手不可用」和「无查看器」会指出要重试的缺失层，而无需丢弃评论。

当完成失败是因为最终截图无法捕获时，工具栏会显示以下消息之一，而不是通用错误，会话会保留在页面上以便重试。每条消息都指明了原因和解决方法：

• 「有标注位于可见区域之外 · 请将其移入可见区域后重试」——滚动到被钉住的元素可见，然后再次完成会话。
• 「截图期间页面发生了变化 · 请停留在该页面后重试」——留在带标注的页面上，从那里再次完成。
• 「带标注的标签页未处于活动状态 · 请切换回该标签页后重试」——切换回带标注的标签页，再次完成。
• 「未能截取屏幕截图 · 请返回带标注的页面后重试」——返回带标注的页面，再次完成。