Home
Softono
ian-handdrawn-ppt

ian-handdrawn-ppt

Open source MIT
1K
Stars
92
Forks
1
Issues
5
Watchers
1 month
Last Commit

About ian-handdrawn-ppt

Ian Handdrawn PPT is a Codex Skill designed to transform articles, course notes, outlines, or raw materials into a cohesive set of full-page PNG images featuring a Chinese hand-drawn technical explanation style. Unlike traditional PPTX generators or editable templates, this tool focuses on content structuring and visual storytelling. It analyzes input material to extract narrative structures, selects appropriate semantic layouts, and ensures a unified visual identity across all pages. The workflow includes generating a 21:9 cover image followed by multiple 16:9 content pages, with an optional contact sheet for quick review. Key visual characteristics include a near-white paper background, fine hand-drawn lines, subtle pencil shading, and a restrained color palette of pale blue, sage green, light peach, and lavender. Text is kept short and precise to ensure clarity, featuring minimal central graphics with ample whitespace. This tool is ideal for technical writers, educators, and content creators needing high-q

Platforms

Web Self-hosted

Ian Handdrawn PPT

把文章、课程笔记、提纲或已有材料,变成一套中文手绘技术解释风格的 PPT-style 页面图。

21:9 封面 | 16:9 正文配图 | PNG 输出 | 适合文章配图、课程课件、知识卡片和技术概念解释


这个仓库是什么

Ian Handdrawn PPT 是一个 Codex Skill,用来指导 AI Agent 把内容整理成中文手绘技术解释图

它不是传统 PPT 模板,也不是可编辑 PPTX 生成器。它的目标是产出可以直接用于文章、课程、分享稿里的整页 PNG 视觉图

  • 先理解材料,提炼叙事结构
  • 再把每一页映射到合适的语义版式
  • 统一锁定手绘视觉 DNA
  • 每页生成一张完整 raster image
  • 多页时生成 contact sheet 方便快速检查

一句话:让 AI 不只是“做几页 PPT”,而是先想清楚内容,再生成一组有统一风格的中文技术解释图。

推荐生图模型:最好使用 ChatGPT Image 2.0。如果当前环境没有这个模型,就使用可用的最高质量图像模型,并尽量让整套图保持同一个模型、同一套 style lock。


适合谁用

特别适合:

  • 写中文技术文章,需要封面图和正文配图的人
  • 做课程、训练营、工作坊,需要解释复杂概念的人
  • 想把长文、提纲、讲稿变成视觉化页面的人
  • 用 Codex 做内容生产,希望减少“模板 PPT 味”的人
  • 想让 AI 先规划页面叙事,再生成图像的人

不适合:

  • 想要可编辑 PPTX 源文件的人
  • 想要自动导出 PDF / PPTX 文件的人
  • 想要复杂动效、交互式网页或矢量图的人
  • 想把大量正文塞进一张图里的人

它会产出什么

默认输出:

  • 21:9 文章封面图
  • 16:9 正文插图 / 标准页面图
  • 多页 contact sheet
  • 简短 slide blueprint summary

默认不输出:

  • 可编辑 PPTX
  • image-based PPTX
  • PDF
  • Keynote 文件
  • HTML / SVG / canvas 版本

视觉风格

这个 skill 默认使用 Ian 的中文手绘技术解释风格:

  • 近白纸底,不发黄
  • 无整页边框
  • 细手绘线条和轻微铅笔排线
  • 淡蓝、鼠尾草绿、浅桃、淡紫标记
  • 中央图小而精,保留大量空白
  • 标题克制,不做大字海报
  • 中文文字短、少、可检查
  • 人物很少,最多一个小读者/工程师角色

参考图在:

ian-handdrawn-ppt/assets/reference-handdrawn-article-illustration-style.png

示例效果

下面是一组用 Ian Handdrawn PPT 生成的示例图:1 张超宽封面 + 3 张正文解释页。

能自动化不等于该自动化

能自动化不等于该自动化

阅读其实是两件事

阅读其实是两件事

自动化该放哪里

自动化该放哪里

三问判断法

三问判断法


安装

克隆仓库:

git clone https://github.com/helloianneo/ian-handdrawn-ppt.git
cd ian-handdrawn-ppt

复制 skill 到 Codex skills 目录:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R ./ian-handdrawn-ppt "${CODEX_HOME:-$HOME/.codex}/skills/"

安装后,在 Codex 里使用:

Use $ian-handdrawn-ppt 把这篇文章做成 1 张封面图 + 3 张正文配图。

怎么用

文章封面 + 正文配图

Use $ian-handdrawn-ppt 把下面这篇文章做成 1 张 21:9 中文封面图 + 3 张 16:9 正文配图。
风格保持中文手绘技术解释图,文字尽量短,每张图只表达一个观点。

<粘贴文章>

课程课件页

Use $ian-handdrawn-ppt 把这份课程大纲整理成 8 页中文手绘技术课件图。
面向有基础的新手,每页一个核心概念,输出 slide-by-slide blueprint,然后生成最终 PNG 页面图。

<粘贴课程大纲>

只规划,不生图

Use $ian-handdrawn-ppt 先不要生图。
请把这篇内容规划成一套 10 页左右的中文手绘技术 PPT-style image deck。
每页给出标题、主旨、版式 archetype、可见文字和图像 brief。

<粘贴素材>

更多示例见 examples/prompts.md


工作流程

这个 skill 的流程是:

  1. 读取材料:文章、Markdown、PDF、DOCX、PPTX、课程大纲、讲稿或粗略想法
  2. 做 intake:判断主题、受众、场景、目标、核心论点和素材充分度
  3. 规划叙事:选择教学、说服、报告、产品解释或知识卡片结构
  4. 选择页面 archetype:封面隐喻、左右对比、流程、循环、分类、矩阵、总结等
  5. 锁定视觉 DNA:统一纸底、标题、页码、线条、色彩、图形尺度
  6. 每页单独写图像 prompt:包含页面角色、主旨、构图和 Required text only
  7. 生图并检查:中文文字、画幅、风格一致性、是否漂黄、是否过度模板化
  8. 多页生成 contact sheet,最后交付 PNG 页面图

目录结构

.
├── README.md
├── LICENSE
├── NOTICE.md
├── examples/
│   ├── images/
│   │   ├── cover-automation-boundary.png
│   │   ├── page-01-reading-two-things.png
│   │   ├── page-02-where-to-automate.png
│   │   └── page-03-three-question-method.png
│   └── prompts.md
└── ian-handdrawn-ppt/
    ├── SKILL.md
    ├── assets/
    │   ├── reference-handdrawn-article-illustration-style.png
    │   └── theme-tokens.json
    └── references/
        ├── intake.md
        ├── narrative-planning.md
        ├── output-quality.md
        ├── prompt-patterns.md
        ├── slide-archetypes.md
        └── visual-dna-v6.md

真正需要安装到 Codex 的是子目录:

ian-handdrawn-ppt/

根目录的 README、LICENSE、NOTICE 和 examples 是 GitHub 分享文档。


注意事项

  • 图片里的中文文字越短越稳定。
  • 最好每个页面多生成几次,再从中挑选中文字、构图、语义关系都最稳的一张。
  • AI 图像模型可能出现错字、幻觉标签、物体关系错误、风格漂移,不要默认第一张就是最终稿。
  • 如果中文渲染失败,应先减少字数并重生。
  • 如果画面方向已经正确但文字仍错,可以保留图像方向,再用确定性后处理叠准确中文。
  • PPTX/PDF 可以作为输入素材读取,但不是这个 skill 的输出格式。
  • 这个 skill 的重点是“内容语义 → 页面叙事 → 手绘解释图”,不是模板套版。

相关资料

如果你对 AI 工作流、内容创作和个人知识库感兴趣,也可以看这些:


关于作者

Ian (伊恩) — 产品设计师 / 一人公司实践者 / AI Builder

用 AI 团队打造一人公司。

🚀 正在开启:内容创作丨AI 工作流围观营,欢迎来玩! 加微信了解详情。


License

MIT License. See LICENSE.