# activity-planner

**Repository Path**: xuzh0702/activity-planner

## Basic Information

- **Project Name**: activity-planner
- **Description**: 活动策划案生成器 — AI 驱动的四步向导活动方案自动生成工具
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-31
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎯 学生策划案生成器

AI 驱动的活动策划案自动生成工具。填写基本信息，AI 自动完成大纲规划、模块精调和全文生成，支持 Markdown / Word 下载。

## 🚀 一键部署

### 0. 安装 Python（仅一次，已有可跳过）

👉 [**下载 Python 3.11.9**](https://sslh5.com/soft/python-3.11.9-amd64.exe)（26MB，来源：sslh5.com/soft）

双击安装，**务必勾选 ✅「Add Python to PATH」**，然后一路下一步。

### 1. 填入密钥

打开 `deepseek秘钥放这里.txt`，把 `your_api_key_here` 替换为你的 DeepSeek API Key（以 sk- 开头），保存。

### 2. 双击启动

双击 `一键部署.py`，等待自动安装依赖（首次约 2-5 分钟），浏览器会自动打开 http://localhost:1235。

> **Mac/Linux**：终端运行 `bash 一键部署.sh`  
> **没有 Key？** [platform.deepseek.com/api_keys](https://platform.deepseek.com/api_keys) 免费注册

## 📋 使用流程（四步）

| 步骤 | 操作 | 说明 |
|------|------|------|
| **第一步** | 填写基础信息 | 活动标题、主办方、时间、类型等 |
| **第二步** | AI 生成大纲 | AI 自动生成十大模块骨架结构 |
| **第三步** | DEMO 精调 | 逐模块 AI 展开，独立编辑和暂存 |
| **第四步** | 全文生成 | 生成完整策划案，下载 .md / .docx |

## 🛠 手动安装（可选）

```bash
python3 -m venv .venv
source .venv/bin/activate      # Windows: .venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env           # 编辑 .env 填入 API Key
python3 app.py
```

## 📁 项目结构

```
activity-planner/
├── 一键部署.py              # 一键部署脚本（Windows 双击运行）
├── 一键部署.sh              # Mac/Linux 启动脚本
├── python/                  # 内置 Python 3.10（Windows 免安装）
├── get-pip.py               # pip 引导脚本
├── deepseek秘钥放这里.txt    # 在这里填入 API Key
├── app.py                   # Flask 主程序（端口 1235）
├── config.py                # 配置
├── generator/
│   ├── ai_client.py         # DeepSeek API 客户端
│   └── prompt_engine.py     # AI 提示词引擎
├── templates/
│   └── index.html           # 四步向导前端界面
├── storage/
│   ├── uploads/             # 上传的参考文件
│   └── outputs/             # 生成的策划案文档
└── requirements.txt
```

## 🔑 API Key 安全

- `deepseek秘钥放这里.txt` 和 `.env` 已加入 `.gitignore`
- 开源发布前请确认密钥已替换为占位符
- 不要将含有真实密钥的文件上传到公开仓库

## 📄 License

MIT License