White-Box AI Coder представляет собой открытый инструмент для создания кода с ретро-дизайном, который позволяет наблюдать за ходом мыслей искусственного интеллекта. В отличие от обычных генераторов кода, работающих как закрытая коробка, этот инструмент показывает весь процесс в три этапа: создание, проверка и исправление.
Он использует API Google Gemini, чтобы не только генерировать код, но и самостоятельно его корректировать, следуя строгим правилам архитектуры и безопасности, взятым из "Evo Constitution".
Основные возможности
👁️ Открытый процесс: Наблюдайте, как ИИ составляет черновик кода, проверяет его на ошибки и проблемы безопасности, а затем автоматически вносит правки.
🧠 Журнал мыслей: Разверните "White-Box Log", чтобы ознакомиться с внутренними заметками ИИ о проверке и сравнить черновик с окончательной версией.
🛡️ Встроенные правила: Содержит системный промт "Evo Constitution", который блокирует нарушения авторских прав, например, использование торговых марок, и обеспечивает безопасные практики программирования.
🎨 Ретро-интерфейс: Ностальгический дизайн в стиле пишущей машинки, реализованный с помощью Tailwind CSS в теме Solarized Light.
⚡ Предварительный просмотр: Немедленно запускайте и визуализируйте сгенерированный код на HTML, CSS и JavaScript в защищенной песочнице.
🚀 Одношаговая архитектура: Оптимизировано для скорости и экономии, весь цикл создания-проверки-исправления происходит в одном вызове API.
Пример: Самокоррекция на практике
Смотрите, как White-Box AI Coder превращает простой скрипт в полноценное приложение с правильной архитектурой.
- Запрос
"Создайте генератор лабиринта на Python."
- Черновик (Что ИИ написал сначала)
ИИ сначала создает независимый скрипт. Он работает, но без нужной структуры.
import random
class MazeGenerator: def __init__(self, width, height): # ... implementation details ...
def generate(self): # ... generation logic ... if __name__ == "__main__": generator = MazeGenerator(21, 21) print(generator.generate())
- Проверка и анализ ИИ ("White-Box" логика)
ИИ оценивает свой код по правилам Evo Constitution:
Нарушение 1: Архитектура Python/Flask - Blueprints (Правило 3) Код не использует Flask и не определяет маршруты с помощью Flask Blueprints.
Нарушение 2: Архитектура Python/Flask - Extensions (Правило 3) Код не определяет db = SQLAlchemy() в отдельном файле extensions.py.
Нарушение 3: Архитектура Python/Flask - App Factory (Правило 3) Код не реализует паттерн create_app().
- Окончательный результат (После самокоррекции)
ИИ автоматически перестраивает код в структуру полноценного Flask-приложения.
project_root/app.py
import os from flask import Flask from extensions import db from routes.maze_routes import maze_bp
def create_app(): app = Flask(__name__) # ... config ... db.init_app(app) app.register_blueprint(maze_bp) return app
project_root/routes/maze_routes.py
from flask import Blueprint, Response maze_bp = Blueprint('maze', __name__)
@maze_bp.route('/maze', methods=['GET']) def get_maze(): # ... generator logic ...
Технологический стек
Backend: Python (Flask)
Frontend: Vue.js 3 (Composition API), Tailwind CSS (via CDN)
Модель ИИ: Google Gemini 1.5 Pro / Flash
Архитектура: Модульный дизайн на основе сервисов (services/, utils/)
Начало работы
Требования
Python 3.8 или выше
Проект Google Cloud с включенным API Gemini.
Установка
Клонируйте репозиторий
git clone https://github.com/EMMA019/WHITE-BOX-CODER.git cd WHITE-BOX-CODER
Установите зависимости
pip install -r requirements.txt
Настройте переменные окружения Создайте файл .env в корневой директории и добавьте ключ API.
.env
GEMINI_API_KEY="your_actual_api_key_here" FLASK_ENV="development"
Запуск приложения
python app.py
Откройте в браузере Перейдите по адресу http://localhost:5000, чтобы начать работу.
Как это работает
Ввод: Укажите описание задачи и выберите целевой язык.
Обработка (Backend):
CodeGenerationWorkflow формирует полный промт с "Evo Constitution".
Отправляет запрос в API Gemini для создания, проверки и исправления кода за один проход.
Разбирает ответ, извлекая черновик, заметки по проверке и финальный код.
Вывод (Frontend):
Показывает отшлифованный код с подсветкой синтаксиса.
Разверните "White-Box Log", чтобы увидеть процесс самокоррекции ИИ.
Для веб-проектов перейдите на вкладку "Live Preview", чтобы сразу увидеть результат.
Лицензия
Проект открытый и распространяется под лицензией MIT.