Библиотека платформы: как завести книгу, показать её и сослаться на неё

Одна книга — одна запись на всех. Она же стоит у вас на полке, она же цитируется в базе знаний, она же собирает отзывы. Это не три разных объекта с похожими названиями, а один объект в трёх ролях, и от этого зависит почти всё, что описано ниже.

Роли три, и они не пересекаются:

---

Участник

Завести книги на полку

Полка наполняется снимком, а не формой ввода. Сфотографируйте обложку или корешки телефоном и отправьте снимок своему боту — тому же, куда вы кидаете мысли и ссылки.

Дальше снимок разбирает агент: он читает, что на кадре, и заводит книги. Разбор — отдельное действие, а не мгновенный автомат: карточка в инбоксе сначала говорит «разбор содержимого — позже», и это нормальный ход, а не сбой.

Формы «добавить книгу руками» намеренно нет. Ключ книги считается из автора и названия один раз и больше не пересчитывается — если бы ту же книгу заводили и снимком, и руками, два написания разошлись бы в две записи.

Проверить: откройте Полка в кабинете. Книги на месте, у каждой снят переключатель «публично».

Показать книгу миру

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

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

Снять публичность можно тем же переключателем в любой момент.

Написать отзыв

Откройте карточку книги — по ссылке с полки или из списка литературы в чужой базе. Под библиографией есть поле «Что вам дала эта книга» и кнопка «Оставить отзыв». Отзыв может оставить любой участник платформы, не только владелец книги: карточка общая, как и сама книга.

Второго отзыва на ту же книгу у вас не будет. «Ещё мысль» — это правка прежнего текста, а не второй отзыв: иначе лента о книге превратилась бы в переписку автора с самим собой. Правленый отзыв помечен словом изменён — единственный вопрос читателя об отзыве звучит как «это тот же текст, что я читал?», и на него страница отвечает.

Свой отзыв можно скрыть. Скрытие — не удаление: текст остаётся, сужается видимость; скрытый помечен словом скрыт для тех, кому он всё ещё виден. Кнопки на карточке для этого пока нет — скрытие делается через агента.

---

Автор базы знаний

Сослаться на книгу из узла

Ссылка на книгу пишется в теле узла — там же, где текст, а не в отдельной карточке:

## Литература

- [[src:taleb--antihrupkost|Талеб. Антихрупкость]]

Три вещи, которые важно не перепутать:

1. Префикс src: обязателен. Без него запись читается как ссылка на другой узел базы — и у читателя получается битая связь.
2. Ключ книги (taleb--antihrupkost) виден в адресе её карточки: /sources/<ключ>. Его не придумывают, его копируют.
3. Подпись после | — «Автор. Название». Она не украшение: платформа проверяет, что из этой подписи получается тот самый ключ. Не совпало — строка уходит в предупреждения прогона, а не заводит в общей таблице третью «книгу» из-за опечатки.

На экране читатель увидит обычную ссылку «Талеб. Антихрупкость» — служебный префикс не показывается.

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

Объяснить, зачем эта книга здесь

К паре «узел + книга» можно привязать заметку о роли: одна-две фразы о том, чем именно эта книга полезна в этом узле. Заметка — не отзыв.

Формы на экране узла для неё пока нет: заметка ставится через агента. Список литературы при этом виден читателю сразу — он рисуется из самого текста узла.

Разница не косметическая, и она видна в том, что с ними происходит дальше:

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

Пересборка списка

Список литературы узла собирается из его тела целиком при каждом импорте. Убрали строку из текста — ссылка исчезает из индекса. Индекс не копит того, чего в тексте уже нет.

---

Библиотекарь

Откуда берутся дубли

Ключ книги — это фамилии авторов плюс основной заголовок. Поэтому «Нассим Талеб. Антихрупкость» и «Талеб. Антихрупкость» дают одну запись: лишнее имя ключ отбрасывает сам.

Дубль появляется там, где ключи честно расходятся:

• у одной записи указан соавтор, у другой нет;
• «Фамилия, Имя» против «Имя Фамилия»;
• лишнее имя в списке авторов.

Двое записали книгу по-разному, и оба правы — склеить это автоматически нельзя, потому что решение о том, что это одна книга, принимает человек.

Свести дубль

Экран Дубли книг в кабинете показывает пары, похожие на одну книгу: совпал заголовок, и есть общая фамилия. Разные авторы одного заголовка в пару не попадают — «Стратегия» трёх разных авторов не сольётся.

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

Слияние необратимо. Кнопки «разделить обратно» нет — и это решение, а не недоделка. Что происходит при слиянии:

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

Кто может сводить дубли

Это способность, а не должность: она выдаётся отдельно и не входит ни в одну роль. Пока её не выдали, пункта «Дубли книг» в кабинете просто нет — и это правильнее, чем показывать всем вход, который ответит отказом.

---

Чего в библиотеке пока нет

Названо прямо, чтобы не искать:

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