コピーとハンドオフの警告を切り分ける

Pinar はまずオフスクリーンドキュメント経由でブラウザのクリップボード API を使い、権限またはフォーカスが阻むときは隠れたテキスト選択にフォールバックします。コピー機構がすべて失敗すると、オーバーレイが復元され、ピンとコメントは編集可能なままです。

screenshot_missing は画像を永続化できなかったことを意味します。helper_unavailable はローカルサービスに届かなかったことです。viewer_unavailable はビューアー URL が作られなかったことです。コメント、DOM パス、セレクター、ピン座標、captureId、pinId から続け、欠けている層だけを再試行してください。

コピーには保存済みコメントと少なくとも1つのピンが必要です。ツールバーは「注釈を保存しています…」を表示し、オーバーレイを隠し、ショットを撮り、オフスクリーンドキュメントに text/html と text/plain の書き込みを依頼します。オフスクリーンはまず navigator.clipboard.write を試し、copy イベントと execCommand にフォールバックします。その書き込みが ok でなければ、コンテンツスクリプトは返された plain ペイロードでまだ writePlainText を試みます。clipboard.writeText、続いて隠れた textarea 選択です。

コピー経路がすべて失敗すると、ページは overlays:hidden を hidden false で送り、「コピーに失敗」を点滅させ、ピンを編集可能なままにします。成功したコピーは「コピーしました！」、または「コピーしました！」に加えて「スクリーンショットなし」、「ヘルパー利用不可」、「ビューアなし」を表示してからセッションを終えます。これらの接尾辞は screenshot_missing、helper_unavailable、viewer_unavailable に対応します。screenshot_inline は劣化したハンドオフ警告のひとつではありません。閉じた pinar-visual-context フェンスの無い貼り付けは JSON として解析できません。

• ツールバーが「コメントを入力」または「先にピンを追加」と出したら、そのピンを仕上げて Command/Ctrl/Alt+Enter を再度押してください。
• 「コピーに失敗」が出たら、ピンがまだページ上にあることを確認し、求められればクリップボード権限を許可し、コピーを再試行してください。
• 「コピーしました！」の接尾辞を読んでください。「スクリーンショットなし」、「ヘルパー利用不可」、「ビューアなし」は、コメントを捨てずに再試行すべき欠けた層を示します。