Communitygithub.com

DemoDay

将代码仓库(GitHub 或本地文件夹)及其网页应用或原生 macOS 应用,一键转化为 45–75 秒的 1080p 演示视频,风格与产品自身设计一致。

DemoDay 是什么?

DemoDay 是一款基于 Node/TS 的 CLI 工具,能够将任意 GitHub 仓库或本地文件夹及其对应的 Web 应用或原生 macOS 应用转化为专业的演示视频。它通过分析仓库代码和应用界面自动提取设计主题(颜色、字体、图标),并生成故事板(plan.json),然后使用 Playwright(Web)或 macOS Accessibility API(原生应用)进行录制,最终通过 Remotion 渲染为 MP4 文件。视频包含自动缩放、字幕、音效,并支持“痛点-解决方案”叙事结构。该工具无需 API 密钥,所有处理均在本地完成,适合开发者快速制作产品发布、演示或教程视频。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/amoveablefeastym/demoday/tree/HEAD

在你喜欢的 AI 中提问

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

文档

DemoDay 是做什么的?

将代码仓库(GitHub 或本地文件夹)及其网页应用或原生 macOS 应用,转化为 45–75 秒的 1080p 演示视频,风格如同产品自己的设计师制作。该工具是一个 Node/TS CLI,随本技能一同提供。您 是导演:您编写故事板(plan.json);工具负责录制和渲染。无需 API 密钥。

0. 查找并设置工具(TOOL)

TOOL 是 此技能的基准目录,前提是它包含 package.json(正常安装:整个仓库克隆到 ~/.claude/skills/demoday)。否则为 ~/demoday。如果两者都不存在,请停止并引导用户查看 README 中的安装步骤。

在机器上首次运行(当 TOOL/node_modules 缺失时):

  1. 检查 node --version(需要 ≥ 20)。如果缺失,告诉用户安装 Node.js(brew install node 或 nodejs.org)并停止。
  2. 在 TOOL 中运行 npm install && npx playwright install chromium。它会下载约 300 MB,因此请先告知用户。
  3. 对于 Mac 应用,还需检查 xcrun swiftc --version。如果缺失,请用户运行 xcode-select --install。辅助工具会在首次使用时自行编译。

以下所有命令均在 TOOL 中运行。OUT = out/<owner>__<repo>(由工具打印)。视频保留在 TOOL/out/ 内,因此请告知用户完整路径。

1. 收集

npx tsx src/cli.ts <owner/repo or github url> [--url <live app url>] --prepare

需要一个可用的 Web URL(--url,否则为仓库的主页)——或者,对于 原生 macOS 应用,请参见下方的“原生 Mac 应用”部分。此命令读取仓库并探测应用,将以下内容写入 OUT: prompt.md(导演规则 + README + 清单 + 文件树 + 无障碍快照)、probe.png(首屏截图)、probe.aria.yml。

阅读 prompt.md 并查看 probe.png。阅读 src/schema.ts——它是 plan.json 的确切结构,其字段描述即为规则(字数限制,每个节拍必须完成什么)。

2. 在编写任何内容之前找到故事

视频的成败取决于两件事:现状为何糟糕 以及 这个产品有何特别之处。

  • 现状:目标用户 今天 在没有此产品的情况下完成的具体工作流程,每一步都要有诚实的时间成本。只对具名的竞争对手提出公平的声明。
  • 特别之处:实现这一点的 机制(来自 README/代码),而不是形容词。“只有 X …”。
  • 阅读代码以了解 README 未充分推销的功能:始终存在的桌面或菜单栏图标、全局热键、离线/本地存储、吉祥物。这些往往是真正的差异化优势。在将任何功能放入视频之前,先在代码中验证它。
  • 如果用户告诉了您他们的定位、竞争对手或差异化优势,请使用他们的。如果没有任何信息表明其与众不同,请在编写计划之前先问一个简短的问题。

3. 匹配应用的风格(必需)

视频必须看起来像应用的一部分:相同的颜色、相同的字体、相同的吉祥物或图标、相同的语调。在一个温馨的柔和色彩应用上使用通用的深色启动模板(反之亦然)会显得与品牌不搭。用户会立即注意到。

  1. 从代码中提取应用的设计令牌:
    • SwiftUI/AppKit: Theme.swift 风格的文件、Assets.xcassets/*.colorset、Color(hex:) 调用。
    • Web: CSS 自定义属性、tailwind.config.*、主题文件、`<meta name=

相关技能