## 为什么选择 Kami Kami (紙, かみ) 在日语中是纸的意思：它是成熟创意最终落脚的表面。AI 生成文档的能力已经超越了大多数人手动排版的水平。目前缺失的环节并非能力，而是约束：如果没有设计系统，每次生成的文档都会滑向千篇一律的灰色和不一致的排版。 Kami 填补了这一空白：一套约束语言，九个模板。它足够简单，能让 agent 稳定运行；又足够严格，确保每次生成的成品都达到可直接交付的标准。英语和中文是作为一等公民支持的；日语和韩语则通过尽力而为的 CJK 路径支持，并在交付前进行视觉 QA。 这是三部曲的一部分：[Kaku](https://github.com/tw93/Kaku) (書く) 编写代码，[Waza](https://github.com/tw93/Waza) (技) 训练习惯，[Kami](https://github.com/tw93/Kami) (紙) 交付文档。 ## 效果展示

Equity Report · 中文 Tesla Q1 2026 财报点评

Slides · English Agent keynote, 6 slides

Resume · 한국어 개발자 이력서, 2페이지

Portfolio · 日本語 Kaku ターミナル作品集 · 7 ページ

## 落地页 落地页模板的实际应用：三个产品，同一套约束规范。此外还附带了五个 `.example` 配套文件（vercel、sitemap、robots、llms、llms-full），以支持多语言部署。

Kami · English Design system homepage

Luo · 中文 CJK reading font specimen

Mole · English macOS system utility

## 使用方法 **Claude Code** ``` npx skills add tw93/kami -a claude-code -g -y ``` **Claude Code 插件市场**（需要 Claude Code v2.1.142+） ``` /plugin marketplace add tw93/kami /plugin install kami@kami ``` **通用 agent**（Codex、OpenCode、Pi 以及其他从 `~/.agents/` 读取配置的工具） ``` npx skills add tw93/kami -a '*' -g -y ``` **Claude Desktop** 下载 [kami.zip](https://github.com/tw93/kami/releases/latest/download/kami.zip)，打开“自定义 > 技能 > "+" > 创建技能”，然后直接上传该 ZIP 文件（无需解压）。 该 ZIP 包非常轻量：技能包中排除了大型 CJK 字体。在代码仓库的 checkout 中，它们会优先从本地字体文件加载，然后通过 jsDelivr CDN 加载；在已安装的技能中，`scripts/ensure-fonts.sh` 会将缺失的中文或韩文字体恢复到用户字体目录中。如需更新：再次下载同一 URL，点击技能卡片上的“...”，选择“替换”并上传。 该技能会根据自然语言请求自动触发，无需使用斜杠命令。针对英语和中文进行了优化；日语和韩语则通过尽力而为的 CJK 路径支持，并在交付前进行视觉 QA。 各语言的提示词示例： - English: `make a one-pager for my startup` / `turn this research into a long doc` / `write a formal letter` / `make a portfolio of my projects` / `build me a resume` / `design a slide deck for my talk` / `make this talk as a Marp deck` / `build a landing page for my app` - 中文: `帮我做一份一页纸` / `帮我排版一份长文档` / `帮我写一封正式信件` / `帮我做一份作品集` / `帮我做一份简历` / `帮我做一套演讲幻灯片` / `帮我做一份 Markdown 风格的演示稿` / `帮我做一个产品落地页` - 日本語: `スタートアップ向けの一枚資料を作って` / `この調査を長文レポートに整えて` / `正式な依頼文を作って` / `プロジェクト作品集を作って` / `履歴書を作って` / `登壇用スライドを作って` / `Marp で登壇スライドを作って` / `アプリのランディングページを作って` - 한국어: `스타트업 원페이저를 만들어줘` / `이 리서치를 장문 문서로 정리해줘` / `정식 레터를 작성해줘` / `프로젝트 포트폴리오를 만들어줘` / `이력서를 만들어줘` / `발표용 슬라이드를 만들어줘` / `Marp 슬라이드로 만들어줘` / `앱 랜딩 페이지를 만들어줘` **可选：品牌档案** 创建 `~/.config/kami/brand.md` 来持久化保存身份、品牌、默认设置和书写习惯。查看 [brand.example.md](references/brand.example.md) 获取完整模板。 该文件包含 YAML frontmatter（结构化字段：姓名、角色、邮箱、网站、GitHub、品牌色、语言、页面大小、货币区域设置、语气等）以及用于自由记录的 Markdown 正文。Kami 会将其视为最低层级的上下文：仅在当前请求存在歧义时才应用，且始终可以被具体文档的特殊需求覆盖。这样做的目的是让你的作品具有熟悉感，而不会让所有输出看起来千篇一律。 ## 设计 温暖的羊皮纸画布，以墨蓝色作为唯一的强调色，使用衬线字体构建层级，没有生硬的阴影或花哨的调色板。它不是 UI 框架，而是用于印刷品的约束系统。文档读起来应该是精心编排的页面，而不是仪表盘。 包含九种模板类型：单页 (One-Pager)、长文档 (Long Doc)、信件 (Letter)、作品集 (Portfolio)、简历 (Resume)、幻灯片 (Slides)、股票研报 (Equity Report)、更新日志 (Changelog) 和落地页 (Landing Page)，支持 EN、CN 和 KO 语言。内置十四种内联 SVG 图表类型。幻灯片支持三种渲染路径：WeasyPrint HTML 转 PDF（默认）、python-pptx（可编辑的 PPTX，按需提供），以及位于 `assets/templates/marp/` 的 Marp 变体（适用于 Markdown 优先的演示文稿）。当安装了 `Pygments` 时，代码块支持基于 Pygments 的语法高亮；如果未安装，PDF 仍可正常渲染，代码将保持单色。Kami 会根据你书写时使用的语言自动选择合适的变体。 | 元素 | 规则 | |---|---| | 画布 | `#f5f4ed` 羊皮纸色，绝不使用纯白 | | 强调色 | 仅使用墨蓝色 `#1B365D`，无其他色相 | | 中性色 | 全部为暖色调（黄褐色底色），无冷感的蓝灰色 | | 衬线字体 | 正文 400，标题 500。避免合成粗体 | | 行高 | 紧凑型标题 1.1-1.3，密集型正文 1.4-1.45，阅读型正文 1.5-1.55 | | 阴影 | 仅使用环状或微弱阴影，无生硬的投射阴影 | | 标签 | 仅使用纯十六进制 (hex) 背景。`rgba()` 会触发 WeasyPrint 的双矩形 Bug | **字体**：每种语言在整个页面中均使用单一的衬线字体。中文：TsangerJinKai02。日语：YuMincho。韩语：Source Han Serif K。英语：Charter。TsangerJinKai 供个人免费使用，商业使用需从 [tsanger.cn](https://tsanger.cn) 获取许可。Source Han Serif K 采用 OFL 许可。所有其他字体均为系统自带。 完整规范：[design.md](references/design.md)。速查表：[CHEATSHEET.md](CHEATSHEET.md)。 ## 转换应用 这套约束系统也可以作为一份简要规范，直接交予任何绘图工具使用。将其指向 [references 文件夹](references/)，输出的内容就会继承温暖的羊皮纸底色、墨蓝色的克制感、单线几何图标和编辑级的排版风格。

Evidence layout · 中文 Tesla Optimus 手部和前臂专利图一览

Architecture redraw · English SpatialVLA Figure 1, schematic

Concept tradeoff · 中文 3D 表示的算力-推理性取舍

_{由 ChatGPT Images 2.0 单次渲染生成，未经任何手动修饰。Kami 制定规范，渲染器负责绘制。} ## 背景 我喜欢投资美股，并经常让 Claude 撰写研报。然而每次输出的外观都千篇一律：灰暗、扁平，且每次会话的排版都不一样。结构难以快速浏览，排版显得过时，整个页面没有任何能吸引我继续阅读下去的元素。于是我开始逐一修正它的排版、配色和间距，直到这份研报变成了一页我真正乐于阅读的内容。 后来我需要做一个名为“你不知道的 Agent：原理、架构与工程实践”的演讲。我已经有了现成的文档，不想从头制作幻灯片，所以我使用 Claude Design 以我自己的风格对其进行排版，经过一轮又一轮的调整，最终达到了我满意的效果。这个过程中加入了内联 SVG 图表、统一的暖色调色板以及更紧凑的编辑节奏。它不断扩展，最终涵盖了我日常交付的所有文档类型。因此，我不断对这个过程进行抽象，它最终演变成了 kami：一套宁静的设计系统，我可以将它交给任何 agent，并完全信任其输出的结果。 ## 许可证 kami 的代码和模板采用 MIT 许可证。欢迎自由使用和贡献。 **字体**：TsangerJinKai02（中文）仅供个人免费使用；商业使用需从 [tsanger.cn](https://tsanger.cn) 获取许可。Charter（英文）、YuMincho（日文）、Source Han Serif K（韩文，OFL 许可）以及 CJK 回退字体均为系统自带或基于开源许可。

标签：AI文档生成, IPv6支持, 后端开发, 排版工具, 排版设计, 模板引擎, 设计系统, 逆向工具, 防御加固