Zhi纸
好内容，值得好版面。Zhi 用清晰的排版，让文档更好读。
00 · See it
输出样本
把文档需求交给 Claude。无论是一页纸、长文、正式信件、作品集、简历还是幻灯片，Zhi 都用少量清晰规则，把提示词变成可交付的排版。同一份 brief 也能 交给绘图模型，README 里附了样图和可复制的提示词。
简历先选底板和页数：默认纯白、A4 一页，可选暖米白或两页，照片按需提供。完成后同时交付 HTML、PDF 和可编辑 DOCX。
个股研报
Tesla 财报 · 3 页
Resume · English
产品实习简历，1 页
一页纸 · 中文
Zhi 介绍，白底打印版，1 页
Slides · English
Agent keynote, 8 slides
Landing Pages
落地页示例
Zhi 与精选第三方产品页面，展示同一套克制的视觉语言。外部产品保留各自的真实身份。
Zhi
设计系统主页
Luo 落文
CJK 阅读字体
Mole 鼹
macOS 系统工具
01 · Usage
安装与调用
直接告诉 Claude 你要什么，比如「帮我排版一份白皮书」「做一份简历」「帮我做一份作品集」，skill 会自动触发，无需斜杠命令。
目前为私有内测，尚未正式发行。先获得仓库访问权限，按内测指引克隆代码，再使用以下本地安装命令。
# Authorized checkout gh auth login gh repo clone okht/zhi ./zhi # Claude Code (v2.1.142+) /plugin marketplace add ./zhi /plugin install zhi@zhi # Codex plugin marketplace codex plugin marketplace add ./zhi codex plugin add zhi@zhi
通用 agent：npx skills add ./zhi/plugins/zhi -a universal -g -y。从已克隆的轻量插件目录安装。
Claude Desktop 使用仓库内的 Slim zhi.zip（小于 6 MB）。授权内测用户可本地构建 zhi-fonts-full.zip，通过 bash scripts/ensure-fonts.sh 的 --bundle 安装；本站不提供公开下载。
02 · Manifesto
设计原则
暖米纸底，油墨蓝点缀，serif 承担层级，硬阴影与花哨配色都退后；这套系统面向印刷文档，负责把内容收束成稳定、清晰、易读的版面。简历默认纯白底，也可选暖米白；其他文档继续使用原有暖米纸底。
- 1
文档底板
#f5f4ed；简历默认纯白 - 2
强调色只有油墨蓝
#1B365D，不引入第二种彩色 - 3
所有灰色暖调 (yellow-brown undertone)，禁止冷蓝灰
- 4
中文使用方正公文楷体，拉丁字符保留独立 Charter 字体
- 5
通用文档正文 400、标题 500；简历按样本使用加粗
- 6
行距三档：紧凑标题 1.1–1.3 / 密排 1.4–1.45 / 阅读 1.5–1.55
- 7
Tag 背景必须实色 hex，禁止 rgba（WeasyPrint 双层矩形 bug）
- 8
阴影只用 ring 或 whisper shadow，不用硬 drop shadow
03 · Color
暖调克制
唯一强调色、纯暖调中性灰、零冷色；油墨蓝全文档不超过 5% 面积，超过就从克制变成堆砌。
画布 · Canvas
Parchment
页面底色，也是整套设计的温度来源
#F5F4EDIvory
卡片 · 浮起容器
#FAF9F5Warm Sand
按钮默认背景 · 交互面
#E8E6DCDeep Dark
深色页面底，保留橄榄色调
#141413主调 · Brand
Ink Blue
主色 · CTA · quote 竖线 · 章节标题
#1B365DInk Light
深色底链接 · 亮色
#2D5A8ADark Surface
深色主题容器 · 暖炭灰
#30302EError
错误，深暖红，不刺眼
#B53333中性 · Warm Neutrals
Near Black
#141413Dark Warm
#3D3D3AOlive
#504e49Stone
#6b6a64Tag Tints · rgba → 实色对照
这里列的是油墨蓝 #1B365D 叠加在 parchment 上的等效实色；Tag 背景不使用 rgba()，避免 WeasyPrint 的双层矩形问题。
0.08
#EEF2F70.14
#E4ECF50.18
#E4ECF50.22
#D0DCE90.30
#D6E1EE04 · Typography
字体系统
通用文档保持正文 400、标题 500；简历的加粗与分隔符遵循参考样本。
紙 Aa
Serif · 标题
公文楷体 / Charter
中文用方正公文楷体，英文用独立 Charter；中文简历姓名用方正新楷体。
</>
Mono · 代码
JetBrains Mono
用于代码块、版本号、hex 值与等宽数字，字号较正文低一档。
层级（印刷品 pt · 屏幕 px ≈ pt × 1.33）
清晰、稳定、有余韵
weight 500
line 1.10
weight 500
line 1.20
weight 500
line 1.25
weight 500
line 1.30
weight 400
line 1.55
weight 400
line 1.55
weight 400
line 1.40
weight 400
line 1.45
weight 600
line 1.35
05 · Spacing & Shape
节奏与形
基础单位 4pt，密度越高 margin 越小，场合越正式 margin 越大。
| Scale | Value | Use | |
|---|---|---|---|
| xs | 2–3 pt | 同行内元素 | |
| sm | 4–5 pt | tag padding · 紧凑布局 | |
| md | 8–10 pt | 组件内部 | |
| lg | 16–20 pt | 组件之间 · 卡片 padding | |
| xl | 24–32 pt | section 标题 margin | |
| 2xl | 40–60 pt | 大 section 之间 | |
| 3xl | 80–120 pt | 长文档章节之间 |
圆角尺度 · Radii
深度 · 阴影三法
Zhi 不用传统硬阴影，深度交给 ring shadow、whisper shadow 与明暗交替。
Ring Shadow
0 0 0 1pt var(--ring-warm)
按钮 · 卡片 hover
Whisper Shadow
0 4pt 24pt rgba(0,0,0,0.05)
极轻浮起 · 特色卡
Light ⇌ Dark
parchment ⇌ deep-dark
section 级别 · 对比最明显
06 · Components
原子组件
组件不求多，只保留能解决具体问题的一组。
Buttons
ring shadow 替代硬投影 · 8pt 圆角
Tags · 三档
实色 hex · 从弱到强选
Quote
左 2pt 品牌实线 + olive 色
一千个 no 换一个 yes，宁可清淡，不可浓艳。
Metric
衬线数字 · 等宽数位
Section Title
15pt 衬线标题 · 字号建立层级
Dash List
短横线代替圆点 · 更书卷气
- 常规文档用暖米纸底；简历可用纯白
- 油墨蓝点缀，不引第二色
- Serif 承担权威
Code Block
象牙白底 · 4pt 圆角 · 等宽字体
// 暖米纸 · 一种克制的温度 canvas = parchment; accent = ink_blue palette = warm_neutrals − cool_grays document = serif × hierarchy + generous_space beauty = constraints × intention ÷ noise
Featured Card
whisper shadow + 16pt 圆角
Tesla 公司介绍 · One-Pager
中文 A4 · 指标、正文与时间线
07 · Diagrams
内联图表
十八种内联 SVG 图表覆盖架构、流程与数据。告诉 Claude 需要哪种图，即可按 Zhi 的配色与字体嵌入文档。
系统组件与连接关系，一个焦点节点
决策分支，Yes / No 路径，焦点为成功路径
季度营收对比，可选颜色渐变或单色
营收结构拆解，支持 3–6 个分段
08 · Decision Lookup
决策速查
遇到「该用什么」时先看这张表，不在表里就回到基础原则。
| 要做什么 | 怎么做 |
|---|---|
| 大标题 | serif 500，字号按层级，line-height 1.10–1.30 |
| 正文阅读 | sans 400，9.5–10 pt，line-height 1.55 |
| 强调一个数字 | color: var(--brand)，不要粗体 |
| 分隔两段内容 | 2.5pt 品牌色左侧竖线，或 0.5pt 暖灰虚线 |
| 引用某人的话 | 左 2pt 品牌色实线 + olive 色 |
| 展示代码 | ivory 底 + 4pt 圆角 + mono 字体，无边框 |
| 区分主次按钮 | Primary 品牌色填充 + ivory 字；Secondary warm-sand + charcoal |
| 标注某张特殊卡片 | border-left: 1.4pt solid var(--brand)，只标一条边 |
| 章节开始 | serif 500 · 15pt · 纯字号层级，无额外装饰 |
| 文档封面 | 单页 Display 字号 + 右对齐作者/日期 + 大量留白 |
| 展示关键数字 | 基线一行排开，透明不做容器 + serif 大数字（油墨蓝） + sans 小标签 |
09 · Anti-Patterns
反面示例
破例可以，但理由要足够清楚。
页面底色
忌避免 #f3f4f6 冷灰。简历与白底打印版可用纯白。
宜始终使用 #f5f4ed parchment，打印时把 @page background 也设为同色，避免白边。
Tag 着色
忌Tag 用 rgba(27,54,93,0.18)，WeasyPrint 会让 padding 区与字形区透明度叠加，形成双层矩形。
宜查 tint 对照表，改用等效实色 #E4ECF5，颜色稳定，PDF 也干净。
合成粗体
忌通用文档标题过度合成加粗，会模糊笔画、削弱层级。
宜保留原字体：正文 400、标题 500；用字号或品牌色左侧竖线强调。简历加粗遵循样本。
阴影
忌box-shadow 硬投影 0 2px 8px rgba(0,0,0,0.3) 观感偏硬，印刷时也容易发黑。
宜用 ring shadow (0 0 0 1pt)、whisper (rgba 0.05)，或直接用明暗交替建立层次。
10 · Background
让内容成为好文档
Zhi 用中文楷体、清晰层级和统一留白，照顾日常文档工作。信件、简介、研究报告、作品集和演示稿，沿用同一套克制的排版规则。
简历从已有材料出发。完整原稿保留文字，通过排版改善阅读；零散经历则通过逐步提问整理。底板、页数和照片按需求设置，最终交付可编辑文件与校验过的 PDF。
11 · 常见问题
FAQ
- Zhi 是什么？
- 一个面向 AI agent 的文档设计系统。一种强调色、衬线层级、暖色羊皮纸画布。给任何 LLM agent 一段描述，就能得到稳定的排版输出。也可以作为视觉设计简报给到 Claude Design 或 GPT Canvas 这类图像渲染工具。
- 能生成什么？
- 八种文档模板：一页纸、长文档、信件、作品集、简历、幻灯片、个股研报、更新日志，外加一套落地页系统。简历会先路由到润色、从零构建或依据材料重建，再经过视觉引导、动态排版和原文保护，交付 HTML、PDF 与校验过页数的可编辑 DOCX。另有 18 种内联 SVG 图表。 简历默认纯白、A4 一页，可选暖米白或两页，照片按需提供。
- 怎么安装？
- 目前为私有内测，尚未正式发行。获得仓库访问权限后，先克隆代码，再从本地插件市场安装。Claude Desktop 使用仓库内的 zhi.zip；获授权的内测用户在本地构建 zhi-fonts-full.zip，并通过 bash scripts/ensure-fonts.sh --bundle 安装。
- 支持哪些语言？
- 支持中、英、日、韩文。中文用方正公文楷体，简历姓名用方正新楷体，拉丁文本用 Charter。日文用 YuMincho；韩文文档用 Source Han Serif K，韩文简历用 Nanum Myeongjo。