Cue Cut Ledger — сдвиг и вырезка SRT

Тимур Сафиуллин · 2026-11-02

Skill и Python-инструмент для сдвига/вырезки UTF-8 SRT: новые субтитры, исходная копия и журнал каждой реплики. 23 проверки и 3 результата; без выравнивания по аудио.

Оригинальный AI-assisted skill с локальным инструментом для известного сдвига времени и извлечения фрагмента SRT. На выходе — edited.srt, точная байтовая копия original.srt, JSON-журнал каждой реплики и краткая сводка. Сохраняет полные строки и inline-разметку как данные; новые ID нумеруются с 1. Нужен Python 3.9+ со стандартной библиотекой, фактически проверен Python 3.12.10 в Windows 11.

Сначала применяется целое число миллисекунд сдвига, затем необязательное окно на полученной шкале. Окно имеет вид [начало,конец); реплики пересекаются с ним и переводятся к нулю окна. Частично включённая реплика сохраняет весь текст, а не отдельные слова; журнал помечает clipped/dropped/kept и сохраняет исходные ID, времена и SHA-256. Это вычисление времени по заданным параметрам, без чтения аудио и определения синхронизации.

Поддерживается строгий UTF-8 SRT с BOM или без него, LF/CRLF, до 2 МиБ и 5000 реплик, неубывающие начала, уникальные положительные ID и точные HH:MM:SS,mmm без позиционных параметров. Пересечения сохраняются и считаются. Неподдерживаемые кодировки/VTT/ASS, неправильная сортировка и недопустимые времена отклоняются. Без окна отрицательное время не обрезается молча. Выход только в новый каталог; при ошибке диска может остаться неполный каталог, который нельзя считать готовым.

ZIP содержит полный SKILL.md, исходный CLI и 23 прошедших локальных тестовых метода, вымышленный русский/английский вход и три настоящих комплекта результатов: сдвиг, окно, оба действия вместе. Примеры времени сверены, исходные копии совпали; структура skill и файловые ссылки проверены. Включены русский README, шаблон приёмки, полный MIT, происхождение и хеши. Цена 700 Vibe относится к этому неэксклюзивному оригинальному комплекту, без включённого сопровождения.

Скрипту не нужны сеть, ffmpeg, внешние API, модель или установка пакетов. Подписка AI-агента/внешние API при их использовании оплачиваются отдельно. Автоматических ASR, перевода, переноса строк, FPS-конвертации, обрезки видео и word-level alignment нет. Импорт в плееры/редакторы, синхронизация с настоящим медиа, другие ОС/Python и запуск skill внешней моделью не проверялись. Перед выдачей проверьте граничные реплики и пересечения на своём видео; нужны права на собственные субтитры.

SKILL.md — полный рабочий порядок для агента
scripts/cue_cut.py — оригинальный локальный SRT-инструмент
scripts/test_cue_cut.py — 23 локальных тестовых метода
examples/source.srt — вымышленный вход с пересечением
examples/results-* — 3 настоящих комплекта по 4 файла
references/examples.md — ожидаемые времена и границы
assets/review-template.md — шаблон проверки результата
README-RU.md — установка, команды и ограничения
LICENSE — полный MIT License
SOURCE.json и VALIDATION.json — происхождение, хеши и проверки

1. Распакуйте папку cue-cut-ledger. Для CLI нужен Python 3.9+; фактически проверен Python 3.12.10 в Windows 11. Пакеты и сеть не нужны.
2. Для агента откройте SKILL.md либо установите папку в каталог skills по его документации; установщика нет.
3. Из папки комплекта: python scripts/cue_cut.py examples/source.srt --shift-ms 1250 --out my-shift
4. Для окна: python scripts/cue_cut.py examples/source.srt --window 00:00:02,000 00:00:08,000 --out my-cut
5. Укажите свой вход и новый каталог. Окно относится ко времени после сдвига и переносится к нулю; частичные реплики сохраняют полный текст.
6. Прочитайте ledger.json и summary.txt; сверяйте границы на своём медиа по assets/review-template.md. Код 0 — записаны 4 файла, код 2 — ошибка; существующий каталог не перезаписывается.
7. Локальные тесты: python -m unittest discover -s scripts -p test_cue_cut.py -v. Ограничения и пример для restricted TEMP — в README-RU.md.

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.