← Открыть Lotus

Создать пропись с ИИ

Инструкция для ИИ-агента: составить набор карточек по запросу пользователя, сохранить JSON-файл и загрузить его через сайт.

1. Порядок работы

Пропись в Lotus — это набор карточек. Один JSON-файл создаёт один набор. Пользователь задаёт иероглифы, слова или выражения; агент дополняет их пиньинем, русскими подсказками и примерами.

Существующие наборы нужно сохранить. Не удаляй, не редактируй и не заменяй их. При совпадении имени нажми «Отмена», измени name в новом файле и загрузи его заново. Не нажимай «Заменить», «Править» или «Удалить набор».

  1. Сохрани состав и порядок единиц из запроса. Каждый отдельно заданный иероглиф — отдельная карточка. Заданное слово или выражение — одна карточка целиком. Не добавляй другие единицы от себя.
  2. Выбери понятное имя набора и проверь в менеджере, что оно свободно. Если имя не задано, придумай его по содержанию, например «Пропись — 山, 水, 火».
  3. Для каждой карточки подбери ровно 3 примера: сначала из Словаря этого сайта, недостающие придумай сам (подробно — в разделе «Учебное содержание»).
  4. Заполни все поля по правилам ниже и сохрани корректный JSON в файл с расширением .json, в кодировке UTF-8.
  5. Загрузи файл через «Карточки» → «Менеджер» → «Добавить набор» и проверь результат. Если сайт спросит код доступа, его вводит пользователь (раздел «Загрузка»).

Для пользователя: передай агенту ссылку на эту страницу и свой запрос. Например:

Создай новую пропись для 山, 水 и 火 по инструкции на этой странице и загрузи её на этот сайт. Существующие наборы сохрани.

Самостоятельная загрузка требует от агента инструментов управления браузером и выбора файла, а в браузере, где правку ещё не открывали, — кода доступа от пользователя. Если таких инструментов нет, подготовь JSON-файл для пользователя и честно сообщи, что загрузка не выполнена. Работай через существующий интерфейс сайта; отдельная интеграция API или MCP для этого сценария не нужна.

2. Формат JSON

Корень файла — объект с полями name и cards. Все поля в таблице обязательны. Текстовые поля должны быть непустыми строками, а не null, числами или строками из одних пробелов.

Структура набора и карточки
ПолеСодержание и ограничения
nameИмя набора: 1–500 символов после удаления пробелов по краям.
cardsМассив из 1–2500 карточек. Порядок определяет порядок изучения и разбиение на «десятки». Дубликаты форматом допускаются.
cards[].unitИзучаемая единица: только иероглифы U+4E00–U+9FFF. Без пробелов, пунктуации, цифр, латиницы и вариантов через косую черту. Для каждого знака должны быть данные прописи на сервере.
cards[].pinyinПиньинь единицы со слогами через пробел: xǐ huān. Пиньинь виден в тесте до раскрытия ответа.
cards[].hintКраткая русская подсказка: значение или грамматическая функция. Она тоже видна в тесте до раскрытия ответа.
cards[].phrasesМассив из 1–20 фраз. Порядок сохраняется. Составляй ровно 3 фразы на карточку, если пользователь не попросил другое число.
phrases[].zhКитайский текст фразы с выделением изучаемой единицы через **...**.
phrases[].pinyinПиньинь всей фразы с соответствующим выделением через **...**.
phrases[].ruЕстественный русский перевод всей фразы, без разметки выделения.

Любое текстовое поле карточки или фразы — не более 2500 символов. Размер файла — не более 10 МиБ (10 485 760 байт). Длины строк сервер считает в единицах UTF-16; для символов указанного диапазона CJK это один знак на единицу.

Используй стандартный JSON: двойные кавычки, без комментариев, завершающих запятых и Markdown-обёртки. Не добавляй другие поля: сервер их игнорирует и не сохраняет. Координаты черт, изображения и аудио в файл не включаются — сайт получает их сам.

Имя файла не определяет имя набора: используется поле name. Для проверки уникальности сервер нормализует имя в NFC, убирает пробелы по краям, схлопывает внутренние пробелы и сравнивает без учёта регистра. «Урок 3» и «урок 3» конфликтуют. Выбирай содержательно отличающееся имя, например «Урок 3 — вариант 2».

3. Как заполнить учебное содержание

Формальная проверка файла не проверяет правильность китайского языка, чтения или перевода. Перед загрузкой проверь их самостоятельно.

Пиньинь и озвучка

Записывай тоны диакритикой: nǐ, hǎo. Нейтральный тон оставляй без знака: de, le, ma; не придумывай для него первый тон и не используй цифры вместо диакритики. Особенности записей аудио на сайте не меняют правильное написание пиньиня.

В unit и его pinyin желательно одинаковое число иероглифов и слогов: 喜欢 → xǐ huān, а не xǐhuān. Это включает озвучку по слогам и подсветку текущего слога.

Если число не совпадает, набор сохраняется с предупреждением PINYIN_SYLLABLE_MISMATCH, но у такой карточки отключаются озвучка по слогам и слоговая подсветка. Исправляй случайно склеенные слоги. Не искажай произношение ради совпадения: например, 哪儿 → nǎr — допустимое несовпадение. Если пользователь задал такую единицу, сохрани её и сообщи об ограничении.

Выделение изучаемой единицы

Хотя бы одна фраза карточки должна содержать разметку **...**. При генерации выделяй изучаемую единицу и в zh, и в соответствующем пиньине каждой фразы, где она встречается. В ru, unit, пиньине самой карточки и hint выделение не ставь.

Выделяется реальный фрагмент фразы, даже если единица изменилась или разделена вставкой. Для 喜欢 корректно: 你**喜不喜欢**喝茶? и nǐ **xǐ bù xǐ huān** hē chá?. Автоматического поиска и выделения сайт не делает.

4. Готовый пример: три иероглифа

Набор для 山, 水 и 火: три карточки, по три фразы в каждой. Для своего набора замени имя и содержание согласно запросу пользователя.

{
  "name": "Пропись — 山, 水, 火",
  "cards": [
    {
      "unit": "山",
      "pinyin": "shān",
      "hint": "гора",
      "phrases": [
        {
          "zh": "那座**山**很高。",
          "pinyin": "nà zuò **shān** hěn gāo.",
          "ru": "Та гора очень высокая."
        },
        {
          "zh": "你喜欢爬**山**吗?",
          "pinyin": "nǐ xǐ huān pá **shān** ma?",
          "ru": "Тебе нравится ходить в горы?"
        },
        {
          "zh": "这座**山**叫什么名字?",
          "pinyin": "zhè zuò **shān** jiào shén me míng zi?",
          "ru": "Как называется эта гора?"
        }
      ]
    },
    {
      "unit": "水",
      "pinyin": "shuǐ",
      "hint": "вода",
      "phrases": [
        {
          "zh": "你想喝**水**吗?",
          "pinyin": "nǐ xiǎng hē **shuǐ** ma?",
          "ru": "Хочешь попить воды?"
        },
        {
          "zh": "杯子里没有**水**。",
          "pinyin": "bēi zi lǐ méi yǒu **shuǐ**.",
          "ru": "В стакане нет воды."
        },
        {
          "zh": "我每天喝很多**水**。",
          "pinyin": "wǒ měi tiān hē hěn duō **shuǐ**.",
          "ru": "Я каждый день пью много воды."
        }
      ]
    },
    {
      "unit": "火",
      "pinyin": "huǒ",
      "hint": "огонь",
      "phrases": [
        {
          "zh": "请不要玩**火**。",
          "pinyin": "qǐng bú yào wán **huǒ**.",
          "ru": "Пожалуйста, не играй с огнём."
        },
        {
          "zh": "他们在生**火**。",
          "pinyin": "tā men zài shēng **huǒ**.",
          "ru": "Они разводят огонь."
        },
        {
          "zh": "**火**已经灭了。",
          "pinyin": "**huǒ** yǐ jīng miè le.",
          "ru": "Огонь уже погас."
        }
      ]
    }
  ]
}

5. Загрузка через сайт

  1. Открой Lotus на этом же сайте или вернись во вкладку приложения. Выбери «Карточки», затем «Менеджер». Подписи панели могут быть скрыты; доступные имена кнопок остаются «Карточки» и «Менеджер».
  2. Очисти поле «Поиск» и нажми «Обновить». Посмотри имена существующих наборов и выбери свободное имя для нового.
  3. Кнопки «Добавить набор» нет, пока в этом браузере закрыта правка. Тогда открой меню сайта (кнопка «Меню» справа на панели), выбери «Правка» и попроси пользователя ввести код в поле под GUID и нажать «ОК». Код знает только пользователь: не подбирай и не угадывай его. После неверного кода меню показывает новый GUID, а после нескольких неверных кодов подряд сайт на время перестаёт их принимать. Если пользователь не может ввести код, отдай ему JSON-файл и сообщи, что набор не загружен.
  4. Нажми «Добавить набор» и выбери подготовленный .json-файл. Загрузка начинается после выбора файла; отдельного поля для вставки JSON нет. Если после выбора файла всё же открылось окно «Код доступа» (срок правки вышел), код в нём тоже вводит пользователь; без кода нажми «Отмена».
  5. Дождись результата. При предложении заменить набор нажми «Отмена», измени name в локальном JSON и повтори загрузку. Изменить только имя файла недостаточно.
  6. Если показаны ошибки, исправь файл по инструкции ниже. Любая ошибка валидации отклоняет весь набор — частично он не сохраняется.
  7. Найди новый набор в списке; при необходимости нажми «Обновить». Проверь его имя и число карточек рядом с именем. Открой набор, сверь состав и порядок карточек с запросом, просмотри пиньинь, подсказки и фразы.
  8. Сообщи пользователю фактическое имя загруженного набора, количество карточек и оставшиеся предупреждения, если они есть. Успех подтверждается появлением и проверкой набора, а не самим нажатием кнопки.

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

6. Если файл не принят

Менеджер показывает ошибки с номером карточки и полем. Исправляй новый локальный файл; существующие наборы не меняй.

Причины отказа и предупреждения
Ситуация / кодДействие
Имя занято
NAME_CONFLICT
Отмени замену, выбери другое имя в name и повтори загрузку.
Нужен код доступа
CARDS_ACCESS_REQUIRED, CARDS_ACCESS_LOCKED
Набор не загружен. Попроси пользователя ввести код в «Правке» меню сайта или в окне «Код доступа»; сам код не подбирай. Если сайт пишет «Много неверных кодов», сообщи пользователю, через сколько минут можно повторить.
Нет данных прописи
UNIT_NO_STROKE_DATA
Сообщи пользователю конкретный знак и уточни дальнейшие действия. Не исключай и не подменяй знак самостоятельно. Наличие знака в допустимом диапазоне Unicode не гарантирует наличие прописи.
Недопустимый знак
UNIT_NOT_CJK
Исправь случайно добавленные агентом пробелы или пунктуацию. Если сама запрошенная единица не поддерживается, сообщи пользователю и уточни дальнейшие действия; не меняй её молча.
Некорректный JSON
INVALID_JSON
Проверь синтаксис: корень — объект, двойные кавычки, без комментариев, лишних запятых и Markdown-обёртки.
Пустые поля или массивы
NAME_EMPTY, NO_CARDS, MISSING_FIELD
Заполни имя и все обязательные строки, добавь карточки и фразы. Пустые строки, null и массивы неверного типа не подходят.
Нет выделения
HIGHLIGHT_MISSING
Добавь непустое парное выделение **...** изучаемой единицы в китайском тексте и пиньине хотя бы одной фразы карточки.
Превышены ограничения
NAME_TOO_LONG, FIELD_TOO_LONG, TOO_MANY_CARDS, TOO_MANY_PHRASES, FILE_TOO_LARGE
Сверь файл с лимитами. Сократи собственные избыточные пояснения и примеры; если для соблюдения лимита нужно менять состав запрошенных единиц или делить набор, согласуй это с пользователем.
Не совпало число слогов
PINYIN_SYLLABLE_MISMATCH
Это предупреждение: набор уже сохранён. Проверь пробелы между слогами до загрузки. Если предупреждение осталось, сообщи пользователю о карточках без озвучки по слогам и подсветки. Не заменяй и не редактируй сохранённый набор в рамках этой инструкции.