Skip to content

About

Gtrk-cli配套MG/OV动画技法skill

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

15 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gtrk-mg-techniques · MG 排版技法族

「整体排版 motion」这一族视觉传达技法的家——每个 skill 是一种技法(一种把东西摆上画面、动起来、把注意力引到某处的方式), 不绑定任何栏目、不带任何栏目审美。

产物有两类,按技法的性质定,不是二选一的风格偏好:

产物 什么时候是这类 怎么进工程
html-particle(gsap-emit v1) 画面元素可数、可用 DOM/SVG 表达、总字符进得了预算 gtrk mg 铺轨 / gtrk mg render 出透明 MOV
视频(mp4) 逐帧素材类——帧数或像素量注定超颗粒字符预算 在客户端拖进目标视频轨(gtrk 没有加任意 clip 的命令)

判据很硬:把内容内嵌成 data URI 之后进不了 1,900,000 字符预算的,就只能是视频。 比如 band-strobe 要在 3.6 秒里放 108 张 1920×360 的画面——没有任何压法能塞进颗粒。

这个仓为什么单开

成片管线里 MG 颗粒由栏目生产 skill 产(它懂栏目的视觉语法),但有一类东西跨栏目通用、又值得反复用: 文献页叠放发牌、新闻截图局部强调、聊天记录回放、数据卡翻面……它们是技法而不是模板—— 脚本只做机械活(图片重编码、几何、时间线发射),给什么内容、强调哪里、什么时候动仍由调用它的 agent 按口播现场决定。 把这一族收在一个仓里,任何栏目 skill 或 agent 都能按需取用,而不必各自重写一遍。

技法目录

skill 示意 产物 一句话 典型触发
doc-reveal doc-reveal 示意 颗粒 文献 / 文档页「叠放 · 发牌 · 局部强调」:多页纸落成一叠,镜头推近某一行,荧光笔划过,旁边落文案卡 「引用这篇论文」「新闻截图叠放展示」「把这段文字圈出来放大」
band-strobe band-strobe 示意 视频 横带频闪蒙太奇:画幅横切成几条带,每条带各自快切不同画面、切点相位错开,叠 RGB 错位与洗白调色 「做个片头 / OP」「开场频闪」「闪回蒙太奇」「glitch 快切」
chat-replay chat-replay 示意 颗粒 聊天记录回放:对话气泡逐条弹出,对方「正在输入」、我方在输入框里逐字打出,排满上推,说到哪句就描边 + 荧光笔(可推近) 「把这段聊天记录做成动画」「群聊对话逐条弹出」「情景还原一段对话」
candle-chart candle-chart 示意 颗粒 K 线图动画:蜡烛逐根从开盘价长出、均线笔尖跟着推进,再落点位标注、支撑 / 压力线与区间高亮;验收从纵轴刻度反推价格与数据对账 「把这段走势画出来」「K 线动画」「标出最高点和最低点」「画条支撑线」
globe-arcs globe-arcs 示意 颗粒 点阵地球飞线:陆地点阵地球自转,按口播把城市转到正面 / 推近,城市间飞出大圆弧(常亮线或彗尾),落地泛起透视光圈 「地球飞线」「全球航线示意」「从 A 飞到 B」「业务覆盖全球」
beat-pulse beat-pulse 示意 视频 卡点冲击链:拍点上震屏、推一下 / 呼吸胀缩、闪白、RGB 色散、负片闪、放射模糊、条带错位按配方叠加衰减,可每拍或重拍切片段 「做卡点」「踩点视频」「卡点震屏闪白」「MAD 冲击感」
cam-whip cam-whip 示意 视频 拉镜 / 甩镜卡点:切点两侧做甩镜、急推急拉(可偏锚点)、平铺推拉,镜像补边、真运动模糊,段内可加缓推与手持微震 「甩镜转场」「拉镜卡点」「锚点拉镜连招」「whip pan」
lyric-pv lyric-pv 示意 颗粒 文字 PV(歌词排版):一句一个镜头,布局 × 登场 × 停留 × 退场 × 装饰 × 转场按 seed 确定性组合,副歌回到原样、强调词放大、一拍二作画节奏 「做歌词 MV」「文字 PV」「歌词动画」「竖排歌词」

示意动图全部用合成素材做:程序化画面(ffmpeg 信号源)、虚构的论文页与对话、合成行情、原创示意歌词;globe-arcs 与 lyric-pv 两张取自 HyperFrames 渲染引擎(同合云云端渲染所用引擎)的实际输出。动图放在 docs/media/,不随单个技法安装。

安装

任一 Agent(Claude Code / Codex / Cursor …):

npx skills add Gitruck/gtrk-mg-techniques --skill doc-reveal
npx skills add Gitruck/gtrk-mg-techniques --skill band-strobe
npx skills add Gitruck/gtrk-mg-techniques --skill chat-replay
npx skills add Gitruck/gtrk-mg-techniques --skill candle-chart
npx skills add Gitruck/gtrk-mg-techniques --skill globe-arcs
npx skills add Gitruck/gtrk-mg-techniques --skill beat-pulse
npx skills add Gitruck/gtrk-mg-techniques --skill cam-whip
npx skills add Gitruck/gtrk-mg-techniques --skill lyric-pv

用 gtrk 的宿主(同一条路,顺带登记进栏目配置 style.skills,缺省 routing:none——技法不是车道生产者,由 agent 按槽位取用):

gtrk skills add Gitruck/gtrk-mg-techniques --skill doc-reveal
gtrk skills add Gitruck/gtrk-mg-techniques --skill band-strobe
gtrk skills add Gitruck/gtrk-mg-techniques --skill chat-replay
gtrk skills add Gitruck/gtrk-mg-techniques --skill candle-chart
gtrk skills add Gitruck/gtrk-mg-techniques --skill globe-arcs
gtrk skills add Gitruck/gtrk-mg-techniques --skill beat-pulse
gtrk skills add Gitruck/gtrk-mg-techniques --skill cam-whip
gtrk skills add Gitruck/gtrk-mg-techniques --skill lyric-pv

脚本依赖:Python 3.10+、Pillow;按需 pymupdf(PDF 取页)、playwright(本地 seek 预检与验收读数)、 ffmpeg + numpy(视频类技法:band-strobe、beat-pulse、cam-whip;颗粒类验收工具的 --video 本地预览也用 ffmpeg)。

每个技法必须满足的门槛

两类产物都要满足的:

  1. 技法 ≠ 模板:脚本不带示例文案、不带任何栏目色板;预设只有中性的几档,栏目色由调用方注入。 同一份脚本给不同内容产的东西应当长得不一样——差别在调用方写的 spec。
  2. 确定性:同 spec 同 seed ⇒ 逐帧一致,可复现。
  3. 可验收:附一个能量出客观读数的工具,别让验收停在"我觉得挺像"。
  4. 自检不静默:脚本自己查得出来的错 MUST 当场退出、不产文件。 宁可炸在生成阶段,也别让一个短了 10% 的产物流到成片。
  5. 一技法一目录:skills/<name>/{SKILL.md, scripts/, references/spec.md, assets/, examples/}。

颗粒类另外要满足的:

  1. 契约:产物过 gtrk mg lint(gsap-emit v1:<template> 包裹 / GSAP paused 时间线注册 / 自包含 / 实心底下沉子层 / 占满坑位 + 终态驻留 / 重复图元合并)。
  2. 预算:单颗 < 1,900,000 字符(客户端上限 2,000,000,超了静默拒挂)。图片内嵌 data URI,脚本自动降质保预算。
  3. 零卷积:不用 filter: blur() / drop-shadow() / feGaussianBlur;软影一律 box-shadow / 渐变(渲染管线逐帧软光栅,卷积按面积 × 半径 × 帧数计价)。
  4. 可预检:附本地 seek 预检(playwright 抽帧接触表),但真验收永远是真渲染引擎抽帧。

视频类另外要满足的:

  1. 帧数精确:每一段、每一条带、成品各查一道帧数。ffmpeg -ss 越界会一帧不出且退出码为 0, 按时长截取会在取整上抖——这两条都会让产物静默变短,到成片才发现。
  2. 落地方式写清楚:gtrk 没有往工程里加任意视频 clip 的命令,SKILL.md MUST 明说这一步是手动拖, 别让调用方去裸手改 .gtrk JSON。

与 gtrk 成片 SOP 的关系

颗粒类在 SOP 第 ⑤ 步(/gtrk-mg)被取用:某个 MG 槽位需要这类技法时,agent 按槽位派单(composition_id / 坑位包络 / category) 写一份 spec、跑脚本、产物直接写到 <工程>/mg/<composition_id>.html,再交回 gtrk mg lint --dispatch 与 gtrk mg 铺轨。

视频类不进 MG 轨——它是一段画面,该在视频轨上。产物落工程目录(如 <工程>/op/), 由人在客户端拖到目标轨、对齐坑位起点。

两类都一样:本仓不驱动任何 gtrk 命令,也不知道工程在哪。

许可

MIT。技法只展示你有权展示的内容:论文首页作引用、新闻截图作评论属常规做法,整篇翻页不是; 频闪蒙太奇用的是你自己片子里的画面;聊天记录回放是重排版的示意,不得用来伪造真实人物的聊天记录。

随仓分发的第三方数据(均非代码依赖,生成器与产物里不含第三方代码):

用在 是什么 来源与许可
globe-arcs/assets/land-mask.json 陆地点阵位图(1.2° 网格,5 KB) 由 Natural Earth 1:110m Land(ne_110m_land)栅格化,naturalearthdata.com,公有领域
chat-replay、candle-chart、globe-arcs 脚本里的 ASCII_EM 表 95 个 ASCII 字符的步进宽度(em),用来估字宽 量自思源黑体 CN Medium 的字形度量;思源黑体以 SIL Open Font License 1.1 发布(字体本身不随仓分发)

candle-chart/examples/synthetic-daily.csv 是固定种子合成的行情,不对应任何真实标的;lyric-pv 的示例歌词是原创示意文字; beat-pulse / cam-whip 的示例素材由 make_clips.py 用 ffmpeg 程序化信号源现场合成,不随仓分发。

思路借鉴(只借分类与构成规则,未复制代码与素材):lyric-pv 的部件分类借鉴 JIZURA(文字 PV 自动构成,MIT)。

About

Gtrk-cli配套MG/OV动画技法skill

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages