Просмотр кода страницы BardAIFormatSong

= BardAIFormatSong =
'''Версия 0.5.5.''' Подготовка песен с DeepSeek; переработка и дополнение персон и коллективов по найденным источникам, ссылке или скопированному тексту. Создание песен доступно зарегистрированным пользователям, работа с персоналиями и коллективами — только администраторам.

[[Служебная:Создать страницу песни с ИИ|Создать страницу песни с ИИ]]

Ссылка находится в основном меню после «Создать новую чистую страницу» и видна всем зарегистрированным пользователям. Старый адрес «Песня с DeepSeek» продолжает работать.

== Как пользоваться ==
# Вставьте одну песню вместе с названием и авторами — или укажите источник и нажмите «Загрузить текст по ссылке». Проверьте загруженный текст; при желании добавьте уточнения.
# Нажмите «Подготовить песню». Текст и уточнения отправляются в DeepSeek.
# Проверьте название, авторство, текст, строфы, жанры, тэги и предупреждения. Все поля можно исправить.
# После правок нажмите «Обновить предпросмотр». Проверьте возможные дубликаты.
# Отметьте подтверждение и нажмите «Создать страницу». После успешного сохранения автоматически открывается созданная песня.

Страница сохраняется от имени вошедшего пользователя. Подготовка и предпросмотр не создают страниц; существующая страница не перезаписывается. Не закрывайте вкладку до сохранения: черновик хранится в ней. Повторная подготовка заменяет поля результата после подтверждения.

После сохранения песни новые тэги получают страницы с шаблоном «Тэги», а авторы музыки, стихов и перевода — заготовки персоналий либо коллективов, если их названия отмечены в поле «Коллективы среди авторов». Создание страниц авторов может занять около минуты. Существующие страницы не перезаписываются; предпросмотр заготовки не создаёт.

== Загрузить текст по ссылке ==
Кнопка рядом с источником заполняет исходное окно текстом страницы. После проверки нажмите «Подготовить песню». Если в окне уже есть текст, замена потребует подтверждения. Ошибка загрузки сохраняет введённый текст.

Проверены примеры с vizbor.ru, vysotskiy-lit.ru, vberkovsky.ru, kolesnikov-pesni.ru и rebards.net. Для первых четырёх сайтов используются известные форматы: дополнительный запрос к ИИ при загрузке не нужен. У Высоцкого сохраняются закодированные строка и год; у Берковского исключается повтор в боковой колонке и сохраняются примечания. На Rebards и других страницах отдельный промпт ИИ выбирает строки, которые сервер копирует из источника дословно. Такие обращения входят в лимиты и оплачиваются как запросы к ИИ.

Сверяйте полноту текста, авторство, даты, строфы и примечания. Страницы за входом, CAPTCHA и произвольный JavaScript не поддерживаются; текст всегда можно вставить вручную. Сама загрузка страниц вики не создаёт.

== Возможности ==
* Название, альтернативные и оригинальные названия, авторы музыки/стихов, переводчики, год, жанры и тэги.
* Текст песни со строфами, эпиграф, дата/место после текста, аккорды и комментарии.
* Примечания: в тексте [1], в поле примечаний отдельная строка «1: Пояснение».
* Исполнение: отдельная строка «Исполнитель {{!}} https://ссылка {{!}} аудио или видео {{!}} комментарий».
* Автоматическая первая строка, сборка разметки и подсказки о похожих песнях.
* Предпросмотр оформляется вики. Сведения под текстом берутся из черновика; после сохранения работает обычный Подвал и Cargo.

== Правила и ограничения ==
Сохранены прежние правила промпта: базовые жанры АП и классическая АП для песен, предложения 7–9 тэгов, год из даты. Если указан один автор песни, возможно прежнее предположение об авторстве и слов, и музыки — оно показывается в предупреждениях. Авторов, даты и сохранность текста проверяет редактор. Правило первой строки 24/52 символа выполняется программно.

Модель возвращает поля, сервер собирает разметку. Чужая HTML/вики-разметка из исходника не исполняется. До 30 000 символов исходника и 2000 символов уточнений; по умолчанию 20 обращений на пользователя в час и 100 на сайт в сутки. Одновременно обрабатывается одна песня. API DeepSeek оплачивается владельцем сайта. Автоматического повторения платных запросов нет.

== Скачать ==
* [https://bard-wiki.net/downloads/extensions/BardAIFormatSong/BardAIFormatSong-0.5.5.zip ZIP]
* [https://bard-wiki.net/downloads/extensions/BardAIFormatSong/BardAIFormatSong-0.5.5.tar.gz TAR.GZ]
* [https://bard-wiki.net/downloads/extensions/BardAIFormatSong/SHA256SUMS SHA256SUMS]

<pre>
e97dafe153d7b5fcecf3e62f199609479fb287e379ecf545e048539e2213c96b  BardAIFormatSong-0.5.5.tar.gz
ee5a08e318189d44f20ab12a4a17afa4e62e071f1d9a8c4cdeedd13af92101bc  BardAIFormatSong-0.5.5.zip
</pre>

== Установка ==
MediaWiki 1.43, PHP 8.3, Cargo, шаблоны Бард-Вики Song, Performance, Подвал, примечания и расширение Poem. Поиск дублей рассчитан на локальную Cargo-таблицу song. Полная инструкция — README.md в архиве.
<syntaxhighlight lang="php">
wfLoadExtension( 'BardAIFormatSong' );
$wgBardAIFormatSongKeyFile = '/private/path/deepseek.key';
</syntaxhighlight>
Ключ хранится отдельно вне каталога сайта, не включается в архивы и не передаётся браузеру. Право bard-ai-song по умолчанию у зарегистрированных пользователей (user) и sysop. Анонимам доступ закрыт; заблокированным пользователям API недоступен. Изменения схемы БД не требуются.

[[Расширения Бард-Вики|Все расширения Бард-Вики]]

== Подсказки жанров ==
В поле «Жанры» начните вводить название: например, «т» предлагает «туристская». Подсказки берутся из разрешённого списка формы ИИ; регистр при поиске не важен. Выберите мышью или стрелками и Enter; Escape закрывает список. Несколько жанров разделяйте запятыми. Можно изменить отдельный жанр в середине строки, сохранив остальные. Уже выбранные жанры повторно не предлагаются. После изменения обновите предпросмотр и заново подтвердите создание. Подсказки не отправляют запросов в DeepSeek.

Версия 0.2.2 (2026-10-09): добавлены подсказки жанров.

== Варианты и стихотворение ==
В редакторе есть два дополнительных поля: «Варианты» и «Стихотворение». Вставляйте только текст: заголовки <nowiki>===Варианты===</nowiki> / <nowiki>===Стихотворение===</nowiki> и теги <nowiki><poem>...</poem></nowiki> формируются автоматически. Сохраняются переносы строк, пустые строки между строфами и начальные пробелы. Пустые поля не создают разделов. Они располагаются после аккордов (если есть), перед комментариями. Первая строка для поиска берётся из основного текста песни.

ИИ выделяет варианты и отдельное стихотворение только из предоставленного исходника; отсутствующий материал не придумывает. Если сам исходник является одним стихотворением, его основной текст остаётся в поле «Текст песни», чтобы не дублировать его в дополнительном разделе. Все поля можно исправить перед предпросмотром и созданием.

Версия 0.2.3 (2026-10-09): два дополнительных поля с отдельными блоками Poem.

== Коллективы среди авторов ==
Если автором музыки, стихов или перевода является дуэт, ансамбль или другой коллектив, укажите его название в соответствующем поле авторства. Повторите это название в поле '''Коллективы среди авторов'''. Несколько названий разделяются запятыми; они должны совпадать с названиями в полях авторства.

Для существующего коллектива используется его страница. Для нового после сохранения песни автоматически создаётся заготовка по форме Collective, а не персоналия. Исполнитель не становится автором только потому, что исполняет песню. Предпросмотр страниц не создаёт.

Версия 0.3.2 (2026-10-15): поле <code>collectiveAuthors</code> в JSON и <code>CollectiveAuthors</code> в шаблоне Song. Для создания заготовок требуется [[Коллективы/Документация|wiki-компонент коллективов]]. Права, квоты и подтверждение создания не изменены.

== Добавить теги к существующей песне с ИИ ==
На странице песни в правой панели '''Инструменты → Действия''' выберите '''Добавить теги с ИИ'''. В узком окне панель может быть свёрнута в меню инструментов. Команда доступна вошедшим участникам с правом редактирования песни.

# Нажмите «Подобрать теги». ИИ прочитает основной текст песни и предложит тематические теги с короткими пояснениями.
# Посмотрите список предложенных тегов. Возможные новые теги помечены «Новый тег»; предпочтение отдаётся существующим.
# На вопрос «Сохраняем новые?» нажмите «Да, сохранить» либо «Нет». Дополнительных галочек и подтверждений нет.

После сохранения откроется песня. Уже имевшиеся теги остаются; текст, авторы, жанры и остальные поля не меняются. Если страницу успел изменить другой участник, инструмент попросит открыть её заново. Подбор сам по себе ничего не сохраняет. ИИ может ошибаться — проверяйте, действительно ли тема важна для песни.

Используются те же ключ и общие лимиты DeepSeek, что при создании песни. Сервис получает основной текст песни и краткий список существующих тегов; поиск похожих названий не гарантирует отсутствия смысловых синонимов. Сложную нестандартную разметку безопаснее править вручную. Подробности и ограничения описаны в README архива версии 0.3.2.

== Единственное число в тегах ==
С версии 0.3.3 ИИ предпочитает существительные в единственном числе: «Кони» → «Конь», «Яблоки» → «Яблоко». Смысловые исключения сохраняются: «Дети», «Старики» (о группе или поколении), слова без обычного единственного числа и устойчивые названия. Правило действует и при создании песни, и при подборе тегов. Новые формы требуют обычного подтверждения; старые теги автоматически не меняются. ИИ может ошибаться — предложения нужно просматривать.

== Импорт — общие проекты администраторов ==
С версии 0.4.0 в меню администраторов есть [[Служебная:Импорт_песен|Импорт]]. Можно вести несколько общих проектов, пополнять очереди и работать с разными песнями одновременно.
# Создайте проект с названием и общими указаниями для ИИ.
# Добавьте ссылки (по одной на строку) или сохраните общий текст нескольких песен.
# Для общего текста откройте разбиение и нажмите «Предложить разбиение с ИИ». Проверьте границы, названия и общие сведения. Текст не переписывается: сохраняются исходные строки. Неясные фрагменты остаются в партии. После проверки добавьте песни в очередь.
# Откройте задание. Для ссылки загрузите текст источника обычной кнопкой; затем подготовьте песню, проверьте поля и предпросмотр.
# Подтвердите результат и нажмите «Создать и перейти к следующей». Можно отложить песню или сохранить и освободить задание.
В режиме импорта черновики сохраняются на сервере после правок. Задание закреплено за открывшим его окном; после 30 минут без сохранения закрепление истекает. При сетевой ошибке последние несохранённые изменения могут остаться только во вкладке. Уже существующие страницы не перезаписываются.

<b>Закрытие проекта</b> удаляет необработанные задания, черновики и исходные партии после подтверждения. Созданные страницы остаются; сохраняются название, даты и ссылки на них. Сначала нужно освободить активные задания.

До 1000 заданий в проекте; одна текстовая партия — до 100 000 символов и 3000 строк. Разбиение расходует обычную квоту ИИ. Автоматической массовой публикации нет. Установка, частное хранилище и ограничения описаны в README архива расширения.

== Общие сведения в уже работающем проекте импорта ==
В версии 0.4.1 у добавленной текстовой партии нажмите «Исходник и общие сведения». Исправьте или очистите поле «Общие сведения партии» и нажмите «Сохранить общие сведения».

Это сведения, которые ИИ при разбиении отнёс ко всему сборнику: они добавляются перед текстом каждой песни. Их изменение обновит ещё не начатые задания этой партии. Открытые задания, любые сохранённые черновики и созданные страницы не изменятся. Исходный сборник и сами тексты песен сохраняются. Сохранение не вызывает ИИ и ничего не публикует.

Отдельные общие указания ИИ (например, автор или желательные теги) меняются в блоке «Изменить название и общие указания проекта». Если сведения уже попали в начатый черновик, поправьте его отдельно в редакторе.

== Колонки основного текста песни ==
Рядом с заголовком «Текст песни» есть галочка "В одну колонку". При новой подготовке песни она включается автоматически, если в тексте меньше 16 непустых строк. Пустые промежутки между строфами не считаются. При 16 строках и больше галочка по умолчанию снята.

С галочкой основной текст получает <code>&lt;poem c=1&gt;</code>, без неё — обычный <code>&lt;poem&gt;</code>. Галочку можно включить или снять вручную; после этого правка текста не сбрасывает выбор. После правок обновите предпросмотр. Выбор сохраняется и в черновике очереди импорта. Аккорды, варианты и отдельное стихотворение эта настройка не меняет. Ранее созданные страницы не изменяются.

== Текст песни при подборе тегов ==
На странице подбора тегов виден основной текст песни с сохранением строф. На широком экране текст и предложения расположены рядом, на узком — друг под другом. Текст остаётся виден после подбора тегов.

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

== Длинные черновики импорта ==
Черновик проекта сохраняется объёмом до 1 МБ (1 048 576 байт) в UTF-8, без искусственного увеличения размера русских букв. Исходник, подготовленный текст и дополнительные разделы сохраняются полностью. Ограничение исходника в 30 000 символов остаётся прежним. При ошибке сохранения не закрывайте окно: текст можно скопировать отдельно и повторить сохранение.

== Инструкция по импорту песен ==
Для редакторов подготовлена подробная [[Справка/Импорт песен|инструкция по импорту песен]]. Ссылка на неё есть над списком проектов и внутри каждого проекта. Старое описание импорта XML сохранено отдельно.

== 0.4.8 — Названия на кириллице ==
Исправлено повреждение последней буквы при удалении многоточия из названия песни (например, «вечер»). Названия обрабатываются по символам Unicode; проверка допустимости названий MediaWiki сохранена. Существующие песни и задания импорта не изменяются.

== Исправить заголовок страницы ==
Если название песни в карточке исправлено, а название самой страницы осталось прежним:
# Сохраните изменения песни.
# В меню «Инструменты» страницы выберите '''«Исправить заголовок страницы»'''.
# Проверьте предложенное название — оно составляется из названия песни и её авторов.
# Подтвердите штатное переименование MediaWiki. Галочка '''«Оставить перенаправление»''' уже снята.

Команда доступна участникам с правами переименования без перенаправления (сейчас администраторам). ИИ для неё не требуется. История страницы сохраняется, текст песни не изменяется. Если название уже правильное или предложенная страница существует, команда сообщит об этом и ничего не заменит.

'''Учтите:''' без перенаправления ссылки на старое название могут перестать работать. Проверьте «Ссылки сюда»; автоматическая правка других страниц не выполняется. При сложной разметке в заголовочных полях используйте обычное переименование.

== Открыть источник ==
Кнопка «Перейти на страницу источника» рядом с загрузкой текста открывает адрес из поля источника в новой вкладке. Можно сверить оригинал, не закрывая редактор. Текст и черновик остаются без изменений. Поддерживаются ссылки http:// и https://.

== Списки в комментариях ==
В комментариях, эпиграфе и подписи после текста песни можно использовать маркированные списки: ставьте <code>*</code> в начале строки. Для вложенного пункта используйте <code>**</code>. После изменения полей обновите предпросмотр.

В стихах и аккордах звёздочки остаются обычными символами. Остальная служебная разметка по-прежнему экранируется. Уже созданные страницы автоматически не меняются.

== Общие комментарии на wysotsky.com ==
При загрузке текста поддерживаются как ссылки <code>1049.ru/номер.htm</code>, так и <code>1049.htm?номер</code>. Из соседней колонки с пояснениями загружаются общие абзацы '''перед нумерованным списком'''. При подготовке песни они попадают в поле «Комментарии» и затем в раздел «Комментарии» в конце страницы.

Нумерованные пояснения к отдельным словам и «См. также» в этот общий блок не переносятся. Если страницу комментария прочитать не удалось, появится предупреждение. Проверьте результат перед созданием песни. Ранее загруженные исходники и готовые страницы автоматически не дополняются.

Отдельные общие комментарии с wysotsky.com загружаются отдельными строками с <code>*</code>. При подготовке песни ИИ должен сохранить маркеры и границы пунктов в поле «Комментарии»; в предпросмотре они отображаются маркированным списком.

В поле «Фильм/спектакль» DeepSeek использует обозначения <code>к/ф</code> (кинофильм), <code>х/ф</code> (художественный фильм), <code>т/ф</code> (телефильм, телевизионный фильм) и <code>спектакль</code>. Например: <code>к/ф «Ветер надежды» (1977)</code>. Тип и год берутся из источника.

При создании песни и отдельном подборе тегов ИИ не должен предлагать фамилии и имена авторов самой песни: авторство уже указано в карточке. Существующие теги автоматически не удаляются.

Лимит загрузки текста по ссылке: до '''60 попыток в час на пользователя'''. Это отдельная квота, не лимит подготовки песни с ИИ.

Если источник указывает, что песня написана для фильма, ИИ добавляет жанр «Песня для фильма»; для пьесы или спектакля — «Песня для спектакля». Другие подходящие жанры сохраняются. Это учитывается и для песен, которые в итоге не вошли в фильм или постановку.

Для аудиоспектакля поле «Фильм/спектакль» сохраняет обозначение <code>аудиоспектакль «Название» (год)</code>. Год указывается, только если он есть в источнике.

== Расположение полей и подбор тегов (0.4.20) ==
В форме проверки результата поля расположены так: «Жанры — Фильм, спектакль», затем «Тэги» отдельным многострочным полем на всю ширину, затем «Год написания — Коллективы среди авторов». На телефоне поля идут одной колонкой.

При подготовке песни и отдельном подборе тегов ИИ не должен предлагать прилагательные как самостоятельные теги, кроме слов, употреблённых в качестве существительных. Для песни или стихотворения короче 9 непустых стихотворных строк достаточно до пяти содержательных тегов; пустые строки, заголовок, подписи и комментарии не считаются. Прежние правила единственного числа и запрета повторять авторов сохраняются. Предложения ИИ нужно проверять; ранее сохранённые теги автоматически не меняются.

С версии 0.4.21 форма компактнее: уменьшены отступы и начальная высота вспомогательных полей. Основные окна исходника и текста песни сохранены; любое многострочное поле можно растянуть за нижний угол. Порядок полей и теги на всю ширину не изменились.

С версии 0.4.22 количество тегов при создании песни проверяется по основному тексту: до 8 непустых строк — до 5 тегов, от 9 строк — 7–9. Учитываются все строфы. Если ИИ вернул другое количество, выполняется один повторный подбор только тегов; текст и другие поля сохраняются. При неудаче показано предупреждение, результат не теряется. Ручные правки и уже сохранённые песни автоматически не меняются.

С версии 0.4.23 при загрузке с wysotsky.com сохраняется ступенчатая сдвижка строк: уровни отступа источника преобразуются в 4, 8, 12 и 16 пробелов. Они сохраняются при подготовке текста ИИ. Старые черновики и страницы автоматически не изменяются; для них нужно повторно загрузить источник.

С версии 0.4.24 [[Справка/Импорт песен|импорт сборников]] принимает до 20 000 строк и 1 000 000 символов. Тексты длиннее 3000 строк редактор сначала вручную делит на части до 3000 строк, с просмотром текста вокруг границы. Затем каждая часть отдельно разбивается ИИ на песни. Исходник сохраняется целиком; пропуски, пересечения и повторное деление блокируются. До подтверждения ручных границ обращений к ИИ нет.

С версии 0.4.25 после подготовки ИИ начальные отступы текста песни восстанавливаются по дословно совпадающим строкам исходника. Учитывается порядок повторяющихся строк; при неоднозначности показано предупреждение, отступ не угадывается. Аккорды и остальные поля этим восстановлением не меняются. Для уже подготовленного результата нужно повторить подготовку из исходника; ручные правки предварительно сохраните отдельно.

С версии 0.4.26 над текстом песни есть редактируемое поле «Первая строка». Оно заполняется автоматически, ручное значение сохраняется в FirstString и в черновиках импорта. Очистка поля возвращает автоматический расчёт при обновлении предпросмотра.

С версии 0.4.27 импорт песен доступен группам «Авторы», «Кураторы» и «Импортёры», а также администраторам. Все они получают право bard-song-import и видят общие проекты импорта. Обычные зарегистрированные пользователи без этих групп доступа не получают.

== Дополнение персон и коллективов из Википедии (0.5.0) ==
[[Справка/Заполнение из Википедии с ИИ|Подробная инструкция]]. Команда «Дополнить из Википедии с ИИ» на существующей странице Persona/Collective. Право bard-ai-profile выдано только sysop. Загружает текст статьи через официальный API Википедии и готовит дополнение с DeepSeek.

Приоритет — сведения об авторской песне; остальная биография из источника излагается короче. Старые сведения не удаляются, заполненные поля заменяются только вручную. Фотографии не переносятся. Обязательные источник, версия статьи, атрибуция и CC BY-SA 4.0 добавляются сервером.

Предпросмотр и сравнение обязательны перед сохранением. POST/CSRF, проверка прав и блокировки, nocreate/baserevid, защита от конфликтов; срок черновика 2 часа. Только HTTPS Wikipedia, без HTTP-переадресаций, предел текста статьи 80 000 символов. Ключ и квоты подготовки общие с песнями. Отдельные страницы не создаются, название страницы не меняется. Состав коллектива дополняется без повторов с учётом перенаправлений; даты коллективов не добавляются в календарь персон.

== Исходный текст для персон и коллективов (0.5.1) ==
Команда теперь называется «Дополнить страницу с ИИ»; старый адрес работает. Вставленный текст (40–80 000 символов) имеет приоритет над загрузкой Википедии. Ссылка необязательна и используется только как атрибуция, без сетевого запроса. Если текст не вставлен, загружается статья Википедии по прежним правилам.

Для произвольного текста не приписываются Википедия, авторы или лицензия CC BY-SA. Сохраняются прежние источники и содержимое страницы. Нужны те же права администратора и проверка перед сохранением. [[Справка/Заполнение из Википедии с ИИ|Обновлённая инструкция]].

== Варианты в одну колонку (0.5.2) ==
В создании песни с ИИ раздел «Варианты» всегда оформляется тегом <code>&lt;poem c=1&gt;</code>, независимо от длины вариантов и настройки основного текста. Это правило действует при предпросмотре и сборке страницы, включая восстановленные черновики. Пустой раздел не добавляется.

== Несколько фильмов и спектаклей (0.5.5) ==
В инструкциях для ИИ явно указано: несколько произведений в поле «Фильм, спектакль» разделяются точкой с запятой (<code>;</code>). Запятые внутри названия, например «Будь здоров, школяр!», сохраняются. Неоднозначные перечисления требуют проверки редактором. Существующие песни автоматически не изменяются.

== Переработка и диалог с ИИ ==
Выбор: «Дополнить существующий текст» или «Переработать существующий текст». Во втором режиме основной повествовательный текст заменяется после проверки; карточка, состав/связанные песни и источники сохраняются. Сложные встроенные шаблоны и сноски в заменяемом тексте дают отказ вместо потери данных.

Поле «Что изменить в предложении ИИ» и кнопка «Доработать с ИИ»: модель получает текущий черновик с ручными правками, исходник и историю замечаний. До 10 уточнений, хранение 2 часа; новый ответ требует повторного просмотра. Источник показан ссылкой и числом загруженных знаков. Права не расширены.

== Поиск в Википедии ==
При поиске источников обязательно выполняется отдельный запрос к русской Википедии, независимо от результатов общего поиска. До четырёх найденных статей Википедии показываются первыми, затем — результаты общего поиска без повторов. Отсутствие результатов и недоступность Википедии обозначаются явно. Источник по-прежнему выбирает редактор.