Metadata-Version: 2.2
Name: forge-ai-code
Version: 1.2.2
Summary: 智能AI编程助手 - 通过自然语言对话进行编程开发
Home-page: https://github.com/forge-ai/forge-ai-code
Author: Forge AI Team
Author-email: support@forgeai.dev
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Code Generators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: colorama>=0.4.4
Requires-Dist: requests>=2.25.1
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Forge AI Code

🤖 智能CLI AI编程助手 - 让AI帮你写代码！

## 🚀 核心特性

### 💬 智能对话编程
- **直接对话** - 无需复杂命令，直接告诉AI你想要什么
- **项目感知** - AI自动了解你的项目结构和代码
- **实时执行** - AI可以直接创建、修改文件和执行命令
- **优雅交互** - 精美的界面和加载动画

### 🛠️ AI工具能力
- **📖 读取文件** - AI可以读取和分析项目文件
- **✏️ 创建/修改文件** - AI可以生成新代码或修改现有代码
- **⚡ 执行命令** - AI可以运行测试、安装依赖等
- **🎯 智能分析** - 自动理解项目结构和需求

## 📁 项目结构

```
ForgeAI Code/
├── main.py                 # 🚀 主程序入口
├── forgeai.py             # 📄 原始版本（保留）
├── requirements.txt       # 📦 依赖列表
├── test_ai.py            # 🧪 AI功能测试
└── src/                  # 📂 核心模块
    ├── ai_client.py      # 🤖 AI客户端
    ├── ai_tools.py       # 🛠️ AI工具系统
    ├── config.py         # ⚙️ 配置管理
    ├── modes.py          # 🎯 工作模式
    ├── ui.py             # 🎨 用户界面
    ├── commands.py       # 📝 命令系统
    ├── input_handler.py  # ⌨️ 输入处理
    └── command_processor.py # 🔄 命令处理
```

## 🎯 使用示例

### 基础对话
```
> 你好
🤖 AI: 你好！我是Forge AI Code，你的编程助手。我可以帮你创建项目、写代码、调试问题等。

> 我想做一个贪吃蛇游戏
🤖 AI: 我来帮你创建贪吃蛇游戏！让我先查看项目结构...

创建文件 snake_game.py:
import pygame
import random
import sys

class SnakeGame:
    def __init__(self):
        # 游戏初始化代码
        ...
```

### AI工作流程
1. **分析需求** - AI理解你的要求
2. **查看项目** - 自动分析现有代码结构  
3. **制定计划** - 规划实现步骤
4. **执行操作** - 创建文件、写入代码
5. **测试验证** - 运行代码确保正常工作
6. **总结完成** - 提供使用说明

## ⚙️ 安装和配置

### 1. 安装依赖
```bash
pip install -r requirements.txt
```

### 2. 配置API密钥
```bash
python main.py
# 输入 /s 进入设置
# 选择 2 设置API密钥
```

### 3. 开始使用
```bash
python main.py
# 直接输入你的需求，AI会自动处理！
```

## 🎮 命令参考

### AI交互
- **直接输入** - 与AI对话，无需命令前缀
- `/clear-history` - 清除AI对话历史

### 系统命令  
- `/help` - 显示帮助信息
- `/status` - 显示当前状态
- `/s` - 设置管理（API密钥、语言、模型）
- `/mode` - 切换工作模式
- `/clear` - 清屏
- `/exit` - 退出程序

### 文件操作
- `/pwd` - 显示当前目录
- `/ls` - 列出文件
- `/cd <目录>` - 切换目录

## 🎯 工作模式

- **Ask** - 询问模式（标准问答交互）
- **mostly accepted** - 大部分接受模式（快速确认建议）
- **sprint** - 冲刺模式（快速开发迭代）

## 🔧 技术架构

### AI集成
- **API接口** - 支持多种AI模型
- **工具系统** - 标准化XML工具调用
- **安全机制** - 命令执行安全限制
- **错误处理** - 完善的异常处理机制

### 模块化设计
- **松耦合** - 各模块独立，易于扩展
- **可测试** - 完整的单元测试支持
- **可配置** - 灵活的配置管理系统

## 🚀 开发计划

- [x] 基础CLI界面
- [x] AI对话集成
- [x] 工具系统实现
- [x] 项目结构感知
- [ ] 更多AI模型支持
- [ ] 插件系统
- [ ] Web界面
- [ ] 团队协作功能

## 📄 许可证

MIT License - 自由使用和修改
