
大多数人用 Claude 写研究报告,结果出来的东西永远是那副样子——默认的黑色字体、纯白背景、段落之间毫无节奏感,像一份随手打印出来的 Word 文档。
再让它生成一次,风格又完全不一样了。更关键的是,看着这种文档,你根本不想读下去。哪怕内容再有价值,视觉上的挫败感已经把你的阅读欲望消耗殆尽了。
开源作者 tw93 就遇到了这个问题。作为长期用 AI 生成研究报告的用户,他对这种"通用灰色"的输出忍无可忍。
于是他开始自己动手,反复调整字体、配色、间距,一条一条地建立设计规则,直到 AI 生成的报告终于变成了他愿意读的样子。
这个过程中,Kami 就诞生了。


Kami(紙,かみ),在日语里就是"纸"的意思——它是你所有交付物最终落地的那个载体。
用官方的话说,Kami 是一套给 AI 写的文档设计系统:一套约束语言,六种文档格式,简单到 AI 可以稳定运行,严格到每份输出都能保持一致且可以直接交付。
这不是一个 UI 框架,而是一个为印刷品设计的约束系统。
文档应该读起来像精心编排的页面,而不是仪表盘。它以 Claude Code Skill 的形式分发,安装之后,你只需要用自然语言告诉 Claude 你要什么文档,它会自动套用这套视觉语言生成 PDF,不需要任何斜杠命令,不需要额外提示。
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 shadow
0 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 检查。
字体系统同样经过精心设计:
Kami 的安装非常简单,支持多种 AI 工具:
Claude Code 用户
npx skills add tw93/kami -a claude-code -g -yCodex 用户
npx skills add tw93/kami -a codex -g -y通用智能体(OpenCode等)
npx skills add tw93/kami -a '*' -g -yClaude Desktop 用户
ZIP 文件非常轻量:中文字体优先从本地加载,然后通过 jsDelivr CDN 加载。如果渲染有问题,Claude 会在下一次运行时下载它们。
要更新的话:下载同样的 URL,点击技能卡片上的 "...",选择 Replace,上传即可。
安装后,直接用自然语言描述你要什么,Skill 会自动触发,无需任何额外指令。
Kami 的 slogan 是"Good content deserves good paper."(好内容,值得好纸面)。
这句话道出了这个项目的核心价值——我们花了那么多时间让 AI 生成高质量的内容,为什么不能让这些内容以一种同样高质量的方式呈现出来呢?
如果你经常让 AI 生成文档,但又受不了默认的排版,Kami 绝对值得一试。
安装只需一分钟,但带来的体验提升是巨大的。你的报告会看起来更专业,你的简历会更有竞争力,你的幻灯片会更有格调。
GitHub:https://github.com/tw93/Kami