Что это
Это справочник для человека из России, который впервые едет в Китай и не знает языка. Он не про визы и не про маршруты. Он на тот случай, когда что-то пошло не так: потеряли телефон или документы, стало плохо, не получается заплатить, непонятна надпись в меню.
Внутри 137 записей в 16 разделах. Самый большой раздел, экстренная помощь, содержит 40 записей, раздел о том, что нельзя по закону, содержит 13, в остальных четырнадцати разделах по шесть записей. Среди тем: Alipay и WeChat Pay, SIM и eSIM, отели и регистрация, таможня, еда и аллергии, розетки, деньги и комиссии, связь с Россией, безвизовый режим, консульская защита. Кроме записей есть разговорник из 43 фраз с китайским текстом, произношением латиницей и озвучкой.
Цифры я пересчитал по файлам с данными. В описании проекта встречаются другие числа, например 84 записи. С данными они не сходятся, верить надо файлам.
Зачем это нужно
В Китае заблокированы Telegram, Google, YouTube, Instagram и WhatsApp, так что обычный сайт может просто не открыться. Поэтому справочник сделан так, чтобы после первой загрузки ему не нужен был интернет.
Что значит «работает офлайн». Когда вы открываете справочник в браузере с интернетом, телефон один раз скачивает в свою память все тексты, шрифты, озвучку фраз и данные метро. Дальше приложение берёт всё из памяти телефона, а не из сети. Поэтому его можно открыть в самолёте, в метро или в стране с блокировками. Скачать нужно до поездки, пока сайт открывается.
Что значит «установить как приложение». Это не магазин приложений. Вы открываете сайт в браузере телефона и просите добавить его на главный экран: в Safari на айфоне это «Поделиться» и «На экран Домой», в Chrome на Android это меню и «Установить приложение». Появляется значок, и справочник открывается на весь экран, как обычная программа. Обычные приложения весят десятки и сотни мегабайт, а здесь около мегабайта, и не нужен ни App Store, ни Google Play, которые в Китае тоже работают плохо.
Как устроено
Справочник написан на обычном JavaScript без готовых фреймворков, собирается через Vite. Он состоит из нескольких экранов: список разделов, поиск, кнопки SOS, калькулятор юаней, разговорник и метро. Внизу переключатель между ними, а на экране есть индикатор «онлайн» или «офлайн».
Тексты лежат в отдельных файлах по одному на раздел. Каждая запись устроена одинаково: заголовок, объяснение простыми словами, обоснование, ссылки на источники, примечание и дата проверки. У записи есть метка уровня доказательности A, B или C и пометка, как она появилась: переведено, адаптировано или написано заново.
Шрифт лежит внутри приложения. Никаких внешних библиотек и Google Fonts я не подключал: из Китая они недоступны.
Озвучка фраз сделана программой синтеза речи: на каждую из 43 фраз приходится один звуковой файл, всего около 350 килобайт.
Метро Пекина загружается лениво, только когда вы открываете вкладку. В данных 28 линий, 425 станций, 514 перегонов и 104 станции с пересадками. Маршрут считается на телефоне алгоритмом поиска кратчайшего пути: время оценивается по средней скорости поезда 34 км/ч плюс 4 минуты на каждую пересадку, у обоих аэроэкспрессов и линии S1 скорости свои. Цена считается по расстоянию по ступенчатому тарифу, для аэроэкспрессов отдельно.
Что уже работает
- Список из 16 разделов, у каждой записи видны источники, уровень доказательности и дата проверки.
- Поиск по всем записям, работает без сети.
- Экран SOS: нажатие на номер сразу запускает звонок. Там номера 120, 110 и 119 и телефоны посольства и консульств России.
- Разговорник: 43 фразы, любую фразу можно раскрыть на весь экран, чтобы показать телефон собеседнику, и включить звук.
- Калькулятор юаней и рублей. Курс вы вводите сами, он сохраняется на устройстве.
- Метро Пекина: поиск станций по русскому, английскому или китайскому названию, маршрут с пересадками, временем и ценой.
- Полная работа без сети: в настройках сборки в память заносятся все тексты, шрифты, звук и данные метро. В проекте есть скрипт, который открывает справочник, отключает сеть, перезагружает страницу и проверяет, что разделы на месте.
Что пока не работает
Здесь я перечислю то, что нельзя принимать на веру.
- Откуда тексты. Из 137 записей 60 переведены с китайского из открытой книги How To Live Better (лицензия Unlicense), 8 адаптированы, 69 написаны заново. Книга на китайском, и как минимум один её раздел написан для граждан КНР за границей, поэтому в записях о консульской защите контакты заменены на российские. В переведённых записях источники оставлены как в оригинале, среди них американские и китайские ведомства.
- Актуальность. У всех 137 записей стоит одна дата проверки, 17 сентября 2026. Что из этого проверялось вручную, а что нет, из документов проекта не видно. Законы, правила въезда и телефоны меняются, перед поездкой важное нужно перепроверить.
- Пометки «требует проверки» стоят у 50 записей из 137. Это записи, где не удалось подтвердить факт первоисточником. По правилам проекта такая запись не выбрасывается, а получает пометку. Например, цены роуминга операторов и подробности о такси DiDi для иностранцев не подтверждены, поэтому цифр там нет.
- У 31 записи вообще нет ссылок на источники, а у нескольких основание звучит как «по сообщениям новостей» или «личный опыт автора книги». Про уровень доказательности C, а это 34 записи, стоит помнить особенно.
- Озвучка синтетическая. В документах проекта нет записи, что фразы проверял носитель китайского языка.
- Курс юаня не обновляется сам. Это сделано намеренно, чтобы не зависеть от сети, но курс по умолчанию 11,5 рубля за юань зашит в код и может не совпадать с реальным.
- Метро есть только у Пекина, других городов нет. Названия станций по-русски есть у 334 из 425, у остальных 91 показывается английское или китайское. Данные взяты из открытого набора по официальным сведениям метро, русские названия из Википедии. Время поездки оценочное, а цена считается только по расстоянию, без скидок.
- Поиск простой: он ищет вхождение набранных букв в текст записи, опечатки и падежи он не понимает.
- Общая юридическая оговорка есть на первом экране: это справочник по открытым источникам, а не консультация врача или юриста.
- Размер. В одном документе сказано, что справочник весит меньше мегабайта, в другом около 1,1 МБ. Точнее я не подтвердил.