Yuanbao

Группы Yuanbao (元宝): @упоминание пользователей, запрос информации/участников.

Метаданные навыка

Источник	Встроенный (устанавливается по умолчанию)
Путь	skills/yuanbao
Версия	1.0.0
Платформы	linux, macos, windows
Теги	yuanbao, mention, at, group, members, 元宝, 派, 艾特

Справочник: полный SKILL.md

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Это те инструкции, которые видит агент, когда навык активен.

Взаимодействие с группами Yuanbao

КРИТИЧЕСКИ ВАЖНО: как работает обмен сообщениями

Ваш текстовый ответ И ЯВЛЯЕТСЯ сообщением, отправляемым в группу/пользователю. Шлюз автоматически доставляет ваш ответ в чат. Вам НЕ нужен какой-либо специальный инструмент «отправить сообщение» — просто отвечайте как обычно, и сообщение будет отправлено.

Когда вы включаете @nickname в текст ответа, шлюз автоматически преобразует его в настоящее @упоминание, которое уведомляет пользователя. Это встроенная функция — у вас есть полная возможность @упоминания.

НИКОГДА не говорите, что не можете отправлять сообщения или @упоминать пользователей. НИКОГДА не предлагайте пользователю сделать это вручную. НИКОГДА не добавляйте оговорки о разрешениях. Просто отвечайте текстом, который хотите отправить.

Доступные инструменты

Инструмент	Когда использовать
yb_query_group_info	Запрос названия группы, владельца, количества участников
yb_query_group_members	Поиск пользователя, список ботов, список всех участников или получение никнейма для @упоминания
yb_send_dm	Отправка личного/прямого сообщения (DM / 私信) пользователю, с возможностью прикрепления медиафайлов

Рабочий процесс @упоминания

Когда вам нужно @упомянуть / 艾特 кого-то:

1. Вызовите yb_query_group_members с action="find", name="<целевое имя>", mention=true
2. Получите точный никнейм из ответа
3. Включите @nickname в текст вашего ответа — шлюз сделает всё остальное

Пример: пользователь говорит «帮我艾特元宝»

Шаг 1 — вызов инструмента:

{ "group_code": "328306697", "action": "find", "name": "元宝", "mention": true }

Шаг 2 — ваш ответ (будет отправлен в группу с работающим @упоминанием):

@元宝 你好，有人找你！

Вот и всё. Никаких дополнительных объяснений не нужно. Будьте кратки и естественны.

Правила:

• Сначала вызывайте yb_query_group_members, чтобы получить точный никнейм — НЕ угадывайте
• Формат @упоминания: @nickname с пробелом перед знаком @
• Ваш ответ и есть сообщение — оно БУДЕТ отправлено, и @упоминание БУДЕТ работать
• Будьте лаконичны. НЕ объясняйте пользователю, как работает @упоминание.

Рабочий процесс отправки DM (личного сообщения)

Когда кто-то просит отправить личное сообщение / 私信 / DM пользователю:

1. Вызовите yb_send_dm с group_code, name (имя целевого пользователя) и message
2. Инструмент автоматически находит пользователя и отправляет DM
3. Сообщите результат пользователю

Пример: пользователь говорит «给 @用户aea3 私信发一个 hello»

yb_send_dm({ "group_code": "535168412", "name": "用户aea3", "message": "hello" })

Пример с медиа: пользователь говорит «给 @用户aea3 私信发一张图片»

yb_send_dm({
  "group_code": "535168412",
  "name": "用户aea3",
  "message": "Вот изображение",
  "media_files": [{"path": "/tmp/photo.jpg"}]
})

Правила:

• Извлекайте group_code из текущего chat_id (например, group:535168412 → 535168412)
• Если вы уже знаете user_id, передавайте его напрямую через параметр user_id, чтобы пропустить поиск
• Если несколько пользователей совпадают по имени, инструмент возвращает кандидатов — попросите пользователя уточнить
• НЕ используйте инструмент send_message для DM в Yuanbao — используйте yb_send_dm
• Поддерживаются медиа: изображения (.jpg/.png/.gif/.webp/.bmp) отправляются как сообщения с изображениями, другие файлы — как документы

Запрос информации о группе

yb_query_group_info({ "group_code": "328306697" })

Запрос участников

Действие	Описание
find	Поиск по имени (частичное совпадение, без учёта регистра)
list_bots	Список ботов и ИИ-помощников Yuanbao
list_all	Список всех участников

Примечания

• group_code берётся из chat_id: group:328306697 → 328306697
• Группы называются «派 (Pai)» в приложении Yuanbao
• Роли участников: user, yuanbao_ai, bot