Files
SHiNE-server/docs/SHINE_TEXT_LINKS.md
T

4.0 KiB

Ссылки в тексте сообщений SHiNE (UI)

Состояние: 10.10.2026. Изменений формата блокчейна и серверного API нет.

Поддерживаемые текстовые ссылки

  • SHiNE/aidar/news/34 — ссылка на публикацию №34. В ленте открывает /SHiNE/aidar/news/s/34; при просмотре отдельной публикации, комментариев или личного чата — /SHiNE/aidar/news/34.
  • SHiNE/aidar/news/s/34 — явно открывает ленту и прокручивает к публикации №34 независимо от исходного экрана.
  • SHiNE/aidar/news — канал, SHiNE/aidar — профиль.
  • Допускается ведущий /; используется текущий origin браузера, без привязки к конкретному серверу доступа.
  • http://, https:// и www. — внешние ссылки, открываются в новой вкладке с rel="noopener noreferrer".
  • Все ссылки могут находиться в обычном тексте публикаций, их обсуждений и личных сообщений. Текст передаётся и сохраняется без преобразований; ссылки становятся кликабельными исключительно при отображении.

Техническое поведение

Обработчик shine-UI/js/services/shine-message-links.js безопасно создаёт DOM-ссылки через textContent, не вставляет пользовательский текст как HTML. Для внутренних переходов используется существующий navigate(); стандартный href позволяет копировать ссылку и открывать её в новой вкладке. Просмотр из контекста ленты передаётся опцией viewMode: 'feed' (без глобального переключателя режима). Вход из чата или извне без контекста по умолчанию открывает отдельную публикацию.

Порядковые номера определяются уже существующим channel-message-ordinals.js. Этот патч не пересчитывает и не меняет правила нумерации. Стабильность номера при позднем импорте/форке требует отдельной проверки.

В этой UI-реализации пока не введена строгая проверка времени создания целевой публикации по отношению к конкретной редакции сообщения. Проверка при записи (в том числе для сторонних клиентов), форки и варианты встроенных сокращённых ссылок отложены; их нельзя считать обеспеченными клиентским преобразованием текста. Редактирование старой публикации и добавление ссылки на уже существующую новую публикацию не блокируется UI.

Тестирование

Из корня проекта:

node --test shine-UI/tests/shine-message-links.test.mjs

Проверяются маршруты, режим ленты, принудительный /s/N, внешние URL, текстовая безопасность и взаимодействие с текущим роутером. Для выпуска дополнительно требуется ручная проверка навигации в браузере из трёх экранов: лента, отдельная запись, личный чат.