Pinar
首页方案新功能帮助
登录
⌘ K

快速开始捕获与图钉AI 智能体项目与集合云与套餐隐私与数据
快速开始
捕获与图钉
AI 智能体
把视觉上下文发给智能体交接格式与目标闭环智能体审阅重新打开并重定位图钉排查复制与交接警告
项目与集合
云与套餐
隐私与数据
帮助/AI 智能体

排查复制与交接警告

从剪贴板、助手、截图或查看器失败中恢复,而不丢失标注。

5 分钟
示意图: 当所有剪贴板路径都失败时,工具栏显示复制失败并恢复图钉,以便在不丢失评论的情况下重试。

本指南内容

  1. 1剪贴板恢复
  2. 2降级并不等于失去关联
  3. 3工具栏报告失败时走一遍复制路径
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。
  • 如果出现「复制失败」,请确认图钉仍在页面上,按提示授予剪贴板权限,然后重试复制。
  • 阅读「复制成功!」后缀:「无截图」、「助手不可用」和「无查看器」会指出要重试的缺失层,而无需丢弃评论。
还需要更多背景?查看该分类全部内容

本页内容

剪贴板恢复降级并不等于失去关联工具栏报告失败时走一遍复制路径
支持 Fair Source 开发

想直接支持公开源码开发?可在 GitHub 赞助或请我们喝杯咖啡。

请我喝咖啡在 GitHub 赞助
Pinar·© 2026·Pinar v0.3.6
Terms of ServicePrivacy Policy