remotion-candlestick
在 Remotion 项目中创建带动画的金融 K 线图(蜡烛图)。涵盖数据获取(Yahoo Finance)、 插件架构(config / timeline / Scene / plugin)、Canvas 逐帧绘制、深色交易终端风格、 以及 Remotion Studio 预览和渲染输出。触发词:K线图、蜡烛图、candlestick、OHLC、 股票动画、金融图表视频、Remotion 图表。
Install / Use
npx skills add vibe-motion/skills --skill remotion-candlestickInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
DesignSupported Platforms
Our assessment of remotion-candlestick
remotion-candlestick scores 89/100 on our quality scale, 104th of 260 Design skills we index (top 40%).
Its SKILL.md is 5.8 KB long, well organised into 21 sections with 14 code examples: a solid amount of guidance for an agent.
With 1,266 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so remotion-candlestick is actively maintained.
- Our last check on 2026-10-31 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
remotion-candlestick compared with similar skills
All 4 of these similar skills score higher than remotion-candlestick; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| remotion-candlestick (this skill)by vibe-motion | 89 | 1.3k | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.4k | 3d ago | MCP Server |
Frequently asked questions
- How do I install remotion-candlestick?
- Run
npx skills add vibe-motion/skills --skill remotion-candlestick. The install tabs above show the steps for each supported agent. - Which AI agents does remotion-candlestick work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is remotion-candlestick safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is remotion-candlestick still maintained?
- The repository was last updated about 2 months ago, so remotion-candlestick is actively maintained.
Skill content
View source on GitHubname: remotion-candlestick description: > 在 Remotion 项目中创建带动画的金融 K 线图(蜡烛图)。涵盖数据获取(Yahoo Finance)、 插件架构(config / timeline / Scene / plugin)、Canvas 逐帧绘制、深色交易终端风格、 以及 Remotion Studio 预览和渲染输出。触发词:K线图、蜡烛图、candlestick、OHLC、 股票动画、金融图表视频、Remotion 图表。 metadata: type: project
Remotion 蜡烛图 (Candlestick) 动画制作流程
本 skill 记录了在 vibe-motion-app 这个 Remotion 项目中创建 S&P 500 K 线图的完整制作过程。
前置条件
- Remotion 4.0.438 项目,已配置 React 19 + TailwindCSS v4
- 插件架构:
motion/定义场景,remotion/处理 Remotion 合成管线 - pnpm 作为包管理器
步骤 1:获取金融数据
Yahoo Finance 提供免费的历史 OHLC 数据(无需 API Key)。
创建 scripts/fetch-sp500-data.mjs:
// 核心:调用 Yahoo Finance Chart API
const url = `https://query1.finance.yahoo.com/v8/finance/chart/%5EGSPC?period1=${PERIOD1}&period2=${PERIOD2}&interval=1wk`;
const resp = await fetch(url);
const json = await resp.json();
const result = json.chart?.result?.[0];
const ts = result.timestamp;
const quote = result.indicators.quote[0];
// 提取 { t: timestamp, o: open, h: high, l: low, c: close }
保存到 public/data/sp500-weekly.json,供 Remotion 通过 staticFile() 加载。
参数说明:
%5EGSPC= S&P 500 的 Yahoo 符号(^GSPCURL 编码)interval=1wk= 周线;可选1d,1moperiod1/period2= Unix 时间戳,覆盖约 40 年(1984-2026)
步骤 2:创建插件文件结构
每个 Remotion 插件需要 4 个核心文件 + 渲染预设:
motion/插件名/
config.js → 默认参数
timeline.js → 场景上下文 + 逐帧动画计算
Scene.jsx → React 组件(Canvas 绘制)
plugin.js → 插件注册对象
render-presets/
default.json → 渲染预设
2a. config.js — 默认参数
export const DEFAULT_LAYOUT_PARAMS = Object.freeze({
videoWidth: 1920, // 16:9 横屏
videoHeight: 1080,
});
export const DEFAULT_ANIMATION_PARAMS = Object.freeze({
durationSeconds: 28, // 动画总时长
title: "S&P 500",
subtitle: "过去40年 · 周线K线图",
});
export const DEFAULT_MOTION_PROPS = Object.freeze({
...DEFAULT_LAYOUT_PARAMS,
...DEFAULT_ANIMATION_PARAMS,
});
2b. timeline.js — 动画逻辑
必须实现三个核心函数:
// 1. 场景上下文:验证 + 强制类型转换所有参数
export const resolveXxxSceneContext = (pluginParams) => { ... }
// 2. 时长计算:durationSeconds * fps
export const getXxxDurationInFrames = ({ fps, sceneContext }) => { ... }
// 3. 逐帧 props:从 frame/fps 计算 progress 等动画值
export const buildXxxSceneProps = ({ frame, fps, loop, sceneContext }) => { ... }
关键设计原则:所有动画状态仅依赖 frame 参数,满足 Remotion 并行渲染要求。
2c. Scene.jsx — Canvas 绘制组件
使用 <canvas> 而非大量 DOM 元素,性能更好。
数据加载模式:
const [dataHandle] = useState(() => delayRender("Loading data"));
useEffect(() => {
fetch(staticFile("data/xxx.json"))
.then(r => r.json())
.then(data => { setData(data); continueRender(dataHandle); })
.catch(err => cancelRender(err));
}, [dataHandle]);
Canvas 绘制核心逻辑:
const draw = useCallback(() => {
const ctx = canvas.getContext("2d");
const dpr = window.devicePixelRatio || 1;
// 高清屏适配
canvas.width = W * dpr;
canvas.height = H * dpr;
ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
// 1. 背景填充
// 2. 网格线 + Y轴价格刻度
// 3. 蜡烛绘制(wick + body)
// 4. X轴年份标签
// 5. 标题/副标题/统计信息
// 6. 进度条
}, [data, progress, ...]);
useEffect(() => { draw(); }, [draw]);
蜡烛绘制关键参数:
const CANDLE_GAP_RATIO = 0.28; // 蜡烛间距比例
const CANDLE_FADE_FRAMES = 22; // 入场动画帧数
const MAX_CANDLE_W = 8; // 最大蜡烛宽度(按缩放后)
const MIN_CANDLE_W = 0.6; // 最小蜡烛宽度
// 蜡烛宽度随可见数量自适应
const slotW = plotWidth / visibleCount;
const bodyW = Math.max(MIN_CANDLE_W, Math.min(MAX_CANDLE_W * scale, slotW * (1 - GAP_RATIO)));
入场动画(fade-in + 从底部生长):
const appearFrame = (i / (N - 1)) * revealEndFrame;
const candleAge = currentFrame - appearFrame;
const fadeAlpha = Math.min(1, Math.max(0, candleAge / CANDLE_FADE_FRAMES));
// 生长动画
if (candleAge < CANDLE_FADE_FRAMES && candleAge > 0) {
const growT = easeOutCubic(candleAge / CANDLE_FADE_FRAMES);
displayBodyBottom = lerp(lowY, bodyBottom, growT);
}
ctx.globalAlpha = fadeAlpha;
// ... 绘制 wick + body ...
ctx.globalAlpha = 1;
深色主题色彩:
const COLORS = {
bg: "#1a1a19",
grid: "#2c2c2a",
upBorder: "#e66767", // 阳线边框(红)
upFill: "rgba(230,103,103,0.15)", // 阳线填充(半透明)
downFill: "#199e70", // 阴线填充(绿)
textPrimary: "#ffffff",
textSecondary: "#c3c2b7",
textMuted: "#898781",
accent: "#3987e5",
};
2d. plugin.js — 插件注册
export const xxxPlugin = Object.freeze({
id: "插件ID",
defaultProps: DEFAULT_MOTION_PROPS,
SceneComponent: XxxScene,
waitForSceneLayoutReady: true, // 等待数据加载完毕
resolveSceneContext: (params) => ...,
getDurationInFrames: ({ fps, sceneContext }) => ...,
buildSceneProps: ({ frame, fps, loop, sceneContext }) => ...,
getLayout: ({ sceneContext }) => sceneContext.layout,
});
waitForSceneLayoutReady: true 确保 Scene 组件调用 onAutoLayoutReady() 后才开始渲染帧。
2e. render-presets/default.json
{
"title": "S&P 500",
"subtitle": "过去40年 · 周线K线图",
"videoWidth": 1920,
"videoHeight": 1080,
"durationSeconds": 28
}
步骤 3:注册合成
修改 motion/project.js,将 ACTIVE_COMPOSITION 切换到新插件:
import { xxxPlugin } from "./xxx/plugin.js";
export const ACTIVE_COMPOSITION = Object.freeze({
id: "SP500Kline",
fps: 30,
plugin: xxxPlugin,
});
步骤 4:验证和渲染
# 验证合成注册
pnpm run remotion:compositions
# 启动 Studio 预览(支持时间轴拖拽、参数调整)
pnpm run dev
# 渲染单帧截图
npx remotion still SP500Kline out/frame.png --frame=420
# 渲染完整视频
npx remotion render SP500Kline out/output.mp4
# 使用预设渲染
REMOTION_PROPS_FILE=motion/xxx/render-presets/default.json pnpm run remotion:render
常见问题
Yahoo Finance API CORS 问题
在 Remotion 渲染环境(Node.js 无头浏览器)中不存在 CORS 问题。
如果浏览器预览遇到 CORS,使用 staticFile() 加载预获取的本地 JSON。
Canvas 在高 DPI 屏幕上模糊
始终乘以 devicePixelRatio:
canvas.width = W * dpr;
canvas.height = H * dpr;
ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
蜡烛数量过多导致宽度太小
设置最小宽度 0.6px,当 slotW < 1 时缩小间距比或聚合数据。
动画进度控制
使用分段缓动函数:
- 开头 3% 快速建立基线
- 中间 90% 匀速揭示
- 结尾可以略微减速增强戏剧感
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.4kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
