anki-mcp/anki-mcp-desktop

Добавляет новое поле в существующий тип заметки Anki (модель). По умолчанию поле добавляется в конец или вставляется в заданную позицию. У существующих заметок этого типа новое поле будет пустым. modelFieldNames перечисляет текущие поля.

Добавляет ОДНУ заметку в Anki. Инструмент пакетного добавления addNotes создаёт несколько заметок за один вызов: AnkiConnect обрабатывает запросы по одному, поэтому повторные (особенно параллельные) вызовы addNote работают медленнее. modelNames перечисляет доступные типы заметок, а modelFieldNames перечисляет их поля. Возвращает ID заметки при успешном выполнении. Заметка и её карточки добавляются в коллекцию пользователя и появляются в его повторениях.

Добавляет несколько заметок в Anki одним пакетом - быстрее, чем повторные вызовы addNote, если заметок больше одной. До 100 заметок с одной и той же колодой и моделью. Дубликаты пропускаются по отдельности; ошибки валидации (пустые обязательные поля, неправильные теги) отклоняют весь пакет. Заметки и их карточки добавляются в коллекцию пользователя и появляются в его повторениях.

Добавляет теги к указанным заметкам. Tags - строка с тегами через пробел (например, "tag1 tag2 tag3"). getTags выводит список существующих тегов, что помогает избежать почти одинаковых (например, "roman-empire" против "roman_empire").

Проверяет, приостановлены ли карточки, ничего не изменяя. Идентификаторы карточек (не идентификаторы заметок), используйте get_cards, get_due_cards или notesInfo, чтобы получить их. Ответ сохраняет порядок ввода; идентификатор карточки, которого не существует, возвращается со значением suspended: null, а не отбрасывается и не вызывает ошибку, поэтому один неверный идентификатор не приводит к сбою всего пакета.

Перемещает карты в другую колоду. Целевая колода будет создана, если её не существует.

Удаляет осиротевшие теги, которые не используются ни одной заметкой в коллекции, сразу по всей коллекции. Удалённые теги исчезают из списка тегов Anki (включая теги, которые пользователь создал, но ещё не применил); заметки не меняются.

Получает агрегированную статистику по всем колодам в коллекции, включая количество карточек, распределение фактора лёгкости и распределение интервалов. Возвращает ДВА разных представления, которые отвечают на разные вопросы: counts и per_deck - это сегодняшняя очередь изучения, как она показана в браузере колод Anki (карточки, СРОК КОТОРЫХ СЕГОДНЯ, ограниченные дневными лимитами новых/повторяемых карточек каждой колоды, приостановленные/отложенные исключены); states - это истинное количество карточек в каждом состоянии (new / learning / review / suspended / buried) по всей коллекции, без учёта сроков и дневных лимитов. Чтобы ответить на вопрос «сколько у меня карточек», используйте states; чтобы ответить на вопрос «что я буду изучать сегодня», используйте counts. Счётчики по колодам сворачиваются по потомкам (родительская колода включает свои дочерние); counts на уровне коллекции суммирует только КОРНЕВЫЕ колоды, чтобы не считать дочерние дважды. states работает только по всей коллекции (это стоит 5 дополнительных поисков в Anki на каждый вызов) - вызывайте инструмент deckStats для истинных счётчиков состояний отдельной колоды. Для каждой колоды и для коллекции: обычно total === new + learning + review + other; other ограничивается снизу нулём, поэтому в редких случаях с фильтрованными колодами / унаследованными лимитами сумма может превысить total. Корзины фактора лёгкости и интервалов можно настроить, чтобы сосредоточиться на конкретных диапазонах.

Создаёт новую пустую колоду Anki. Использует "::" для структуры родитель::потомок (максимум 2 уровня, например, "Japanese::JLPT N5"). Не перезаписывает существующие колоды.

Создаёт новый тип заметок (модель) в Anki с пользовательскими полями, шаблонами карточек и стилями. Полезен для создания специализированных моделей, например, моделей для языков с написанием справа налево (RTL), таких как иврит, арабский и т.д. Каждая модель определяет структуру заметок и то, как из них создаются карточки.

Получает подробную статистику по одной колоде: количество карточек, распределение ease и интервалов. Принимает имя колоды (например, "Japanese::JLPT N5") и необязательные границы диапазонов. Возвращает ДВА разных представления, которые отвечают на разные вопросы: counts - это сегодняшняя очередь изучения, как её показывает браузер колод Anki (карточки, СРОК КОТОРЫХ НАСТУПИЛ СЕГОДНЯ, ограниченные дневными лимитами колоды на новые и повторяемые карточки, приостановленные и отложенные исключены); states - это реальное число карточек в каждом состоянии (new / learning / review / suspended / buried), без учёта сроков и дневных лимитов. Чтобы ответить на вопрос "сколько у меня карточек", используй states; чтобы ответить "что я буду учить сегодня" - counts. Оба представления сворачиваются по дочерним колодам (родительские колоды включают свои дочерние). states стоит 5 дополнительных поисков в Anki за вызов. Для counts: обычно total === new + learning + review + other; other ограничен снизу нулём, поэтому в редких случаях с фильтрованными колодами или унаследованными лимитами сумма может превысить total.

Удаляет медиафайл из папки collection.media в Anki (Anki перемещает его в свою корзину медиафайлов). Карточки, которые ссылаются на этот файл, перестают его показывать или воспроизводить; удаление также доходит до других устройств при следующей синхронизации с AnkiWeb.

Удаляет заметки по их ID. Безвозвратно удаляет заметки и ВСЕ их карточки, включая расписание карточек. История отмены в Anki (Правка > Отменить или guiUndo, который откатывает последнее действие) может восстановить их, пока эта история не очищена, например, изменением, которое Anki не записывает для отмены, таким как updateNoteFields; после этого их восстановит только резервная копия. Вызов отклоняется, если confirmDeletion не true.

Ищет заметки по синтаксису запросов Anki. Возвращает массив ID заметок, соответствующих запросу. Примеры: "deck:Spanish", "tag:verb", "is:due", "front:hello", "added:1" (карточки, добавленные сегодня), "prop:due<=2" (карточки, срок которых наступает в течение 2 дней), "flag:1" (красный флажок), "is:suspended"

Сбрасывает карточки в очередь новых, отбрасывая их текущее расписание (интервал, дату повторения и коэффициент лёгкости). Используйте это, когда карточку нужно выучить заново с нуля - например, когда пользователь постоянно не может вспомнить слово, которое Anki запланировал на месяцы вперёд. Предпочтите это оценке карточки «Снова»: оценка фиксирует реальное повторение и считается ошибкой, что искажает и будущее расписание, и статистику коллекции. Журнал повторений сохраняется, поэтому прошлые повторения по-прежнему видны в информации о карточке и статистике. Это меняет только расписание - содержимое заметки, теги и размещение в колоде не затрагиваются. Карточки, которые уже новые, не затрагиваются, поэтому повторный запуск безопасен.

Извлекает карточки из Anki с гибкой фильтрацией по колоде и состоянию карточки. Читает локальную коллекцию как есть и не синхронизируется с AnkiWeb, поэтому повторения, сделанные на других устройствах после последней синхронизации, не отражаются. Ответы по умолчанию не включаются (include_answer=false), поэтому обратная сторона карточки не попадает в диалог, пока её не покажет present_card; include_answer=true возвращает и обратные стороны, что подходит для анализа содержимого или редактирования, а не для живого повторения.

Получает карточки, которые пора повторить, из Anki. Читает локальную коллекцию как есть и не синхронизируется с AnkiWeb, поэтому повторы, сделанные на других устройствах после последней синхронизации, не отражаются. Ответы по умолчанию не включаются (include_answer=false), поэтому обратная сторона карточки не попадает в диалог, пока present_card её не покажет; include_answer=true возвращает и обратные стороны, что подходит для анализа содержимого или редактирования, а не для живого повторения.

Перечисляет медиафайлы в папке collection.media программы Anki, опционально отфильтрованные по шаблону в стиле glob.

Получите все теги в коллекции Anki. Используйте это, чтобы выявить существующие теги перед созданием заметок и тем самым сохранить согласованность и предотвратить дублирование тегов (например, избегая вариантов 'roman-empire' vs 'roman_empire' vs 'RomanEmpire').

Открывает диалог Add Cards в настольном приложении Anki на экране пользователя, заранее заполненный колодой, типом заметки, полями и тегами (заменяя уже открытый диалог Add Cards), и делает эту колоду и этот тип заметки текущими в Anki. Ничего не сохраняется, пока пользователь не нажмёт Add, поэтому возвращаемый noteId не ссылается на сохранённую заметку. Для случаев, когда пользователь хочет просмотреть и доделать заметку вручную в Anki; addNote создаёт заметки напрямую.

Открывает окно Card Browser в десктопном приложении Anki на экране пользователя и запускает в нём поиск (синтаксис запросов Anki). Возвращает ID подходящих карточек. Для случаев, когда пользователь просит открыть браузер, например, чтобы найти и отредактировать заметки вручную; findNotes ищет без открытия окна. Не часть сессии повторения.

Читает карточку, которая сейчас показана на экране повторения в десктопном приложении Anki: вопрос, ответ, поля, колоду, тип заметки и кнопки ответа. Ничего не меняет на экране. Результат всегда содержит ответ, поэтому если вызвать инструмент, пока пользователь повторяет в Anki, ответ раскроется до того, как он ответит; present_card умеет показывать карточку без ответа. Когда Anki не в режиме повторения, AnkiConnect сообщает об ошибке ('Gui review is not currently active.').

Переключает главное окно настольного приложения Anki на экране пользователя на список колод (Deck Browser), при этом окно покидает любой экран, на котором находилось, например незавершённое повторение. Нужен, когда пользователь просит показать свои колоды в Anki; listDecks возвращает список колод, не меняя экран. Не входит в сессию повторения.

Делает колоду с указанным именем текущей колодой Anki и переключает главное окно настольного приложения Anki на экране пользователя на обзор этой колоды (счётчики к повторению и кнопка Study Now). Возвращает ошибку, если колоды не существует. Для случаев, когда пользователь просит открыть колоду в Anki; deckStats возвращает числа, не меняя экран. Не часть сессии повторения.

Открывает окно редактора заметки в десктопном приложении Anki на экране пользователя для одной заметки, где пользователь может вручную редактировать её поля и теги. Сам инструмент не меняет содержимое заметки. Для случаев, когда пользователь хочет отредактировать заметку в Anki; updateNoteFields редактирует поля напрямую.

Меняет выделение в окне Card Browser, открытом в настольном приложении Anki на экране пользователя, на одну карточку, сбрасывая предыдущее выделение. Возвращает ошибку, если Card Browser не открыт (guiBrowse открывает его). Для случаев, когда пользователь просит выбрать карточку в браузере. Не часть сессии повторения.

Читает идентификаторы заметок, которые пользователь выбрал в окне Card Browser десктопного приложения Anki. Ничего не меняет на экране. Возвращает пустой список, если ничего не выбрано или окно Card Browser не открыто. Пригодится, когда пользователь ссылается на заметки, которые выбрал в Anki.

Переворачивает карточку на экране повторения в десктопном приложении Anki на сторону ответа, на экране пользователя. Не возвращает содержимое карточки и не записывает повторение. inReview равен false (и ничего не меняется), когда Anki не в режиме повторения. Для случаев, когда пользователь просит показать ответ в Anki; инструменты повторения здесь (present_card, rate_card) запускают повторение без окна Anki.

Переворачивает карточку на экране повторения в настольном приложении Anki обратно на сторону вопроса, на экране пользователя. Не возвращает содержимое карточки и не записывает повторение. inReview имеет значение false (и ничего не меняется), когда Anki не в режиме повторения. Для случаев, когда пользователь просит показать вопрос в Anki; здешние инструменты повторения (present_card, rate_card) запускают повторение без окна Anki.

Запускает в настольном приложении Anki команду Edit > Undo, откатывая то, что история отмены Anki хранит как последнее действие. Это может быть действие, которое пользователь выполнил в Anki, а не изменение, сделанное через этот сервер, а некоторые изменения AnkiConnect (например, updateNoteFields) вообще не записываются в эту историю. AnkiConnect сообщает об успехе, как только команда отправлена, даже если отменять было нечего. Для случаев, когда пользователь просит отменить что-то в Anki.

Перечисляет все колоды Anki, при необходимости со статистикой очереди изучения по каждой колоде. Эта статистика - это цифры из браузера колод Anki: карточки К ПОВТОРЕНИЮ СЕГОДНЯ, ограниченные дневными лимитами новых/повторных карточек для каждой колоды, исключая приостановленные и отложенные карточки, а НЕ суммарные значения по состояниям карточек. Инструмент deckStats (его блок states) и collection_stats возвращают настоящие счётчики по состояниям карточек. Читает локальную коллекцию, которая отражает другие устройства только на момент последней синхронизации с AnkiWeb.

Получает названия полей для конкретного типа заметки (модели). Используйте это, чтобы узнать, какие поля обязательны при создании заметок этого типа.

Получите список всех доступных названий типов заметок (моделей) в Anki. Используйте его, чтобы увидеть, какие типы заметок доступны перед созданием заметок.

Получает стили CSS для конкретного типа заметок (model). Этот CSS используется при рендеринге карточек этого типа.

Получить шаблоны карточек (HTML лицевой и обратной стороны) для конкретного типа заметок (модели). Возвращает HTML-содержимое лицевой и обратной сторон каждого шаблона карточки. Используйте это перед updateModelTemplates, чтобы увидеть текущие шаблоны и спланировать изменения.

Получает поля, теги, название типа заметки (модели), ID карточек и время изменения для каждой заметки по ID заметки (из findNotes). CSS хранится для каждого типа заметки и не включается; modelStyling возвращает его.

Возвращает отрендеренную лицевую сторону карточки, а также её колоду, тип заметки, теги и информацию о расписании. Обратная сторона включается только при show_answer=true, поэтому карточку можно показать пользователю ещё до того, как раскрыт ответ. Чтение карточки не записывает повторение; rate_card записывает.

Записывает реальное повторение карточки в планировщике Anki: оно добавляется в историю повторений и статистику карточки, а оценка задаёт следующую дату повторения карточки. Оценка должна отражать, насколько хорошо, по мнению самого пользователя, он вспомнил материал, и выставляется после просмотра ответа (present_card с show_answer=true).

Удаляет поле из существующего типа заметок Anki (model). Все данные, хранящиеся в этом поле во всех заметках этого типа, удаляются безвозвратно. Вызов отклоняется, если confirmDeletion не равен true. modelFieldNames перечисляет текущие имена полей.

Удаляет теги из указанных заметок. Теги - это строка, разделённая пробелами (например, "tag1 tag2 tag3").

Переименовывает поле в существующем типе заметки Anki (model). Anki переписывает ссылки на старое имя в шаблонах карточек типа заметки (например, {{OldName}} становится {{NewName}}); затем Anki проверяет все шаблоны карточек при сохранении типа заметки, и если какой-то из них недействителен (например, не разбирается, ссылается на поле, которого нет в типе заметки, или не содержит поля на лицевой стороне), переименование не срабатывает. Имена полей чувствительны к регистру; modelFieldNames перечисляет текущие имена.

Переименовать тег в указанных заметках (например, «RomanEmpire» -> «roman-empire»). Только один тег; пробелы запрещены в обоих значениях.

Изменяет позицию поля в типе заметки Anki (model). Поля нумеруются с 0: индекс 0 - первое поле. (То, какое поле служит полем сортировки, задаётся отдельной настройкой модели и не меняется при смене позиции.) modelFieldNames перечисляет текущий порядок полей.

Скачивает медиа-файл из папки collection.media в Anki. Возвращает содержимое файла в кодировке base64 или null, если файл не найден.

Получает анализ истории повторений, включая временные закономерности, метрики удержания и данные о серии занятий. Используйте его, чтобы анализировать прогресс обучения во времени, выявлять закономерности повторений и отслеживать регулярность. Требуется дата начала; колода необязательна - пропустите её, чтобы проанализировать всю коллекцию (все колоды). Дата окончания по умолчанию - сегодня. Дни считаются календарными (от полуночи до полуночи) в часовом поясе машины, где запущен сервер, то есть машины с Anki; час 'next day starts at' из Anki не применяется. Повторения карточек, удалённых позже, не учитываются, поэтому итоги могут быть ниже, чем в собственной статистике Anki.

Переносит срок показа карточек на заданное количество дней, не записывая повторение. Используйте это, чтобы перенести карточку на более ранний срок (или отложить), когда её текущий интервал не соответствует тому, насколько хорошо пользователь на самом деле её знает: оценка карточки вместо этого запишет фиктивное повторение и исказит её фактор лёгкости. В отличие от forgetCards, этот инструмент сохраняет текущий интервал и лёгкость карточки, если вы не попросите иного, так что это более щадящий вариант, когда историю карточки ещё стоит сохранить. Обратите внимание: применение этого к новой карточке превращает её в карточку для повторения.

Загружает медиафайл в папку collection.media Anki. Поддерживает данные base64, абсолютные пути к файлам и URL-адреса. По умолчанию файл с таким же именем перезаписывается.

Приостанавливает карточки, чтобы они пропускались во время повторения до отмены приостановки. Идентификаторы карточек (не идентификаторы заметок) - используйте get_cards, get_due_cards или notesInfo, чтобы получить их. Идентификаторы карточек сначала проверяются на существование, и ничего не меняется, если какой-либо отсутствует - собственное действие suspend в AnkiConnect обрабатывает несуществующие идентификаторы непоследовательно (обычно ошибка, иногда молчаливый пропуск в зависимости от порядка ввода). Приостановка уже приостановленной карточки - безопасная no-op операция, поэтому повторный запуск с теми же идентификаторами безопасен. Приостановленная карточка молча выпадает из повторений пользователя (в Anki и на синхронизированных устройствах) до тех пор, пока не будет возобновлена.

Синхронизирует локальную коллекцию Anki с AnkiWeb (сетевой вызов; нужно, чтобы десктопное приложение Anki вошло в AnkiWeb). Остальные инструменты работают с локальной коллекцией (кроме скачивания медиа по URL-адресам, переданным в storeMediaFile или updateNoteFields), поэтому повторения, сделанные на других устройствах, появятся только после синхронизации, а изменения, сделанные здесь, дойдут до других устройств только после синхронизации.

Снимает приостановку с карточек, чтобы они вернулись к обычному повторению. Идентификаторы карточек (не заметок) получаются с помощью get_cards, get_due_cards или notesInfo. Сначала проверяется существование идентификаторов карточек, и ничего не изменяется, если какой-либо отсутствует: собственное действие unsuspend в AnkiConnect обрабатывает несуществующие идентификаторы непоследовательно (обычно ошибка, иногда молчаливый пропуск в зависимости от порядка ввода). Снятие приостановки с уже снятой карточки безопасно и не даёт эффекта, поэтому повторный запуск с теми же идентификаторами безопасен.

Обновляет CSS-оформление для существующего типа заметки (модели). Это меняет то, как карточки этого типа отображаются в Anki. Пригодится для добавления поддержки RTL (справа налево), смены шрифтов, цветов или макета. Переданный CSS заменяет весь существующий CSS типа заметки (modelStyling возвращает текущий CSS). Изменения затрагивают все карточки, использующие эту модель.

Обновляет шаблоны карточек (HTML для Front и Back) для существующего типа заметок (model). Каждый шаблон карточки определяет, как отрисовываются лицевая и обратная стороны карточки. HTML для Front и Back, заданный для каждого именованного шаблона, заменяет существующий HTML; modelTemplates возвращает текущие шаблоны. Изменения применяются ко всем карточкам, которые используют эту модель. Anki проверяет каждый шаблон карточки при сохранении типа заметок и отклоняет обновление, если шаблон недействителен, например если его не удаётся разобрать, он ссылается на поле, которого нет у типа заметок, не имеет поля на лицевой стороне или имеет такую же лицевую сторону, как другой шаблон; в этом случае ничего не меняется. Имена шаблонов карточек сверяются с существующими шаблонами модели (с учётом регистра) - неизвестные имена или имена с неправильным регистром отклоняются до любого обновления. Пустую строку нельзя использовать, чтобы очистить сторону.

Обновляет поля существующей заметки. Текущее содержимое указанных полей перезаписывается (HTML поддерживается; CSS типа заметки не затрагивается), а изменение не записывается в историю отмены Anki. Необязательные элементы аудио/изображений скачиваются по своим URL и добавляются к перечисленным полям как теги [sound:...] / <img>, поэтому повторный вызов с медиа добавит их снова, если только эти поля не перезаписываются заодно. Известная проблема AnkiConnect: если заметка открыта в окне Browse в Anki, вызов сообщает об успехе, но поля не сохраняются.