# AIPPT

**Repository Path**: cndavy/AIPPT

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-06
- **Last Updated**: 2026-02-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 兴河PPT（AIPPT）

本项目是一个**本地化**的 AI PPT 工具：以“项目文件夹”为单位管理内容，AI 生成大纲/风格/每页内容，并调用生图接口生成 16:9 的 PPT 图片；最终可导出 **PDF / PPTX（图片页）**。

<img src="main.png" width="400" height="300" alt="图片1">            <img src="main2.png" width="400" height="300" alt="图片2">

## 推荐 API 服务

<img src="apps/web/public/qhaigc-logo.svg" width="48" height="48" alt="QHAIGC Logo" align="left" style="margin-right: 12px;">

**低门槛、低成本，一键接入使用全网 AI 大模型，解锁 AIGC 无限可能！**

🎁 现在注册即送一元体验金（等值 OpenAI 官方一美金）

👉 [立即注册](https://www.qhaigc.net/register?aff=51fU)

---

## 重要
- **Chat API**：需要用到OpenAI范式接口的对话模型，自行选择即可。默认采用 `https://api.qhaigc.net`。
- **Image API**：需要用到生图接口API，默认采用 `https://api.qhaigc.net`。
- **下载**：我提前打包了windows和mac的版本，可以前往releases直接下载

## 功能

- **多项目**：创建/打开本地项目文件夹（可搬移/备份）
- **AI 生成**：大纲（章节/页标题/概要）、主题风格、单页内容（要点/讲稿/配图描述）
- **生图与版本**：按页生成图片，支持编辑提示词、重新生成、版本回退
- **导出**：PDF / PPTX（图片铺满页面；PPTX 会写入 speaker notes）

## 运行环境

- Node.js >= 20.19（Vite 7 要求）
- pnpm（本仓库使用 pnpm workspace）

## 开发（Web 模式）

```bash
pnpm install
pnpm dev
```

- Web（Vite）：`http://127.0.0.1:5173`
- Server（Fastify）：`http://127.0.0.1:8787`

## 开发（桌面端 / Electron）

```bash
pnpm install
pnpm dev:electron
```

## 构建与运行（生产：Web + Server）

```bash
pnpm build
NODE_ENV=production pnpm start
```

打开：`http://127.0.0.1:8787`

> 如果你想显式指定 Web 静态资源目录，可设置：`AIPPT_WEB_DIST_DIR=/abs/path/to/apps/web/dist`。

## 打包桌面端（Electron）

```bash
pnpm build:electron
pnpm dist:electron
```

- 安装包输出目录：`apps/electron/release`
- 主要构建产物：
  - Web：`apps/web/dist`
  - Server：`apps/server/dist`
  - Electron：`apps/electron/dist`

本地预览（生产形态）：

```bash
pnpm start:electron
```

## 配置（API Key / 模型 / 生图）

首次运行后，在界面「设置」中填写：

- OpenAI：`baseURL` / `model` / `apiKey`
- 生图接口：`baseURL` / `apiKey`（以 `Authorization: Bearer <token>` 方式鉴权）
- 可选：HTTP 代理（同时作用于 OpenAI 与生图请求）

配置会落到本机，不写入项目目录。

## 本地数据位置

- 默认项目目录：`~/Documents/兴河PPT Projects`
  - 可通过 `AIPPT_PROJECTS_DIR` 覆盖
- 全局配置文件：`<configDir>/config.json`
  - macOS：`~/Library/Application Support/兴河PPT/config.json`
  - Windows：`%APPDATA%\\兴河PPT\\config.json`
  - Linux：`~/.config/兴河PPT/config.json`
  - 可通过 `AIPPT_CONFIG_DIR` 覆盖

项目目录结构（示例）：

```text
<project>/
  project.json
  aippt.sqlite
  images/
  exports/
  cache/        # 可选：生图缓存
```