用途：Astroshot 用统一 CLI 生成确定性的 PNG 截图与旅程影片，覆盖四种捕获边界：react（隔离浏览器 React 组件）、ink（固定 Ink 组件树）、pty（真实终端与键盘流程）、movie（多步旅程录制）。选择能证明目标状态的最小边界，不要为省事重建完整应用外壳。
常用命令：npx astroshot --help；astroshot demo 生成包含 stills、movie 与 manifest.json 的真实 .astroshot 集合，无需下载 Chromium；astroshot doctor 逐项检查 Node 版本、项目是否位于 Astroshots 监看目录、应用是否安装运行、托管 Chromium 是否就绪及 macOS 屏幕录制状态，失败行给出修复命令，且不安装或修改任何内容。安装浏览器：npx astroshot install-browser，Linux CI 可加 --with-deps。
安装与回退：当 archdev shots 已启用时，同一引擎以 archdev shots 命令组运行，先执行 archdev shots doctor 检测；否则使用独立 astroshot 命令。子命令与参数一致。若 npm 尚未提供，可用 node packages/astroshot/bin/astroshot.mjs --help。不要用旧的 react-shot、tui-shot、astroshot-movie 替代。
静态图流程：用 astroshot init react|ink|pty 生成 fixture，替换占位内容为生产导入或真实命令，使用合成数据、固定尺寸与基于内容的就绪检查，截图后检查裁切、换行、加载态、颜色、透明与隐私数据。React 与 Ink 支持批量：astroshot react batch ./shots.yaml 与 astroshot ink batch ./terminal-shots.yaml。
影片流程：先运行 astroshot movie which-source "<intent>" 依据意图选择来源——Web/SPA 用 browser，TUI/CLI 用 pty，原生 macOS 窗口用 desktop.window，自有帧序列用 frames。同一旅程使用稳定 --run-id，并提供 --feature、--slug、标题与所证内容。desktop.window 仅限 macOS，默认拒绝离屏或近乎空白的帧，--allow-blank 为显式逃生口。
限制：astroshot 只产出图像或影片产物，不代表人工审核；不要从 manifest.json.status 推断 Seen。fixture、配置、导入与 PTY 命令以当前用户权限执行，临时 Vite 服务器、Chromium 或伪终端不是安全沙箱，捕获前应审阅不可信改动。其他收费、价格与平台细节暂未提供。