proslide

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ProSlide - Professional Slide Generator

ProSlide - 专业幻灯片生成器

Tạo professional text-only slides từ content input. Vietnamese default. Activate

slidev

skill (built-in, cùng context) cho Slidev Markdown generation + PDF export.

根据输入内容生成纯文本的专业幻灯片。默认语言为越南语。激活内置的

slidev

技能（同上下文）以生成Slidev Markdown文件并导出PDF。

Output Folder Structure

输出文件夹结构

Mỗi lần tạo presentation, output được lưu trong folder có cấu trúc:

output/
└── {slug}-{YYMMDD-HHmm}/
    ├── outline.md
    ├── content-map.md
    ├── coverage-report.md
    ├── research-notes.md
    └── slides/
        └── {slug}-{theme-name}/    # Slidev project
            ├── package.json
            ├── slides.md
            └── dist/               # After export (gitignored)
                └── {slug}.pdf

Naming rules:

```
{slug}
```
: kebab-case từ topic chính (max 30 chars)
```
{YYMMDD-HHmm}
```
: timestamp lúc tạo folder
```
{theme-name}
```
: tên Slidev theme đã chọn (VD: default, seriph, apple-basic)
Khi reuse outline để generate thêm slide mới, folder mới được thêm vào
```
slides/
```
của folder đã có

每次创建演示文稿时，输出内容会保存在以下结构的文件夹中：

output/
└── {slug}-{YYMMDD-HHmm}/
    ├── outline.md
    ├── content-map.md
    ├── coverage-report.md
    ├── research-notes.md
    └── slides/
        └── {slug}-{theme-name}/    # Slidev项目
            ├── package.json
            ├── slides.md
            └── dist/               # 导出后（已加入git忽略）
                └── {slug}.pdf

命名规则：

```
{slug}
```
：由主题转换为短横线分隔格式（最多30个字符）
```
{YYMMDD-HHmm}
```
：文件夹创建时的时间戳
```
{theme-name}
```
：所选的Slidev主题名称（例如：default, seriph, apple-basic）
当复用大纲生成新幻灯片时，新文件夹会添加到已有文件夹的
```
slides/
```
目录下

Step 0: Detect Mode (New / Reuse)

步骤0：检测模式（新建/复用）

Kiểm tra input từ user:
- Nếu user chỉ vào folder output đã có (chứa
```
outline.md
```
  ) → Reuse mode
- Nếu user cung cấp nội dung mới (text, file path) → New mode
- Nếu user nói "dùng lại outline", "reuse", "tạo thêm slide" + chỉ folder → Reuse mode
Reuse mode → nhảy thẳng tới Step 2.5 (skip Step 1 & 2)
New mode → tiếp tục Step 1

检查用户输入：
- 如果用户指向已有的输出文件夹（包含
```
outline.md
```
  ）→ 复用模式
- 如果用户提供新内容（文本、文件路径）→ 新建模式
- 如果用户提到“复用大纲”、“reuse”、“生成更多幻灯片”并指定文件夹→ 复用模式
复用模式 → 直接跳转到步骤2.5（跳过步骤1和2）
新建模式 → 继续执行步骤1

Step 1: Tiếp nhận nội dung & Cấu hình

步骤1：接收内容与配置

Đọc input từ user: text trực tiếp hoặc file path (.md, .txt, .pdf)
Nếu input là file path, đọc nội dung file
Phân tích sơ bộ: topic, length, complexity
Hỏi user bằng AskUserQuestion (4 câu hỏi trong 1 lần):

Câu hỏi 1 - Loại nội dung (header: "Content type"):

"Hướng dẫn/Giáo dục" - Giải thích khái niệm, tutorial, hướng dẫn học (Gagné + scaffolding)
"Business/Báo cáo" - Phân tích, đề xuất, báo cáo kết quả (Pyramid Principle)
"Thuyết phục/Pitch" - Bán ý tưởng, pitch sản phẩm, proposal (PAS + Sparkline)
"Technical/Process" - Quy trình, kiến trúc, hệ thống, so sánh kỹ thuật (SCR + step-by-step)

Câu hỏi 2 - Mức độ chi tiết (header: "Detail level"):

"L1 - Tổng quan" - Chỉ ý chính, bullet ngắn gọn (5+ slides)
"L2 - Cân bằng" - Ý chính + giải thích + ví dụ minh họa (10+ slides)
"L3 - Chi tiết" - Đầy đủ nội dung, deep dive, code examples (18+ slides)

Câu hỏi 3 - Ngôn ngữ (header: "Language"):

"Tiếng Việt" - Toàn bộ nội dung tiếng Việt (Recommended)
"English" - Toàn bộ nội dung tiếng Anh
"Song ngữ" - Title tiếng Anh, body tiếng Việt (phù hợp technical/academic)

Câu hỏi 4 - Research bổ sung (header: "Research"):

"Chỉ dùng source" - Tạo slide 100% từ nội dung đầu vào, không tìm thêm
"Research thêm" - Tìm thêm data, statistics, examples từ web để bổ sung slide
"Auto" - Tự động: research nếu source ít thông tin (<500 words hoặc thiếu data/metrics), skip nếu đủ

Logic đánh dấu Recommended cho câu hỏi 4:

Nếu source < 500 words HOẶC source chỉ có bullet points không context HOẶC thiếu data/metrics/examples → đánh dấu "Research thêm" là (Recommended)
Nếu source >= 500 words VÀ có đầy đủ data/context → đánh dấu "Chỉ dùng source" là (Recommended)

读取用户输入：直接文本或文件路径（.md, .txt, .pdf）
如果输入是文件路径，读取文件内容
初步分析：主题、长度、复杂度
通过AskUserQuestion向用户一次性提出4个问题：

问题1 - 内容类型（标题："Content type"）：

"指南/教育" - 解释概念、教程、学习指南（采用Gagné模型+脚手架式教学）
"商务/报告" - 分析、建议、成果汇报（采用金字塔原理）
"说服/推介" - 推销想法、产品推介、提案（采用PAS模型+Sparkline图表）
"技术/流程" - 流程、架构、系统、技术对比（采用SCR模型+分步讲解）

问题2 - 详细程度（标题："Detail level"）：

"L1 - 概述" - 仅核心要点，简短项目符号（5张以上幻灯片）
"L2 - 平衡" - 核心要点+解释+示例说明（10张以上幻灯片）
"L3 - 详细" - 完整内容、深度剖析、代码示例（18张以上幻灯片）

问题3 - 语言（标题："Language"）：

"越南语" - 所有内容为越南语（推荐）
"英语" - 所有内容为英语
"双语" - 标题为英语，正文为越南语（适合技术/学术场景）

问题4 - 补充调研（标题："Research"）：

"仅使用源内容" - 100%基于输入内容生成幻灯片，不额外查找信息
"补充调研" - 从网络查找更多数据、统计信息、示例来补充幻灯片
"自动" - 自动处理：如果源内容信息不足（少于500词或缺少数据/指标）则进行调研，信息充足则跳过

问题4的推荐逻辑：

如果源内容少于500词或仅包含无上下文的项目符号或缺少数据/指标/示例 → 标记“补充调研”为（推荐）
如果源内容不少于500词且包含完整的数据/上下文 → 标记“仅使用源内容”为（推荐）

Step 1.5: Research bổ sung (Optional)

步骤1.5：补充调研（可选）

Chạy sau Step 1, trước Step 2. Quyết định dựa trên câu hỏi 4 ở Step 1.

Khi nào chạy:

User chọn "Research thêm" → luôn chạy
User chọn "Auto" → chạy NẾU source < 500 words HOẶC source thiếu data/metrics/examples cụ thể
User chọn "Chỉ dùng source" → SKIP hoàn toàn, nhảy tới Step 2

Process:

Extract 3-5 topic keywords từ source input (dựa trên content type đã chọn)
Tạo 2-3 search queries phù hợp:
- Query 1:
```
"{topic chính}" statistics data {năm hiện tại}
```
  (tìm số liệu mới nhất)
- Query 2:
```
"{topic chính}" trends insights
```
  (tìm xu hướng, insights)
- Query 3:
```
"{topic chính}" examples best practices
```
  (tìm ví dụ, case studies)
Chạy WebSearch cho mỗi query
Extract findings relevant: statistics, data points, examples, quotes, trends
Lưu kết quả vào
```
{output_folder}/research-notes.md
```
theo format:

markdown

undefined

在步骤1之后、步骤2之前执行。是否执行由步骤1的问题4决定。

执行条件：

用户选择“补充调研” → 始终执行
用户选择“自动” → 当源内容少于500词或缺少具体的数据/指标/示例时执行
用户选择“仅使用源内容” → 完全跳过，直接进入步骤2

流程：

从源内容中提取3-5个主题关键词（基于所选的内容类型）
生成2-3个合适的搜索查询：
- 查询1：
```
"{核心主题}" statistics data {当前年份}
```
  （查找最新数据）
- 查询2：
```
"{核心主题}" trends insights
```
  （查找趋势、洞察）
- 查询3：
```
"{核心主题}" examples best practices
```
  （查找示例、案例研究）
为每个查询执行WebSearch
提取相关发现：统计数据、数据点、示例、引用、趋势
将结果保存到
```
{output_folder}/research-notes.md
```
，格式如下：

markdown

undefined

Research Notes — [Topic]

调研笔记 — [主题]

Search Queries

搜索查询

[query 1]
[query 2]
[query 3]

[查询1]
[查询2]
[查询3]

Findings

调研结果

Statistics & Data

统计数据

[stat 1] — Source: [url/name]
[stat 2] — Source: [url/name]

[统计数据1] — 来源：[链接/名称]
[统计数据2] — 来源：[链接/名称]

Trends & Insights

趋势与洞察

[insight 1]
[insight 2]

[洞察1]
[洞察2]

Examples & Case Studies

示例与案例研究

[example 1]
[example 2]

[示例1]
[示例2]

Selected for Slides

选中用于幻灯片的内容

Items below sẽ được đưa vào Content Map với tag [R]:

[item] — lý do chọn
[item] — lý do chọn


1. Append selected items vào Content Map (Step 2) với prefix `[R]` để phân biệt source gốc vs researched
2. Thông báo user: "Research xong: tìm thấy X data points, Y insights. Đã lưu tại research-notes.md"

**Quy tắc research:**

* Chỉ lấy thông tin factual, có nguồn rõ ràng

* Ưu tiên: số liệu cụ thể > xu hướng > ví dụ > quotes

* KHÔNG thay thế nội dung source, chỉ BỔ SUNG

* Max 10 items đưa vào Content Map (tránh overwhelming)

* Research items trong outline phải ghi rõ "(Nguồn: research)" trong speaker notes hoặc content

以下项目将被添加到内容地图，并标记[R]：

[项目] — 选中原因
[项目] — 选中原因


6. 将选中的项目添加到内容地图（步骤2），并添加前缀`[R]`以区分原始内容与调研内容
7. 通知用户：“调研完成：找到X个数据点、Y个洞察。已保存至research-notes.md”

**调研规则：**

* 仅获取事实性、来源明确的信息

* 优先级：具体数据 > 趋势 > 示例 > 引用

* 不替换源内容，仅做补充

* 最多向内容地图添加10个项目（避免信息过载）

* 大纲中的调研内容必须在演讲备注或正文中标注“（来源：调研）”

Visual Patterns per Content Type

各内容类型的视觉模式

Khi tạo slides, áp dụng visual patterns phù hợp với content type đã chọn:

Content Type	Visual Patterns	Recommended Slide Types
Hướng dẫn/Giáo dục	Numbered step indicators, before/after comparison, warm decorations	content, comparison, statement (cho key concepts)
Business/Báo cáo	Accent bars, data callout slides, conservative decorations	content, metric (cho KPIs), comparison, summary
Thuyết phục/Pitch	Bold statement slides, high contrast, CTA emphasis	statement (30%+), metric, content, cta
Technical/Process	Code blocks, process flow indicators, comparison tables	content, comparison, code, transition

创建幻灯片时，应用与所选内容类型匹配的视觉模式：

内容类型	视觉模式	推荐幻灯片类型
指南/教育	带编号的步骤指示器、前后对比、温馨装饰	内容页、对比页、声明页（用于核心概念）
商务/报告	强调栏、数据标注幻灯片、保守风格装饰	内容页、指标页（用于KPI）、对比页、摘要页
说服/推介	醒目声明幻灯片、高对比度、强调行动号召	声明页（占30%以上）、指标页、内容页、行动号召页
技术/流程	代码块、流程步骤指示器、对比表格	内容页、对比页、代码页、过渡页

Auto Theme Recommendation

自动主题推荐

Dựa trên content type, gợi ý Slidev theme (user có quyền chọn khác hoặc nhập tên theme bất kỳ):

Content Type	Primary Recommendation	Secondary
Hướng dẫn/Giáo dục	seriph	default
Business/Báo cáo	default	apple-basic
Thuyết phục/Pitch	apple-basic	seriph
Technical/Process	default	seriph

根据内容类型，推荐Slidev主题（用户可选择其他主题或输入任意主题名称）：

内容类型	首选推荐	次选推荐
指南/教育	seriph	default
商务/报告	default	apple-basic
说服/推介	apple-basic	seriph
技术/流程	default	seriph

Slidev Theme List

Slidev主题列表

Danh sách themes chính thức và community phổ biến, hiển thị cho user khi chọn:

Official themes:

Theme	Package	Mô tả
`default`	`@slidev/theme-default`	Minimalist, light/dark
`seriph`	`@slidev/theme-seriph`	Serif-based formal, light/dark
`apple-basic`	`@slidev/theme-apple-basic`	Keynote-inspired, light/dark
`bricks`	`@slidev/theme-bricks`	Playful blocks, light
`shibainu`	`@slidev/theme-shibainu`	Cute dark theme

Community themes (phổ biến):

Theme	Package	Mô tả
`geist`	`slidev-theme-geist`	Vercel design system, light/dark
`academic`	`slidev-theme-academic`	Formal academic, light/dark
`dracula`	`slidev-theme-dracula`	Vibrant dark theme

User cũng có thể nhập tên bất kỳ Slidev theme từ npm.

以下是官方和热门社区主题，供用户选择时展示：

官方主题：

主题	包名	描述
`default`	`@slidev/theme-default`	极简风格，支持明暗模式
`seriph`	`@slidev/theme-seriph`	基于衬线字体的正式风格，支持明暗模式
`apple-basic`	`@slidev/theme-apple-basic`	仿Keynote风格，支持明暗模式
`bricks`	`@slidev/theme-bricks`	趣味方块风格，仅浅色模式
`shibainu`	`@slidev/theme-shibainu`	可爱深色主题

热门社区主题：

主题	包名	描述
`geist`	`slidev-theme-geist`	基于Vercel设计系统，支持明暗模式
`academic`	`slidev-theme-academic`	正式学术风格，支持明暗模式
`dracula`	`slidev-theme-dracula`	活力深色主题

用户也可以输入npm上的任意Slidev主题名称。

Step 2: Phân tích nội dung & Tạo outline (New mode)

步骤2：内容分析与大纲创建（新建模式）

Tạo output folder:
```
output/{slug}-{YYMMDD-HHmm}/
```
và subfolder
```
slides/
```
Đọc
```
references/outline-rules.md
```
(relative to this skill folder) để nắm quy tắc outline
Áp dụng framework tương ứng với content type đã chọn ở Step 1 (xem Content Type → Framework Mapping trong outline-rules.md)
Content Map (xem "Content Map Rules" trong outline-rules.md):
- Parse source → extract topics → assign priority (
```
must
```
  /
```
should
```
  /
```
nice
```
  ) theo detail level
- Nếu Step 1.5 đã chạy → append research items vào Content Map với prefix
```
[R]
```
  (xem outline-rules.md)
- Lưu Content Map ra file
```
{output_folder}/content-map.md
```
Phân tích nội dung theo detail level đã chọn (xem Detail Level Mapping + Content Selection Criteria trong outline-rules.md)
Tạo outline theo cấu trúc bắt buộc: Opening > Body > Closing. Cross-check với Content Map: mọi
```
must
```
topics phải xuất hiện,
```
should
```
/
```
nice
```
theo threshold
Lưu outline ra file
```
{output_folder}/outline.md
```
với metadata header (xem Outline File Format trong outline-rules.md)
Hiển thị outline cho user review (numbered list với slide titles + brief content description)
Coverage Report (xem "Coverage Report Rules" trong outline-rules.md):
- Generate file
```
{output_folder}/coverage-report.md
```
  mapping source topics → slides + omission justification
- Thông báo cho user: tóm tắt 1 dòng coverage % + mention report file path
Feedback loop: Hỏi user "Outline OK? Bạn có muốn chỉnh sửa gì không?" bằng AskUserQuestion (header: "Outline review"):

"OK, tiếp tục" - Chấp nhận outline, chuyển sang chọn theme
"Chỉnh sửa" - User sẽ mô tả thay đổi → cập nhật outline file + re-check coverage → show lại → hỏi lại

创建输出文件夹：
```
output/{slug}-{YYMMDD-HHmm}/
```
及子文件夹
```
slides/
```
读取
```
references/outline-rules.md
```
（相对于本技能文件夹）以了解大纲规则
应用与步骤1中所选内容类型对应的框架（参见outline-rules.md中的内容类型→框架映射）
内容地图（参见outline-rules.md中的“内容地图规则”）：
- 解析源内容→提取主题→根据详细程度分配优先级（
```
must
```
  /
```
should
```
  /
```
nice
```
  ）
- 如果步骤1.5已执行→将调研项目添加到内容地图，并添加前缀
```
[R]
```
  （参见outline-rules.md）
- 将内容地图保存到
```
{output_folder}/content-map.md
```
根据所选的详细程度分析内容（参见outline-rules.md中的详细程度映射+内容选择标准）
按照固定结构创建大纲：开场→主体→结尾。交叉检查内容地图：所有
```
must
```
主题必须包含，
```
should
```
/
```
nice
```
主题按阈值筛选
保存大纲到
```
{output_folder}/outline.md
```
，并添加元数据头部（参见outline-rules.md中的大纲文件格式）
向用户展示大纲供审核（带编号的列表，包含幻灯片标题+简要内容描述）
覆盖报告（参见outline-rules.md中的“覆盖报告规则”）：
- 生成
```
{output_folder}/coverage-report.md
```
  文件，映射源主题→幻灯片+未包含的理由
- 向用户发送通知：1行摘要说明覆盖百分比+提及报告文件路径
反馈循环：通过AskUserQuestion向用户提问“大纲是否可行？您需要修改吗？”（标题："Outline review"）：

“OK，继续” - 确认大纲，进入主题选择环节
“修改” - 用户描述修改内容→更新大纲文件+重新检查覆盖情况→再次展示→再次询问

Step 2.5: Reuse mode (khi đã có outline)

步骤2.5：复用模式（已有大纲时）

Đọc
```
{output_folder}/outline.md
```
— parse metadata header để lấy: content_type, detail_level, language, slug
Hiển thị tóm tắt cho user: "Reuse outline: {title}, {detail_level}, {language}, {N} slides"
Tiếp tục chọn theme ở Step 2.6

读取
```
{output_folder}/outline.md
```
— 解析元数据头部获取：content_type、detail_level、language、slug
向用户展示摘要：“复用大纲：{标题}，{详细程度}，{语言}，共{N}张幻灯片”
进入步骤2.6选择主题

Step 2.6: Chọn Slidev theme (cả New và Reuse mode)

步骤2.6：选择Slidev主题（新建和复用模式均适用）

Hiển thị bảng Slidev Theme List (xem section ở trên)
Kiểm tra
```
{output_folder}/slides/
```
xem đã có Slidev project folder nào chưa → show user "(đã tạo)" bên cạnh theme đã dùng
Hỏi user bằng AskUserQuestion (header: "Theme"): "Chọn Slidev theme:" + đánh dấu recommended theme dựa trên bảng Auto Theme Recommendation + cho phép nhập tên theme khác qua "Other"

展示Slidev主题列表（参见上方章节）
检查
```
{output_folder}/slides/
```
是否已有Slidev项目文件夹→向用户展示已使用的主题并标记“(已创建)”
通过AskUserQuestion向用户提问：“选择Slidev主题：”（标题："Theme"），并根据自动主题推荐表标记推荐主题，同时允许用户通过“Other”输入其他主题名称

Step 3: Tạo slide (Slidev)

步骤3：创建幻灯片（Slidev）

Xác định theme package name:
- Official themes:
```
@slidev/theme-{name}
```
  (VD:
```
@slidev/theme-seriph
```
  )
- Community themes:
```
slidev-theme-{name}
```
  (VD:
```
slidev-theme-geist
```
  )
- Nếu user nhập custom name → dùng nguyên tên
Đọc
```
references/slide-templates.md
```
(relative to this skill folder) để nắm Slidev Markdown patterns cho từng slide type
Đọc outline từ
```
{output_folder}/outline.md
```
(nếu Reuse mode) hoặc từ context (nếu vừa tạo)
Activate slidev
skill trong cùng agent context. Cung cấp:
- Headmatter config:
  yaml
```
theme: { theme-name }
fonts:
  sans: Tahoma
  serif: Arial
  mono: Fira Code
  provider: none
```
- Layout mapping table cho mỗi slide type:
  
  Slide Type Slidev Layout
  title cover
  agenda default
  content default
  comparison two-cols-header
  summary default
  cta end
  transition section
  statement statement
  metric fact
  code default
- Nội dung từng slide theo outline (title, body content, slide type → layout)
- Slidev Markdown templates từ
```
references/slide-templates.md
```
- Vietnamese fonts requirement:
```
Tahoma, Arial, sans-serif
```
  qua fonts config
- Output path:
```
{output_folder}/slides/{slug}-{theme-name}/
```

Slide Type	Slidev Layout
title	cover
agenda	default
content	default
comparison	two-cols-header
summary	default
cta	end
transition	section
statement	statement
metric	fact
code	default

Slidev skill tạo Slidev project:

package.json
:

json

{
  "name": "{slug}-{theme-name}",
  "private": true,
  "scripts": {
    "dev": "slidev",
    "build": "slidev build",
    "export": "slidev export --output dist/{slug}.pdf --timeout 60000"
  },
  "dependencies": {
    "@slidev/cli": "latest",
    "{theme-package}": "latest"
  },
  "devDependencies": {
    "playwright-chromium": "latest"
  }
}

slides.md
: Headmatter + all slides theo Slidev Markdown format

Install dependencies:
```
pnpm install
```
trong Slidev project folder

Export PDF:

npx slidev export --output dist/{slug}.pdf --timeout 60000

Thông báo output:
- Slidev project path
- PDF path (nếu export thành công)
- Output folder path (nhắc user có thể reuse outline:
```
/proslide
```
  + chỉ folder path)
- Hướng dẫn:
```
cd {project-path} && pnpm dev
```
  để xem slides trong browser

确定主题包名：
- 官方主题：
```
@slidev/theme-{name}
```
  （例如：
```
@slidev/theme-seriph
```
  ）
- 社区主题：
```
slidev-theme-{name}
```
  （例如：
```
slidev-theme-geist
```
  ）
- 如果用户输入自定义名称→直接使用该名称
读取
```
references/slide-templates.md
```
（相对于本技能文件夹）以了解各幻灯片类型的Slidev Markdown模板
从
```
{output_folder}/outline.md
```
读取大纲（复用模式）或从上下文读取（刚创建的大纲）
激活同上下文的**
```
slidev
```
**技能，并提供以下信息：
- 头部配置：
  yaml
```
theme: { theme-name }
fonts:
  sans: Tahoma
  serif: Arial
  mono: Fira Code
  provider: none
```
- 布局映射表，对应每种幻灯片类型：
  
  幻灯片类型 Slidev布局
  title cover
  agenda default
  content default
  comparison two-cols-header
  summary default
  cta end
  transition section
  statement statement
  metric fact
  code default
- 每张幻灯片的内容，按照大纲（标题、正文内容、幻灯片类型→布局）
- Slidev Markdown模板，来自
```
references/slide-templates.md
```
- 越南语字体要求：通过字体配置使用
```
Tahoma, Arial, sans-serif
```
- 输出路径：
```
{output_folder}/slides/{slug}-{theme-name}/
```

幻灯片类型	Slidev布局
title	cover
agenda	default
content	default
comparison	two-cols-header
summary	default
cta	end
transition	section
statement	statement
metric	fact
code	default

Slidev技能创建Slidev项目：

package.json
：

json

{
  "name": "{slug}-{theme-name}",
  "private": true,
  "scripts": {
    "dev": "slidev",
    "build": "slidev build",
    "export": "slidev export --output dist/{slug}.pdf --timeout 60000"
  },
  "dependencies": {
    "@slidev/cli": "latest",
    "{theme-package}": "latest"
  },
  "devDependencies": {
    "playwright-chromium": "latest"
  }
}

slides.md
：头部配置+所有Slidev Markdown格式的幻灯片

安装依赖：在Slidev项目文件夹中执行
```
pnpm install
```

导出PDF：执行

npx slidev export --output dist/{slug}.pdf --timeout 60000

通知用户输出信息：
- Slidev项目路径
- PDF路径（如果导出成功）
- 输出文件夹路径（提醒用户可复用大纲：使用/proslide指令+指定文件夹路径）
- 使用指南：
```
cd {project-path} && pnpm dev
```
  在浏览器中查看幻灯片

Slidev Constraints (CRITICAL)

Slidev约束条件（关键）

Khi activate slidev skill, PHẢI tuân thủ các constraints sau:

Vietnamese fonts: Dùng
```
Tahoma, Arial, sans-serif
```
qua fonts config trong headmatter với
```
provider: none
```
(system fonts, không fetch từ Google Fonts). KHÔNG dùng Impact, Courier New (Vietnamese rendering kém)
Text-only: Không dùng image layouts, không embed images. Chỉ text, bullets, code blocks
Speaker notes: Dùng HTML comments
```

```
sau content mỗi slide
Code blocks: Dùng native Markdown fenced blocks với language tag (
```
python, 
```
javascript, etc.). Slidev tự động syntax highlight. Max 10-15 dòng/slide. Dùng line highlighting
```
{2,3}
```
để nhấn mạnh dòng quan trọng, hoặc click-based highlighting
```
{1|3-4|all}
```
để walkthrough từng phần (xem templates trong
```
references/slide-templates.md
```
)
Nested lists: Slidev Markdown hỗ trợ nested lists tốt (indent 2 spaces). Dùng thoải mái cho L2/L3 sub-bullets
Max content per slide: Tuân theo rules từ
```
outline-rules.md
```
:
- L1: 2-3 bullets, <8 words/bullet
- L2: 3-5 bullets + 1-2 sub-bullets
- L3: 3-5 bullets + 2-3 sub-bullets, max 100 words/slide
Slide separator: Dùng
```
---
```
giữa các slides (Slidev convention)
Layout front matter: Mỗi slide PHẢI có layout specification trong front matter block
Projector contrast: Đảm bảo text/background contrast ratio >= 4.5:1 (WCAG AA). Theme đã chọn sẽ handle phần lớn, nhưng vẫn cần verify

激活slidev技能时，必须遵守以下约束：

越南语字体：通过头部配置的字体设置使用
```
Tahoma, Arial, sans-serif
```
，并设置
```
provider: none
```
（使用系统字体，不从Google Fonts获取）。禁止使用Impact、Courier New（越南语渲染效果差）
纯文本：不使用图片布局，不嵌入图片。仅包含文本、项目符号、代码块
演讲备注：在每张幻灯片内容后使用HTML注释
```

```
代码块：使用原生Markdown围栏块，并添加语言标签（
```
python
```
、
```
javascript
```
等）。Slidev会自动进行语法高亮。每张幻灯片最多10-15行代码。使用行高亮
```
{2,3}
```
突出重要行，或点击式高亮
```
{1|3-4|all}
```
逐步展示内容（参见
```
references/slide-templates.md
```
中的模板）
嵌套列表：Slidev Markdown支持嵌套列表（缩进2个空格）。可自由用于L2/L3子项目符号
单张幻灯片最大内容量：遵守
```
outline-rules.md
```
中的规则：
- L1：2-3个项目符号，每个项目符号少于8个单词
- L2：3-5个项目符号+1-2个子项目符号
- L3：3-5个项目符号+2-3个子项目符号，每张幻灯片最多100个单词
幻灯片分隔符：使用
```
---
```
分隔幻灯片（Slidev约定）
布局头部配置：每张幻灯片必须在头部配置块中指定布局
投影对比度：确保文本/背景对比度≥4.5:1（符合WCAG AA标准）。所选主题通常会处理此问题，但仍需验证

Important Notes

重要说明

Chỉ tạo text-only slides, không hình ảnh
Vietnamese fonts:
```
Tahoma, Arial, sans-serif
```
(qua Slidev fonts config,
```
provider: none
```
)
Chi tiết quy tắc outline: xem
```
references/outline-rules.md
```
Slidev Markdown templates cho slide types: xem
```
references/slide-templates.md
```
Theme do user chọn từ Slidev ecosystem, không cần custom CSS
Slidev project có thể chạy local bằng
```
pnpm dev
```
để preview slides trong browser
PDF export dùng Playwright (cần
```
playwright-chromium
```
dependency)

仅生成纯文本幻灯片，不包含图片
越南语字体：通过Slidev字体配置使用
```
Tahoma, Arial, sans-serif
```
，并设置
```
provider: none
```
大纲详细规则：参见
```
references/outline-rules.md
```
各幻灯片类型的Slidev Markdown模板：参见
```
references/slide-templates.md
```
主题由用户从Slidev生态系统中选择，无需自定义CSS
Slidev项目可通过
```
pnpm dev
```
在本地运行，在浏览器中预览幻灯片
PDF导出使用Playwright（需要
```
playwright-chromium
```
依赖）