夜雨聆风学习资料网

ARTICLE · 1020545

AI写得出好内容,却总排不出好看的文档版式?11.5K Star的Kami,把排版写成8条铁律,避免AI在排版上随机发挥

AI写得出好内容,却总排不出好看的文档版式?11.5K Star的Kami,把排版写成8条铁律,避免AI在排版上随机发挥

Design System

好内容值得好纸张:这个 11.5k Star 的开源项目,把排版品味写成了八条铁律

暖米纸底、一种强调色、三档行距、不用粗体。不给 AI 自由,只给约束——所以它每次都稳。

让 AI 写一份研报,内容挑不出毛病;但那份排版——纯白底、默认字体、行距松散,换个对话再生成一次,风格又换一套。你不好意思把它发给任何人。

有个开发者被这件事烦了很多年,最后把解法开源了。项目叫 Kami,日语里是「纸」。

11,508

GitHub Star

8

文档模板

18

内联图表

8

排版铁律

官方发布的架构图:从「生成」到「可验证」——素材、内容契约、模板图表、统一渲染、可交付产物,底下还压着一条质检线。

作者是国内开发者 tw93,做 Pake 的那位。他平时的习惯是让 AI 帮他写美股研报,每次出来的都是「同一种默认文档的样子」:灰扑扑、结构不清、换个对话就换一套排版。他原话是:纸,是一份好想法最终落地的地方。

我把它的设计规范、官方样例和架构图都翻了一遍。结论放在前面:它不是一套模板,是一套写给 AI 看的约束系统。它解决的不是「AI 写不出」,是「AI 交付不了」。

问题

01排版为什么是最后一公里

AI 生成文档这件事,卡在第三步:内容写得动了,结构理得清了,但交付物拿不出手。

这件事的吊诡之处在于:生成环节的技术这两年突飞猛进,呈现环节还停在十几年前的默认样式。你花在打磨内容上的心思,第一眼就被版式出卖了。

我的看法是:读的人不会为你的内容原谅你的排版。视觉上的挫败感,会先于逻辑消耗掉阅读欲望。

官方样例:一份中文财报点评。K 线、指标卡、章节节奏都是排版系统的一部分——像印刷品,不像网页。

核心

02八条铁律:把品味写成规则

Kami 的核心资产不是模板,是八条设计约束。挑几条感受一下:

画布永远是暖米色 #f5f4ed,不用纯白——纯白在屏幕上刺眼,打印出来显廉价;强调色只有油墨蓝 #1B365D 一种,全文档占比不超过 5%,超过就从克制变成堆砌;所有灰色必须带黄棕底色,禁止冷蓝灰——那是 SaaS 产品的味道,放进文档里就廉价。

再看字体:每种语言只用一种衬线字体,中文仓耳今楷、英文 Charter、日文游明朝;正文字重 400、标题 500,禁止合成粗体——需要强调,用字号或左侧竖线,不靠加粗。

八条铁律:纸底、强调色、灰调、字体、字重、行距、标签、阴影——每一档都有明确理由。

第七条最能说明这套系统的来历:标签背景必须用实色 hex,禁用 rgba()。原因是 WeasyPrint 渲染 PDF 时,rgba 会让 padding 区和字形区的透明度叠加,出现双层矩形 bug。

这条规则不是设计灵感,是踩坑记录。一套设计系统真正值钱的地方,往往不是它规定了什么好看,而是它记得住哪些坑。

参数

03一致性是算出来的

光有原则还不够,Kami 把每个原则都落成了参数表。字阶从 Display 36–48pt 到图注 8.5–9pt 共九档;间距以 4pt 为基础单位;圆角七档,从代码块的 6pt 到 Hero 的 32pt。

行距只给三档:紧凑标题 1.1–1.3,密排 1.4–1.45,阅读正文 1.5–1.55。规范里专门写了原因:中文 pt 字号下 1.4–1.45 最舒服,网页习惯的 1.6 放进印刷品会显得松散。

参数表:九档字阶、三档行距、定档的间距与圆角——每一档都标了使用场景。

生成模型每次都在概率里掷骰子,Kami 把骰子换成了参数表。AI 时代最稀缺的不是能力,是每次都一样的能力——尤其在交付物这个场景里,「稳」本身就是专业。

能力

04它能交付什么

八种文档模板:一页纸、长文、正式信件、作品集、简历、幻灯片、研报、更新日志,外加产品落地页。中英文是一等公民,日文走 CJK 路径,韩文也有实际样例——官方仓库里连韩语简历都排好了。

从一句话到成品:意图路由选模板,渲染走 WeasyPrint,交付前还有三道检查。

图表不用外挂:18 种内联 SVG 图表直接嵌进文档,架构图、流程图、甘特图、象限图都有,配色字体沿用同一套设计语言,文档天然可移植。

一页纸样例(白底打印版):页眉、页脚、指标卡、章节节奏俱全——注意这是刻意切到白底适配打印机的版本。

英文简历样例:两页,衬线字体承担层级,数字用等宽对齐。

幻灯片样例:同一套设计语言从纸面延伸到了演示场景。

作者还用同一套规则搭了产品的落地页——一套约束,撑起完全不同的门面。

Kami 官网本身就按这套设计系统搭建:规则从 PDF 一路管到了网页。

渲染走 WeasyPrint:HTML 进,PDF 出,同时支持 PNG 和可编辑的 PPTX 导出。交付前还有三道检查——结构完整、事实核对(名称、数字、日期、图片不许漏)、逐页视觉复核。

换句话说,它管的不是「生成一张图」,是「交付一份能直接发出去的东西」。

形态

05从 Prompt 到 Skill:形态变了

以前想让 AI 排版像样,做法是在对话里反复叮嘱:用暖色、用衬线、行距小一点、别乱加粗。下次开个新对话,全忘。

Kami 把这些沉淀成了文件系统里的资产:SKILL.md 写触发条件和流程,templates 放八套模板,references 放设计规范,scripts 管构建和字体回退。安装之后自然语言触发,不需要记任何命令。

Prompt 和 Skill 的区别:一个活在对话里,一次一散;一个住在文件系统里,越攒越值钱。

这也是为什么它值得被当成一个样本来看:AI 工作流正在从「聊出来」变成「攒出来」。提示词是一次性的,Skill 是可以继承的资产。

冷静看

06冷静三连

第一:它只有一种审美。暖米纸、油墨蓝、衬线,适合报告、简历、信函这类正式交付物;品牌稿、深色科技风、多色数据可视化,它不对口。八条铁律既是护城河,也是围墙。

第二:中文字体有商用授权问题。仓耳今楷02 个人使用免费,商用需要授权——要商用得换成思源宋体或者买授权,这一条很多人会漏看。

第三:它管排版,不管内容。内容还得你自己或让 AI 写;输出是 PDF 和 HTML,不是能继续编辑的 Word。想要排版自由发挥的人,会觉得它管得太宽。

约束不是创造力的敌人,是交付物的朋友。好内容值得好纸张——这句话的另一半是:烂排版配不上你写的东西。

—— 写在最后

你最近一次因为排版拿不出手、而没发出去的文档,是什么?

相关学习资料