Communitygithub.com

screen-demo

通过代码将任何网页或Web应用录制成精美的演示视频(及GIF)。Claude会查看页面、规划导览,然后脚本在Chromium中模拟流畅的光标、真实点击、输入和缓动滚动,最终渲染出带有缩放、高亮圈、字幕和标题卡的1920x1080(或竖屏/正方形)视频。

screen-demo 是什么?

screen-demo 是一个AI驱动的技能,旨在将任何URL转化为专业演示视频。它模拟人工操作(滚动、点击、输入),以30fps逐帧捕获页面渲染内容(而非桌面),保证流畅度。支持多平台:Windows/macOS/Linux,依赖Python、Playwright和ffmpeg。工作流分为inspect(查看页面结构)、编写tour.json(定义导览步骤)、record(录制并渲染视频)和render(仅修改字幕/缩放时无需重新录制)。最终输出MP4(可选GIF),适合用于README、YouTube、社交媒体等场景。该技能强调安全:拒绝密码/支付字段,不登录不提交敏感数据,并提示用户尊重网站的使用权限。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/gabrielebolognese/screen-demo/tree/HEAD/skills/screen-demo

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

screen-demo 是做什么的?

将URL转换为演示视频。你就是导演:你查看页面,将导览编写为JSON,然后脚本播放导览、捕获页面自身的帧(而非桌面)并剪辑视频。滚动、光标滑动和打字都以30fps逐帧捕获,即使在复杂页面上也流畅自如;页面在点击或加载后自行发生的变化则来自实时屏幕录制。

一次性设置

  1. 需要 Python 3.10+,安装 Pillow 和最新 Playwright:python -m pip install -U playwright pillow,然后执行 python -m playwright install chromium。
  2. ffmpeg 需加入 PATH 环境变量(winget install ffmpeg 或 brew install ffmpeg)。

验证:执行 python tests/selftest.py(本地页面,无需网络,大约一分钟)。

工作流程

  1. 询问视频用途: URL、需要展示的2到4个要点(如首屏、某个功能、价格、注册流程)、格式(landscape 16:9 适合 YouTube 和 README,vertical 9:16 适合 Shorts 和 Reels,square),以及是否需要 GIF。仅限于用户自己的网站或应用,或用户有权展示的公开页面。
  2. 查看页面: python scripts/demo.py inspect URL WORK [--format vertical]。阅读 WORK/ 目录下每张 page-N.jpg(按视口大小切割的页面截图,每个可点击元素用红色数字框标出)以及 elements.txt。Cookie 横幅或弹窗会在这里出现:导览的第一步应关闭它(点击“拒绝”或“关闭”按钮)。
  3. 编写 WORK/tour.json(格式详见 references/tour-format.md):包含一张标题卡,然后是简短的步骤。一个好的导览示例:一张说明产品功能的字幕;滚动到第一个值得看的内容;放大它;点击或输入以演示产品工作;高亮结果;每个想法配一条字幕。时长15到40秒。目标元素可通过 inspect 中的编号(#12)、css=... 或 text=... 指定。
  4. 录制: python scripts/demo.py record WORK/tour.json OUT [--gif]。脚本播放导览,打印每个失败的步骤,并渲染 OUT/demo.mp4(及 OUT/demo.gif)。
  5. 查看 OUT/keys.jpg(每步骤的关键帧)以确认最终效果:缩放位置错误、字幕遮挡了画面重点、步骤失败(元素移动或隐藏)、仍有横幅遮挡。如果只需修改字幕、缩放或标题卡,可直接编辑 OUT/tour.json,然后执行 python scripts/demo.py render OUT [--gif](无需重新录制);其他改动则需重新录制。
  6. 交付: 提供 demo.mp4(及 GIF)的路径、时长,以及每个展示想法的简要说明。

规则

  • 绝不允许使用密码登录、输入密码或卡号(脚本会拒绝密码和支付字段),不允许购买、发送、删除或发布内容,不允许提交包含他人个人数据的表单。如需演示登录后的区域,用户应自行提供测试账号的页面。
  • 默认拒绝 Cookie 横幅(最小化数据收集),除非用户另有说明。
  • 字幕保持简短(3至8个单词);每条字幕表达一个想法;视频本身的动态效果可以补充说明。
  • 尊重网站权益:不得导览用户无权展示的页面。

示例

用户:“为我的落地页 https://example.com 制作一个20秒的演示视频,用于 README,展示注册功能”

你运行 inspect 后阅读了3张切片,发现一个 Cookie 横幅(#2“全部拒绝”)、首屏、一个“立即试用”输入框(#9)以及一个定价卡片(#21);你编写了导览:一张标题卡,点击 #2,字幕“自动记录的笔记”,在 #9 中输入文字,点击 #10,高亮结果,字幕“永久免费”,滚动到 #21,放大;使用 --gif 录制,打开 keys.jpg 确认缩放成功框住了价格,然后回答 demo.mp4(21秒)、demo.gif(3MB)以及四个展示要点。

相关技能