Pins, Kommentare und Farben

Jedes nummerierte Badge auf dem Screenshot gehört zu einem Kommentar und einem Pin-Datensatz. Die rotierende Farbpalette trennt nahe Markierungen, ohne ihre Identität zu ändern.

Schreibe captureId oder pinId nicht um, wenn du das Bundle an ein anderes Tool übergibst. Diese Felder lassen Workspace, Viewer, Agent-Ergebnis und Review-Verlauf auf dasselbe Capture verweisen.

Ein Pin wird nur gespeichert, wenn der Kommentar getrimmt und nicht leer ist. Neue Pins erhalten eine UUID, eine 1-basierte Nummer aus ihrer Reihenfolge im Capture und eine Farbe aus der Elf-Felder-Palette an dieser Nummer. Nahe Badges unterscheiden sich daher optisch, ohne die behaltene Identität zu ändern.

Der strukturierte Kontext übernimmt pinId aus dem vorhandenen pinId oder id. Fehlen diese Felder, erzeugt der Parser captureId:pN aus der Capture-Identität und der Pin-Nummer. Nachgelagerte Tools können dann auf denselben Screenshot, Kommentar und dieselbe Review-Zeile zeigen.

• Ein leerer Composer lässt sich nicht kopieren; der Fokus bleibt auf dem Feld, bis ein Kommentar existiert.
• Beim Zeigen auf eine Markierung siehst du Nummer, Kommentar und aktuelle Locator-Konfidenz auf der Live-Seite.
• Das Bearbeiten eines vorhandenen Pins aktualisiert nur den Kommentar; die gespeicherte id bleibt unverändert.

Jeder Element-Pin speichert außerdem einen Snapshot dessen, worauf er zeigt: den HTML-Baum des Elements, die berechneten Stile, die von den Browser-Standardwerten abweichen, die verwendeten Schriften und Symbole sowie Eltern- und Geschwisterelemente. Die Vorschau zeigt die mit dem Pin gespeicherten Locator und Belege, während der vollständige Snapshot in der gespeicherten Aufnahme und dem vollständigen Handoff-Paket bleibt. Große Elemente werden gekürzt, um innerhalb der Capture-Grenze zu bleiben, und das Sitzungs-Markdown weist darauf mit einer gekürzten Knotenanzahl hin.

„Technische Belege“ listet Fakten auf, die die Erweiterung während des Pinnens auf der Seite beobachtet hat: Konsolenfehler, fehlgeschlagene Anfragen und die Umgebung (Browser, Viewport, Sprache). Jeder Eintrag ist als „Nach Interaktion“ eingestuft, wenn er nach deinem letzten Klick oder Tastendruck aufgetreten ist, oder als „Gleiche Seite“, wenn er nur dieselbe Seite teilt. Nichts wird abgeleitet und kein KI-Credit verbraucht; entferne einen Eintrag vor dem Teilen, wenn er nichts damit zu tun hat.

• Bereichs-Pins haben keine Struktur; verwende einen Element-Pin, wenn der Agent DOM-Kontext und robuste Locator benötigt.
• Der Standard-Kompakt-Prompt behält die Locator, den Kommentar und die kompakten Belege; der Element-Snapshot reist mit dem pinar-visual-context-Block des vollständigen Pakets und dem Sitzungs-Markdown und steht über den Kontext-Link zur Verfügung.

Die Pin-Diskussion im Viewer bietet die Original-Notiz und die gespeicherten Thread-Kommentare zur Bearbeitung an. Die Regeln unterscheiden sich zwischen dem lokalen Workspace und Pinar Cloud.

Der lokale Workspace hat kein Login, daher können im Viewer jede Notiz und jeder gespeicherte Kommentar bearbeitet werden. In Pinar Cloud bearbeitet der Sitzungsinhaber die Notiz, und einen menschlichen Kommentar kann nur seine Verfasserin oder sein Verfasser bearbeiten. Agenten-Kommentare sind im Viewer nie bearbeitbar.

• Eine Bearbeitung überschreibt den gespeicherten Text und behält die Identität, die Urheberschaft und den Zeitstempel der Nachricht.