返回 ppt-master
design_spec.md
1 # 林徽因:被文学光环遮蔽的建筑巨匠 - Design Spec
2
3 > This document is the human-readable design narrative — rationale, audience, style, color choices, content outline. It is read once by downstream roles for context.
4 >
5 > The machine-readable execution contract lives in `spec_lock.md` (short form of color / typography / icon / image decisions). Executor re-reads `spec_lock.md` before every SVG page to resist context-compression drift. Keep the two files in sync; if they diverge, `spec_lock.md` wins.
6
7 ## I. Project Information
8
9 | Item | Value |
10 | ---- | ----- |
11 | **Project Name** | 林徽因:被文学光环遮蔽的建筑巨匠 |
12 | **Canvas Format** | PPT 16:9 (1280×720) |
13 | **Page Count** | 10 |
14 | **Design Style** | General Versatile (A) |
15 | **Target Audience** | 文化爱好者、建筑学关注者、历史人文读者 |
16 | **Use Case** | 知识分享、纪念专题、文化传播 |
17 | **Created Date** | 2026-04-21 |
18
19 ---
20
21 ## II. Canvas Specification
22
23 | Property | Value |
24 | -------- | ----- |
25 | **Format** | PPT 16:9 |
26 | **Dimensions** | 1280×720 |
27 | **viewBox** | `0 0 1280 720` |
28 | **Margins** | 左右 60px,上下 50px |
29 | **Content Area** | 1160×620 (60,50 → 1220,670) |
30
31 ---
32
33 ## III. Visual Theme
34
35 ### Theme Style
36
37 - **Style**: General Versatile — 图文并茂、视觉叙事
38 - **Theme**: Dark theme(深色主题)
39 - **Tone**: 中式古典建筑美学 × 人文纪念感。以深藏青为底、古铜金为魂,营造庄重典雅、跨越时空的历史感
40
41 ### Color Scheme
42
43 | Role | HEX | Purpose |
44 | ---- | --- | ------- |
45 | **Background** | `#1A1A2E` | 深藏青页面背景,沉稳厚重 |
46 | **Secondary bg** | `#16213E` | 卡片底色、分区背景 |
47 | **Primary** | `#C9A96E` | 古铜金,标题装饰、关键区块、图标 |
48 | **Accent** | `#E8D5B7` | 暖象牙,高光数据、重点信息 |
49 | **Secondary accent** | `#8B6F47` | 深棕色,辅助强调、渐变过渡 |
50 | **Body text** | `#E8E8E8` | 浅灰白正文文字 |
51 | **Secondary text** | `#A0A0B0` | 灰色注释说明 |
52 | **Tertiary text** | `#6B6B80` | 页码、辅助信息 |
53 | **Border/divider** | `#2A2A4A` | 卡片边框、分隔线 |
54 | **Success** | `#4CAF50` | 正向指标(绿色系) |
55 | **Warning** | `#E57373` | 问题标记(红色系) |
56
57 ### Gradient Scheme
58
59 ```xml
60 <!-- 标题渐变(金色系) -->
61 <linearGradient id="titleGradient" x1="0%" y1="0%" x2="100%" y2="100%">
62 <stop offset="0%" stop-color="#C9A96E"/>
63 <stop offset="100%" stop-color="#E8D5B7"/>
64 </linearGradient>
65
66 <!-- 背景装饰光晕 -->
67 <radialGradient id="bgDecor" cx="80%" cy="20%" r="50%">
68 <stop offset="0%" stop-color="#C9A96E" stop-opacity="0.08"/>
69 <stop offset="100%" stop-color="#C9A96E" stop-opacity="0"/>
70 </radialGradient>
71
72 <!-- 卡片渐变底色 -->
73 <linearGradient id="cardGradient" x1="0%" y1="0%" x2="0%" y2="100%">
74 <stop offset="0%" stop-color="#16213E"/>
75 <stop offset="100%" stop-color="#1A1A2E"/>
76 </linearGradient>
77 ```
78
79 ---
80
81 ## IV. Typography System
82
83 ### Font Plan
84
85 **Recommended preset**: P3 — Culture/Arts/Humanities
86
87 | Role | Chinese | English | Fallback |
88 | ---- | ------- | ------- | -------- |
89 | **Title** | KaiTi | Georgia | serif |
90 | **Body** | Microsoft YaHei | Arial | sans-serif |
91 | **Code** | - | Consolas | Monaco |
92 | **Emphasis** | SimHei | Arial | sans-serif |
93
94 **Font stack**: `"KaiTi", Georgia, serif` (标题) / `"Microsoft YaHei", Arial, sans-serif` (正文)
95
96 ### Font Size Hierarchy
97
98 **Baseline**: Body font size = 22px (内容密度适中)
99
100 | Purpose | Ratio | Size | Weight |
101 | ------- | ----- | ---- | ------ |
102 | Cover title | 2.5x | 54px | Bold |
103 | Chapter title | 2x | 44px | Bold |
104 | Content title | 1.5x | 32px | Bold |
105 | Subtitle | 1.3x | 28px | SemiBold |
106 | **Body content** | **1x** | **22px** | Regular |
107 | Annotation | 0.73x | 16px | Regular |
108 | Page number/date | 0.55x | 12px | Regular |
109
110 ---
111
112 ## V. Layout Principles
113
114 ### Page Structure
115
116 - **Header area**: 高 80px — 页面标题 + 金色装饰线
117 - **Content area**: 高 540px — 主要内容区域
118 - **Footer area**: 高 40px — 页码 + 来源信息
119
120 ### Common Layout Modes
121
122 | Mode | Suitable Scenarios |
123 | ---- | ----------------- |
124 | **Single column centered** | 封面、结尾、关键引言 |
125 | **Left-right split (4:6)** | 图文混排(图片+文字说明) |
126 | **Left-right split (5:5)** | 双概念对比 |
127 | **Three-column cards** | 并列要点、作品展示 |
128 | **Top-bottom split** | 超宽图片 + 文字 |
129 | **Timeline** | 人生轨迹、编年概述 |
130
131 ### Spacing Specification
132
133 | Element | Value |
134 | ------- | ----- |
135 | Card gap | 24px |
136 | Content block gap | 32px |
137 | Card padding | 24px |
138 | Card border radius | 12px |
139 | Icon-text gap | 12px |
140 | Single-row card height | 540px |
141 | Double-row card height | 260px each |
142 | Three-column card width | 360px each |
143
144 ---
145
146 ## VI. Icon Usage Specification
147
148 ### Source
149
150 - **Built-in icon library**: `templates/icons/chunk/` (直线几何风格,适配典雅庄重调性)
151 - **Library**: `chunk`
152 - **Usage method**: Placeholder format `{{icon:chunk/icon-name}}`
153
154 ### Recommended Icon List
155
156 | Purpose | Icon Path | Page |
157 | ------- | --------- | ---- |
158 | 建筑/设计 | `{{icon:chunk/building}}` | Slide 03, 04 |
159 | 古堡/历史建筑 | `{{icon:chunk/castle}}` | Slide 03 |
160 | 博物馆/文化 | `{{icon:chunk/museum}}` | Slide 04 |
161 | 地图/考察 | `{{icon:chunk/map}}` | Slide 05 |
162 | 圆规/制图 | `{{icon:chunk/compass-drafting}}` | Slide 06 |
163 | 书籍/学术 | `{{icon:chunk/book-open}}` | Slide 07 |
164 | 钢笔/写作 | `{{icon:chunk/pen-nib}}` | Slide 08 |
165 | 皇冠/巨匠 | `{{icon:chunk/crown}}` | Slide 01, 10 |
166 | 星星/成就 | `{{icon:chunk/star}}` | Slide 09 |
167 | 旗帜/先驱 | `{{icon:chunk/flag}}` | Slide 09 |
168 | 心/情怀 | `{{icon:chunk/heart}}` | Slide 10 |
169 | 眼睛/重识 | `{{icon:chunk/eye}}` | Slide 02 |
170 | 时钟/时光 | `{{icon:chunk/clock}}` | Slide 02 |
171 | 全球/影响力 | `{{icon:chunk/globe}}` | Slide 07 |
172
173 ---
174
175 ## VII. Visualization Reference List
176
177 | Visualization Type | Reference Template | Used In | Purpose |
178 | ------------------ | ------------------ | ------- | ------- |
179 | timeline | `templates/charts/timeline.svg` | Slide 02 | 林徽因人生关键节点时间轴 |
180 | icon_grid | `templates/charts/icon_grid.svg` | Slide 03 | 建筑作品一览(多项目卡片) |
181 | vertical_list | `templates/charts/vertical_list.svg` | Slide 07 | 学术贡献要点列表 |
182
183 ---
184
185 ## VIII. Image Resource List
186
187 | Filename | Dimensions | Ratio | Purpose | Type | Status | Generation Description |
188 | -------- | --------- | ----- | ------- | ---- | ------ | --------------------- |
189 | cover_bg.png | 1280x720 | 1.78 | 封面背景 | Background | Pending generation | Chinese traditional architectural elements (curved tile rooflines, wooden brackets/dougong) silhouetted against a deep navy-to-midnight blue gradient sky (#1A1A2E to #16213E), golden light (#C9A96E) glowing along the roofline edges, subtle mist/cloud in lower third, clean center area reserved for title text overlay, cinematic atmospheric style |
190 | lin_portrait.png | 640x703 | 0.91 | 封面人物肖像 | Photography | Existing | - |
191 | jihai_station_old.png | 670x346 | 1.94 | 吉海铁路总站历史照片 | Photography | Existing | - |
192 | jihai_station_new.png | 1080x608 | 1.78 | 修复后的吉海铁路总站 | Photography | Existing | - |
193 | pku_geology.png | 745x414 | 1.80 | 北大地质馆旧址 | Photography | Existing | - |
194 | yingqiu_院.png | 792x606 | 1.31 | 映秋院历史照片 | Photography | Existing | - |
195 | kunming_site.png | 1080x783 | 1.38 | 昆明建筑工地 | Photography | Existing | - |
196 | babaoshan.png | 1080x712 | 1.52 | 八宝山革命公墓 | Photography | Existing | - |
197 | lin_tomb.png | 1080x796 | 1.36 | 林徽因墓碑 | Photography | Existing | - |
198 | monument.png | 960x1280 | 0.75 | 人民英雄纪念碑 | Photography | Existing | - |
199 | liang_lin_together.png | 1000x710 | 1.41 | 梁思成与林徽因合影 | Photography | Existing | - |
200 | first_paper.png | 1080x810 | 1.33 | 首篇建筑论文 | Photography | Existing | - |
201 | lin_survey.png | 1056x1080 | 0.98 | 林徽因考察古建筑 | Photography | Existing | - |
202 | lin_later.png | 857x804 | 1.07 | 林徽因晚年照片 | Photography | Existing | - |
203
204 ---
205
206 ## IX. Content Outline
207
208 ### Part 1: 开篇
209
210 #### Slide 01 - 封面
211
212 - **Layout**: 全屏背景图 + 居中竖排标题 + 人物剪影
213 - **Title**: 林徽因:被文学光环遮蔽的建筑巨匠
214 - **Subtitle**: 逝世70周年 · 重识中国建筑史上的女性力量
215 - **Info**: 凤凰空间 · 2025
216 - **Image**: cover_bg.png (全屏底), lin_portrait.png (右侧)
217
218 #### Slide 02 - 人生轨迹概览
219
220 - **Layout**: 横向时间轴
221 - **Title**: 建筑巨匠的一生
222 - **Visualization**: timeline
223 - **Content**:
224 - 1904 出生于杭州
225 - 1924 赴美留学宾夕法尼亚大学
226 - 1928 与梁思成结婚,归国
227 - 1930 加入中国营造学社
228 - 1932 发表首篇建筑论文
229 - 1937-1946 战时流亡,坚持研究
230 - 1949 参与国徽设计
231 - 1952 参与人民英雄纪念碑设计
232 - 1955 逝世,墓碑刻"建筑师林徽因墓"
233
234 ### Part 2: 建筑师林徽因
235
236 #### Slide 03 - 为数不多的建筑作品(上)
237
238 - **Layout**: 三列卡片布局
239 - **Title**: 归国初期的建筑实践
240 - **Visualization**: icon_grid
241 - **Content**:
242 - 1929 梁启超墓碑设计 — 学成归来第一件作品
243 - 1929 吉林大学石头楼 — 参与"梁陈童蔡营造事务所"设计
244 - 1929 吉海铁路总站 — 林徽因设计总体风貌,哥特式雄狮造型
245
246 #### Slide 04 - 为数不多的建筑作品(下)
247
248 - **Layout**: 左右分栏(4:6),左图右文
249 - **Title**: 战火中的建筑理想
250 - **Content**:
251 - 1932 北大地质馆与女生宿舍 — 中国最早引入西方现代主义建筑
252 - 1938 云南大学映秋院 — 融合云南民间建筑元素
253 - 1938 西南联大校舍 — "一生中最痛苦、最委屈的设计"
254 - 1940 昆明自宅 — 两位建筑师一生唯一为自己设计的房子
255 - **Image**: kunming_site.png
256
257 #### Slide 05 - 丰碑之作
258
259 - **Layout**: 左右分栏(5:5),左文右图
260 - **Title**: 国之重器上的建筑印记
261 - **Content**:
262 - 1950 八宝山革命公墓 — 主体建筑格局设计
263 - 1952 人民英雄纪念碑 — 提出创造性修改方案
264 - 亲自设计碑座全套饰纹与花环浮雕
265 - 以唐代风格为蓝本,展现中国传统建筑美学
266 - 墓碑上只有七个字:建筑师林徽因墓
267 - **Image**: monument.png
268
269 ### Part 3: 被低估的学术先驱
270
271 #### Slide 06 - 中国建筑理论的奠基者
272
273 - **Layout**: 左右分栏(4:6),左图右文
274 - **Title**: 首篇建筑论文:技惊四座
275 - **Content**:
276 - 1932《论中国建筑之几个特征》— 首次由中国专业学者发表的建筑理论文章
277 - 首次在理论上定义了中国建筑木框架结构体系的基本特征
278 - 反驳西方学者对中国建筑的误读
279 - 描绘出关于中国建筑史的完整概念框架
280 - **Image**: first_paper.png
281
282 #### Slide 07 - 独创概念与超前思想
283
284 - **Layout**: 纵向要点列表
285 - **Title**: 学术贡献一览
286 - **Visualization**: vertical_list
287 - **Content**:
288 - "建筑意"概念 — 原创性的中国建筑美学理念,建筑是技术、美、历史与人情的凝聚
289 - 《清式营造则例》绪论 — 归纳中国建筑理论框架
290 - 民居研究先驱 — 在中国建筑界率先提出保护民间建筑
291 - 《现代住宅设计的参考》 — 远见性地提出战后为普通人设计建筑
292 - 首开"住宅概论"课 — 1949年清华大学首次系统教授现代住宅设计理论
293
294 ### Part 4: 强者与精神
295
296 #### Slide 08 - 远比传闻更震撼的一生
297
298 - **Layout**: 左右分栏(5:5),左文右图
299 - **Title**: 穿越战火的建筑斗士
300 - **Content**:
301 - 荒郊野谷考察古建筑,风餐露宿不退缩
302 - "只要梁先生敢爬敢上的,林先生就敢上"
303 - 战乱流亡中肺炎发作,此后再未恢复健康
304 - 带病坚持在偏远小镇一笔一笔书写中国建筑史
305 - "什么美人不美人,我还有好多事要做呢!"
306 - **Image**: lin_survey.png
307
308 #### Slide 09 - 她想要终生奋斗的事业
309
310 - **Layout**: 引言卡片 + 成就总结
311 - **Title**: 当之无愧的建筑师
312 - **Content**:
313 - 引言:"我自己也到了相当年纪,也没有什么成就…我禁不住伤心起来" — 28岁写给胡适的信
314 - 与梁思成共同创办东北大学、清华大学建筑系
315 - 深入荒凉之地一寸寸测量古建筑
316 - 在国徽和纪念碑上倾注最后心血
317 - 她是学科的奠基者,更是思想上的先行者
318
319 #### Slide 10 - 结尾
320
321 - **Layout**: 单列居中,引言式
322 - **Title**: 建筑师林徽因墓
323 - **Subtitle**: 她用一生证明,她是当之无愧的建筑师
324 - **Content**:
325 - 中央金色竖线装饰
326 - 墓碑铭文引用
327 - 致敬语
328 - 来源信息
329
330 ---
331
332 ## X. Speaker Notes Requirements
333
334 - **File naming**: Match SVG names (e.g., `01_cover.svg` → `notes/01_cover.md`)
335 - **Total duration**: ~15 minutes
336 - **Notes style**: 叙述型(Narrative),兼具历史厚重感与人文温度
337 - **Presentation purpose**: Inspire + Inform(致敬与知识传递)
338 - **Content includes**: 每页演讲要点、补充历史细节、过渡衔接语
339
340 ---
341
342 ## XI. Technical Constraints Reminder
343
344 ### SVG Generation Must Follow:
345
346 1. viewBox: `0 0 1280 720`
347 2. Background uses `<rect>` elements
348 3. Text wrapping uses `<tspan>` (`<foreignObject>` FORBIDDEN)
349 4. Transparency defaults to `fill-opacity` / `stroke-opacity`; `rgba()` remains converter-compatible
350 5. FORBIDDEN: `mask`, `<style>`, `class`, `foreignObject`
351 6. FORBIDDEN: `textPath`, `animate*`, `script`
352 7. `marker-start` / `marker-end` conditionally allowed: `<marker>` must be in `<defs>`, `orient="auto"`, shape must be triangle / diamond / circle
353
354 ### PPT Compatibility Rules:
355
356 - Prefer opacity on each child element; `<g opacity="...">` remains compatible with an approximate-fidelity warning
357 - Image transparency uses overlay mask layer (`<rect fill="bg-color" opacity="0.x"/>`)
358 - Inline styles only; external CSS and `@font-face` FORBIDDEN
359
359 lines MARKDOWN