Design System · v1.12.0 · 內測

Zhi

好內容,值得好版面。Zhi 用清晰的排版,讓文件更好讀。

Canvas#f5f4ed Accent#1B365D Serif公文楷體 / Charter Sans= Serif (一頁一字體)

00 · See it

輸出樣本

把文件需求交給 Claude。無論是一頁紙、長文、正式信件、作品集、履歷還是簡報,Zhi 都用少量清晰規則,把提示詞變成可交付的排版。同一份 brief 也能 交給繪圖模型,README 裡附了樣圖和可複製的提示詞。

履歷先選底板與頁數:預設純白、A4 一頁,可選暖米白或兩頁,照片依需求提供。完成後同時交付 HTML、PDF 與可編輯 DOCX。

Tesla 財報 · 3 頁

Equity Report · 中文

Tesla 財報 · 3 頁

Product resume

Resume · English

產品實習履歷,1 頁

Zhi 列印一頁紙

一頁紙 · 中文

Zhi 介紹,白底列印版,1 頁

Agent slides

Slides · English

Agent keynote, 8 slides

Landing Pages

落地頁範例

Zhi 與精選第三方產品頁面,呈現同一套克制的視覺語言。外部產品保留各自的真實身分。

Zhi 官網

Zhi

設計系統主頁

Luo 落文官網

Luo 落文

CJK 閱讀字體

Mole 官網

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 使用儲存庫內小於 6 MB 的 Slim zhi.zip。獲授權的內測使用者在本機建立 zhi-fonts-full.zip,再透過 bash scripts/ensure-fonts.sh--bundle 參數安裝;本站不提供公開下載。

02 · Manifesto

設計原則

暖米紙底,油墨藍點綴,serif 承擔層級,硬陰影與花俏配色都退後;這套系統面向印刷文件,負責把內容收束成穩定、清晰、易讀的版面。履歷預設純白底,也可選暖米白;其他文件維持原有暖米紙底。

  1. 1

    其他文件預設 parchment #f5f4ed;履歷預設純白,可選暖米白

  2. 2

    強調色只有油墨藍 #1B365D,不引入第二種彩色

  3. 3

    所有灰色暖調 (yellow-brown undertone),禁止冷藍灰

  4. 4

    中文使用方正公文楷體,拉丁字元保留獨立 Charter 字體

  5. 5

    一般文件正文 400、標題 500;履歷依樣本使用粗體

  6. 6

    行距三檔:緊湊標題 1.1-1.3 / 密排 1.4-1.45 / 閱讀 1.5-1.55

  7. 7

    Tag 背景必須實色 hex,禁止 rgba(WeasyPrint 雙層矩形 bug)

  8. 8

    陰影只用 ring 或 whisper shadow,不用硬 drop shadow

03 · Color

暖調克制

唯一強調色、純暖調中性灰、零冷色;油墨藍全文件不超過 5% 面積,超過就從克制變成堆砌。

畫布 · Canvas

Parchment

頁面底色,也是整套設計的溫度來源

#F5F4ED

Ivory

卡片 · 浮起容器

#FAF9F5

Warm Sand

按鈕預設背景 · 互動面

#E8E6DC

Deep Dark

深色頁面底,保留橄欖色調

#141413

主調 · Brand

Ink Blue

主色 · CTA · quote 豎線 · 章節標題

#1B365D

Ink Light

深色底連結 · 亮色

#2D5A8A

Dark Surface

深色主題容器 · 暖炭灰

#30302E

Error

錯誤,深暖紅,不刺眼

#B53333

中性 · Warm Neutrals

Near Black

#141413

Dark Warm

#3D3D3A

Olive

#504e49

Stone

#6b6a64

Tag Tints · rgba → 實色對照

這裡列的是油墨藍 #1B365D 疊加在 parchment 上的等效實色;Tag 背景不使用 rgba(),避免 WeasyPrint 的雙層矩形問題。

 Tag sample

0.08

#EEF2F7
 Tag sample

0.14

#E4ECF5
DefaultTag sample

0.18

#E4ECF5
 Tag sample

0.22

#D0DCE9
 Tag sample

0.30

#D6E1EE

04 · Typography

字體系統

一般文件保持正文 400、標題 500;履歷的粗體與分隔符遵循參考樣本。

紙 Aa

Serif · 標題

公文楷體 / Charter

中文用方正公文楷體,英文用獨立 Charter;中文履歷姓名用方正新楷體。

</>

Mono · 代碼

JetBrains Mono

用於代碼塊、版本號、hex 值與等寬數字,字號較正文低一檔。

層級(印刷品 pt · 螢幕 px ≈ pt × 1.33)

Display
高品質文件讀起來
清晰、穩定、有餘韻
36-48 pt
weight 500
line 1.10
Section H1
色彩系統 · Color
18-22 pt
weight 500
line 1.20
Subsection H2
畫布 · Canvas
14-16 pt
weight 500
line 1.25
Item H3
Tag Tints · rgba 對照
12-13 pt
weight 500
line 1.30
Body Lead
面向印刷文件的約束系統,目標是穩定、清晰、易讀。
11 pt
weight 400
line 1.55
Body
油墨藍全文件不超過 5% 面積,超過就從克制變成堆砌;所有灰色都有暖黃底色,R ≈ G > B 是基本規律。
9.5-10 pt
weight 400
line 1.55
Body Dense
密排正文用於履歷、一頁紙、名片、索引卡,中文 pt 字號下 1.4-1.45 的行距最舒服,英文網頁的 1.6 放進來會顯得鬆散。
9-9.2 pt
weight 400
line 1.40
Caption
圖註、腳註、說明文字,顏色用 olive 或 stone 降一級。
8.5-9 pt
weight 400
line 1.45
Label
Design System · v1.12.0
7.5-8 pt
weight 600
line 1.35

05 · Spacing & Shape

節奏與形

基礎單位 4pt,密度越高 margin 越小,場合越正式 margin 越大。

ScaleValueUse
xs2-3 pt同行內元素
sm4-5 pttag padding · 緊湊佈局
md8-10 pt元件內部
lg16-20 pt元件之間 · 卡片 padding
xl24-32 ptsection 標題 margin
2xl40-60 pt大 section 之間
3xl80-120 pt長文件章節之間

圓角尺度 · Radii

4 pt
極緊
6 pt
代碼塊
8 pt
預設卡片
12 pt
容器
16 pt
特色卡片
24 pt
大容器
32 pt
Hero

深度 · 陰影三法

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 圓角

Primary CTA Secondary Ghost

Tags · 三檔

實色 hex · 從弱到強選

極淡 0.08 標準 0.18 筆刷漸變

Quote

左 2pt 品牌實線 + olive 色

一千個 no 換一個 yes,寧可清淡,不可濃豔。

Metric

襯線數字 · 等寬數位

6文件類型
1強調色
8條規則

Section Title

15pt 襯線標題 · 字號建立層級

核心項目 · Selected Works

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 · 指標、正文與時間線

中文 A4 × 1 Ink Blue

07 · Diagrams

內聯圖表

十八種內聯 SVG 圖表涵蓋架構、流程與資料。告訴 Claude 需要哪種圖,即可按 Zhi 的配色與字體嵌入文件。

架構圖 · Architecture
CLIENT Browser SERVICE API DATA Database

系統元件與連接關係,一個焦點節點

流程圖 · Flowchart
Start Valid? Yes Process No Reject

決策分支,Yes / No 路徑,焦點為成功路徑

柱狀圖 · Bar Chart
Q1 Q2 Q3 Q4 180 220 195 240

季度營收對比,可選顏色漸變或單色

環形圖 · Donut Chart
60% 主營 主營業務 · 60% 服務收入 · 25% 其他來源 · 15%

營收結構拆解,支援 3-6 個分段

08 · Decision Lookup

決策速查

遇到「該用什麼」時先看這張表,不在表裡就回到基礎原則。

要做什麼怎麼做
大標題serif 500,字號按層級,line-height 1.10-1.30
正文閱讀sans 4009.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。日文與韓文為最佳努力的 CJK 路徑,交付前會做視覺 QA。