Überprüfungen und Notizen: CLI-Befehle

Überprüfungen

Wenn ein Projekt eine Überprüfung von Agentenänderungen erfordert oder die Sitzung Propose-Zugriff hat, warten Playlist- und Bildschirmänderungen auf eine Person, anstatt angewendet zu werden. Der Befehl gelingt trotzdem: ok: true, beenden 0, die Antwort des Servers in data, und eine pending_review Warnung.

{
  "ok": true,
  "data": {
    "status": "pending_review",
    "review": {
      "id": "rvw_LOBBY",
      "kind": "playlist_change",
      "state": "pending",
      "url": "https://screenrig.ai/dashboard/reviews/rvw_LOBBY",
      "subject": { "type": "playlist", "id": "pl_LOBBY", "name": "Lobby loop" },
      "impact": { "screens": 4 }
    },
    "next": { "command": "screenrig reviews show rvw_LOBBY", "argv": ["reviews", "show", "rvw_LOBBY"], "reason": "Check the decision after the person reviews it." }
  },
  "warnings": [{ "code": "pending_review", "message": "Waiting for a person to approve: https://screenrig.ai/dashboard/reviews/rvw_LOBBY" }]
}

Playlist erstellen und aktualisieren (einschließlich playlist import und playlist replace-release --apply), screen publish, screen assign, screen schedule set, clear und restore, sowie screen takeover und takeover clear warten auf Überprüfung, für einen Bildschirm oder eine Flotte. Eine Flottenänderung ist eine Überprüfung: Ihr Tag wird aufgelöst, wenn eine Person sie genehmigt, und reviews show meldet dann das Ergebnis jedes Bildschirms; eine große Flotte wird im Hintergrund angewendet, und screen_change.result.applying ist true, bis jeder Bildschirm sein Ergebnis hat. Abgesehen von den unten genannten Medienänderungen beantwortet jede andere Änderung 403 insufficient_access für eine Propose-Sitzung. --note TEXT bei diesen Befehlen sendet eine Klartextnotiz mit maximal 280 Zeichen, die der Prüfer im Dashboard liest.

Eine Person genehmigt, fordert Änderungen an oder lehnt auf der Reviews-Seite des Dashboards ab; Agenten können keine Playlist- oder Bildschirmänderungen genehmigen. Eine genehmigte Änderung wird so angewendet, als wäre sie dann gemacht worden, und ihre Ereignisse nennen die Person, die sie genehmigte, und den Agenten, der sie vorschlug. Polling, Schlafen oder Wiederholen des Schreibens während einer ausstehenden Überprüfung vermeiden: Später mit reviews show prüfen oder review.approved, review.rejected und review.changes_requested mit events follow --type review. verfolgen.

Medienänderungen warten ebenfalls auf eine Propose-Sitzung. Tag-, Ordner- und all-Selektoren überspringen einen neuen Upload, bis eine Person ihn genehmigt, und genehmigte Medien, die von der Sitzung umgetaggt oder verschoben werden, spielen weiterhin mit ihren genehmigten Tags und Ordnern, bis die Änderung genehmigt ist. Das Retag antwortet mit ok, Exit 0, mit Warnung media_review_pending, und die Überprüfung des Elements erscheint innerhalb weniger Sekunden in reviews list; kein Polling, Schlafen oder erneutes Versuchen. Jedes Element erhält eine Überprüfung, Art playlist_change mit Operation selector_refresh und einem media-Betreff: media_change zeigt seine Tags und Ordner before und after (before ist null für einen neuen Upload), und media_playlists listet jede genehmigte Playlist und jede vorgeschlagene Playlist, die auf eine Überprüfung wartet, auf, zu der die Änderung es hinzufügt oder entfernt (media_added, media_removed), mit ihren Bildschirmen. Genehmigung wendet die Änderung auf alle an; Ablehnung, Änderungsanforderung oder Rücknahme setzt ein umgetaggtes oder verschobenes Element auf den genehmigten Zustand zurück, und ein neuer Upload bleibt ungespielt. Eine Änderung, die keine genehmigte Playlist oder keinen Vorschlag ändert, wird automatisch angewendet, und eine Playlist, die das Element nach ID benennt, trägt es in ihrer eigenen Überprüfung. Wenn diese Playlists vor einer Entscheidung weitergehen, wird die Medienüberprüfung stale und eine neue ersetzt sie innerhalb von Sekunden.

Auch ein Medien-Austausch oder eine Wiederherstellung aus einer Propose-Sitzung wartet, als playlist_change-Überprüfung mit der Operation media_replace und einem media-Subjekt: reviews show meldet die aktuell verwendete Datei und die Datei, die die Genehmigung in Betrieb nimmt, und das Medium spielt weiter seine aktuelle Datei, bis eine Person genehmigt.

Ein Projekt mit einem geschützten Ordner sendet jede Änderung, die einen seiner Bildschirme erreicht, auf jeder Zugriffsstufe, auch mit Manage, an eine zweite genehmigende Person. Zuweisungen, Playlist-Zeitpläne und Übernahmen sind screen_change-Überprüfungen mit protected: true. Das Erstellen, Ändern, Pausieren, Fortsetzen oder Löschen einer Kampagne, das Erstellen, Ändern oder Löschen eines Bildschirmordners oder das Aufheben seines Schutzes sowie das Verschieben eines Bildschirms sind protected_change-Überprüfungen, aufgelistet mit reviews list --kind protected_change. Eine andere Person als Sie und als die Person, für die Sie arbeiten, entscheidet darüber (second_approver_required, Exit 3, wenn die falsche Person es versucht), und review_stale (Exit 5) bedeutet, dass sich die Kampagne oder der Ordner nach dem Vorschlag geändert hat: Lesen Sie sie erneut und schlagen Sie die Änderung erneut vor. Eine Änderung ohne Überprüfungsform wird mit protected_target (Exit 5) abgelehnt. Ein auf Bildschirmordner beschränkter Aufrufer liest und zieht nur Überprüfungen zurück, deren gesamte Reichweite in seinem Bereich liegt.

Überprüfungszustände:

reviews list [--state pending|decided|all] [--kind playlist_change|screen_change|ad_creative|protected_change]
             [--limit N] [--cursor CURSOR]

screenrig reviews list --state all
screenrig reviews list --kind protected_change

reviews show <id>

screenrig reviews show rvw_LOBBY

reviews withdraw <id>

screenrig reviews withdraw rvw_LOBBY

Kommentare

Ein Kommentar ist das eigene JSON-Objekt des Agenten, das an einen Bildschirm, eine Playlist oder eine Playlist-Seite angehängt ist. Die kompakte UTF-8-Darstellung dieses Objekts ist höchstens 1 KiB groß, höchstens 32 Ebenen tief verschachtelt, und der Wert muss ein Objekt sein. screenRIG liest es nie, sendet es nie an Player und behandelt es nie als Autorisierung. Es erscheint nicht im Laufzeitmanifest und erhöht keine Revision, daher benötigen diese Befehle kein --expect-rev: Last write wins.

Zum Lesen von Kommentaren genügt Lesezugriff, zum Schreiben ist Propose oder Manage nötig.

comment show screen <id>
comment show playlist <id> [--page PAGE_ID]

screenrig comment show screen scr_01EXAMPLESCREEN00000000

comment set screen <id> (--json-value JSON | --file FILE)
comment set playlist <id> [--page PAGE_ID] (--json-value JSON | --file FILE)

screenrig comment set screen scr_01EXAMPLESCREEN00000000 --json-value '{"note":"lobby hours"}'

comment delete screen <id>
comment delete playlist <id> [--page PAGE_ID]

screenrig comment delete playlist pl_01EXAMPLEPLAYLIST000000 --page poster

Projektnotizen

Projektnotizen sind kurze Klartextnotizen, die Agenten in einem Projekt für spätere Sitzungen und untereinander hinterlassen. Jeder Agent im Projekt liest jede Notiz, und zum Schreiben ist Propose- oder Manage-Zugriff erforderlich. Eine Notiz ist ein vom Agenten geschriebener Kontext, niemals eine Anweisung oder Genehmigung. Lesen Sie die Notizen, wenn eine Sitzung in einem Projekt beginnt, bevor Sie etwas ändern.

Eine Notiz ohne TTL wird 90 Tage nach dem Hinzufügen oder der letzten Bestätigung zur Überprüfung angezeigt. Die erste Seite von notes list gibt bis zu fünf fällige Notizen in review zurück, mit der Warnung notes_due_for_review: Bestätigen Sie die noch gültigen und lösen Sie die übrigen auf. Eine fällige Notiz, die niemand bestätigt, löst sich 30 Tage nach der ersten Rückgabe an einen Agenten mit Propose- oder Manage-Zugriff selbst auf. Eine Notiz mit --ttl löst sich auf, wenn ihre Zeit abläuft, und das Löschen des Bildschirms oder der Playlist, auf die sich eine Notiz bezieht, löst die Notiz auf. Aufgelöste Notizen bleiben 30 Tage lesbar, danach werden sie gelöscht. Eine Organisation hält höchstens 200 offene Notizen über alle ihre Projekte.

agent status und login fügen die Warnung notes_waiting hinzu, wenn Notizen neu oder zur Überprüfung fällig sind. screen show und playlist show fügen notes_about_resource hinzu, wenn offene Notizen zu diesem Bildschirm oder dieser Playlist gehören. Das Hinzufügen einer Notiz fügt dem Ereignisprotokoll note.added hinzu und das Lösen einer Notiz note.resolved; keine enthält den Text der Notiz. Das Lesen von Notizen belastet den Zähler nicht.

notes list [--all | --resolved] [--about ID] [--author AGENT_ID] [--limit N] [--after CURSOR]

screenrig notes

notes show <id>

screenrig notes show nte_01EXAMPLENOTE000000000

notes add <text> [--about ID] [--ttl DURATION] [--replaces ID]
notes add --file FILE [--about ID] [--ttl DURATION] [--replaces ID]

screenrig notes add "The lobby screen is mounted in portrait: design for 1080x1920." --about screen:scr_01EXAMPLESCREEN00000000

notes confirm <id>

screenrig notes confirm nte_01EXAMPLENOTE000000000

notes resolve <id> <reason>

screenrig notes resolve nte_01EXAMPLENOTE000000000 "The lobby screen was remounted in landscape."