Kami 开源：给 AI 生成的文档配上印刷级排版，好内容值得好纸面
大多数人用 Claude 写研究报告，结果出来的东西永远是那副样子——默认的黑色字体、纯白背景、段落之间毫无节奏感，像一份随手打印出来的 Word 文档。
再让它生成一次，风格又完全不一样了。更关键的是，看着这种文档，你根本不想读下去。哪怕内容再有价值，视觉上的挫败感已经把你的阅读欲望消耗殆尽了。
开源作者tw93就遇到了这个问题。作为长期用 AI 生成研究报告的用户，他对这种"通用灰色"的输出忍无可忍。
于是他开始自己动手，反复调整字体、配色、间距，一条一条地建立设计规则，直到 AI 生成的报告终于变成了他愿意读的样子。
这个过程中，Kami就诞生了。
Kami 是什么
Kami（紙，かみ），在日语里就是"纸"的意思——它是你所有交付物最终落地的那个载体。
用官方的话说，Kami 是一套给 AI 写的文档设计系统：一套约束语言，六种文档格式，简单到 AI 可以稳定运行，严格到每份输出都能保持一致且可以直接交付。
这不是一个 UI 框架，而是一个为印刷品设计的约束系统。
文档应该读起来像精心编排的页面，而不是仪表盘。它以 Claude Code Skill 的形式分发，安装之后，你只需要用自然语言告诉 Claude 你要什么文档，它会自动套用这套视觉语言生成 PDF，不需要任何斜杠命令，不需要额外提示。
Kami 是作者 "工作方法论三部曲" 的最后一环：
•Kaku（書く）：你写代码的方式（AI 编程终端）
•Waza（技）：你练习技能的方式
•Kami（紙）：你交付文档的方式
核心亮点
Kami 的核心不是一堆花哨的模板，而是一套跨文档的约束集合，每一条都有明确理由：
1、页面背景用#f5f4ed暖米色，不用纯白
纯白页面在屏幕上太刺眼，打印出来也容易显得廉价。米色是整个设计系统的情感基础，给人一种温暖、专业、值得信赖的感觉。
2、强调色只有油墨蓝#1B365D一种
全文档占比不超过 5%。超过就是堆砌，不是克制。这种单一强调色的策略，让视觉焦点永远清晰，不会被各种花哨的颜色分散注意力。
3、所有灰色必须暖调，禁止冷蓝灰
冷灰色（比如#6b7280）是 SaaS 产品的典型配色，放进文档里会显得廉价和模板化。Kami 要求所有灰色都必须有黄棕底色，保持整体色调的温暖统一。
4、每种语言只用一种 serif 字体
英文用 Charter，中文用仓耳今楷 02，日文用 YuMincho。不混合多种字体，保持视觉的纯净感。serif 字体天然带有一种权威感和印刷质感，非常适合专业文档。
5、字重固定，不用 bold
单一字重是这套系统的签名——需要更强存在感，用字号或左侧竖线，不加粗。这种约束反而让设计更有格调，不会出现随意加粗的廉价感。
6、行距三档，禁止 1.6+
紧凑标题 1.1–1.3 / 密排正文 1.4–1.45 / 阅读正文 1.5–1.55。网页习惯用的 1.6 行距放进印刷品里会显得松散，Kami 用更紧凑的行距营造出专业印刷品的感觉。
7、Tag 背景必须实色 hex，禁止rgba()
这条是个技术细节：WeasyPrint 渲染 PDF 时，rgba()会导致 padding 区和字形区透明度叠加，出现双层矩形 bug。
8、阴影只用 ring shadow 或 whisper shadow0 0 0 1pt的描边阴影，或rgba(0,0,0,0.05)的极轻浮起。硬 drop shadow 是 SaaS 界面的习惯，放进文档里很突兀。
这 8 条铁律，每一条都是 tw93 在反复试验中总结出来的。它们不是凭空想象的设计准则，而是解决实际问题的具体方案。
功能特性
Kami 支持六种核心文档类型，每种都有专门的中英日模板：
| 类型 | 适用场景 |
|---|---|
| One-Pager | 一页纸报告、公司简介、产品介绍 |
| Long Doc | 白皮书、长篇分析、研究报告 |
| Letter | 推荐信、正式信函、商务函件 |
| Portfolio | 项目作品集、个人展示 |
| Resume | 简历、个人履历 |
| Slides | 演讲稿、演示幻灯片 |
| 除此之外，Kami 还内置了十二种内嵌 SVG 图表类型，包括架构图、流程图、甘特图等，AI 可以直接注入到文档中，不需要依赖外部图片，保证了文档的完整性和可移植性。 | |
| 语言支持方面，中文和英文是一等公民，日文也通过尽力而为的 CJK 路径支持，交付前需要进行视觉 QA 检查。 | |
| 字体系统同样经过精心设计： | |
| •中文：仓耳今楷 02（serif，个人使用免费，商业用途需授权） | |
| •英文：Charter（serif，系统自带） | |
| •日文：YuMincho（serif，系统自带） |
快速上手
Kami 的安装非常简单，支持多种 AI 工具：
Claude Code 用户
npx skills add tw93/kami -a claude-code -g -y
Codex 用户
npx skills add tw93/kami -a codex -g -y
通用智能体（OpenCode等）
npx skills add tw93/kami -a '*' -g -y
Claude Desktop 用户
- 下载 kami.zip[1]
- 打开 Claude Desktop 的 Customize > Skills > "+" > Create skill
- 直接上传 ZIP 文件（不需要解压）
ZIP 文件非常轻量：中文字体优先从本地加载，然后通过 jsDelivr CDN 加载。如果渲染有问题，Claude 会在下一次运行时下载它们。
要更新的话：下载同样的 URL，点击技能卡片上的 "..."，选择 Replace，上传即可。
安装后，直接用自然语言描述你要什么，Skill 会自动触发，无需任何额外指令。
写在最后
Kami 的 slogan 是"Good content deserves good paper."（好内容，值得好纸面）。
这句话道出了这个项目的核心价值——我们花了那么多时间让 AI 生成高质量的内容，为什么不能让这些内容以一种同样高质量的方式呈现出来呢？
如果你经常让 AI 生成文档，但又受不了默认的排版，Kami 绝对值得一试。
安装只需一分钟，但带来的体验提升是巨大的。你的报告会看起来更专业，你的简历会更有竞争力，你的幻灯片会更有格调。
GitHub：https://github.com/tw93/Kami