乐于分享
好东西不私藏

还在手动调文档样式?这个 AI 开源工具 5 天拿下 3.2k Star,输出即专业级

还在手动调文档样式?这个 AI 开源工具 5 天拿下 3.2k Star,输出即专业级

用 AI 写文档,最常见的结果是什么样的?灰白底色、黑色 Arial 字、段落之间就靠一行空白隔开。内容可能很扎实,但看着就是一股"默认样式"的味道,放不出手。

tw93 做 Kami 之前,自己也是这么过来的。他喜欢研究美股,经常让 Claude 帮他写研究报告,每次出来的格式都一样,平平整整,毫无变化,翻几页就觉得沉。后来他一条规则一条规则地调,调配色、调字体、调间距,调到某一天,他发现这套东西已经不止适用于报告了,什么文档都能往里套。于是就有了 Kami。

项目口号只有一句话:Good content deserves good paper(好内容值得好纸张)。

设计规范

Kami 定义了一套很克制的规则,所有文档都在这套规则里运行。

  • • 底色不用纯白: 所有页面背景是 #f5f4ed,接近羊皮纸的颜色,有一点暖,看着不刺眼。这个选择不起眼,但放在屏幕上会感觉比一片纯白舒服很多。
  • • 强调色只有一个: 整个文档里,有颜色的地方只能用"墨蓝" #1B365D。面积不能超过全页的 5%。没有第二个彩色。这个限制迫使排版专注于结构本身,而不是靠颜色吸引眼球。
  • • 灰色也要暖: 文档里用到的中性色,全部带黄褐色调。禁止出现带蓝调的冷灰。这个细节让整体色温保持统一,不会出现一块冷一块暖的割裂感。
  • • 阴影只用极轻的: 允许用 Ring 或轻微的 Whisper Shadow,不允许硬投影。这一条让界面显得干净,没有那种做网页 Banner 的厚重感。
  • • 标签背景必须实色: Tag 类元素只能用纯 Hex 值,不能用 rgba()。原因是 WeasyPrint(用于生成 PDF 的工具)在渲染 rgba 背景时会出现重叠的矩形 bug,实色能绕开这个问题。

这五条规则组合起来,形成了 Kami 的视觉基调:暖、静、有层次。

Kami 生成的 Tesla 公司一页纸示例,展示暖米纸底色、墨蓝强调色和衬线体排版效果

六种文档类型

Kami 支持六种文档格式,每种都有独立的中英文模板:

  • • 一页纸(One-Pager): 适合做公司或产品介绍,把核心内容压缩在一张 A4 内。示例里用了特斯拉的公司简介,排版非常干净,一眼能抓到关键信息。
  • • 长文档(Long Doc): 用于研究报告、技术说明这类需要多页展开的内容。Kami 在这里把行距和字号管理得比较细,密排和阅读两种模式行距分别控制在 1.4–1.45 和 1.5–1.55,读起来不累。
  • • 正式信件(Letter): 格式清晰,适合对外的商务沟通或正式函件。
  • • 作品集(Portfolio): 展示项目经历,有独立的布局结构,适合设计师或开发者整理自己的工作成果。
  • • 简历(Resume): 这是很多人最常用到的。Kami 的简历模板不靠花哨的颜色块吸引注意,靠的是字体和间距的层级。示例用的是 Elon Musk 的虚构简历,可以当作参考看看效果。
  • • 幻灯片(Slides): 生成类似 Keynote 风格的演示文稿。项目里有一份 AI Agent 相关的幻灯片示例,六张左右,布局简洁,没有多余装饰。

另外内置了 12 种 SVG 图表类型,涵盖折线图、环形图、架构图等常见形式,风格和文档整体保持一致,不需要另外引入图表库。

Kami 生成的 Elon Musk 简历示例,衬线体排版,单页布局,展示工作经历和技能
Kami 生成的 AI Agent 幻灯片示例,简洁演示风格,墨蓝色调强调关键信息

字体选型

字体是文档风格中很重要的一块,Kami 对三种语言分别选了不同的字体方案。

中文用 tw93 自己喜欢的仓耳今楷(02帧)。这款字体是衬线和非衬线混排的楷书风格字体,书写感强,放在标题上比较有书卷气质。个人使用免费,商业使用需要向 tsanger.cn 购买授权。

英文用 Charter。这是一款放在报纸上也好看的衬线体,文字较长的情况下可读性好,系统自带,不需额外安装。

日文用 YuMincho(游明朝),这也是系统自带的明朝体。日文支持目前属于“尽力而为”的状态,Kami 建议在日文文档交付前做一次目视确认。

行高设置也有明确规定:标题用 1.1–1.3,密排正文用 1.4–1.45,阅读性正文用 1.5–1.55。字重方面,标题用 500,正文用 400,不用算法合成的假粗体。

安装与接入方式

Kami 目前支持四种接入方式。

Claude Code 环境,一行命令全局安装:

npx skills add tw93/kami -a claude-code -g -y

Codex 环境

npx skills add tw93/kami -a codex -g -y

其他支持 ~/.agents/ 路径的 Agent 工具(比如 opencode、pi 等):

npx skills add tw93/kami -a '*' -g -y

Claude Desktop 就稍微麻烦一点。从仓库下载 kami.zip,在 Claude 的设置页进入 Customize > Skills > "+",选择 Create skill,把 zip 文件直接上传,不需要解压。更新时下载同一链接,在已安装的技能卡上点"..."选择 Replace 重新上传就行。

安装完成后不需要任何断言命令来激活, Kami 会根据自然语言请求自动匹配。

怎么用

安装好之后,直接用中文说就可以,不需要记任何命令:

提示词:

帮我做一份一页纸帮我排版一份长文档帮我写一封正式信件帮我做一份作品集帮我做一份简历帮我做一套演讲幻灯片

Kami 会根据你写的是中文还是英文,自动匹配对应语言的模板。

Kami 生成的 Kaku 作品集示例,展示项目排版和整体文档风格

Kami 在三部曲里的位置

Kami 是 tw93 三个开源项目的其中之一。这三个项目分层负责不同的事情:Kaku(書く)负责写代码,Waza(技)培养开发习惯,Kami(紙)负责交付文档。

如果你现在已经在用 Kaku 写代码、用 Waza 练习,那么 Kami 就是三部曲的最后一环。上游产出的内容,经由 Kami 变成可以提交的文档。

tw93 在开源圈里还有两个知名项目:Pake(把网页打包成桌面应用)和妙言(Markdown 编辑器)。tw93 这个 ID 在 GitHub 上已经有相当多的常规用户。

加了 Kami ,文档还能干什么

如果你平时用 AI 帮忙大量文字工作,文档排版又不想投入太多时间,Kami 可以就着试试。它不是要求你学一套新软件,也不是要你改变工作方式,只是将一套设计规范加到 AI 已经在做的事里。

另外,它的定位是针对“带有美感的印刷文档”,不是通用工具。如果你需要的是动态页面或互动式报表,这不是它的强项。但如果你的需求是每隔一段时间交一份看起来就很专业的 PDF 或 HTML 文档,Kami 确实能省不少动手的力气。

项目基于 MIT 许可证,完全开源。GitHub 地址:https://github.com/tw93/Kami

后端专属技术群

构建高质量的技术交流社群,欢迎从事编程开发、技术招聘HR进群,也欢迎大家分享自己公司的内推信息,相互帮助,一起进步!

文明发言,以交流技术职位内推行业探讨为主

广告人士勿入,切勿轻信私聊,防止被骗

加我好友,拉你进群

点下方的“❤支持我们,非常感谢!