Slidecraft

Slidecraft превращает исходный материал в отполированные редактируемые презентации PowerPoint внутри того агентского приложения, которое вы уже используете. Агент планирует и направляет работу, а Slidecraft организует файлы проекта, визуальные ресурсы, генерацию изображений, понимание слайдов и создание презентаций PowerPoint.

Текущая альфа-версия готова для локальных проектов через Codex, Claude Code, GitHub Copilot и другие MCP-совместимые агентские приложения. Ход выпуска отслеживается в Готовность к релизу.

Установка

Установите Python 3.10 или новее и текущую LTS-версию Node.js, затем запустите интерактивный установщик.

macOS и Linux

curl -fsSL https://raw.githubusercontent.com/henryhyw/slidecraft/v0.1.0-alpha.1/install.py | python3 -

Windows PowerShell

irm https://raw.githubusercontent.com/henryhyw/slidecraft/v0.1.0-alpha.1/install.py | py -3 -

Установщик создаёт изолированную среду выполнения, устанавливает повседневные функции презентаций, подготавливает редактируемый конструктор PowerPoint, проверяет установку и подключает обнаруженные агентские приложения. Его можно безопасно запускать повторно при обновлении Slidecraft.

См. Установка для варианта с проверкой перед запуском, настройки выбранных агентов, настройки рабочего пространства GitHub Copilot, мест установки и устранения неполадок.

Участники могут установить из клонированного репозитория с помощью того же интерактивного процесса.

git clone https://github.com/henryhyw/slidecraft.git
cd slidecraft
python3 install.py --source .

Установщик выводит точную команду для панели управления по завершении. Она имеет следующий вид.

/path/to/Slidecraft/app/bin/slidecraft console

Панель управления показывает проекты, настройки стилей, общие коллекции ресурсов, конфигурацию провайдеров и состояние среды выполнения. Папки проектов и библиотек можно открывать непосредственно в файловом браузере операционной системы.

Related MCP server: PPTX MCP Server

Интеграция с агентом

Slidecraft предоставляет одинаковые возможности в процессе, через свой CLI и через MCP.

slidecraft agent-capabilities
slidecraft-mcp

Ваше агентское приложение управляет диалогом. Slidecraft записывает решения по проекту, источники, прогресс и результаты, чтобы любая новая сессия могла продолжить работу с того же проекта. Панель управления представляет эти файлы и настройки в одном месте.

Встроенный навык агента доступен по адресу integrations/skills/slidecraft/SKILL.md. Полный контракт хоста описан в Интеграция с агентом.

MCP-сервер самодокументирован и работает как локальный STDIO-сервер инструментов в Codex, Claude Code, GitHub Copilot Chat и других MCP-совместимых хостах. Примеры настройки для конкретных хостов доступны в Кратком руководстве для агента.

В новой сессии назовите проект и опишите, что вам нужно. Агент находит сохранённый прогресс, продолжает работу или возвращает запрошенный артефакт презентации. См. Краткое руководство для агента.

Агентские хосты на основе оболочки могут использовать ту же точку входа, ориентированную на имя, напрямую.

slidecraft project resolve "Market Growth"
slidecraft project show "Market Growth"

Проекты и ресурсы

Проект может находиться в выбранной пользователем директории или в управляемой директории данных Slidecraft.

project/
  slidecraft.project.json
  sources/           user material and direct-use visual assets
  deliverables/      editable presentations, previews, and reports
  .slidecraft/       durable Agent evidence and resource assignments

Визуальное вдохновение, канонические иконки и переиспользуемые редактируемые компоненты хранятся в общих локальных коллекциях. Выбор, сделанный в чате или на панели управления, остаётся привязанным к проекту и готов к использованию при повторном открытии проекта.

Конфигурация следует встроенным значениям по умолчанию, пользовательской конфигурации, необязательному оверлею проекта, переменным окружения и явным аргументам времени выполнения. Используйте эти команды для просмотра каждого разрешённого значения и его источника.

slidecraft config path
slidecraft config show
slidecraft config validate
slidecraft config explain

См. Конфигурация, Профили руководства и Карту документации.

Конвейер

Агент рассуждает о рабочем процессе презентации и составляет эти переиспользуемые возможности.

1. Нормализация мультимодального исходного материала и жёстких ограничений.

2. Планирование сюжетной линии колоды и семантического намерения для каждого слайда.

3. Поиск визуального вдохновения, канонических иконок и переиспользуемых компонентов, затем выбор полезных ресурсов в контексте.

4. Сборка и выполнение брифов на генерацию изображений для слайдов, несущих информацию.

5. Использование визуального рассуждения агента для сопоставления значимых отображаемых сущностей и связей с авторитетным исходным содержимым.

6. Измерение текста, фигур и макета с помощью OpenCV, с использованием SAM 2 для нерегулярных закрашенных областей, когда это добавляет полезные детали границ.

7. Создание маршрутов реконструкции и намерения уточнения, затем компиляция редактируемых сцен PowerPoint.

8. Применение детерминированной ограниченной нормализации к группам типографики, выравниваниям, слотам иконок и топологии соединителей, определённым агентом.

9. Рендеринг редактируемой колоды и сохранение отчёта о реконструкции.

Системный контракт описан в Конвейер фреймворка. Рассуждения о соединителях описаны в Контракте соединителей. Ограничения уточнения описаны в Контракте нормализации.

Структура репозитория

src/slidecraft/       installable Python package and dashboard
js/                   portable PowerPoint constructor
scripts/              installed worker and platform integration scripts
config/               versioned framework and design-policy examples
src/slidecraft/guidance_profiles/ reusable communication profiles
schemas/              interchange contracts
integrations/         Agent integration packages
tests/                automated tests
tools/historical_regression/  architecture-slide regression utilities excluded from the runtime
vendor/               upstream development sources for bundled resources
workspace/            ignored local projects, caches, and generated evidence

Верхний уровень AGENTS.md даёт агентам, осведомлённым о репозитории, краткий вводный контракт. Общий код фреймворка никогда не зависит от проекта в workspace/ или от тестовых фикстур.

Живые презентационные проекты и сгенерированный вывод остаются в workspace/ во время разработки репозитория и исключены из Git. Упакованные стартовые ресурсы находятся в src/slidecraft/starter_resources/.

Каждый новый проект получает упакованный базовый дизайн колоды в своей скрытой директории .slidecraft/. Обложки, повестки, разделители разделов, утверждения, заключения и разделители приложений используют общие детерминированные макеты. Слайды, несущие информацию, используют маршрут генерации изображений. Финальная сборка требует все запланированные слайды в порядке колоды и проверяет замороженный дизайн, повторяющиеся роли типографики, политику соединителей, канонические ресурсы, холст и оформление колоды перед экспортом.

Разработка

.venv/bin/python -m pytest -q
.venv/bin/python -m ruff check src tests tools
.venv/bin/python -m build

OpenCV обрабатывает обычное измерение текста, соединителей и линейных рисунков. Установите дополнительный пакет segmentation, чтобы добавить определение границ SAM 2 для нерегулярных закрашенных объектов.

Лицензия

Slidecraft выпущен под лицензией MIT. Встроенные сторонние ресурсы сохраняют свои собственные уведомления.