Карточки решений Mila Companion: варианты, кнопки, одно нажатие

Карточка

Что на карточке

Формат держит скрипт, а не настроение: kartochki.py проверяет карточку до записи и плохую не пропускает, называя причину. Тогда она переписывает, а не обходит. skills/kartochki:17

01 · ВОПРОС

Одно решение, вопросом

Первая строка — само решение, до двенадцати слов. Под ней строка-две: почему сейчас. Два решения — две карточки.

kartochki.py:161-168 skills/yasno:21-29

02 · ВАРИАНТЫ

Два-три варианта

У каждого варианта написано, что будет после него. Меньше двух или больше трёх — скрипт карточку не запишет.

kartochki.py:169-174

03 · РЕКОМЕНДАЦИЯ

Её выбор отмечен ★

Рекомендация — зелёная кнопка со ★ и строка «Советую: А». Рекомендацию не из списка вариантов скрипт не примет.

kartochki.py:135-145

04 · СРОК

Срок, если он есть

«Нужно до» — дата и время в вашем поясе. 🔴 Срочно — только если завтра будет поздно.

kartochki.py:137-138 skills/kartochki:14-16

Кнопки

Нажмите — или просто скажите

Нажатие возвращается к ней как «[кнопка] …» с подписью, и скрипт сопоставляет его с карточкой, которую она показала. Голосовое или текст вместо кнопки — тоже ответ.

receiver.ts:1387-1391 · skills/kartochki:25-30

Под карточкой-вопросом

Варианты — первой строкой; её выбор зелёный, со ★. kartochki.py:141-147
💬 Поясни — объясняет подробнее и снова показывает ту же карточку. kartochki.py:253-254
⏸ До завтра — карточка вернётся следующим утром. kartochki.py:228-230
🤷 Реши сама — решает она, но права тратить деньги эта кнопка не даёт. skills/kartochki:33
Задачи команде — своя строка кнопок: ✅, ✏️ Изменить, Нет, ➡️ Другой Миле. kartochki.py:156-157
До шести кнопок, по три в ряд. Кнопка-ссылка просто открывает страницу. receiver.ts:776-787

Один раз

Карточка срабатывает один раз

Отметка — раньше доставки. Плагин сначала пишет в свой файл «использована» и только потом передаёт нажатие ей, поэтому два быстрых нажатия не дают двух решений. receiver.ts:1378-1384
Кнопки гаснут. После нажатия они выключаются, а выбранная получает ✅ — в истории чата видно, что выбрали. На второе нажатие ответ «Already handled.» receiver.ts:1331-1345 receiver.ts:1374-1377
Только тому, кому отправлена. Карточку в личке можете нажать только вы. Чужому — короткий отказ, след в отдельном файле, и к ней ничего не доходит. receiver.ts:788-798 receiver.ts:1363-1372
Ответ не перезаписывается. Второй ответ на уже закрытую карточку колода не принимает, и это проверяет тест. kartochki.py:233-237 test_kartochki.py:62-63

Ничего само

Без нажатия ничего не уходит

01 · ТЕКСТ

Уходит только после нажатия на этот текст

От вашего имени ничего не уходит само. Вчерашнее нажатие сегодняшний текст не покрывает: новый текст — новое нажатие. Это закон 3 её конституции.

CONSTITUTION.md:17

02 · РАССЫЛКИ

Рассылка показывает, кому и что

«Рассылка: N человек», текст целиком и две кнопки — ✅ Отправить N и Отмена. Без ✅ она даже не пишет заявку, а повтор рассылки — только с новым ✅.

Работает у Мил, которые размещает MILAGPT: служба отправки живёт на сервере.

skills/bot-send:13-19 skills/bot-send:31

03 · ИНСТРУМЕНТЫ

Сначала правила, карточка — когда нужна

Рутинные действия проходят по правилу и пишутся в журнал; запрещённые отклоняются, не беспокоя вас; остальное приходит карточкой со сроком. Срок вышел без нажатия — значит, нет, и она прямо говорит, что не сделала.

install/permission_policy.ts:8-15 receiver.ts:618-633

04 · ЗАЩИТА

Битый файл правил спрашивает, а не открывает

Если файл правил не читается, каждое действие идёт через карточку. Если зациклившийся процесс шлёт лавину запросов, карточки прекращаются, а запросы отклоняются.

install/permission_policy.ts:114-117 receiver.ts:600-611

Журнал

Что записывается и где

Только то, что есть в коде сегодня. Каждый пункт — файл, одна строка на событие.

Файлы, где записываются карточки, нажатия и решения
Файл	Что записано
`inbox.jsonl`	Её вопросы вам. Каждое изменение — новой строкой, старые строки не правятся; текущее состояние карточки — её последняя строка. kartochki.py:5-6 kartochki.py:66-71 kartochki.py:74-88
`inbox.jsonl` · ответ	Какой вариант, кто ответил (вы или Мила), как (чат, голос, мини-апп) и когда. kartochki.py:244-246
`proposals.jsonl`	Карточки задач команде, так же: принята, отклонена, изменена, передана другой Миле. kartochki.py:5-6
`cards.jsonl`	Список карточек с кнопками в плагине: чат, кто может нажать, текст, кнопки; потом строка «использована» — кто и когда нажал. Читать файл может только владелец процесса. receiver.ts:1285-1292 receiver.ts:818
`permission-log.jsonl`	Каждое решение по инструментам: пропущено или отклонено правилом, отправлено карточкой, отклонено по сроку или из-за лавины. Права файла проверяет `mila doctor`. install/permission_policy.ts:143-164 receiver.ts:586-590 install/doctor.py:248-256
`auth-log.jsonl`	Каждое решение о подключении группы, отказы тоже. mila-telegram · README:15
`suspicious.jsonl`	Нажатия на карточку теми, кому она не отправлялась. receiver.ts:1309-1313
`tasks/sent.jsonl`	Каждое исходящее сообщение, пишет хук. skills/mila-tasks:27

Честно

Чего эта страница не обещает

Единого журнала решений нет. Одного файла со всеми вашими решениями в репозитории нет: они разложены по файлам из таблицы выше.
В группе нажать может группа. За одним человеком закреплена только карточка в личке; карточку в группе может нажать любой её участник. receiver.ts:788-798
Рассылки — у размещённых Мил. Служба, которая отправляет от вашего публичного бота, живёт на сервере MILAGPT; токена бота у Милы нет. skills/bot-send:13-19
Мини-аппа здесь нет. Умение говорит, что карточки видны и в мини-аппе «Офис Мил»; его кода в этом репозитории нет. skills/kartochki:3

В репозитории

Каждую строку можно прочитать

Файлы карточек решений в репозиториях mila-companion и mila-telegram
Файл	Что делает
skills/kartochki	как пишется карточка и как на неё отвечают
kartochki.py	проверяет, пишет и показывает карточки; принимает нажатие
test_kartochki.py	тесты, в том числе «второго ответа нет»
skills/yasno	правила ясного языка для карточек и кнопок
skills/bot-send	рассылки от вашего публичного бота после ✅
install/permission_policy.ts	правила для инструментов: allow, deny, ask
permissions.example.json	стартовые правила, у каждого — причина
CONSTITUTION.md	закон 3: от вашего имени ничего не уходит само
mila-telegram · receiver.ts	кнопки: регистрация, проверка, выключение, доставка

Открытый код · Apache-2.0

Форкните, научите, пришлите PR

Оба репозитория открыты: набор с умениями, хуками, инструментами и шаблонами и Telegram-плагин. Каждый pull request читает человек и Мила Качество.

Звезда на GitHub mila-telegram на GitHub ← Mila Companion Своя Мила

Факты на странице: github.com/shakhruz/mila-companion (main, v1.3.0) и github.com/shakhruz/mila-telegram (main), проверено 18.10.2026. «Mila», «MILAGPT» и логотип — товарные знаки MILAGPT.

Милы

Для бизнеса

Умения

Блог

О нас

Когда нужно ваше решение — карточка с кнопками, а не длинное письмо