ピン、コメント、色

スクリーンショット上の番号バッジは、それぞれ1つのコメントと1つのピン記録に対応します。回転するカラーパレットは、識別子を変えずに近いマーカーを見分けやすくします。

バンドルを別のツールへ渡すときに captureId や pinId を書き換えないでください。これらのフィールドにより、ワークスペース、ビューアー、エージェント結果、レビュー履歴が同じキャプチャを指せます。

ピンは、コメントがトリムされて空でない場合にだけ保存されます。新しいピンは UUID、キャプチャ内の順序による1始まりの番号、その番号の11色パレットから色を受け取ります。近いバッジは見た目が違っても、保持する識別子は変わりません。

構造化コンテキストは、既存の pinId または id から pinId を保ちます。それらのフィールドが無い場合、パーサーはキャプチャ識別子とピン番号から captureId:pN を合成します。下流のツールは、同じスクリーンショット、コメント、レビュー行を指せます。

• 空の入力欄はコピーできません。コメントができるまでフォーカスはその欄に残ります。
• マーカーにホバーすると、ライブページ上で番号、コメント、現在のロケーター信頼度がプレビューされます。
• 既存ピンの編集はコメントだけを更新し、保存済みの id は変えません。

各要素ピンは、指している対象のスナップショットも保存します。要素の HTML ツリー、ブラウザーの既定値と異なる計算済みスタイル、使用しているフォントとアイコン、親と兄弟要素です。プレビューはピンとともに保存されたロケーターと証拠をレンダリングし、完全なスナップショットは保存されたキャプチャと完全なハンドオフペイロードの中に留まります。大きな要素はキャプチャの上限に収めるため省略され、セッションの Markdown は切り詰められたノード数としてそれを示します。

「技術的な証拠」は、ピン留め中に拡張機能がページで観測した事実を列挙します。コンソールエラー、失敗したリクエスト、環境（ブラウザー、ビューポート、言語）です。各項目は、最後のクリックやキー入力のあとに起きたものは「操作直後」、同じページにあるだけのものは「同じページ」と区分されます。推測は含まれず、AI クレジットも消費しません。無関係な項目は共有前に削除してください。

• 領域ピンには構造がありません。エージェントが DOM コンテキストと堅牢なロケーターを必要とする場合は要素ピンを使ってください。
• デフォルトのコンパクトプロンプトはロケーター、コメント、コンパクトな証拠を保持します。要素のスナップショットは、完全ペイロードの pinar-visual-context ブロックとセッションの Markdown に載り、完全コンテキストのリンク越しに利用できます。

ビューアーのピンディスカッションでは、元のノートと保存されたスレッドのコメントを編集できます。ルールはローカルワークスペースと Pinar Cloud で異なります。

ローカルワークスペースはログインがないため、ビューアーではどのノートや保存されたコメントも編集できます。Pinar Cloud では、セッションの所有者がノートを編集し、人間のコメントはその投稿者だけが編集できます。エージェントのコメントはビューアーでは決して編集できません。

• 編集は保存されたテキストを上書きし、メッセージの識別子、作成者、タイムスタンプを保持します。