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

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

最後のスクリーンショットを取得できないために完了が失敗すると、ツールバーは汎用エラーの代わりにこれらのメッセージの1つを表示し、セッションは再試行のためにページ上に留まります。各メッセージは原因と対処を示します。

• 「可視領域の外にピンがあります · 表示領域に移動して再試行してください」 — ピン留めした要素が見えるまでスクロールし、セッションをもう一度完了します。
• 「キャプチャ中にページが変わりました · そのページに留まって再試行してください」 — 注釈したページから離れず、そこで再度完了します。
• 「注釈したタブがアクティブではありませんでした · そのタブに戻って再試行してください」 — 注釈したタブに戻り、再度完了します。
• 「スクリーンショットを取得できませんでした · 注釈したページに戻って再試行してください」 — 注釈したページに戻り、再度完了します。