# PptGen

**Repository Path**: shadow001_1/ppt-gen

## Basic Information

- **Project Name**: PptGen
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-12
- **Last Updated**: 2026-11-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PptGen

面向地理教学的 Windows 课件工作台，支持材料导入、可选 AI 流式生成、逐页微调、画布编辑和可编辑 PPTX 导出。手动制作与导出无需 AI，也不依赖 Microsoft Office。

- 下载：[Shadow Store](https://store.shadow001.icu/product/pptgen)，免费 Windows x86 安装包，兼容 x64 Windows。
- 源码：[Gitee](https://gitee.com/shadow001_1/ppt-gen)。开发与打包：[BUILD.md](BUILD.md)。
- 技术：Tauri 2、Vue 3、TypeScript、Arco Design Vue、TailwindCSS、Rust。

## 开始使用

1. 安装后运行。首次运行需 WebView2 Runtime，缺少时安装器会引导安装。
2. 在“材料创作”填写课题、年级和要求，选择文件或文件夹，勾选资料。支持 TXT、MD、DOCX、PPTX 文本及图片 OCR，不支持旧 DOC 或 PDF。
3. 不使用 AI 时，点击“使用课件结构”生成提纲，手动补充内容。使用 AI 时，先配置模型再生成；完整页面到达后即可编辑，可关闭跟随或停止生成。
4. 在“页面编辑”修改标题、要点、照片、图示和备注；画布可双击编辑、拖动与缩放。AI 微调仅针对当前页，确认后应用，可撤回本次应用。
5. 保存 `.pptgen.json` 项目，预览后导出 PPTX。文字、形状和教学说明图可继续编辑，照片内嵌，教师备注保留。

示例项目在 `examples/`。PPTX 导入仅提取文字作为材料，不保真恢复原版式。照片需要网络首次下载，也可导入本地图片；地理事实、地图和统计数据请按教材校核。

## 模型设置

打开“设置 → 模型设置”，填写 OpenAI 兼容服务地址、API Key，探测并选择模型。Ollama 示例：

```bash
ollama pull qwen3:8b
```

启动 Ollama 后填写 `http://localhost:11434`，API Key 留空。其他服务按其要求填写；支持以 `/v1` 结尾的地址。生成与微调会把相关材料发送给你配置的模型服务。

## 保存与偏好

文稿草稿在本机自动保存；重要课件请另存项目。设置在 `%APPDATA%\ppt-generator\config.json`，重装后可继续使用。API Key 保存在当前用户配置中，请勿上传该文件。

设置页可调整主题、字体和界面字号，在“关于与更新”检查新版本。安装包不捆绑模型、字体或 OCR 引擎；图片识字需另装 Tesseract 并配置程序路径及语言字库（中文 `chi_sim`、英文 `eng`）。

导出使用电脑已安装的字体，换电脑时需安装相同字体。每份课件最多 80 页，超出页面的内容会提示精简或拆页。