Перейти к содержанию

Как дополнять вики

Вики проекта Yandex Station Extended полностью открыта для сообщества. Если вы исследовали свою колонку, сняли дампы или написали полезный скрипт — вы можете легко добавить свой материал.

Самый простой способ — в браузере

На сайте настроена прямая интеграция с GitHub:

  1. Откройте любую статью на сайте hackalice.me.
  2. Вверху справа (под заголовком) нажмите иконку ✏️ (карандаш) — «Редактировать страницу».
  3. Вас перенаправит в веб-редактор GitHub прямо к нужному .md-файлу.
  4. Внесите изменения или дополнения.
  5. Внизу страницы нажмите «Propose changes» (Создать Pull Request).
  6. Мы проверим правки, нажмём Merge, и сайт обновится автоматически через GitHub Actions (обычно за минуту).

Куда добавлять материалы

Тип материала Куда
Получение и закрепление доступа, восстановление docs/start/
Готовый рецепт («как сделать X») docs/recipes/ + строка в docs/recipes/index.md
Железо конкретной модели docs/devices/<модель>.md
Новая модель новый файл в docs/devices/ + пункт в nav в mkdocs.yml
Как устроена прошивка, сеть, сборка софта docs/internals/
Скрипты и бинарники contrib/

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

Золотое правило: Общее для всех Станций на Amlogic — в «Как это устроено», специфика корпуса и платы — в «Устройства».

Минимальный набор данных для новой модели

Если у вас на руках модель, которой ещё нет в матрице (например, Станция Мини 3, Станция Дуо Макс, Станция Про):

Подключитесь по adb shell и снимите диагностику одной командой:

echo "=== MODEL & KERNEL ==="
cat /proc/device-tree/model
uname -a
echo "=== CPU ==="
cat /proc/cpuinfo | grep -E 'processor|part|Hardware|model name'
echo "=== MEMORY & STORAGE ==="
cat /proc/meminfo | head -2
cat /proc/mtd
df -h
echo "=== I2C & PERIPHERY ==="
ls /sys/bus/i2c/devices/
ls /sys/class/leds/
cat /proc/asound/cards
echo "=== QUASAR VERSION ==="
cat /system/vendor/quasar/VERSION 2>/dev/null

Откройте Issue в репозитории или создайте Pull Request — мы оформим эти данные в красивую страницу устройства!

Что нельзя публиковать

В целях безопасности и приватности авторов в статьях запрещено указывать: * Приватные ключи устройства (/data/quasar/devices.json: server_private_key, secret); * Реальные MAC-адреса, серийные номера и персональные device-id; * OAuth-токены аккаунтов Яндекса; * Пароли, Wi-Fi SSID и домашние координаты.

(Заменяйте серийники и токены на <DEVICE_ID> / <REDACTED>).

Локальный запуск

Если вы хотите клонировать репозиторий и просматривать правки локально:

git clone https://github.com/Marker284/yandex-station-extended.git
cd yandex-station-extended
python3 -m venv venv
./venv/bin/pip install -r requirements.txt
./venv/bin/mkdocs serve
Сайт с live-reload откроется на http://127.0.0.1:8000.

Все, чьи правки и данные вошли в вики, перечислены на странице Участники.