审核和备注 CLI 命令

审核

当项目需要审查 agent 更改，或会话具有提议访问权限时，播放列表和屏幕更改将等待人工处理而非立即应用。命令仍然成功：ok: true，退出 0，服务器在 data 中响应，并有 pending_review 警告。

{
  "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 import 和 playlist replace-release --apply）、screen publish、screen assign、screen schedule set、clear 和 restore，以及 screen takeover 和 takeover clear 等待审核，针对单个屏幕或设备群。设备群变更为一次审核：当有人批准时其标签解决，reviews show 然后报告每个屏幕的结果；大型设备群在后台完成应用，screen_change.result.applying 是 true，直到每个屏幕都有结果。除以下媒体变更外，其他变更均响应 403 insufficient_access 用于 Propose 会话。--note TEXT 命令发送纯文本备注，最多 280 字符，审核者在控制台阅读。

某人在仪表板的审核页面批准、请求更改或拒绝；智能体无法批准播放列表或屏幕变更。批准的变更视为当时生效，其事件记录批准者和提议智能体。审核等待时请勿轮询、休眠或重复写入：稍后使用 reviews show 检查，或按 review.approved、review.rejected、review.changes_requested 后跟 events follow --type review. 进行操作。

媒体变更也来自 Propose 会话等待。标签、文件夹和 all 选择器在人员批准前跳过新上传，已批准的媒体被会话重新标记或移动时，屏幕继续播放其批准的标签和文件夹，直到变更获批。重新标记返回 ok，退出码 0，带警告 media_review_pending，项目的审核在几秒内显示于 reviews list；请勿轮询、休眠或重试。每个项目获得一次审核，类型 playlist_change，操作 selector_refresh，主题 media：media_change 显示其标签和文件夹 before 与 after（before 为新上传的 null），media_playlists 列出所有批准的播放列表及所有等待审核的提议播放列表，显示变更添加或移除的播放列表 (media_added, media_removed) 及其屏幕。批准即应用变更；拒绝、请求更改或撤回则将重新标记或移动的项目恢复为批准状态，新上传保持未播放。无变更的批准播放列表和提议自动应用，按 ID 命名项目的播放列表在自身审核中包含该项目。当播放列表在人员决定前移动，媒体审核变为 stale，几秒内由新的审核替代。

来自 Propose 会话的媒体替换或恢复同样会等待，表现为操作为 media_replace、主体为 media 的 playlist_change 审核：reviews show 会报告当前正在使用的文件和批准后将启用的文件，在有人批准之前，媒体继续播放当前文件。

含有受保护文件夹的项目，会把涉及其屏幕的每项更改都交给第二位审批人，在任何访问级别（包括 Manage）都是如此。分配、播放列表排程和接管是带有 protected: true 的 screen_change 审核。创建、更改、暂停、恢复或删除活动，创建、更改或删除屏幕文件夹或移除其保护，以及移动屏幕，是 protected_change 审核，可用 reviews list --kind protected_change 列出。由你以外、也不是你所服务之人的另一个人来决定（错误的人尝试时返回 second_approver_required，退出码 3），review_stale（退出码 5）表示活动或文件夹在提议之后已更改：重新读取并再次提议。没有审核形式的更改会被 protected_target（退出码 5）拒绝。限定于屏幕文件夹的调用方只能读取和撤回整体影响范围都在其范围内的审核。

审核状态：

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

评论

评论是智能体附加到屏幕、播放列表或播放列表页面的 JSON 对象。该对象的 UTF-8 压缩体积最多 1 KiB，嵌套最多 32 层，且值必须是对象。screenRIG 从不读取、不发送给播放器，也不作为授权处理。它不出现在运行时清单中，也不增加修订版本，因此这些命令不需要 --expect-rev：最后写入获胜。

读取评论需要只读权限，写入评论需要提议或管理权限。

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

项目备注

项目备注是智能体为其后续会话及相互之间留下的简短纯文本备注。项目中的每个智能体都能读取所有备注，写备注需要提议或管理权限。备注是智能体写的上下文，不是指令，也不是批准。会话开始时读取备注，变更前请先阅读。

无 TTL 的备注将在添加或最后确认后 90 天进入审核。notes list 的第一页返回最多五条到期备注，位于 review，并带有警告 notes_due_for_review：确认仍有效的备注，解决其余备注。无人确认的到期备注将在首次返回给具有 Propose 或 Manage 权限的代理 30 天后自动解决。带有 --ttl 的备注在时间到期时自动解决，删除备注所关联的屏幕或播放列表也会解决该备注。已解决的备注可阅读 30 天，之后删除。每个组织跨其所有项目最多持有 200 条未解决备注。

agent status 和 login 在备注为新建或待复查时添加警告 notes_waiting。screen show 和 playlist show 在有未解决备注与该屏幕或播放列表相关时添加 notes_about_resource。添加备注会将 note.added 追加到事件日志，解决备注会追加 note.resolved；两者都不包含备注内容。阅读备注不会扣减额度。

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."