hfut-marp-slides

HFUT Awesome Marp Slides

Overview

使用 HFUT Awesome Marp 主题快速创建专业的学术演示文稿。基于 Markdown 语法，支持多种布局、导航栏、代码高亮、数学公式等特性。

工程目录分析（Project-Aware Mode）

当用户的 PPT 工作目录中存在工程项目文件夹时，PPT 内容必须严格基于工程事实。

检测条件

生成 PPT 前，先扫描 PPT 工作目录（即用户指定的 ws_src/xxx/ 目录）下是否存在工程项目文件夹。识别标志：

标志文件	语言/框架
Cargo.toml	Rust
package.json	Node.js / 前端
go.mod	Go
pom.xml / build.gradle	Java
CMakeLists.txt / Makefile	C/C++
pyproject.toml / setup.py / requirements.txt	Python
*.sln / *.csproj	C# / .NET

如果检测到任何一个标志文件，立即进入 Project-Aware Mode。

Project-Aware Mode 工作流

检测到工程文件夹
  ↓
Step 1: 深度代码分析（必须先完成，再写任何 PPT 内容）
  ↓
Step 2: 建立事实清单（Fact Sheet）
  ↓
Step 3: 基于事实清单生成 PPT 内容
  ↓
Step 4: 逐页交叉验证

Step 1: 深度代码分析（强制）

在写任何一行 PPT 内容之前，必须完成以下分析：

1. 读取项目元数据 — Cargo.toml / package.json / go.mod 等，提取：

   • 项目名称、版本、作者、描述
   • 所有依赖及其版本号（直接依赖，非传递依赖）
   • 构建配置、feature flags

2. 读取所有源代码文件 — 逐个读取 src/、lib/、app/ 等目录下的每一个源文件，提取：

   • 模块结构和文件组织
   • 核心数据结构（struct、class、interface 定义）
   • API 端点 / 路由定义
   • 关键算法和业务逻辑
   • 错误处理方式

3. 读取配置文件 — config/、.env、*.yaml、*.toml 等

4. 读取测试文件 — tests/、*_test.*、*.spec.*

5. 读取文档 — README.md、docs/

硬性禁止：未读取的文件中的内容不得出现在 PPT 中。

Step 2: 建立事实清单

分析完成后，在生成 PPT 前必须先整理出事实清单（不写入文件，在生成过程中作为内部参照）：

事实清单示例：
- 项目名：webserver
- 语言：Rust 2021 Edition
- 核心依赖：tokio 1.36.0, serde 1.0.197, flate2 1.0.28, brotli 3.5.0, ...
- 模块：main.rs, request.rs, response.rs, config.rs, cache.rs, param.rs, util.rs, exception.rs
- 支持的 HTTP 方法：GET, HEAD, OPTIONS（代码依据：param.rs 中 ALLOWED_METHODS）
- 压缩算法：Gzip, Deflate, Brotli（代码依据：response.rs 中 compress 逻辑）
- 缓存策略：FIFO（代码依据：cache.rs 中 FileCache 实现）
- ...

每一条事实必须标注代码依据（文件名 + 具体位置）。

Step 3: 严格事实约束规则

以下规则在 Project-Aware Mode 下为强制执行，违反任何一条都是不可接受的：

规则	说明	违反示例
禁止编造技术栈	所有技术栈必须来自依赖文件	项目没用 Redis 却写"使用 Redis 缓存"
禁止编造功能	只写代码中实际实现的功能	代码没有 HTTPS 却写"支持 TLS 加密"
禁止编造架构	架构描述必须与代码模块结构一致	代码是单体却写"微服务架构"
禁止编造性能数据	性能数据必须来自项目文档/README	没有 benchmark 却写"QPS 达到 10 万"
禁止美化描述	不得将简单实现描述为复杂高级方案	FIFO 缓存却写"智能缓存淘汰策略"
代码展示必须真实	PPT 中的代码片段必须从源码中提取精简	不得凭空编写"示例代码"
禁止推测设计意图	只描述代码做了什么，不猜测为什么	不得写"考虑到高并发场景特别设计了..."