repo-demo-generator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Repo Demo Generator

代码仓库演示生成器

Generate demo assets from any codebase in 3 stages:
  1. Extract code context as
    <code="path">...
    blocks
  2. Generate outlines (hook outline + demo outline)
  3. Generate HTML (hook, demo, and merged)
通过3个阶段从任意代码库生成演示资源:
  1. 将代码上下文提取为
    <code="path">...
  2. 生成大纲(hook大纲 + 演示大纲)
  3. 生成HTML(hook、演示及合并版本)

Quick Start

快速开始

bash
.gemini/skills/repo-demo-generator/scripts/run_demo.sh .
bash
.gemini/skills/repo-demo-generator/scripts/run_demo.sh .

Common Commands

常用命令

bash
undefined
bash
undefined

Full hook+demo pipeline (default: mix mode)

完整的hook+demo流水线(默认:混合模式)

.gemini/skills/repo-demo-generator/scripts/run_demo.sh . --mode mix --hook random
.gemini/skills/repo-demo-generator/scripts/run_demo.sh . --mode mix --hook random

Force a specific hook template

指定特定hook模板

.gemini/skills/repo-demo-generator/scripts/run_demo.sh . --hook text
.gemini/skills/repo-demo-generator/scripts/run_demo.sh . --hook text

Demo only

仅生成演示

.gemini/skills/repo-demo-generator/scripts/run_demo.sh . --mode demo
.gemini/skills/repo-demo-generator/scripts/run_demo.sh . --mode demo

Hook only

仅生成hook

.gemini/skills/repo-demo-generator/scripts/run_demo.sh . --mode hook --hook 4methods
.gemini/skills/repo-demo-generator/scripts/run_demo.sh . --mode hook --hook 4methods

Skip non-critical paths and enforce scan token budget

跳过非关键路径并限制扫描令牌配额

.gemini/skills/repo-demo-generator/scripts/run_demo.sh . --mode mix
--ignore docs --ignore assets --ignore youtube
--token-limit 200000
.gemini/skills/repo-demo-generator/scripts/run_demo.sh . --mode mix
--ignore docs --ignore assets --ignore youtube
--token-limit 200000

Custom model and requirement

自定义模型与需求

.gemini/skills/repo-demo-generator/scripts/run_demo.sh .
--model gemini-3-pro-preview
--requirements "强调商业价值与一分钟内可读性"
undefined
.gemini/skills/repo-demo-generator/scripts/run_demo.sh .
--model gemini-3-pro-preview
--requirements "强调商业价值与一分钟内可读性"
undefined

Notes

注意事项

  • Core script:
    scripts/run_demo.sh
  • Scanner:
    scripts/scan_codebase.py
  • Default provider in
    .gemini
    path:
    gemini
  • Output directory default:
    ./.demos/demo_<timestamp>_<repo>/
  • Default scan token guard:
    200000
    estimated tokens; use
    --token-limit 0
    to disable.
  • Source scan default: unlimited (
    --max-chars 0
    ); set
    --max-chars <n>
    only when you need truncation.
  • 核心脚本:
    scripts/run_demo.sh
  • 扫描工具:
    scripts/scan_codebase.py
  • .gemini
    路径下的默认提供商:
    gemini
  • 默认输出目录:
    ./.demos/demo_<timestamp>_<repo>/
  • 默认扫描令牌限制:预估200000令牌;使用
    --token-limit 0
    可禁用该限制。
  • 默认源代码扫描:无限制(
    --max-chars 0
    );仅当需要截断时设置
    --max-chars <n>