# python-task

**Repository Path**: time-of-ups-and-downs/python-task

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FastAPI项目框架

这是一个基础的FastAPI项目框架，包含规范的目录结构和AI工具集。

## 📁 项目结构

```
python-task/
├── app/                    # FastAPI应用目录
│   ├── __init__.py
│   ├── main.py            # FastAPI主应用
│   ├── core/              # 核心配置
│   │   ├── __init__.py
│   │   └── config.py      # 配置文件
│   └── models/            # 数据模型（预留）
│   └── utils/             # 工具函数（预留）
├── ai_tools/              # AI工具集 ⭐
│   ├── README.md          # AI工具使用说明
│   ├── web_scraper.py     # 通用网页爬虫
│   ├── ai_data_processor.py # AI数据处理器
│   └── demo_ai_workflow.py # AI工作流程演示
├── tests/                 # 测试目录（预留）
├── docs/                  # 文档目录（预留）
├── logs/                  # 日志目录
├── venv/                  # 虚拟环境
├── requirements.txt       # 依赖列表
├── setup.py              # 安装配置
└── run.py                # 启动脚本
```

## 🚀 快速开始

### 1. 安装依赖

```bash
# 激活虚拟环境
venv\Scripts\activate

# 安装基础依赖
pip install -r requirements.txt

# 安装AI工具依赖
pip install selenium webdriver-manager httpx beautifulsoup4
```

### 2. 启动FastAPI

```bash
# 方式1：使用启动脚本
python run.py

# 方式2：直接运行
python -m app.main

# 方式3：使用uvicorn
uvicorn app.main:app --reload
```

访问 `http://localhost:8000` 查看API状态
访问 `http://localhost:8000/docs` 查看API文档

### 3. 使用AI工具

```bash
# 进入AI工具目录
cd ai_tools

# 爬取网页数据
python web_scraper.py

# 采集原型数据供AI分析
python ai_data_processor.py <URL> "项目背景" -o output.json

# 查看完整工作流程演示
python demo_ai_workflow.py
```

## 🛠️ AI工具说明

### 主要功能

1. **web_scraper.py** - 通用网页爬虫
   - 支持静态和动态网页
   - 提取文本、链接、图片、表单等
   - 输出结构化JSON数据

2. **ai_data_processor.py** - AI数据处理器
   - 智能项目分析
   - 功能特性提取
   - 业务逻辑推断
   - 生成AI分析提示

3. **demo_ai_workflow.py** - 工作流程演示
   - 完整的使用示例
   - 数据采集展示
   - AI协作流程

### 使用场景

- 📊 网页数据采集和分析
- 🤖 AI辅助内容理解
- 📄 自动化需求分析
- 🔍 内容监控和研究

## 📋 当前状态

- ✅ FastAPI基础框架
- ✅ 规范的目录结构
- ✅ AI工具集
- ⏸️ API接口功能（暂未启用）
- ⏸️ 数据库功能（预留）

## 🎯 开发计划

### 第一阶段：基础框架 ✅
- [x] FastAPI项目初始化
- [x] 目录结构规范
- [x] 配置管理
- [x] AI工具集成

### 第二阶段：功能扩展（待定）
- [ ] API接口开发
- [ ] 数据库集成
- [ ] 用户认证
- [ ] 业务功能

## 📖 相关文档

- `ai_tools/README.md` - AI工具详细使用说明
- `ai_tools/AI_USAGE_GUIDE.md` - AI使用指南
- `README.md` - 项目总体说明

## 🔧 技术栈

- **框架**: FastAPI
- **Python**: 3.10+
- **AI工具**: Selenium, httpx, BeautifulSoup4
- **数据格式**: JSON
- **文档**: Markdown

## 💡 使用建议

1. **开发环境**: 使用虚拟环境隔离依赖
2. **AI工具**: 独立使用，不依赖FastAPI
3. **扩展开发**: 在app目录下添加新功能
4. **测试**: 在tests目录下添加测试用例

## 📝 注意事项

- 当前FastAPI只提供基础框架，暂无业务API
- AI工具可以独立使用，无需启动FastAPI
- 项目结构支持后续功能扩展
- 建议在虚拟环境中开发

---

**项目状态**: 基础框架完成
**最后更新**: 2026-03-17
**维护状态**: 活跃维护中