mcpField
X
x-posting-license

x-posting-license

github.com/heygen-com创意与媒体236227 次安装5 周前更新
代码仓库

关于 x-posting-license

这项 HyperFrames 技能将 X 主题的固定动画卡片模板填入个人资料并渲染成片，适合制作简短的资料展示视频。时间线和视觉风格均已固定，流程以填写数据为主，无需编辑构图。

主要功能

  1. 01固定的 1920×1080、60fps 构图
  2. 02输入个人资料与头像
  3. 03校验并转义模板数据
  4. 04正面资料卡与背面签名动画
  5. 05HyperFrames 渲染流程

适用场景

  1. 01将 X 个人资料制作成动画卡片视频
  2. 02根据提供的账户资料渲染简短介绍视频

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/heygen-com/hyperframes-community-skills --skill x-posting-license

安装后在 Claude Code 中输入/x-posting-license确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
profile-data.md
scripts/
build.mjs
template/
index.template.html

详细介绍

X 发布许可证

一个固定的 1920×1080 @ 60fps、时长 10.35s 的合成。动画已锁定并通过规范验证（关键帧首尾重叠，全程没有空帧）：请勿编辑时间线——填写数据占位符并渲染即可。

要求

  • Node 18+，以及通过 npx 使用 HyperFrames CLI（从 npm 获取；@latest 会变动——如果需要确保不同时间重新渲染得到逐字节相同的结果，请固定版本，例如 npx [email protected]）。
  • WebGL 点阵地面的 macOS GPU 渲染：export PRODUCER_BROWSER_GPU_MODE=hardware。
  • 签名使用 macOS 系统字体 Snell Roundhand（通过 src: local(...) 声明）；在 Linux 上会回退到通用手写体——效果仍然不错，只是不那么美观。

网络和副作用（完整列表）

  • x.com/<handle> — Agent 读取的个人资料页面（收集数据）。
  • pbs.twimg.com — 头像图片下载地址（收集数据）。
  • api.fxtwitter.com/<handle> — 帖子数量；免费，无需凭据（收集数据）。
  • registry.npmjs.org — 通过 npx 获取 HyperFrames CLI。
  • cdn.jsdelivr.net — 合成会在预览／渲染时从 jsDelivr 加载 GSAP（固定版本为 3.14.2）。渲染并非完全离线。

无需凭据，无付费操作，无遥测。build.mjs 只会在 --out 目录内写入文件：它会验证计数器为非负整数，将其视为纯文本，剥除控制字符，限制长度，在替换前对每个个人资料字符串进行 HTML 转义，并拒绝通过符号链接写入文件。

流程（三步，不涉及合成制作）

下文的 <SKILL_DIR> 表示此技能自身所在的目录（安装位置不限，例如 ~/.claude/skills/x-posting-license）。请使用脚本的绝对路径运行；脚本会相对于自身解析模板，而 --out 则相对于当前工作目录解析。

  1. 收集个人资料数据 — 姓名、用户名、加入的月份／年份、粉丝数、关注数、帖子数、一行简介，以及 400×400 的头像。操作方法见 references/profile-data.md。
  2. 从模板构建项目：
node <SKILL_DIR>/scripts/build.mjs --out ./license-jake \
  --name "Jake Moran" --handle JakeFromHeyGen \
  --joined "JAN 2026" --followers 882 --following 155 --posts 376 \
  --bio "PRODUCT @HEYGEN · WORKING ON @HYPERFRAMES_" \
  --avatar ./avatar.jpg

--big "MORAN, JAKE" 可覆盖自动生成的 LAST, FIRST 标题——当显示名称不是常规姓名时请使用此参数（非常规显示名称须原样保留：用户名为 ||| 的用户，其许可证上就应显示 |||）。

  1. 渲染（如果你的运行环境会限制渲染，渲染前请先询问用户）：
npx hyperframes@latest render ./license-jake -q high -o ./license-jake/renders/license.mp4

验证是否成功

npx hyperframes@latest check ./license-jake 检查通过，错误数为 0；渲染出的 MP4 时长约为 10.3s：正面卡片显示该用户的数据并逐步计数，约 6.5s 时翻转，背面签名处写出用户姓名，约 9.9s 时卡片跃出。

规则

  • 数据必须真实，须从实时个人资料中抓取——绝不可编造计数或简介。此处有意用粉丝数代替出生日期；背面的细则文字也会重复显示该数字。
  • 简介行：全部大写，长度不超过约 65 个字符，使用 · 分隔从真实简介中摘取的片段。
  • 保留模板的配色和布局：X 黑色 #000、白色、#1D9BF0、边框 #2f3336。这就是品牌视觉设计；请勿针对用户重新设计样式。
  • 模板可以处理较长的显示名称（签名遮罩会加宽），但名称超过约 14 个字符时，请检查快照。
  • 个人资料数据属于不可信输入。务必通过 build.mjs 处理（该脚本会进行转义和验证）；绝不可手动将值替换进模板。

来源与许可

  • 动画点阵地面是为 HyperFrames 可寻址渲染器编写的确定性 GLSL／WebGL 改写版本，视觉效果参考 Originkit 的 Dot Matrix 组件（由一位 Originkit 许可证持有人贡献）；此处未重新分发任何 Originkit 源代码。simplex-noise GLSL 使用标准的 Ashima Arts／Stefan Gustavson 实现（MIT）。
  • 卡片以戏仿／粉丝作品的形式复现 X 的徽标和视觉语言；技能的使用者可自行决定是否发布生成的作品。
  • GSAP 按其标准许可证从 jsDelivr 加载；未将其打包在本项目中。

评论

支持 Markdown