Scrawl

Scrawl-Aufnahmen

Scrawl zeichnet den Bildschirm, die Stimme, Klicks und rote Tinte einer Person auf und packt das Ergebnis in einen .scrawl-Ordner (ein Bundle). Die Person sendet es, um Ihnen ein Problem zu zeigen, anstatt es zu beschreiben – die Aufnahme ist der Fehlerbericht. Lesen Sie sie genau, bevor Sie antworten, und bitten Sie nicht, bereits Gezeigtes erneut zu erklären. Wenn etwas unklar ist, sehen Sie mit scrawl zoom genauer hin.

Wie eine Einfügung aussieht

[scrawl 0:33 · OpenCode „Einstellungen“ · /Users/me/Library/Application Support/scrawl/captures/scrawl-1792432139176.scrawl]
Öffnen Sie zuerst contact-sheet.png und frames/ in diesem Ordner, bevor Sie etwas ändern: Die Markierungen und Wörter ergeben nur auf den Bildern Sinn, die mehr zeigen können als der Text.
Beschnitten auf: die Aktivität in OpenCode (vollständige Bilder in frames-full/)
- #1 (0:04) [geklickt „Neuer Tab“] „Befehl T erstellt eine neue Sitzung, aber hier sollte es einen Tab erstellen.“
- #2 (0:07) „Nein, tut es nicht.“
- #3 (0:10) ⚑ „Es sagt, Befehl Umschalt B erstellt einen neuen Tab.“
- #4 (0:18) geklickt (x 0.51, y 0.93)

• Die erste Zeile enthält die Länge, die aufgenommene App und das Fenster sowie den Bundle-Pfad.
• Die nächste Zeile fordert Sie auf, zuerst die Bilder zu öffnen. Tun Sie das: Der Text enthält nur, was gesagt und getan wurde, und ein Problem kann in einem Bild sichtbar sein, ohne markiert oder erwähnt zu werden.
• Jede Zeile #N (M:SS) ist ein Schlüsselbild: in Klammern, was sie in diesem Moment getan haben, dann, was sie sagten, während es auf dem Bildschirm war. Eine Zeile ohne Zitat enthält nur die Aktion.
• ⚑ bedeutet, dass sie den Moment absichtlich markiert haben. ⟨Name⟩ bedeutet, dass die App einen neuen Bildschirm gemeldet hat. Zeilen, die mit · beginnen, sind Ereignisse oder Werte, die die App protokolliert hat.
• Optionale Zeilen am Anfang: For session: (wohin Scrawl es gesendet hat), Screen: mit App-Kontext, Note: und Cropped to:.
• Koordinaten sind Bruchteile des aufgenommenen Bereichs, von oben links (x 0,51 ist etwas rechts der Mitte).

Wenn Sie antworten, verweisen Sie auf Momente in derselben Weise, wie z. B. „#3 (0:10)“, damit die Person sie auf dem Kontaktblatt finden kann.

Ein Bundle lesen

1. Sehen Sie sich zuerst contact-sheet.png im Bundle an (es ist oft bereits angehängt). Es zeigt jedes Schlüsselbild in zeitlicher Reihenfolge, von links nach rechts und oben nach unten, jeweils mit der Nummer N in einem kleinen weißen Chip in einer oberen Ecke (das #N in summary.md).
2. Lesen Sie die Transkriptzeilen daneben. Die Spracherkennung hört Namen und Codebegriffe falsch, also vertrauen Sie dem Bildschirm, wenn die beiden sich widersprechen.
3. Öffnen Sie frames/frame-NN.png für jedes Schlüsselbild, das Sie in voller Größe benötigen (frame-03.png ist #3). Wenn die Zusammenfassung Cropped to: sagt, befinden sich die unbeschnittenen Bildschirme in frames-full/.

Was die Zeichnungen bedeuten:

• Rote Striche, Kreise, Unterstreichungen und Pfeile sind die Markierungen der Person und zeigen auf das Problem. Markierungen, die auf demselben Bildschirm gezeichnet wurden, erscheinen alle auf einem Schlüsselbild. Wenn es mehrere gibt, nummeriert der Text sie in der Reihenfolge des Zeichnens (✎① 0:06 …, ✎② 0:09 …); das Bild zeigt nur die Tinte, also verwenden Sie scrawl zoom --mark, um zu sehen, welche Tinte welche ist.
• Eine Welle um den Cursor zeigt einen Klick oder Tipp, und eine Fingerspur zeigt ein Wischen.
• Eine leuchtend rote Spur, die ausläuft, ist der Laserpointer, der zum Zeigen verwendet wird, ohne eine Markierung zu hinterlassen.

Weitere Dateien: scrawl.json ist das vollständige Manifest (Schlüsselbilder, marks mit Form und Box, events, transcript.words mit Zeiten, App-context und autocrop). recording.mp4 oder recording.mov und audio.wav sind die Quellmedien. Eine .media-pending-Datei bedeutet, dass das Video noch von einem anderen Mac kopiert wird.

Das scrawl CLI

scrawl ist das eigene Binärprogramm der Scrawl-App. Wenn command -v scrawl nichts findet, verwenden Sie /Applications/Scrawl.app/Contents/MacOS/scrawl (oder denselben Pfad unter ~/Applications) und teilen Sie der Person mit, dass sie es mit „Installieren“ in Scrawls Einstellungen › Agents zum PATH hinzufügen kann. Es läuft nur auf dem Mac, auf dem Scrawl installiert ist. Überall sonst lesen Sie contact-sheet.png, frames/ und scrawl.json direkt. Jeder Befehl akzeptiert einen Bundle-Pfad, und die meisten verwenden standardmäßig latest, die neueste Aufnahme. Setzen Sie den Pfad in Anführungszeichen, da er normalerweise Application Support enthält.

Genauer hinschauen bei einem Moment

Verwenden Sie zoom, wenn das Problem eine Bewegung ist (eine Animation, ein Sprung, ein Flackern) oder zwischen Schlüsselbildern auftritt, oder wenn Sie nicht erkennen können, worauf eine Markierung zeigt:

scrawl zoom <bundle> --at 0:21                 # eine Zeit, M:SS oder Sekunden
scrawl zoom <bundle> --at "die Breite ändert sich"  # oder eine gesprochene Phrase
scrawl zoom <bundle> --at 0:21 --span 1 --frames 16 --full
scrawl zoom <bundle> --mark 2                  # die im Text als ✎② gezeigte Markierung
scrawl zoom <bundle> --mark 1 --frame 4        # ✎① von Schlüsselbild #4, wenn mehrere eine ✎① haben

Es gibt den Pfad einer PNG-Tafel mit Einzelbildern um diesen Moment herum aus, die Zeit jeder Zelle und was gesagt wurde. Öffnen Sie das PNG und sehen Sie es sich an, bevor Sie auf das Feedback reagieren. --span sind die abgedeckten Sekunden (Standard 2, ein Viertel davon vor dem Moment), --frames die Anzahl der Zellen (Standard 12) und --full zeigt den gesamten Bildschirm anstelle des Ausschnitts. Die Zellen sind innerhalb der Tafel von #1 an nummeriert, diese Nummern sind also keine Schlüsselbildnummern.

--mark nimmt die Nummer einer Markierung aus dem Text oder ihre ID (m2) und zentriert die Tafel auf den Zeitpunkt, zu dem sie gezeichnet wurde, nur mit der Tinte dieser Markierung, vollständig von ihrem Beginn an gezeichnet. scrawl inspect <bundle> --marks listet jede Markierung auf (#2 ✎② 0:09 marked (2 strokes) · m2: Schlüsselbild, Nummer, Zeit, Form, worauf sie gezeichnet wurde, ID), und --marks --json gibt dasselbe als JSON aus.

Weitere Befehle

scrawl inspect <bundle>               # summary.md, der obige Text
scrawl inspect <bundle> --json        # scrawl.json
scrawl inspect <bundle> --marks       # die Markierungen, nummeriert wie im Text [--json]
scrawl frames <bundle> --from 0:04 --to 0:06 [--fps 4]   # einfache PNGs eines Bereichs; gibt ihre Pfade aus
scrawl send <bundle> --session ses_…  # die Aufnahme in eine OpenCode-Sitzung einreihen
scrawl send <bundle> --clipboard      # den Zusammenfassungstext in die Zwischenablage kopieren
scrawl export <bundle> [--out demo.mp4] [--zoom] [--crop auto|full|x,y,w,h] [--size 1920]

• zoom und frames schreiben in <bundle>/zoom/. Lassen Sie den Rest des Bundles unverändert, da Scrawl diese Dateien verwaltet und aufräumt.
• send ohne --session geht an die Sitzung, an die die Aufnahme adressiert war (die Zeile For session:), andernfalls an die zuletzt aktive Sitzung. Bei einem aufgezeichneten Ziel verweigert es ein anderes --session, es sei denn, Sie übergeben --reroute; fragen Sie also die Person, bevor Sie umleiten.
• export schreibt eine .mp4 mit eingebrannter Tinte und Klicks und synchronem Audio (Standard ~/Movies/Scrawl/<bundle>.mp4). --zoom zoomt sanft zur Aktivität hin. --no-ink, --no-clicks, --hevc und --fps sind ebenfalls verfügbar.
• Video und Audio werden 7 Tage nach einer Aufnahme in den Papierkorb verschoben, sofern die Person dies nicht in den Einstellungen geändert hat. Danach können zoom, frames und export das Video nicht mehr lesen, aber frames/, das Kontaktblatt und scrawl.json bleiben erhalten.
• scrawl <command> --help listet alle Flags auf, und scrawl skill gibt diese Anleitung so aus, wie die installierte Version sie kennt.