Kami （紙，かみ）在日语里是「纸张」——一个完稿想法落地的表面。这套设计系统的作者是 tw 93（macOS 清理工具 Mole 的作者），它的口号很朴素：好内容，值得好版面。
Kami的定位不仅仅是一个文档排版工具 skill ，更是面向 AI Agent 的设计约束系统。作者把长期沉淀的排版规则压缩成一套约束语言：暖米纸底、一种强调色、衬线承担层级、无硬阴影。任何 LLM Agent（Claude Code、Codex，或任何支持技能包的工具）拿到这套规则后，都能稳定输出可交付的文档，而不是每次会话都漂移成不同的灰色排版。它属于作者规划的三部曲之一：Kaku（書く）写代码、Waza（技）练习惯、Kami（紙）交付文档。
在这之前，用户遇到什么问题
让 AI 写文档，用户多半经历过类似场面：让 Claude 写一份研究报告，出来的东西是默认样式的灰底白字，标题层级混乱、表格对不齐、代码块挤成一团；换个会话重来一遍，排版又换了一套。内容是对的，可页面让人没有读下去的欲望。想要好看的输出，就得在提示词里反复描述「用衬线字体、别用阴影、留白多一点」，结果 agent 每次都理解得不太一样。
手动修也不轻松。做一份像样的简历、研报或演讲幻灯片，把内容排进模板要花大量时间；用工具链（如 ffmpeg、Node 环境）做 PDF 渲染又是一道门槛。Kami想解决的就是这件事：把「怎么排得专业」从每次对话里抽出来，变成一份 agent 可以直接执行的约束系统。
核心功能
一套约束语言，而不是一套 UI
Kami的设计核心是一条条可执行的规则：页面底色用暖米纸 parchment #f5f4ed，不用纯白；强调色只有油墨蓝 #1B365D 一种，全文档不超过 5% 面积；所有灰色带暖黄底色（R ≈ G > B），禁止冷蓝灰；serif 正文用 400、标题用 500，不用合成粗体；行距分紧凑、密排、阅读三档。反模式清单同样明确：Tag 背景用实色 hex 而不用 rgba（规避 WeasyPrint 的双层矩形 bug）、阴影只用 ring 或 whisper、不用硬投影。这套规则的目标是印刷品而非仪表盘——文档读起来像排过版的纸页，而不是控制台。
八种文档模板与落地页系统
内置八种文档模板：一页纸（One-Pager）、长文档、正式信件、作品集、简历、幻灯片、个股研报、更新日志，外加一套落地页系统，支持中、英、韩文。README 里附了真实产物示例：创始人简历、Tesla Q 1 2026 财报点评、Agent 主题演讲幻灯片、推荐信、产品发布说明等。用户只需描述需求，比如「帮我做一份简历」「帮我排版一份长文档」，模板会自动匹配。
十八种内联 SVG 图表
覆盖架构、流程、数据三大场景：架构图、流程图、柱状图、环形图等 18 种类型，配色与字体沿用 Kami设计语言。序列图、类图、ER 图可以直接用 Mermaid 文本编写—— beautiful-mermaid 负责渲染 SVG，scripts/mermaid_normalize.py 再重新上色为 Kami配色并做 WeasyPrint 兼容处理，全程不需要 Node 环境。
幻灯片三路渲染
幻灯片有三条渲染路径：默认用 WeasyPrint 把 HTML 转 PDF；按需用 python-pptx 生成可编辑的 PPTX；Markdown 优先的用户可以用 assets/templates/marp/ 下的 Marp 变体。代码块在安装 Pygments 时带语法高亮，没有 Pygments 时 PDF 依然能渲染，代码保持单色。
确定性质量验证
Kami 内置了四道质量闸门：按文档类型的内容 schema 先校验结构；可选的 brief 文件记录交付目标和验收边界；覆盖检查确认每个事实都进入成品页面；最后视觉检查把页面导出为图片对照固定清单逐项核对。仓库提交记录里也能看到这种「fail-closed」的验证哲学——发布前强制校验 tag、SHA 与包身份匹配。
零依赖 MCP 服务器
scripts/mcp_server.py 是一个零依赖的 MCP 服务器，暴露能力诊断、渲染、结构检查、截图四类工具，任何支持 MCP 的 Agent 都可以把 Kami 当渲染引擎直接驱动，无需加载完整技能提示词。安全边界写得很清楚：只渲染可信的本地 HTML，引用文件与 HTTP/HTTPS 资源按 MCP 进程自身权限加载。
四语支持与专属字体
英文、中文、日文、韩文四语，每种语言全页只用一款衬线字体：英文 Charter、中文 TsangerJinKai 02（仓耳今楷）、日文 YuMincho、韩文 Source Han Serif K，字距、行高、字号按语言做了印刷级调优。默认羊皮纸底，另有白底打印变体，把任意文档切到白底适配家用或办公打印机，暖意沉入卡片与表格。仓库检出时中文字体从本地字体文件加载、失败回退 jsDelivr CDN；安装为技能包后，scripts/ensure-fonts.sh 会把缺失的中韩字体恢复到用户字体目录。
品牌配置文件与版本检查
用户可以在 ~/.config/kami/brand.md 建立品牌档案：YAML 前置区存名称、角色、邮箱、品牌色、语言、纸张尺寸、语气等结构化字段，正文用 Markdown 记自由备注。Kami 把它当作最低优先级的上下文，只在当前请求含义模糊时采用，且随时可被具体文档需求覆盖。隐私方面，Kami 每天至多做一次静默版本检查：写入本地 XDG 缓存，然后解析 GitHub 最新公开发布版本，不上传任何用户文档或任务内容，离线或无缓存目录时静默失败。
越过纸张：落地页与图像简报
同一套约束也能越过纸面：落地页模板可以生成可部署的多语言静态站点（Kami、Luo 落文、Mole 鼹三款产品共用一套模板）；面向 AI 图像渲染器，Kami 会输出完整的设计简报——一段「暖米纸底、油墨蓝点缀、衬线标签、无渐变无阴影」的提示词，交给 ChatGPT Images 之类工具即可单次渲染出 Kami 风格插图，无需人工修图。
安装与使用
前置条件
- Claude Code 需要 v 2.1.142 或更高版本
- Codex 与 Claude Desktop 无额外版本要求
- 通用 Agent 需支持读取
~/.agents/目录
安装
四种安装方式：
| 平台 | 命令 / 步骤 |
| Claude Code | /plugin marketplace add tw93/kami 后 /plugin install kami@kami |
| Codex | codex plugin marketplace add tw93/kami 后 codex plugin add kami@kami |
| 通用 Agent | npx skills add tw93/kami/plugins/kami -a universal -g -y |
| Claude Desktop | 从 Releases 下载 kami.zip 资产（不要下载 Source code 包），在 Customize > Skills > 「+」> Create skill 中直接上传 |
注意：通用 Agent 安装必须走 plugins/kami 子路径，直接 tw93/kami 只会装到根目录的 SKILL.md 单文件；更新时建议重跑安装命令覆盖，暂时避免 npx skills update（vercel-labs/skills#1517 会误判仓库子路径安装）。Codex 更新用 codex plugin marketplace upgrade kami 后再 codex plugin add kami@kami。
日常使用
安装后无需斜杠命令，直接自然语言描述需求，技能自动触发。示例：「帮我做一份一页纸」「帮我排版一份长文档」「帮我写一封正式信件」「帮我做一份作品集」「帮我做一份简历」「帮我做一套演讲幻灯片」「帮我做一个产品落地页」。
| 场景 | 推荐说法 | 产出 |
| 产品介绍 | 「帮我做一份一页纸」 | One-Pager 模板，PDF |
| 深度内容 | 「帮我排版一份长文档」 | Long Doc 模板，PDF |
| 融资/路演 | 「帮我做一套演讲幻灯片」 | Slides 模板，PDF 或可编辑 PPTX |
| 个人品牌 | 「帮我做一份简历 / 作品集」 | Resume / Portfolio 模板，PDF |
| 官网宣传 | 「帮我做一个产品落地页」 | Landing Page 多语言静态站点 |
我的使用感受
Kami 最打动人的是它的克制：一种强调色、一款字体、一套反模式清单，把「专业感」变成了可复现的规则，而不是每次对话重新碰运气。作者在 README 里讲了缘起——常让 Claude 写美股研报，受不了默认灰色样式，于是一条条调字体、配色、间距，直到报告变成自己愿意读的页面；后来为《你不知道的 Agent》分享排版幻灯片，又加了内联 SVG 图表与统一暖色调，最终抽象成 Kami。
这种「从自己真实需求里长出来」的工具，规则往往最干净。工程上它同样诚实：MCP 只渲染可信本地 HTML、版本检查不上传内容、无托管 API，边界都写在明处；唯一需要用户留意的是字体条款——中文仓耳今楷仅个人免费，商用需单独取得许可。
官方网站
https://kami.tw93.fun/index-zh.html
下载地址
https://pan.quark.cn/s/8f6cce762672
