Skip to content

Repository files navigation

Punk 图文转换 Skill

把长篇 Markdown 转换成一套适合竖屏阅读与发布的现代主义编辑系统:先生成五张完整封面供选择,再制作继承所选封面视觉语言的正文知识卡片,最后按发布平台生成三套标题、短正文与 Tag。

欢迎使用

Hi,我是 Punk,欢迎使用 Punk 图文转换 Skill

这个 Skill 专门把冗长的 Markdown 或长文章,整理成适合 小红书、微信公众号贴图和抖音图文发布的 3:4 竖版内容。它会先理解文章结构和重点,再生成 5 张不同构图的封面供你选择;选定封面后,继续制作配色统一、图文并茂的正文卡片。排版完成后,还可以根据发布平台提供 3 套推荐标题、300 字以内的发布正文和 Tag/关键词。

开始时,把文章或 Markdown 发给我,并告诉我作者名即可。如果原文自带封面,我会先问你是否保留。

封面示例

下面八张是已确认的封面能力示例,覆盖超大字、竖排、纯文字、瑞士图形、路径叙事、编辑插画与书刊细体。它们不是实际任务中的画风配额:处理一篇文章时,Skill 会先按主题筛选构图、字体、配色、强调和图片风格,再在合格候选中做稳定随机组合;同一种合适画风可以重复使用,但五张主标题不能全部依赖同一种字体气质。

超大数字字报封面 路径叙事插画封面 瑞士轨道图形封面 竖排标题与路径插画封面
01 · 超大数字字报 02 · 路径叙事插画 03 · 瑞士轨道图形 04 · 竖排标题+路径插画
中期现代主义档案插画封面 全中轴纯文字封面 左侧竖排瑞士线形封面 细宋体书封封面
05 · 中期现代主义档案 06 · 全中轴纯文字 07 · 左侧竖排+瑞士线形 08 · 细宋体书封

安装

在 Codex 中直接提供仓库地址并要求安装:

请安装这个 Skill:https://github.com/adrianpunk/punk-text-image-converter

也可以手动安装:

git clone https://github.com/adrianpunk/punk-text-image-converter.git
cp -R punk-text-image-converter ~/.codex/skills/

安装后重新打开 Codex,即可通过 $punk-text-image-converter 调用。

设计系统预览

下面五张图是 Skill 当前使用的设计库总览。封面先从版式、字体、标题强调、图片风格和配色中选型;正文再继承选定封面的配色。

20 种封面版式

定位图使用黑白表达文字方向、图片位置、副标题、作者与留白关系。

20 种封面版式

25 套配色清单

每套配色分别定义封面背景、文字、点缀与正文背景角色。

25 套配色清单

6 种图片风格

原封面适配、Anthropic 风格插画、瑞士国际主义线条/色块/形状、扁平编辑插画、中期现代主义复古编辑插画、纯文字排版。预览展示的是原创图像语言样张,实际画面主体仍按文章内容重新提炼。六种风格是可选库,不是五案配额:每篇文章只使用真正适合它的风格,同一种风格可以出现在多张封面中。

6 种图片风格

12 款中文/40 款英文原库与 4 种标题强调

中文和英文字体独立选择,不要求中英混排。英文部分完整采用 Punk 原先提供的 40 种字体图鉴,并直接展示原始字形样张;其中 33–40 为八种英文手写方向,用于短题签、批注或署名。标题强调使用默认层级、点缀色关键词、短下划线、荧光笔高亮四种方式。

字体清单与标题强调

20 种正文版式

20 种正文版式

可打开 完整设计系统预览,在同一页面从上到下连续查看确认版式、配色、图片风格、真实字体样张与强调方式、正文版式;也可直接查看 完整系统长图

能做什么

  • 理解文章主题、对象、读者、矛盾、方法和关键数字;
  • 使用 Image 2 直接生成五张 3:4 完整封面 PNG;
  • 每个设计环节先从对应视觉库按内容和可读性筛选,再在合格候选中做可复现的随机组合;
  • 五张封面至少呈现三种可辨识的主标题字体气质,同一主标题字体不得主导三张以上;
  • 保留原始标题,并为长标题建立主标题与说明标题层级;
  • 从已确认的正文版式系统中按内容语义选择页面;
  • 让正文继承所选封面的配色、字体方向、对齐轴和图形语言;
  • 输出适用于公众号、抖音或小红书的三套发布文案;
  • 检查错字、重叠、裁切、低对比、缩略图可读性、页面密度和文件完整性。

工作流程

Markdown
  ↓
理解文章与整理标题层级
  ↓
Image 2 生成 5 张完整封面
  ↓
用户选择 1 张
  ↓
HTML 正文排版并导出 PNG
  ↓
询问发布平台
  ↓
输出 3 套标题+300 字内正文+Tag/关键词

封面和正文是两种不同媒介:封面由 Image 2 直接生成完整位图;正文才使用 HTML 渲染。所选封面原样成为第一页,不使用 HTML 重画。

使用方式

在 Codex 中调用:

Use $punk-text-image-converter to turn this Markdown article into five cover options and a matching vertical article deck.

也可以直接提供 Markdown 文件、作者名和必要图片。系统会先完成五张封面并等待选择,不会跳过确认直接制作正文。若只打开 Skill、尚未提交文章,会先显示上面的欢迎语和开始方式;已经提供文章时则直接进入处理流程。

输出规格

  • 画幅:1080 × 1440 px;
  • 比例:3:4 竖版;
  • 封面候选:固定五张,通过质检后才展示;
  • 正文:含封面最多 20 页;
  • 发布文案:平台确定后输出三套,每段正文不超过 300 个可见字符;
  • 平台:公众号、抖音、小红书。

主要输出包含封面 PNG、正文 HTML、正文 PNG、缩略图、总览图、配方记录、manifest 和质检报告。

目录

punk-text-image-converter/
├── SKILL.md                 Skill 入口与核心工作流
├── agents/                  Codex 展示与调用配置
├── assets/                  字体和已确认的内部视觉资产
├── design-system/           构图、层级、字体、配色与正文模板
├── evals/                   回归测试与测试素材
├── references/              条件化加载的详细规则
├── scripts/                 构建、渲染、验证与确定性检查
├── LICENSE                  个人非商业许可;商业使用须书面授权
└── README.md

验证

node evals/qa.test.cjs
node evals/publishing-copy.test.cjs
python3 scripts/validate_system.py

Skill 结构可使用 Codex 的 skill-creator/scripts/quick_validate.py 检查。

原创与授权

本项目的工作流、构图系统、标题层级、配色角色、提示词结构、选择逻辑、正文模板、验证规则、实现代码和项目文档由 Punk 独立设计与实现。本项目采用 Punk 个人非商业许可协议 1.0,不是开源软件:

  • 自然人可免费用于个人学习、研究、测试、兴趣创作及非商业、未变现的个人账号;
  • 公司/工作室/机构使用、商业账号、品牌营销、广告赞助、客户交付、付费服务、课程、SaaS 集成、转售、托管或再分发,均须事先获得 Punk 的书面授权;
  • 未经授权的商业使用可能同时构成违约与知识产权侵权;完整边界与救济条款以 LICENSE 为准;
  • 商业授权请通过 Punk 的 GitHub 主页 或本仓库公布的联系渠道申请。

以下字体文件不适用本项目的自定义许可,继续遵循各自随附的 SIL Open Font License 1.1:

  • SourceHanSansCN-VF.otfLICENSE-source-han-sans.txt
  • SourceHanSerifCN-VF.otfLICENSE-source-han-serif.txt
  • JetBrainsMono-VF.ttfLICENSE-jetbrains-mono.txt
  • Archivo-VF.ttfLICENSE-archivo.txt

运行时使用的 Playwright、Sharp 与 Marked 等软件包遵循其各自许可证,不因本项目的自定义许可而改变。

About

把 Markdown 长文转换为适合小红书、公众号和抖音发布的 3:4 竖版封面与知识卡片

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages