y83 code / справочник

Настройки главной

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

раздел
Подсистемы приложения
пунктов возможностей
22
источник
docs/about/home-settings.md

Здесь две вещи: видимость и порядок плиток главной плюс список видимых агентов. Всё применяется сразу, кнопки «сохранить» нет.

Возможности

  • Раздел 01 / БЫСТРЫЙ ДОСТУП — список плиток главной. У каждой строки значок, название, короткое описание, две стрелки и переключатель.
  • Переключатель у плитки — включает или убирает её с главной.
  • Две стрелки у плитки — поднимают строку выше или опускают ниже. На крайних позициях соответствующая стрелка гаснет и не нажимается.
  • Счётчик у заголовка — сколько плиток включено сейчас из всех, например «8/27». Так сразу видно, сколько всего доступно.
  • «Показать все» и «Скрыть все» — включают или выключают все плитки разом. Это не кнопки-картошки, а тихие надписи-ссылки справа под описанием раздела, и «Скрыть все» нарочно сделана блёклой, чтобы её не нажать случайно.
  • Раздел 02 / АГЕНТЫ — список агентов главной: Codex, OpenCode и «Удалённые агенты». У каждого тоже переключатель, но стрелок нет: агентов нельзя менять местами.
  • Счётчик у второго заголовка — сколько агентов видно из всех.
  • Свои «Показать все» и «Скрыть все» для агентов, независимые от плиток.
  • Кнопка «Сбросить порядок главной» внизу — с вопросом для подтверждения.
  • Кнопка «назад» в шапке возвращает на предыдущий экран.
  • Счётчики в шапке — те же цифры, что и у разделов, плюс бейдж: «по умолчанию», если настройки не трогали, и «свой порядок», если меняли.
  • Выключенная плитка гаснет целиком: значок сереет, название бледнеет, фон карточки становится темнее. Видно, что плитка убрана с главной, даже не глядя на переключатель.

Технические данные

ПараметрЗначение
Плиток в списке28
Агентов в списке3: два локальных и удалённые
Сейчас включено плиток8 из 28
Сейчас скрыто агентов0 из 3
Инструментов в хабе всего37, из них на главную выводятся 28
Порядок на главнойсетка по 4 плитки в ряд
Разделов на экране2, плюс кнопка сброса
Сетка плиток на главной4 колонки
Где хранитсянастройки телефона, не в базе данных
Ключ настройкиодин, называется home_dashboard_config
Формат хранениятекст в виде JSON со списком плиток и агентов
Хранится ли в конфиге названиенет, берётся из каталога инструментов
Работает без интернетада
Работает без бэкендада

Как читать экран

Шапка сверху показывает имя раздела y83@home, два счётчика и бейдж справа. Счётчик «тайлы 8/27» означает: включено 8 из 27 возможных. Счётчик «агенты 3/3» означает: видны все три агента.

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

Второй раздел — агенты. У них только значок, название, описание и переключатель. Стрелок нет, потому что порядок агентов фиксированный.

Самый нижний элемент — кнопка сброса. Она одна на весь экран.

Про две независимые настройки

Плитка на главной и инструмент в хабе — это разные вещи. Настройки живут независимо и не влияют друг на друга.

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

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

То же самое с агентами: агент, убранный с главной, никуда не девается — он по-прежнему доступен в хабе и в списке тредов.

Про перемещение

Способ переместить плитку ровно один: стрелки в её строке, по одной позиции за нажатие. Перетаскивания пальцем нет ни в каком виде — ни долгого нажатия, ни переноса строки за её середину.

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

Почему список нельзя сократить

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

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

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

Про то, что имена не хранятся

В сохранённых настройках лежит только код инструмента, признак «показывать» и номер позиции. Ни названий, ни описаний, ни значков там нет.

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

Поэтому руками в файле настроек ничего не испортить — там нет текста.

Про выключенный, но доступный инструмент

В списке плиток есть видеоредактор — он в приложении помечен как временно выключенный, и в хабе на него не нажать. Но переключатель у него на главной рабочий.

Это не ошибка, а разные настройки: «выключен для хаба» и «показывать на главной» не связаны. Если включить видеоредактор здесь, плитка появится на главной и откроет экран редактора. Сейчас он выключен.

Связанное с этим: в списке 28 плиток, а инструментов в хабе 37. Девять разницы — те, что на главную не выводятся в принципе, ни при каких настройках. Например, язык и настройки самой главной: они и не плитки, и настраиваются здесь же.

Про бейдж в шапке

Бейдж «по умолчанию» означает, что настройки совпадают с заводскими: все плитки на своих местах и включены, все агенты видны. Любое отличие — и появляется «свой порядок».

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

То же самое с лишними пропусками в нумерации: перед сравнением настройки приводятся к общему виду, поэтому дыры в нумерации изменением не считаются.

Про сброс

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

Сброс стирает всё, что вы настраивали в этом разделе. Отдельного сброса только порядка или только видимости нет — либо всё, либо ничего.

На настройки вне этого раздела сброс не влияет: язык, тема, VPN и остальное остаются как были.

Про исчезнувшие инструменты

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

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

Что агент умеет

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

Агент может прочитать сами настройки командой чтения настроек телефона: он видит ключ home_dashboard_config и весь список плиток с их видимостью и номерами. Это читаемый текст, его можно разобрать и показать вам.

Агент может и изменить настройки: команда нажатия на элемент экрана умеет переключать видимость плитки, двигать её стрелками и нажимать сброс. Но, как и на других экранах, это работает только когда приложение открыто и лежит на экране, а не в фоне.

Отдельного инструмента «переставить плитки» нет ни в мосте, ни среди инструментов агента. Обходных путей тут нет — только нажатия на экран.

Ограничения

  • Перетаскивать плитки пальцем нельзя, только стрелками по одной позиции.
  • У агентов нет стрелок: их порядок изменить нельзя.
  • Строку из списка удалить нельзя, можно только выключить переключателем.
  • Размер списка изменить нельзя: он ровно такой, сколько инструментов приложение разрешает вывести на главную. Сейчас это 28 из 37.
  • Видеоредактор помечен в приложении как выключенный, но его переключатель здесь рабочий: включите — плитка появится на главной.
  • Сброс необратим и стирает всё сразу — порядок, видимость и агентов.
  • Сброс затрагивает только главную: язык, тема, VPN и прочее не меняются.
  • Новый инструмент из обновления появится на главной сам, без спроса.
  • Весь этот экран переведён на оба языка, включая подписи переключателей для озвучки. Английские надписи остались только на главном экране: Home settings в меню и Configure dashboard у значка шестерёнки.
  • Описание плитки обрезается двумя строками с многоточием, если текст не помещается. Название не обрезается — оно и так короткое.

Источник: docs/about/home-settings.md. Страница собрана из документации проекта при сборке сайта — без пересказа.

Настройки главной Вернуться к справочнику