1. Порядок работы
Пропись в Lotus — это набор карточек. Один JSON-файл создаёт один набор. Пользователь задаёт иероглифы, слова или выражения; агент дополняет их пиньинем, русскими подсказками и примерами.
Существующие наборы нужно сохранить. Не удаляй, не редактируй и не заменяй их. При совпадении имени нажми «Отмена», измени name в новом файле и загрузи его заново. Не нажимай «Заменить», «Править» или «Удалить набор».
- Сохрани состав и порядок единиц из запроса. Каждый отдельно заданный иероглиф — отдельная карточка. Заданное слово или выражение — одна карточка целиком. Не добавляй другие единицы от себя.
- Выбери понятное имя набора и проверь в менеджере, что оно свободно. Если имя не задано, придумай его по содержанию, например «Пропись — 山, 水, 火».
- Для каждой карточки подбери ровно 3 примера: сначала из Словаря этого сайта, недостающие придумай сам (подробно — в разделе «Учебное содержание»).
- Заполни все поля по правилам ниже и сохрани корректный JSON в файл с расширением
.json, в кодировке UTF-8.
- Загрузи файл через «Карточки» → «Менеджер» → «Добавить набор» и проверь результат. Если сайт спросит код доступа, его вводит пользователь (раздел «Загрузка»).
Для пользователя: передай агенту ссылку на эту страницу и свой запрос. Например:
Создай новую пропись для 山, 水 и 火 по инструкции на этой странице и загрузи её на этот сайт. Существующие наборы сохрани.
Самостоятельная загрузка требует от агента инструментов управления браузером и выбора файла, а в браузере, где правку ещё не открывали, — кода доступа от пользователя. Если таких инструментов нет, подготовь JSON-файл для пользователя и честно сообщи, что загрузка не выполнена. Работай через существующий интерфейс сайта; отдельная интеграция API или MCP для этого сценария не нужна.
3. Как заполнить учебное содержание
Формальная проверка файла не проверяет правильность китайского языка, чтения или перевода. Перед загрузкой проверь их самостоятельно.
- Значение. Одна карточка — одна единица в одном значении. Используй контекст пользователя. Если контекста нет и возможны разные чтения, выбери наиболее употребительное значение и согласуй с ним пиньинь, подсказку и все примеры.
- Подсказка. Обычно 1–5 русских слов. Она должна наводить на выбранное значение, без дублирования пиньиня.
- Примеры. На каждую карточку ровно 3 примера, если пользователь не попросил другое число. Примеры бери из Словаря этого сайта: открой Lotus, выбери инструмент «Словарь» (кнопка на верхней панели с печатным 字; её имя и подсказка — «Словарь», а над полем поиска написано «Словарь BKRS». Кнопка «Шовэнь» с древним 字 — другой словарь), введи изучаемую единицу в поле поиска и выбери короткие, простые и подходящие к выбранному значению фразы в блоке «Примеры с …» ниже статьи (к нему ведёт кнопка «Примеры» под словом; бери список ZH — фразы из китайско-русских статей с переводом; сначала видно по три фразы, кнопка «Ещё» показывает следующие) или в статье самой единицы. Китайский текст переноси без изменений, перевод сверь со Словарём, пиньинь запиши сам (в примерах Словаря его нет) и добавь выделение
**...**. Если подходящих примеров в Словаре меньше трёх, придумай недостающие сам: только простые и на 100% корректные фразы из базовой лексики, ориентировочно 5–12 иероглифов. Если сомневаешься в правильности фразы, не используй её и составь более простую. Варьируй контекст, вопрос, отрицание или конструкцию. Диалог допустим, но не обязателен; в диалоге ответ должен отвечать на вопрос.
- Словарь без браузера. Те же примеры, что в блоке «Примеры с …», доступны только для чтения по адресу
/api/v1/bkrs/examples-with?q=山 на этом сайте. Ответ — объект с полями query, total, zh и ru. В списке zh — фразы из китайско-русских статей: китайский текст в поле zh, перевод в ru, слово статьи, откуда взята фраза, в src. В списке ru — фразы из русско-китайских статей с теми же полями. В каждом списке до 103 фраз, короткие повседневные первыми.
- Перевод. Переводи смысл всей фразы естественным русским языком. Проверяй, что пиньинь соответствует именно китайскому тексту этой фразы.
Пиньинь и озвучка
Записывай тоны диакритикой: 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. Загрузка через сайт
- Открой Lotus на этом же сайте или вернись во вкладку приложения. Выбери «Карточки», затем «Менеджер». Подписи панели могут быть скрыты; доступные имена кнопок остаются «Карточки» и «Менеджер».
- Очисти поле «Поиск» и нажми «Обновить». Посмотри имена существующих наборов и выбери свободное имя для нового.
- Кнопки «Добавить набор» нет, пока в этом браузере закрыта правка. Тогда открой меню сайта (кнопка «Меню» справа на панели), выбери «Правка» и попроси пользователя ввести код в поле под GUID и нажать «ОК». Код знает только пользователь: не подбирай и не угадывай его. После неверного кода меню показывает новый GUID, а после нескольких неверных кодов подряд сайт на время перестаёт их принимать. Если пользователь не может ввести код, отдай ему JSON-файл и сообщи, что набор не загружен.
- Нажми «Добавить набор» и выбери подготовленный
.json-файл. Загрузка начинается после выбора файла; отдельного поля для вставки JSON нет. Если после выбора файла всё же открылось окно «Код доступа» (срок правки вышел), код в нём тоже вводит пользователь; без кода нажми «Отмена».
- Дождись результата. При предложении заменить набор нажми «Отмена», измени
name в локальном JSON и повтори загрузку. Изменить только имя файла недостаточно.
- Если показаны ошибки, исправь файл по инструкции ниже. Любая ошибка валидации отклоняет весь набор — частично он не сохраняется.
- Найди новый набор в списке; при необходимости нажми «Обновить». Проверь его имя и число карточек рядом с именем. Открой набор, сверь состав и порядок карточек с запросом, просмотри пиньинь, подсказки и фразы.
- Сообщи пользователю фактическое имя загруженного набора, количество карточек и оставшиеся предупреждения, если они есть. Успех подтверждается появлением и проверкой набора, а не самим нажатием кнопки.
Если связь оборвалась или результат загрузки неясен, сначала обнови список и проверь, появился ли набор с ожидаемым содержимым. Не загружай повторно под другим именем до этой проверки, чтобы не создать лишнюю копию.
6. Если файл не принят
Менеджер показывает ошибки с номером карточки и полем. Исправляй новый локальный файл; существующие наборы не меняй.