CLIPY 实战指南

想法录一次,从头用到尾。

把一段录屏变成清晰的交接、智能体上下文、已上线的修复以及结果可用的证明,完整流程都在这里。

快速解答

用 Clipy 录下你想讲清楚的那件事,借助 Flare 和讲解让重要时刻一目了然,再把同一个链接分享给人或 AI 智能体。Clipy 还能把 YouTube 视频变成智能体上下文,并把智能体的验证过程录下来作为证明。

从这里开始

应该用哪个录制工具?

无论用哪个,最后得到的都是同一种分享链接。按你要展示的内容选择录制工具即可。

Mac 应用

最适合 Flare、系统音频、原生应用和精确的 Mac 窗口。

获取 Mac 应用

Chrome 扩展

最适合快速录制标签页,可选附带已脱敏的 bug 诊断信息。

添加到 Chrome

视频指南

我该怎么……?看一段一分钟的指南。

用 Clipy 本身录制的简短讲解指南。每一个都会打开完整讲解该任务的页面,视频就在页面顶部。

01 · MAC 应用

怎样指示而不遮挡屏幕?

打开 Flare,你的光标就会变成临时的聚光灯。它把“看这里”变成一条可见的轨迹,同时记录在录像和 Clipy 的指针证据中。

  1. 1在原生的 Clipy Mac 应用中开始录制。
  2. 2在录制控件中打开 Flare。
  3. 3按住 Control,把指针绕着你说的元素移动。标注完成后松开。
  4. 4一边指示一边讲出重点:问题是什么、期望的状态是什么,或者精确测量出的差异。

最佳习惯:圈一次,在目标上停一下,说出一条完整的指令。快速乱画看起来很有劲,但给观众和智能体的可用证据反而更少。

Clipy Flare 用逐渐淡出的橙色光标轨迹高亮录制画面的一部分
How to point at what you mean: Flare, hover, clicks and the pen Watch on Clipy
AI 智能体用 Clipy 包裹测试命令,返回证明录像和 AREC 文档

02 · 智能体录制

你的智能体怎样证明它的工作真的有效?

让智能体录下验证过程,而不只是报告“测试通过”。Clipy 会包裹这次运行、录下界面,交给你一段普通视频,外加另一个智能体能读取的结构化证据。

clipy session run --url http://localhost:3000 --type bug -- npx playwright test
  1. 1为当前智能体设置 Clipy,只需一次。安装和录制始终需要你明确授权。
  2. 2告诉它要演练哪些用户可见的行为,以及怎样才算成功。
  3. 3让它在操作前、操作中和操作后的关键时刻添加证据标记。
  4. 4要求两项输出:给人观看的 URL,以及规范的 .arec 上下文 URL。

被包裹的命令失败时会被丢弃,成功时才会上传。Clipy 记录证据,但这些标记描述的仍是执行者观察到的情况,并不能独立证明该结论。

03 · 视频上下文

怎样把 YouTube 视频交给智能体?

不要让智能体凭标题猜,也不要让它硬啃整段视频。Clipy 会把 URL 变成一个 AREC 包,包含带时间戳的转写片段、画面缺口说明,以及可用时挑选的画面。

clipy context import "https://youtu.be/..." --sync --json
  1. 1粘贴 YouTube URL,并说明你希望智能体从中学到或实现什么。
  2. 2让 Clipy skill 执行导入。先获取字幕,再在视觉证据重要的时刻挑选画面。
  3. 3智能体先读取元数据和画面缺口,搜索你的问题,然后只打开相关的转写片段和附近的画面。
  4. 4如果部分结果已有转写上下文但画面仍在处理中,重新运行同一个导入即可;导入是幂等的。
打开完整的 YouTube 上下文指南
Clipy 把 YouTube URL 导入为带时间戳的转写和挑选出的智能体可读画面
一段 Clipy bug 录制变成 AREC 证据,再由 AI 编程智能体完成修复

04 · 从 BUG 到修复

怎样录制 bug,才能让智能体把它修好?

录一次干净的复现,并说出你期望的结果。普通的观看链接就够了:安装 Clipy skill 后,智能体会获取请求、计划、关键时刻、指针证据、录制缺口和转写。

  1. 1从一个已知状态开始,说明相关的浏览器、账号角色、测试数据和路由。
  2. 2每个操作讲一次。故障出现时停一下,说明实际结果和预期结果。
  3. 3在 Chrome 扩展中打开 Capture bug context,附上控制台错误、未处理的拒绝、失败的请求、GraphQL 错误和 WebSocket 活动。该选项默认关闭。
  4. 4把 Clipy 链接粘贴给你的编程智能体:“复现这个问题,修复根本原因,运行相关检查,并用 Clipy 发来修复的证明。”

隐私边界:证据在上传前就在你的浏览器中脱敏,Cookie 从不读取,请求头和请求体只有在开启 Full network detail 时才会保留。控制台消息是页面写入的自由文本,所以请避免录制敏感界面,并在分享前检查。

05 · 设计迭代

怎样把设计反馈变成同一次会话内的修复?

对照设计稿走一遍已构建的界面。用 Flare 让“这个元素”毫无歧义,再用智能体能直接修改的差异来表达:当前值、目标值、token 和状态。

这样说

“这个 CTA 的水平内边距是 20 像素。设计稿用的是 32 像素,也就是我们的 --space-8 token。”

不要这样说

“这个按钮看起来有点挤。”

  1. 1打开设计稿作为参考,但要录制开发者将要修改的真实构建。
  2. 2把布局、字体、颜色、圆角和交互状态分别记录成独立的、有数值的说明。
  3. 3把录制链接交给开发者的智能体,让它把每一处差异对应到负责的组件和 token。
  4. 4让智能体重新构建,录下修正后的状态,并返回证明链接,供设计师做最后的视觉检查。
设计师用 Clipy Flare 指出界面不一致之处,智能体应用并验证测量得到的 CSS 改动

完整闭环

充分发挥 Clipy 的作用是什么样子?

  1. 01

    录制

    展示真实的界面。

  2. 02

    说明

    指出并讲清意图。

  3. 03

    交接

    粘贴一个普通链接。

  4. 04

    证明

    录下可用的结果。

快速参考

开始之前需要知道什么?

应该用哪个 Clipy 录制工具?
想用 Flare、系统音频或录制真实应用窗口时,用原生 Mac 应用。想快速录制标签页、窗口或屏幕,并可选附带已脱敏的 bug 诊断信息时,用 Chrome 扩展。想马上开始、不安装任何东西时,用网页录制器。
AI 智能体怎样读取 Clipy 录制内容?
安装一次 Clipy skill,然后把普通的 Clipy 观看链接粘贴到 Claude Code、Codex、Cursor、Windsurf 或 OpenCode 中。skill 会获取该录制内容的规范 AREC 文档,其中包含请求、关键时刻、视觉证据、录制缺口和转写。
Clipy 能为智能体提供 YouTube 上下文吗?
能。Clipy CLI 可以把 YouTube URL 导入为 AREC 包,包含带时间戳的转写和可用时挑选的画面。使用 --sync 时,生成的文本和挑选的画面会进入你私有的 Clipy 上下文库;该流程不会上传原视频本身。
AI 智能体能用 Clipy 录下自己的工作吗?
能。Clipy CLI 可以包裹无头浏览器的验证命令,录下这次运行,添加证据标记,并返回观看 URL 和 AREC 上下文 URL。对于原生窗口,在用户授权录制后,它可以录制指定的 Mac 屏幕或窗口。
设计反馈录制中应该说什么?
一边指着确切的元素,一边说出当前值、目标值和相关 token。例如:‘这个按钮的水平内边距是 20 像素;设计稿用的是 32 像素,也就是我们的 space-8 token。’这样编程智能体得到的是具体的差异,而不是一个形容词。
Clipy 会在浏览器诊断信息中捕获机密吗?
Bug 捕获会在上传前于你的浏览器中脱敏。令牌、密钥、邮箱和卡号无论出现在哪里都会被移除,包括控制台文本,Cookie 也从不读取。只有当你同时开启 Full network detail 时,请求和响应的头部、正文以及查询参数值才会保留,而且名称类似密码、令牌或个人数据的字段会被替换为 [redacted]。

让你的下一段录制成为工作可以接着推进的起点。

录下上下文,指出重点,让同一个链接把任务从讲解带到实现,再到证明。