别人分享一个好用的 GitHub 项目。 你点了 Download ZIP，解压后全是文件夹，没有一个像安装程序。
卡住的原因，可能是入口选错了。
GitHub 上既有可以直接打开的网站，也有安装包、学习资料、插件和项目源码。拿到链接后，先往下找到 README（项目说明），再按“我想拿它做什么”选路。
不用先学会给仓库分类。仓库就是作者放项目文件和说明的地方；同一个仓库，也可能有好几种用法。
下面的操作依据官方说明整理。每条路线都看四件事：入口在哪、在哪里操作、做到什么算成功、卡住先查什么。
图 1｜按这次想做的事选路，同一个项目可以有多种用法。
① 我只想直接用：找在线入口
识别词：Website、Try online、Editor。
比如 Excalidraw。你想画流程图，点 README 中的 Excalidraw Editor，进入画布，画两个方框、写上文字、连一条箭头即可。
这些操作都在浏览器里完成。如果要把图带走，再使用导出功能，保存后打开文件检查。
页面里的 npm 安装命令，是另一种用途：把白板接进自己的程序。只是画图，用不着先做这一步。
注意：Demo 有时只有视频。能实际操作的页面，才是在线使用入口。只有宣传页或展示视频，就回 README 找 Usage（使用说明）或作者提供的其他入口。
② 我想学做法、找素材：找目录和具体资源
识别词：Docs、Tutorial、Gallery、Examples。
比如 awesome-ai-motion。先进入作品画廊，找到想参考的效果，再看它提供了什么：
- 只有成片：参考画面和节奏。
- 有提示词：按说明，在对应工具里使用。
- 有源码：继续看该案例自己的运行步骤。
下载整个案例库，不会让所有动效自动跑起来，也不会补出作者没公开的过程。链接失效时，先找案例保留的作者原帖；没有公开的制作资料，就保留这个缺口。
再看一个更简单的例子：HowToCook。在 README 的菜谱目录点一道菜，看到材料、用量和做法，再保存具体页面链接，这次查资料就完成了。
它也有本地部署和 Docker 说明，但只想看菜谱，可以跳过。点网页打不开时，回仓库目录找对应菜谱文件。
图标、字体、素材文件也是同样的思路：只拿需要的文件，先核对格式、适用软件和使用许可。能在目标软件里打开或使用，才算拿对。 导入失败先查格式和版本，不必把整个仓库重新下载一遍。
③ 我想装在电脑上：先分清成品软件和命令行工具
识别词：Download、Installation、Releases；命令行用法还可能写 CLI、Command line、Usage。
以录屏工具 OpenScreen 为例，先看 Installation，按自己的系统进入官方安装渠道。若从旧链接进来，注意原仓库已经归档，作者指向了现在的社区续作。
当前说明中，macOS 需要 13 或更高版本，下载与芯片相符的 .dmg；Windows 推荐从 README 指向的 Microsoft Store 安装；Linux 按发行版选择。Mac 芯片类型可以在“关于本机”查看，安装前再核对当前系统要求。
若说明指向 Releases，打开版本，再展开 Assets 文件列表，选择对应安装包。特别注意：
- Code → Download ZIP 下载的是项目文件快照。
- Releases → Source code 也是源码归档。
- 它们不等于可以直接安装的软件。GitHub 源码下载说明
图 2｜认准下载入口和作者说明，不凭“.zip”后缀下结论。
安装后，按官方说明处理录屏所需权限，先录五秒不含隐私的画面。停止录制，进入编辑器，再从 Export 导出 MP4，找到文件并播放。只保存 .openscreen 工程，还没得到可以直接播放的视频。OpenScreen 导出说明
打不开，先查系统与安装说明；能打开却不能录，先查权限；能录却没有声音，再查对应系统的音频设置。
还有些工具本来就通过终端使用，不会出现桌面窗口。
比如 HyperFrames，同一个项目既有 Skill 用法，也有手动 CLI 用法。想让 AI 帮你创作，就看兼容助手的安装说明；想自己敲命令，就看手动 CLI。
手动路线当前要求 Node.js 22+ 和 FFmpeg。准备好后，在电脑终端进入存放练习项目的文件夹，逐行执行。这里用 my-hyperframes-video 作示例，已有同名文件夹就换个新名字：
npx hyperframes init my-hyperframes-video
cd my-hyperframes-video
npx hyperframes preview
打开终端显示的本地地址，检查预览。预览会占用这个终端；可以保留它，另开一个终端，进入同一个项目文件夹，再执行：
npx hyperframes render
按终端报告的输出路径找到视频并播放，这次操作才算完成。命令找不到先核环境，文件找不到先核当前目录，渲染报错就带着第一条具体错误查官方文档和 Issues。
不要一看到安装命令就选 CLI。那段命令也可能只是为了安装 Skill，或者开发源码；要看它最终替你做什么。
④ 我想给现有工具加能力：先确定“装给谁”
识别词：Plugin、Extension、Skill。
浏览器扩展装进浏览器，编辑器插件装进编辑器。Skill 也要看支持哪个助手、装在哪个目录，不能随便下载一个文件夹就算完成。
先核对宿主工具与版本。“宿主”就是承载这个插件或 Skill 的工具。再按官方入口安装、启用，最后用一个小任务检查有没有生效。扩展无反应，先查是否启用和站点权限；插件不工作，先查支持的文件类型及安装范围。
比如 Remotion 的 Agent Skills，用于辅助编程助手制作视频。它和视频项目要配合使用，不是一个双击就能播放的成品，也不会替你开通模型服务。
图 3｜这是配合关系，不是安装顺序；具体操作按下文进行。
想从零试做，可以按下面的顺序。
第一步，准备环境和已经能用的编程助手。
先安装 Node.js，以及支持这些 Skills 的助手，完成登录和一次普通对话。相关助手服务可能需要订阅。还要核对 Remotion 当前系统要求，例如当前本地运行要求 macOS 15 或更高版本；能安装 Skill，不代表已经满足视频渲染条件。
Mac 打开“终端”，Windows 打开终端或 PowerShell。输入下面两行，每行执行后按回车：
node --version
npm --version
两条都显示版本号，再继续。找不到命令，先重开终端、核对 Node.js 安装情况。
第二步，没有视频项目，就创建一个；已有项目，就进入原目录。
第一次练习，先进入专门存放项目的文件夹：输入 cd、空格、文件夹完整路径；路径有空格时，用英文双引号包住。
在这个父文件夹里逐行执行：
npx create-video@latest --yes --blank my-video
cd my-video
第一行创建空白项目，第二行进入它。my-video 是示例名字，不能覆盖已有同名文件夹。进入后，应能看到 package.json 等项目文件。官方新建项目说明
如果已有能运行的 Remotion 项目，直接进入它的根目录，按原 README 准备依赖，不再创建一套。如果只是普通网站项目，还没接入 Remotion，就按现有项目接入说明处理。
第三步，在视频项目目录里安装 Skill、启动预览。
继续逐行执行：
npx remotion skills add
npm run dev
安装界面出现选择时，选自己实际使用的助手和安装范围。已有正确安装并被识别的 Skill 就沿用，不需要重复安装另一套。
保留这个终端，打开它显示的本地网址。地址和端口以实际输出为准。以上顺序来自 Remotion 官方编程助手入门；已有项目的启动命令不同时，以原 README 为准。
第四步，让助手在同一个项目里做一个小任务。
用桌面助手或编辑器，就在原工具里打开同一个 my-video 文件夹。用终端版助手，就另开一个终端，用完整路径进入这个文件夹，再按该助手自己的说明启动。已经在用 Codex 就继续用 Codex，不必为这一步另装 Claude Code。
确认助手能识别 Remotion Skill 后，给它这个任务：
做一个 5 秒文字动效：深色背景，“第一条视频”逐字出现。请使用 Remotion 技能，告诉我在预览里选择哪个视频。
空白项目只是起点。预览里选到这段视频，能播放并看见预期文字，才算这一阶段完成。
第五步，导出文件并真正播放。
在 Remotion Studio 检查文字、时长和画面，点 Render，核对格式及输出位置，再点 Render video。等导出完成，找到文件并从头播放到尾。官方导出说明
命令逐行执行，出错就停在那一步：找不到 package.json，先核当前目录；Skill 没被识别，核助手和安装范围；预览正常但导出失败，再查渲染报错。不要把命令输入 GitHub 搜索栏，也不要把终端版步骤套到所有桌面助手上。
⑤ 我想改成自己的项目：找模板、运行或接入文档
识别词：Template、Starter、Development、Library、SDK。
这里可以再分三种：
- 拿一套起点来改。 比如 Remotion Hello World 模板。下载、完整解压，在终端进入含
package.json的项目目录，按 README 安装依赖并启动。这个模板当前写的是先npm install，再npm run dev。先让原版示例跑起来，再改文字和颜色，刷新预览检查变化。 - 运行或修改已有源码。 找 Development、Build 或运行说明，核对环境后再操作。仓库能下载，不代表存在一条适用于所有项目的启动命令。
- 给已有程序加一个部件。 比如把 Excalidraw 放进自己的网站，要走组件接入文档，在已有项目里安装、导入并使用。打开在线画布，不等于已经把白板接进了自己的网站。
第一种和第二种，都要先看原版是否能运行，再看自己的修改是否生效；第三种要在自己的应用里看到功能，不能停在“包已安装”。
ZIP 和 clone 怎么选？ZIP 是拿一份源码快照；clone 是用 Git 取得仓库，方便后续版本操作。两者都不会自动把程序运行起来。
如果上一节已经创建了 my-video，就接着用它，不必再复制一套模板。遇到 Missing script 或找不到文件，先核对当前目录、README 和 package.json，不要把其他项目的命令直接搬过来。
最后，留一张不用 AI 也能用的选路卡：
- 想直接做事：找在线入口。
- 想学方法、拿资料：找目录和具体文件。
- 想在电脑上用：分清安装包与终端用法，核对系统和环境。
- 想增强已有工具：找对应插件或 Skill 的安装说明。
- 想做自己的项目：找模板启动、源码运行或组件接入文档。
配套的 GitHub 上手指南，也按这五种用途组织：先选想做的事，再对照你看到的入口，查看通用步骤和具体案例。它不要求项目必须已收录，也不需要粘贴网址让 AI 解析。
同一个仓库可以有多条路线。只画图和把白板放进网站，即使面对同一个 Excalidraw，步骤也不同。
下次打开 GitHub，先把“我想拿它做什么”写清楚，再找入口。完成自己的小任务，比把所有文件下载下来更重要。
如果你也经常卡在“好工具找到了，第一步怎么做”，可以继续关注这里的工具上手分享。