告别 AI “排版灾难”：用 Kami 一键生成印刷级专业文档

告别 AI "排版灾难"：用 Kami 一键生成印刷级专业文档（完整使用教程）

Good content deserves good paper.

好内容，值得好纸张。

你是否经历过这样的场景：让 AI 写了一份逻辑严密的商业计划书、技术白皮书或个人简历，内容无可挑剔，但导出的文档却是"白底黑字、排版粗糙、字体混乱"，根本不好意思发给客户或打印出来？

今天介绍的开源项目 tw93/Kami ，就是为了解决这个"最后一公里"的痛点而生。它不是传统的排版软件，也不是复杂的 UI 框架，而是一套专为 AI Agent 设计的文档约束系统。本文将从定位、原理、安装、使用到进阶配置，带你彻底掌握这款"让 AI 懂排版"的神器。

📖 一、Kami 是什么？核心定位

Kami （日语「紙」，意为"纸"）是由国内知名开源开发者 tw93（代表作 Pake、Kaku、妙言）创建的 Claude Code Skill。它以 MIT 协议开源，核心目标只有一个：

让 AI 生成的文档，告别"灰色单调"，直接输出可交付、可打印的专业级排版 PDF。

与传统 Markdown 编辑器或排版工具不同，Kami 不依赖手动调整样式，而是将排版规则编码成 AI 可理解的约束指令。你只需提供内容，Kami 负责让它"长得专业"。

🧠 二、底层原理：为什么 AI 能稳定输出"印刷级"排版？

Kami 的核心不是"生成内容"，而是"约束排版"。它的架构可抽象为三层：

复制代码

┌─────────────────────────────────┐
│ ① 意图识别层 (Intent Routing)    │ 自然语言 → 匹配 8 种模板之一
├─────────────────────────────────┤
│ ② 约束执行层 (Constraint Engine) │ 8 条排版铁律 + 反模式拦截
├─────────────────────────────────┤
│ ③ 渲染输出层 (Render Pipeline)   │ HTML/CSS → WeasyPrint → 印刷级 PDF
└─────────────────────────────────┘

🔑 8 条"排版铁律"（设计约束系统）

Kami 在 CHEATSHEET.md 中硬编码了以下规则，确保 AI 不会"自由发挥"：

画布底色 ：暖米色 #f5f4ed，永不使用纯白
强调色 ：仅用油墨蓝 #1B365D，占比 ≤5%
字体栈：每种语言仅用一种衬线字体（中文：仓耳今楷02 / 英文：Charter / 日文：YuMincho）
字重控制：正文 400，标题 500，严禁 AI 合成粗体
行距规范：标题紧凑(1.1-1.3)、正文密排(1.4-1.45)、阅读区适中(1.5-1.55)
阴影策略：仅用柔和光晕，禁用硬投影
标签背景 ：仅用纯色 hex，规避 WeasyPrint 的 rgba() 渲染 Bug
图表规范：内置 14 种 SVG 图表样式，直接内联嵌入

🛠️ 技术栈亮点

模板路由 ：通过 SKILL.md 中的决策树，AI 自动判断使用 One-Pager、Resume、Long Doc 等 8 种模板
构建引擎 ：底层调用 WeasyPrint（Python HTML-to-PDF 引擎），配合自定义 build.py 解决渲染兼容性
字体回退：优先本地加载，缺失时自动 fallback 到 jsDelivr CDN，支持离线环境基础渲染
元数据注入：自动写入 PDF 的 Author、Title、Keywords，符合出版规范

📦 三、安装与配置（保姆级教程）

✅ 前置条件

已安装 Claude Code 或兼容的 AI Agent 终端
系统安装 Python 3.10+（用于 WeasyPrint 渲染）
网络可访问 GitHub / jsDelivr（首次安装字体）

🔧 安装方式（任选其一）

方式 1：命令行一键安装（推荐）

bash 复制代码

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

方式 2：Claude Code 插件市场

复制代码

/plugin marketplace add tw93/Kami
/plugin install kami@kami

方式 3：Claude Desktop 手动导入

从 GitHub Releases 下载 kami.zip
打开 Claude Desktop → Customize → Skills → + Create Skill → 上传 ZIP

🔍 验证是否安装成功

在 Claude Code 终端输入 /，随后键入 kami。若出现：

复制代码

kami - Generate professional documents with print-ready typography...

即表示安装成功，可随时调用。

🎮 四、使用指南：自然语言 vs `/kami` 命令

Kami 支持两种调用方式，作者更推荐自然语言触发，但显式命令同样可用。

🗣️ 方式 1：自然语言自动触发（推荐）

直接像聊天一样描述需求，Claude 会自动识别意图并加载 Kami：

text 复制代码

帮我做一份一页纸，介绍我的 AI 编程工具
Turn this research notes into a long doc
Build me a professional resume for a product manager

工作流：

Claude 读取 SKILL.md 的 description，语义匹配成功
自动选择对应模板（如 one-pager.html）
读取 ~/.config/kami/brand.md 填充品牌信息
按 8 条规则生成 HTML，调用 build.py 输出 PDF

⚡ 方式 2：显式 `/kami` 命令调用

如果你希望强制触发或带参数执行，可使用斜杠命令：

text 复制代码

/kami make a resume in Chinese
/kami generate a one-pager for my SaaS startup
/kami help  # 查看可用模板与参数说明

💡 注意：/ 后跟的是 Skill 的目录名 （即 kami），而非 SKILL.md 中的 name 字段。这是 Claude Code Skill 的标准调用规范。

📂 内置 8 种专业模板

模板	适用场景	触发关键词示例
`One-Pager`	融资路演 / 产品简介	"一页纸"、"one-pager"
`Long Doc`	白皮书 / 研究报告	"长文档"、"report"
`Resume`	专业简历	"简历"、"CV"、"resume"
`Letter`	正式商务信函	"信函"、"letter"
`Portfolio`	作品集 / 案例展示	"作品集"、"portfolio"
`Slides`	演讲演示文稿	"演示"、"slides"
`Equity Report`	财报 / 股东分析	"财报"、"equity"
`Changelog`	产品更新日志	"更新日志"、"changelog"

🛠️ 五、高阶技巧：个性化配置与避坑指南

📝 1. 持久化品牌配置（推荐）

创建文件 ~/.config/kami/brand.md，填入你的固定信息：

markdown 复制代码

# Brand Profile
- Name: 张三
- Title: 独立开发者 & AI 产品架构师
- Email: zhangsan@example.com
- Language: zh-CN
- Currency: CNY
- Tone: 专业、克制、数据驱动
- Notes: 避免使用"赋能""闭环"等词汇

每次生成文档时，Claude 会自动读取并填充，无需重复描述。

⚠️ 2. 常见避坑指南

问题	原因	解决方案
中文显示为方块	未安装仓耳今楷02字体	运行 `brew install --cask font-cang-er-jin-kai` 或手动安装
PDF 背景纯白	AI 未遵守约束规则	在提示词末尾追加 `严格遵守 Kami 的 8 条排版规则`
图表渲染错位	使用了 `rgba()` 或 CSS Grid	Kami 已内置规避逻辑，勿手动覆盖模板 CSS
商用字体侵权风险	仓耳今楷02 商用需授权	个人/内部使用免费；商用请替换为思源宋体或购买授权

🔌 3. 如何脱离 Claude 独立使用？

Kami 本质是 模板 HTML + CSS 约束 + 构建脚本。你完全可以：

克隆仓库：git clone https://github.com/tw93/kami.git
替换 templates/ 下的内容变量
运行 python3 scripts/build.py --input your.html --output doc.pdf
实现纯本地、无 AI 依赖的批量排版。

🎯 六、适合谁？不适合谁？

✅ 强烈推荐

产品经理 / 运营 / 创业者：需要快速产出可交付的方案、BP、一页纸
独立开发者 / 创作者：希望简历、作品集自带"印刷级"质感
AI 重度用户：厌倦了手动调整 AI 导出文档的排版格式

❌ 暂不推荐

需要复杂交互式图表（如 D3.js、动态数据看板）的团队
企业级文档管理系统（DMS）需求
追求"全自动内容生成"的用户（Kami 专注排版约束，内容仍需你或 AI 提供）

📝 结语

tw93/Kami 的出现，标志着 AI 工作流正从"能生成"迈向"能交付"。它用极简的约束系统，解决了 AI 时代最容易被忽视的痛点：好内容，往往毁于烂排版。

无论你是偶尔需要排版的职场人，还是追求极致交付体验的创作者，Kami 都能以接近零学习成本的方式，让你的文档"拿得出手、印得漂亮"。

🌐 官方仓库 ：https://github.com/tw93/Kami

🌍 在线演示 ：https://kami.tw93.fun/

📜 开源协议：MIT（代码/模板免费商用，中文字体请留意授权）

如果你已经安装并使用过 Kami，欢迎在评论区分享你的模板定制技巧或踩坑经验。下一期，我们将拆解 build.py 的渲染管线，手把手教你扩展自定义模板。👇

本文基于 Kami v1.4.1 编写，适用于 Claude Code 2025+ 版本。排版规则可能随版本迭代微调，请以官方 CHEATSHEET.md 为准。

告别 AI “排版灾难”：用 Kami 一键生成印刷级专业文档