Kami：开源AI文档设计系统，标准化排版约束让输出直接可交付

一、Kami是什么

Kami（紙，日语中“纸”的意思）是一套专为AI Agent打造的约束式文档设计系统，由开源作者tw93（大漠穷秋）开发，是其“工作方法论三部曲”的终章（另外两个项目为Kaku<AI编程终端>、Waza<习惯养成工具>）。它的核心使命是解决AI生成文档时样式混乱、排版随意、风格不一致的痛点，通过一套标准化视觉约束与模板体系，让AI输出的文档直接具备专业印刷级质感，无需二次排版调整。

Kami并非传统UI框架或文档编辑器，而是面向印刷品与静态文档的美学约束系统——简单到AI能稳定执行，严格到每份输出风格统一且可直接交付。其设计理念可概括为：Good content deserves good paper（好内容值得好纸张）。

二、功能特色

1. 六大核心文档模板（中英双语）

内置6类高频办公文档模板，覆盖绝大多数专业交付场景，均支持中英双语自动适配：

• One-Pager（一页纸方案）：执行摘要、项目简介、商业计划书单页版；

• Resume（简历）：结构化个人简历、创始人CV、求职简历；

• Slides（幻灯片）：演讲PPT、主题分享、项目路演（支持导出PDF/PPTX）；

• Long Doc（长文档）：白皮书、技术报告、财报分析、研究论文；

• Letter（正式信件）：推荐信、商务信函、官方通知；

• Portfolio（作品集）：项目作品集、设计作品集、个人成果展示。

2. 标准化视觉设计体系

Kami的核心竞争力是一套严格且统一的视觉约束规则，所有模板均遵循此规范，彻底杜绝AI生成内容的样式漂移：

• 底色规范：暖米色背景（#f5f4ed），模拟羊皮纸质感，避免纯白刺眼与廉价感；

• 色彩体系：仅用墨蓝色（#1B365D）作为强调色，无其他彩色，营造专业沉稳氛围；

• 字体规则：优先使用衬线字体（Serif），正文400字重、标题500字重，中英文字体智能匹配；

• 排版细节：行高严格控制在1.4-1.55，段落留白均衡，无硬阴影，纯暖色调适配印刷与屏幕阅读；

• 图表支持：内置14种嵌入式SVG图表（架构图、流程图、四象限图等），无需外部依赖，渲染稳定。

3. AI友好的极简交互

• 自然语言触发：无需复杂指令或斜杠命令，直接用日常语言描述需求即可自动生成文档；

• 中文示例：“帮我生成一份特斯拉Q1财报分析长文档”“做一套6页的AI主题演讲幻灯片”；

• 英文示例：“make a 2-page resume for a software engineer”；

• 零配置开箱即用：安装后默认启用标准化风格，无需手动调整字体、配色、间距；

• 个性化品牌定制：支持创建~/.config/kami/brand.md文件，通过YAML前置元数据定义个人/品牌默认风格（名称、邮箱、品牌色、页面尺寸、语气等），模糊需求时自动生效。

4. 轻量高效与多端适配

• 无数据库依赖：纯HTML/CSS架构，加载速度快，首屏渲染控制在毫秒级；

• 多平台支持：适配Claude Code、Claude Desktop、Codex、OpenCode等主流AI Agent工具；

• 打印友好：所有模板均针对打印优化，排版规整、色彩适配纸质输出；

• 轻量包体：以ZIP包分发，体积小，上传安装便捷，更新简单（重新下载替换即可）。

三、技术细节

1. 核心架构：内容与载体解耦

Kami采用内容数据与展示层分离的设计理念，架构简洁高效，数据流清晰：

+----------+   +----------+   +----------+
| 内容源 | ---> | Kami 模板 | ---> | 用户浏览器/打印 |
| (Markdown)|   | (HTML/CSS)|   | (渲染引擎)   |
+----------+   +----------+   +----------+

• 内容源：AI生成的Markdown格式文本，专注内容创作；

• Kami模板：封装严格的排版规则与视觉样式，负责格式渲染；

• 输出端：支持浏览器预览、PDF导出、直接打印，适配多场景交付。

2. 关键技术实现

• 约束语言设计：定义一套简洁的排版约束语法，包含页面布局、字体层级、色彩规范、间距规则等，AI可精准解析并执行；

• SVG图表内置化：所有图表均采用嵌入式SVG，无外部CDN依赖，避免渲染失败，同时保证清晰度；

• 字体加载策略：优先从本地加载系统衬线字体，本地无则从jsDelivr CDN拉取备用字体，平衡加载速度与渲染一致性；

• PDF渲染优化：基于WeasyPrint引擎生成PDF，针对透明度叠加、边框渲染等问题做专项优化，避免排版错乱；

• 跨语言适配逻辑：中英双语智能识别，自动匹配对应字体与排版规则；日语通过CJK路径做最大努力适配，交付前需视觉校验。

3. 技术栈与依赖

• 核心语言：HTML、CSS、JavaScript；

• 分发形式：Claude Code Skill、ZIP技能包（适配Claude Desktop）；

• 外部依赖：无重型框架依赖，仅少量轻量工具库，保证轻量与稳定性；

• 开源协议：MIT许可证，可自由使用、修改和分发。

四、应用场景

Kami聚焦专业文档交付场景，适合个人、创业者、职场人士、团队及AI开发者使用，核心场景包括：

1. 商业报告生成：财报分析、行业研究、市场调研报告，一键生成排版专业的PDF文档；

2. 求职与个人展示：结构化简历、个人作品集，风格统一且具备高级质感，提升通过率；

3. 演讲与路演材料：项目路演PPT、主题分享幻灯片，排版简洁大气，重点突出；

4. 正式商务文书：商务信函、推荐信、官方通知，符合正式文档规范，专业严谨；

5. 技术与学术文档：技术白皮书、研究论文、项目文档，适配长文档排版，阅读体验流畅；

6. AI工具集成：AI Agent开发者可集成Kami，为用户提供“内容生成+专业排版”一站式服务，提升产品竞争力。

五、使用方法

1. 环境准备

Kami主要适配Claude生态工具（Claude Code、Claude Desktop）及通用AI Agent（Codex、OpenCode等），需提前安装对应AI工具并配置环境。

2. 安装步骤

（1）Claude Code 安装（推荐）

打开终端，执行一行命令完成安装：

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

（2）通用AI Agent 安装（Codex、OpenCode等）

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

（3）Claude Desktop 安装

1. 访问Kami发布页（https://github.com/tw93/kami/releases），下载最新版`kami.zip`；

2. 打开Claude Desktop，进入「自定义 > 技能 > + > 创建技能」；

3. 直接上传kami.zip（无需解压），完成安装；

4. 更新时重新下载最新版ZIP，替换原有技能即可。

3. 基础使用

1. 打开已集成Kami的AI工具；

2. 用自然语言描述文档需求，示例：

• “帮我生成一份3页的人工智能行业研究长文档”；

• “制作一份简洁的英文简历，包含工作经历和技能”；

• “生成一套5页的项目路演幻灯片，风格简洁专业”；

3. AI自动调用Kami模板，生成符合规范的文档（支持预览、导出PDF/PPTX、打印）。

4. 个性化品牌定制（可选）

1. 在本地创建配置文件：~/.config/kami/brand.md；

2. 文件内容示例（YAML前置元数据+Markdown正文）：

---
name: 张三
role: 产品经理
email: zhangsan@example.com
brandColor: "#1B365D"
pageSize: A4
language: zh
tone: professional
---
# 个人品牌文档
专注AI产品设计与用户体验优化，5年行业经验...

3. 保存后，模糊需求（如“生成一份个人介绍文档”）将自动应用该配置风格。

六、竞品对比

选取2款主流AI文档工具（WPS灵犀、Notion AI）与Kami从核心定位、排版能力、模板体系、AI适配性、使用门槛5个维度对比，如下表：

七、常见问题解答

1. Kami支持哪些语言？

优先支持英语、中文，双语自动适配；日语通过CJK路径做最大努力适配，交付前建议进行视觉校验，避免排版错乱。

2. 生成的文档可以导出哪些格式？

默认支持PDF格式导出（适配打印与分享）；幻灯片模板额外支持PPTX格式导出，方便二次编辑。

3. 可以自定义模板吗？

目前Kami以标准化模板为核心，暂不支持自定义模板，但支持通过brand.md配置文件自定义个人/品牌风格（品牌色、页面尺寸、语气等），满足个性化需求。

4. 安装后无法触发Kami，怎么办？

首先确认AI工具版本适配（Claude Code需最新版）；其次检查安装命令是否正确，重新执行安装；最后确认需求描述清晰，避免过于模糊（如“生成文档”需明确类型，如“生成一页纸方案”）。

5. Kami免费吗？有付费功能吗？

Kami是开源项目，采用MIT许可证，完全免费，无付费功能，可自由使用、修改和分发。

6. 支持团队协作使用吗？

目前Kami主要面向个人用户，暂不支持团队协作功能；团队可通过共享配置文件的方式，统一文档风格，间接实现团队风格统一。

八、相关链接

• GitHub仓库：https://github.com/tw93/Kami

九、总结

Kami是一款聚焦AI文档排版痛点的开源设计系统，以“好内容值得好纸张”为理念，通过标准化视觉约束、六大专业模板、AI友好交互与轻量架构，让AI生成文档告别平庸样式，直接具备专业印刷级质感。它无需复杂配置，自然语言即可触发，适配主流AI Agent工具，兼顾个人使用与品牌定制需求，是AI时代提升文档交付质量的高效工具，尤其适合需要频繁生成专业文档的职场人士、创业者与AI开发者。