用途：Astroshots 把捕获工具产生的图像或流程影片送到真人面前评审，并回写反馈。捕获工具负责产出画面，Astroshots 负责传输画面并把人的评审意见写入 review.json。它是仅菜单栏的 macOS 应用，可跨多个被监视的工作树保持一条流。
主要能力：监视 .astroshot/ 目录树；新帧以桌面叠加层闪出；菜单栏托盘显示流，可过滤影片、显示时长与播放叠加层，并在托盘或全屏评审中播放视频（支持拖动、音量、全屏控制）；manifest.json 记录捕获执行状态，review.json 记录人工反馈；评审状态分为 unseen、stale、seen，结合 run_id 与图像哈希判断。可选的原生 archdev shots 支持把捕获、渲染、状态查询、上传与拉取评论并入 archdev 命令组。
使用方式：在捕获源已存在后开始。从工作树根写入 .astroshot/<feature>/ 下的 manifest.json、review.json 及按零填充序号加 slug 命名的图片；影片会额外写入 poster PNG 与视频负载（如 .webm）。可用 astroshot-capture（或 archdev shots capture）传入 --feature、--slug、--source 或 --from-agent-browser、--title、--description、--url、--viewport、--status、--run-id、--root、--finalize 等参数，结束时用 --status pass --finalize 收敛执行状态。影片录制前需先定 --source：网页/SPA 用 browser，TUI/CLI 用 pty，原生 Mac 窗口用 desktop.window，自定义 PNG 序列用 frames。原生支持检测可运行 if command -v archdev >/dev/null 2>&1 && archdev shots doctor >/dev/null 2>&1; then NATIVE=1 ... fi，doctor 退出码 0 表示该功能已安装并启用（archdev settings set shots on），否则走独立路径。终端评审可用 npx astroshot review。排障从诊断开始：astroshot doctor、astroshot doctor --json、astroshot demo。
适用场景：需要在开发流程中把 UI 截图或端到端流程影片交给真人快速过目并收集意见的场景，包括网页、TUI、原生 Mac 窗口和自定义帧序列。
限制：desktop.window 仅限 macOS，使用系统 screencapture 加该包自带的 Swift 窗口列表，需要屏幕录制 TCC 权限。评审与 poster 文件名/哈希绑定，替换 poster 会使已见状态失效。不要自行编辑 review.json 把自己的成果标为 Seen。一次性 harness 帧不要放在保留目录 .astroshot/stories/ 或 .astroshot/friction-logs/ 下，这两者用于智能体用户故事场景。上述资料未提供收费、价格或其他平台支持信息。