乐于分享
好东西不私藏

AI 生成的文档太丑?这个 4.5k Star 的开源项目让 AI 输出像印刷品

AI 生成的文档太丑?这个 4.5k Star 的开源项目让 AI 输出像印刷品
你用 Claude、ChatGPT 生成过文档吗?简历、报告、方案——内容写得头头是道,但排版一塌糊涂。灰扑扑的背景、随意的间距、每次生成都长得不一样。

说实话,我自己也有这个困扰。

直到我看到一个叫 Kami(紙) 的开源项目。GitHub 上线没多久就冲到 4.5k Star,作者 tw93 是个产品设计师,给 AI 写文档这件事,定了一套从颜色到字体到间距的完整规矩。

结果就是:AI 生成的东西,看着像印刷品了。


Kami 是什么?

Kami,日语里「紙」的意思——承载最终想法的那个表面。

它的定位很明确:不是 UI 框架,而是一套给 AI 用的文档设计约束系统。你可以把它理解成一叠「设计规则卡」,丢给 Claude 或者 Codex,让它们在生成文档时自动遵守。

现在支持 8 种文档类型

  • 一页纸(One-Pager)
  • 长文档(Long Doc)
  • 正式信件(Letter)
  • 作品集(Portfolio)
  • 简历(Resume)
  • 幻灯片(Slides)
  • 股权报告(Equity Report)
  • 更新日志(Changelog)

中英文是第一梯队支持,日语也能用(best-effort CJK 路径)。

💡 一句话理解:Kami 就是给 AI Agent 装了一套「设计师审美」,让它输出排版像模像样的专业文档。


为什么 AI 需要设计系统?

很多人觉得 AI 写内容够用了,排版嘛,将就一下就行。

但 tw93 在项目 README 里写得很直接:

"AI 能比大多数人工做得更好。缺失的不是能力,而是约束。没有设计系统,每次生成都在往通用的灰色和混乱的布局漂移。"

说白了,AI 不缺审美,缺的是边界。

这就像你让一个会做饭但没有菜谱的人做菜——每次都能吃,但味道全看心情。Kami 就是那份菜谱,把「什么颜色、多大字号、多宽间距」全部锁死,AI 只需要专注内容。

我自己的看法是,这件事迟早会变成标配。现在各家 AI Agent 都在卷「写代码」「做分析」,但输出质量这一环,差距太大了。Kami 算是第一个认真回答「AI 输出应该长什么样」这个问题的人。


它的审美哲学:少即是多

Kami 的设计原则很有态度,不是那种堆砌渐变和动效的风格。

核心就三条:

1. 羊皮纸底色,不是白纸

  • 页面背景固定为 #f5f4ed,一种暖色调的羊皮纸色
  • 永远不用纯白——白纸太冷,像电子表格,不像印刷品

2. 墨蓝是唯一的强调色

  • #1B365D,一种深沉的墨蓝色
  • 规则:整页中墨蓝面积不超过 5%
  • 超过这个比例就不叫克制了,叫花哨

3. 灰色必须是暖灰色

  • 所有灰色都带黄棕色调,R ≈ G > B
  • 绝不用冷灰(蓝灰),因为冷灰色看起来像仪表盘,不像纸

这三条规则组合在一起,出来的效果就是那种——翻开发达国家年报时看到的高级感。沉稳、安静、有质感。


字体系统:衬线为王

Kami 对字体的选择也很讲究:

英文用 Charter,中文用仓耳今楷02,日文用游明朝。

有意思的是,它坚持「一页只一种衬线体」的原则。英文章面,Charter 包办标题和正文;中文页面,仓耳今楷包办标题,正文用思源黑体。

具体规格:

层级
字号
字重
行高
Display
36-48pt
500
1.10
H1
18-22pt
500
1.20
H2
14-16pt
500
1.25
H3
12-13pt
500
1.30
Body
9.5-10pt
400
1.55
Caption
8.5-9pt
400
1.45
Label
7.5-8pt
600
1.35

行高分了三档:标题紧(1.1-1.3)、密集正文(1.4-1.45)、阅读正文(1.5-1.55)。

⚠️ 有一条很细节的规则:正文用 400 字重,标题用 500。不要用合成的粗体(synthetic bold),因为渲染出来会虚。


配色全表

把 Kami 的完整色板列出来,方便想用的人直接抄:

画布色(底色)

  • Parchment #F5F4ED — 页面底色,情绪基础
  • Ivory #FAF9F5 — 卡片/浮层
  • Warm Sand #E8E6DC — 按钮默认态
  • Deep Dark #141413 — 深色主题底色

品牌色

  • Ink Blue #1B365D — 主色,CTA、引用条、章节标记
  • Ink Light #2D5A8A — 深色面上的链接
  • Error #B53333 — 错误态

暖灰梯度

💡 实用技巧:标签背景必须用纯 hex 色值,不能用 rgba()。因为 WeasyPrint(Kami 用的 PDF 渲染引擎)对 rgba 会画双矩形 bug。


怎么用?比你想象中简单

Kami 现在支持三种方式安装:

Claude Code(最推荐):

npxskillsaddtw93/kami-aclaude-code-g-y

或者通过插件市场:

/pluginmarketplaceaddtw93/Kami/plugininstallkami@kami

Claude Desktop:
去 GitHub Releases 下载 kami.zip,然后在 Claude Desktop 里 打开 Customize > Skills > "+" > Create skill,直接上传 ZIP 就行。

其他 Agent(Codex、OpenCode 等):

npxskillsaddtw93/kami-a'*'-g-y

安装完之后,不需要任何特殊指令。你正常跟 AI 说需求就行:

  • "帮我做一份简历"
  • "帮我排版一份长文档"
  • "帮我做一套演讲幻灯片"

Kami 的 skill 会自动触发,AI 就会按照这套规则来排。


更厉害的:Travel 模式

这是我觉得 Kami 最有意思的功能。

同样的这套设计约束,不仅能给 AI Agent 用来生成 HTML 文档,还能作为 brief 交给任何图像生成工具——比如 ChatGPT Images、Midjourney。

你只需要在 prompt 里加一句:

Apply the Kami design system from github.com/tw93/kami/tree/main/references

图像生成工具就会沿用同样的暖色羊皮纸底色、墨蓝强调色、衬线字体风格来画图。

效果相当惊艳——GitHub README 里有三张示例,分别展示了证据布局图、架构重绘和概念对比图,风格高度统一。

换句话说,Kami 不只是帮你做文档排版,它定义了一种视觉语言,让你的所有 AI 输出——文档、图表、信息图——都保持一致的设计调性。


谁做的?为什么做?

作者 tw93 是个产品设计师,也是开源社区的老面孔。他还有两个姊妹项目:

  • Kaku(書く):让 AI 写代码
  • Waza(技):让 AI 训练习惯
  • Kami(紙):让 AI 输出文档

三件套凑齐了「写、练、交付」的完整链条。

tw93 说他一开始是因为自己买美股,经常让 Claude 写研究报告。每次输出都是默认灰色、扁平、每 session 布局不一样,看着不舒服。

所以他开始一条条修:先修排版,再修配色,再修间距。修着修着,发现这套规则不仅能用在研报上,简历、幻灯片、作品集全都适用。于是就抽像成了 Kami。

这个动机很真实——不是「我觉得应该做个设计系统」,而是「我自己受不了 AI 输出的丑东西了」。


跟其他方案比怎么样?

现在 AI 文档工具越来越多,我简单列个对比:

维度
Kami
直接让 AI 排版
Canva / Figma
设计一致性
★★★★★ 每次都一样
★★ 每次不一样
★★★★★ 模板固定
使用门槛
★★★★ 说句话就行
★★★★★ 什么都不用学
★★★ 手动拖拽
中文支持
★★★★★ 一等公民
★★★ 看模型能力
★★★★ 有模板
输出质量
★★★★★ 印刷级
★★ 参差不齐
★★★★ 看设计能力
灵活性
★★★ 有规则约束
★★★★★ 随心所欲
★★★★★ 完全自由
适合场景
专业文档输出
快速草稿
可视化设计

说白了,如果你的需求是「我要一份看起来专业的文档,但我不想自己排版」,Kami 目前是 AI 领域最靠谱的选择。


实际效果怎么样?

官网上放了 4 个示例 PDF,我直接说我的感受:

Tesla 股权报告:中文的,分析 Tesla Q1 2026 财报。排版有财经杂志内味了——数据表格规整、引用块有墨蓝侧线、图表和文字节奏搭配得当。

Musk 简历:2 页的创始人简历,英文。信息密度高但不挤,关键数据用大号衬线字体突出。

Kaku 作品集:日文的,7 页。这个最有说服力——多页面的设计一致性非常好,封面到内页风格统一。

Agent 幻灯片:6 页的演讲稿,英文。不是 PPT 那种花哨的 slide,更像是杂志排版式的幻灯片,适合高端场合。

你可以自己去官网下载 PDF 看:

  • Tesla 股权报告[https://kami.tw93.fun/assets/demos/demo-tesla.pdf]
  • Musk 简历[https://kami.tw93.fun/assets/demos/demo-musk-resume.pdf]
  • Kaku 作品集[https://kami.tw93.fun/assets/demos/demo-kaku.pdf]
  • Agent 幻灯片[https://kami.tw93.fun/assets/demos/demo-agent-slides.pdf]

我的看法

Kami 解决的问题其实不只是「AI 输出丑」这件事。

更深层的意义在于:它给 AI Agent 定义了一套设计语言的语法

以前我们说 AI 不懂设计,其实不完全对——AI 懂设计的概念,但它没有一个可执行的约束框架。Kami 填补的就是这个空白。颜色锁死、字体锁死、间距锁死,AI 只需要在这个框架里填内容。

这让我想到一个趋势:AI Agent 时代,最好的工具可能不是「功能最多的」,而是「约束最清晰的」。越明确的约束,AI 执行得越可靠。Kami 的 22 条生产规则、13 个设计 token、8 套模板——每一条都在收窄 AI 的选择空间,而收窄越多,输出越稳定。

我预测未来半年内,会出现更多这类「AI 设计系统」——不只是文档,还会有专门的 PPT 系统、数据可视化系统、社交媒体图文系统。Kami 开了个好头。

如果你日常用 AI 写文档、做报告、排简历,试试 Kami,你会被效果吓一跳。


资源汇总

  • 🌐 官网:https://kami.tw93.fun/ (支持中/英/日三语)
  • 💻 GitHub:https://github.com/tw93/Kami (MIT 开源)
  • 📦 最新版本:v1.1.0(2026 年 4 月)
  • 🌟 Star 数:4.5k+(截至 2026 年 5 月)
  • 👤 作者:tw93(@HiTw93[https://x.com/HiTw93]
  • 📄 姊妹项目Kaku[https://github.com/tw93/Kaku](代码)、Waza[https://github.com/tw93/Waza](习惯)

你觉得 AI 生成的内容最缺什么?是设计、准确性、还是创造力?
评论区聊聊 👇

标签:#AI工具#开源项目#设计系统#文档排版#Claude