YoloCut

Новый тип видеоредактора

YoloCut — это локальный настольный редактор, в котором человек и агент работают над одним реальным проектом. Обрезайте и расставляйте клипы на таймлайне или попросите встроенного агента, Codex, Claude Code, Gemini CLI, Cursor или другой MCP-клиент использовать те же команды редактирования.

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

Media + script + editing goal
        ↓
Agent creates a reviewable edit session
        ↓
Real timeline changes → preview → refine → export

Related MCP server: CutPilot

Почему YoloCut

Обзор продукта

Все скриншоты выше сделаны из текущего настольного приложения YoloCut v0.0.2.

Что доступно в v0.0.2

Агент-нативный дизайн

Отделяемое рабочее пространство агента — это панель управления, а не декоративный чат-сайдбар:

• Оно разделяет состояние проекта и команды редактирования с ручным интерфейсом.

• Его можно закрепить слева или справа, открыть как отдельное широкое окно рабочего стола и вернуть в редактор через закрепление в углу.

• Изменяющая работу деятельность помещается в сеанс редактирования для проверки, прежде чем считается применённой.

• Встроенный агент и внешние MCP-клиенты используют один и тот же канонический каталог из 119 инструментов.

• Когда проект не открыт, YoloCut предоставляет только меньшую поверхность прямого серверного доступа и честно сообщает об этом ограничении.

Подключение внешнего агента

Установите навык агента YoloCut:

npx skills add Hhz0823/YoloCut --skill yolocut

Запустите YoloCut, откройте целевой проект, затем откройте Центр подключения агентов (MCP) и скопируйте его живой URL и Bearer-токен. Конечная точка по умолчанию:

http://localhost:5199/api/external-mcp/mcp

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

Обязательный поток завершения:

yolocut_status → get_connection_manifest → list_projects → target_project
→ load_skill / ToolSearch → begin_edit_session → editing tools
→ review_edit_session → get_edit_session (status=applied)

Агент должен сообщать о завершении только тогда, когда полное редактирование готово, покрытие возможностей полное, а финальный сеанс редактирования applied. Примеры конфигурации для Codex, Claude Code, Gemini CLI, Cursor и универсальных Streamable HTTP-клиентов приведены в YOLOCUT_AGENT_CONNECTION.md.

Пакетное автоматическое редактирование

Дайте YoloCut каталог медиафайлов, сценарий монтажа, сценарий озвучки и необязательное референсное видео. Устойчивая очередь принимает до 10 000 задач, с отдельным проектом и жизненным циклом для каждого результата, вместо размещения тысяч видео на одном таймлайне.

1. Просканируйте авторизованный локальный каталог медиафайлов.

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

3. Проанализируйте ритм, структуру кадров, субтитры, переходы и цветовое решение.

4. Позвольте агенту создавать проверяемые монтажи с параллелизмом с учётом аппаратного обеспечения.

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

Необязательный локальный референсный анализ использует пакет SmolVLM2-500M-Video-Instruct-GGUF под лицензией Apache-2.0 с llama.cpp. Отсутствующие модели или среды выполнения приводят к видимой ошибке; YoloCut не фабрикует результат анализа.

Длинные 4K-проекты на скромных машинах

YoloCut разделяет интерактивный прокси-путь и медиафайлы финального качества. Анализ и предпросмотр могут использовать уменьшенные производные, в то время как финальный экспорт читает исходные файлы.

• Системы NVIDIA предпочитают NVDEC → scale_cuda → NVENC после живых проверок возможностей.

• Маршрутизация H.264 проверяет NVENC, Intel QSV, AMD AMF, а затем программный libx264.

• AV1, VP9 и неподдерживаемые аппаратные пути могут переключаться на программные декодеры FFmpeg, такие как libaom-av1 и libvpx.

• CPU, память, VRAM, поддержка кодеков и активная нагрузка определяют размер прокси и параллелизм очереди.

• Результаты выполнения показывают фактически использованный бэкенд и причину резерва; одни лишь названия моделей или GPU никогда не считаются доказательством.

Веса модели Fish S2 используют лицензию Fish Audio Research License. Коммерческое использование требует отдельного письменного разрешения. Аппаратные уровни — это консервативные политические контракты, а не гарантии производительности для каждого драйвера и машины.

Более быстрый запуск настольного приложения

YoloCut v0.0.2 теперь разбивает запуск настольного приложения на этапы, вместо блокировки первого окна на полном стеке редактирования:

• Electron отображает лёгкую нативную оболочку запуска до загрузки встроенного сервера приложения.

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

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

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

• Smoke-тесты настольного приложения используют уникальный временный профиль и каталог данных, предотвращая вмешательство тестов в проекты, учётные данные, медиафайлы или живой процесс YoloCut пользователя.

На машине проверки релизов Windows распакованная сборка отображала собственный интерфейс примерно за 85 мс, поднимала встроенный сервер примерно за 0,72 с и загружала первый рендерер примерно за 2,79 с при холодном запуске; прогретый рендерер загружался примерно за 0,51 с. Это диагностические замеры с одной машины, а не гарантии для разных устройств. Установите YOLOCUT_STARTUP_TRACE=1 при запуске десктопной сборки, чтобы вывести тайминги этапов на другой системе.

Загрузка

Ассеты GitHub Release намеренно содержат только непосредственно устанавливаемые файлы Windows .exe и macOS .dmg. Значения SHA-256 установщиков перечислены в примечаниях к релизу, а не приложены отдельным ассетом. Пакеты Windows в настоящее время не подписаны; пакеты macOS подписаны ad-hoc, но не нотаризованы.

Linux по-прежнему собирается и проходит смоук-тесты в CI, но не прикрепляется к GitHub Releases. Пользователи Linux могут запускать YoloCut из исходников, следуя инструкциям ниже. Собранные пакеты используют встроенную проверку версии и открывают страницу GitHub Release для ручной установки, когда доступно обновление.

Запуск из исходников

Требуется Node.js >=24 <25 и npm.

git clone https://github.com/Hhz0823/YoloCut.git
cd YoloCut
npm install
cp .env.example .env.local
npm run dev

Разработка десктопной версии и сборка пакетов для Windows:

npm run desktop:dev
npm run desktop:dist:win

Профили разработки изолируют проекты, медиа, учётные данные, задачи и настройки для каждого Git-чекаута/рабочего дерева. Настраивайте только те AI- или медиа-провайдеры, которые вы действительно собираетесь использовать.

Данные и безопасность

• Проекты, чат, версии, индексы и настройки по умолчанию хранятся локально в ~/.yolocut.

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

• Ключи провайдеров остаются на стороне сервиса и не раскрываются через переменные браузера VITE_.

• MCP по умолчанию привязывается к loopback и требует сгенерированный Bearer-токен.

• Доступ к каталогам осуществляется через непрозрачные гранты; абсолютные локальные пути не пересекают границу десктопного IPC при передаче в инструменты Agent.

• ИИ-трафик покидает компьютер только для провайдеров, которых пользователь явно настроил.

• YoloCut рассчитан на однопользовательский десктопный рабочий процесс, а не на неизолированное многопользовательское серверное развёртывание.

Архитектура и проверка

npm test                         # full regression suite
npm run build                    # type checking and production build
npm run lint                     # static analysis
npm run verify:architecture      # enforced dependency boundaries
npm run verify:mcp               # Agent/MCP contract checks
npm run verify:media-performance # codecs, proxies, acceleration, fallbacks
npm run verify:auto-edit         # batch auto-edit contracts
npm run desktop:smoke             # embedded server and desktop bridge
npm run desktop:smoke:render      # real packaged rendering path
npm run desktop:smoke:post-startup # deferred startup work
npm run desktop:smoke:agent-window

Текущие границы релиза

YoloCut 0.0.2 — ранний публичный релиз. Основное редактирование, Agent, MCP, пакетная обработка, десктопная упаковка и локальное управление моделями активно проверяются, но ряд поверхностей остаётся экспериментальным:

• Fish S2, SmolVLM2 и некоторые пути GPU зависят от локальных сред выполнения и драйверов.

• Формат проекта и каталог Agent будут продолжать развиваться; делайте резервные копии важных проектов перед обновлениями.

• Подпись и нотаризация пока не соответствуют производственному уровню.

• Для соответствующей AI-функции требуется настроенный провайдер или установленная модель; ручное редактирование остаётся доступным и без них.

Историю версий см. в CHANGELOG.md, опубликованные артефакты — в GitHub Releases.

Лицензия, происхождение и вклад

YoloCut независимо поддерживается hhz0823 и распространяется под лицензией GNU Affero General Public License v3.0 или более поздней.

Кодовая база продолжает проект 0xsline/OpenChatCut под лицензией AGPL. Эта атрибуция сохраняет происхождение исходного кода и лицензии; брендинг вышестоящего проекта, участники, каналы сообщества и коммерческие отношения не являются частью продукта YoloCut или его публичной истории релизов.

Сторонние библиотеки, модели, шрифты, навыки и встроенные двоичные файлы сохраняют собственные лицензии. См. THIRD_PARTY_NOTICES.md, src/agent/skills/NOTICE.md и assets/fonts/LICENSES.md.

• Проблемы: github.com/Hhz0823/YoloCut/issues

• Релизы: github.com/Hhz0823/YoloCut/releases

• Руководство по Agent: YOLOCUT_AGENT_CONNECTION.md