https://fedtail.dmesg.online/ru/tags/internals/Recent content in Internals on fedtailHugoru-RUhttps://fedtail.dmesg.online/ru/docs/architecture/Mon, 01 Jan 0001 00:00:00 +0000https://fedtail.dmesg.online/ru/docs/architecture/<p>fedtail спроектирован для тех, кто помнит Juick и Point.im и устал от хаотичной ленты с обрывками чужих разговоров в современных микроблогах.</p> <h2 id="ключевые-архитектурные-принципы">Ключевые архитектурные принципы</h2> <ol> <li><strong>Ничего не дёргается.</strong> Открыл ленту — стоишь на первом непрочитанном. Пришло новое — позиция не меняется, просто растёт счётчик. Читаешь строго по хронологии, как RSS.</li> <li><strong>Каждый ответ знает, на что он отвечает.</strong> Над ответом — полоска с началом исходного поста, клик открывает весь тред деревом.</li> <li><strong>Ленты строго разделены.</strong> Люди отдельно, боты отдельно, ответы мне отдельно от прочих упоминаний.</li> <li><strong>Приватно по умолчанию.</strong> Новый пост — только подписчикам. Ответ никогда не может быть публичнее исходного.</li> <li><strong>Любое поведение — ключ в конфиге.</strong> Окна настроек нет и не будет. По умолчанию поведение настроено продуманно; привычный режим «как у всех» включается простым флагом.</li> <li><strong>К чужим серверам — без вашего токена.</strong> Всё, что fedtail подтягивает с сервера автора напрямую по ActivityPub, запрашивается анонимно: удаленный сервер видит только IP-адрес.</li> <li><strong>Ядро не зависит от GUI.</strong> Интерфейсы — подключаемые плагины: классическое окно на Qt, терминальный TUI, браузерный веб-интерфейс.</li> <li><strong>Один профиль — один аккаунт.</strong> Второй аккаунт — второй профиль (<code>--profile</code>); при необходимости несколько профилей объединяются в одном окне (<code>ui.merge</code>).</li> <li><strong>Взрослые разбираются сами (режим arts).</strong> Режим в честь @arts, создателя Point.im: контент отображается без навязчивой внешней опеки.</li> </ol> <hr> <h2 id="устройство-ядра-и-компонентов">Устройство ядра и компонентов</h2> <ul> <li><strong>Ядро (<code>fedtail/core</code>)</strong>: полностью изолировано от графического интерфейса. Общается с фронтендами асинхронно через события (events) и futures.</li> <li><strong>Хранилище данных</strong>: локальная реляционная база данных SQLite (<code>~/.local/share/fedtail/&lt;профиль&gt;/</code>). В ней хранятся закэшированные посты, связи тредов, состояние прочитанности и подписки на треды.</li> <li><strong>Цикл опроса (Polling)</strong>: периодический сбор обновлений с инстанса по Mastodon API с защитой от дубликатов и сохранением курсоров.</li> <li><strong>Сборка тредов (Thread Reassembly)</strong>: если в треде отсутствуют промежуточные комментарии (потому что ваш домашний сервер их не зафедерировал), fedtail анонимно запрашивает недостающие ActivityPub-объекты непосредственно у сервера автора.</li> <li><strong>Фронтенды (<code>fedtail/frontends</code>)</strong>: <ul> <li><code>qt</code> — основной десктопный интерфейс на PySide6 (Qt).</li> <li><code>tui</code> — легковесный текстовый консольный интерфейс.</li> <li><code>web</code> — локальный HTTP-сервер со встроенным веб-интерфейсом.</li> <li><code>cli</code> — утилиты командной строки (<code>fedtail lanes</code>, <code>fedtail show</code>, <code>fedtail tail</code>, <code>fedtail post</code>).</li> </ul> </li> </ul>