# История изменений (/ru/docs/notion/changelog)

Заметные изменения `@wirecat/notion-cli`. Один раздел на версию, новые сверху.

## 0.2.0 — 16.11.2026 [#020--16112026]

### Добавлено [#добавлено]

- `notion <profile> sync` копирует страницы Notion, страницы внутри страниц, базы данных и их строки в общее
  хранилище WireCat, с провайдером `notion`. Без выбранной папки он копирует все, что видит токен. `--limit`
  ограничивает один запуск, а `--rescan` заново проходит по всему. Страница или база данных, которую Notion не отдал,
  названа в `meta.issues` и в `warnings` ответа. Тогда ответ содержит `meta.complete: false`, а код выхода равен 0.
  Обход, слишком долгий для одного запуска, вовремя останавливается, и следующая синхронизация его продолжает. Размер
  выбранных папок не ограничен. Блок внутри страницы, дочерние элементы которого Notion не отдает (синхронизированный
  блок, к оригиналу которого нет доступа), пропускается с предупреждением. Страница или база данных, на которую Notion
  отвечает 403, остается как была. Удаляют ее только ответ 404 или корзина. Блок, который Notion не отдает в Markdown
  страницы, или источник данных, к которому он не принимает запросы, пропускается с предупреждением, а остальное
  синхронизируется. См. [описание синхронизации](https://github.com/WireCatLabs/notion-cli/blob/v0.2.0/docs/dev/SYNC.md).
- Синхронизация идет до 15 минут в терминале и до 45 секунд через MCP, если `--timeout` не задает другое время
  (cli-core 0.671.0). Она останавливается до своего срока, и в ежечасном проходе, и в ежедневном обходе, по одному
  запросу за раз. Она сохраняет, где остановилась, отвечает `complete: false` и называет `sync` следующим шагом.
  Дочерние страницы страницы приходят из ее списка, по 100 за запрос. `--timeout`, слишком короткий, чтобы что-то
  сохранить, завершается ошибкой `timeout` с причиной `notion.timeout-too-short`. См.
  [описание синхронизации](https://github.com/WireCatLabs/notion-cli/blob/v0.2.0/docs/dev/SYNC.md).
- Одному подключению Notion соответствует один профиль. `session start` и `sync` отказываются работать с подключением,
  которое использует другой профиль с выполненным входом, а профиль, синхронизированный из одного подключения,
  отклоняет токен другого. Профиль, вошедший через `WCNOTION_TOKEN`, тоже учитывается. См.
  [описание входа](https://github.com/WireCatLabs/notion-cli/blob/v0.2.0/docs/dev/DESIGN.md).
- Страницы внутри страниц и страница в роли выбранной папки теперь синхронизируются. В 0.1.0 говорилось, что они еще
  не готовы.
- `folders add|list|browse|remove` сужают синхронизацию до выбранных страниц и баз данных. `folders browse` показывает
  один уровень напрямую из Notion. После удаления последней папки команда сообщает, что следующая синхронизация снова
  скопирует все рабочее пространство. Через MCP `folders add` идет через инструмент записи.
- `status`, `documents list|show|export|context|add`, `search` (синтаксис Lucene, без сети), `catalog`, `tags`,
  `relationships`, `notes`, `memories`, `facts` и `identities`: общие команды документов из cli-core для локальной
  копии. `documents add` сохраняет одну страницу, прочитанную напрямую из Notion, среди источников, добавленных
  вручную.

### Исправлено [#исправлено]

- Первая синхронизация большой базы данных или страницы с большим числом дочерних страниц продвигается в каждом
  запуске, в том числе за 45 секунд MCP. Синхронизация читает список папки по одной странице списка и продолжает с
  того места, где остановилась (`childrenPage` из cli-core). Раньше база данных больше примерно 12 000 строк
  останавливала первую синхронизацию через MCP на одном и том же шаге в каждом запуске. См.
  [описание синхронизации](https://github.com/WireCatLabs/notion-cli/blob/v0.2.0/docs/dev/SYNC.md).
- Запросы к базам данных укладываются в документированный лимит Notion, около 3 запросов в секунду, а не 60 в минуту.
  См. [устройство инструмента](https://github.com/WireCatLabs/notion-cli/blob/v0.2.0/docs/dev/DESIGN.md).
- `folders browse --parent` и синхронизированная копия дают странице внутри страницы ссылку в собственной форме
  Notion, `https://app.notion.com/p/{page-id}`, вместо пустого `url`. См.
  [описание синхронизации](https://github.com/WireCatLabs/notion-cli/blob/v0.2.0/docs/dev/SYNC.md).

## 0.1.0 — 15.11.2026 [#010--15112026]

### Добавлено [#добавлено-1]

- Создан из `@wirecat/cli-template` 0.24.0.
- **`api`: весь публичный API Notion, по команде на каждую операцию.** 61 операция из
  [документа OpenAPI](https://developers.notion.com/openapi.json) Notion стала командой, `notion personal api retrieve-a-page
  --page-id …`, и у каждой свой ключ разрешения, `api.<operation>`. `api list` и `api show <operation>` читают
  сохраненный документ и не обращаются к Notion. Каждый запрос передает `Notion-Version` 2026-03-11, поэтому ни одна
  команда ее не спрашивает. Операция, которая удаляет, в терминале сначала спрашивает. Через MCP `ask` ее пропускает,
  поэтому задайте ее ключу `deny`, чтобы остановить агента. `--dry-run` ничего не отправляет. Операции с токенами
  OAuth и две загрузки файлов не предлагаются. Первые входят с секретом клиента подключения и передают токены, вторые
  отправляют тела multipart. Проверки принимают чуть больше, чем Notion: любое значение JSON не типизировано, а три
  ограничения (`exclusiveMinimum`, `exclusiveMaximum`, `maxProperties`) отброшены в шести местах, так что нарушение
  этих ограничений отклоняет сам Notion.
  [Покрытие API](https://github.com/WireCatLabs/notion-cli/blob/v0.2.0/docs/dev/API_COVERAGE.md).
- `session start | status | end | list` с персональным токеном доступа Notion или токеном внутреннего подключения.
  Токен проверяется в Notion и хранится в связке ключей как `token:<profile>`. Аккаунтом считаются рабочее
  пространство и бот токена.
- `documents get` читает одну страницу напрямую как Markdown, дочитывает недостающие части длинной страницы и
  вырезает подпись из подписанных ссылок Notion на файлы. Если страница все еще неполная, ответ содержит
  `meta.complete: false`, а код выхода не равен нулю.
- `databases list` и `databases show`: базы данных, которые видит токен, а также id и свойства каждого источника
  данных.
- Запросы идут медленнее лимита Notion, а запросы к источникам данных еще медленнее. После отказа инструмент ждет
  столько, сколько указывает `Retry-After` от Notion. Запрос через подключение, которое Notion заблокировал, не повторяется.
- Переменные окружения начинаются с `WCNOTION_` (`WCNOTION_TOKEN`, `WCNOTION_PROFILE`), а не с `NOTION_`. Собственный
  MCP-сервер Notion читает `NOTION_TOKEN`, и токен, заданный для него, не должен выполнять вход в этот инструмент.
- Инкрементальный источник синхронизации для Notion, готовый для движка синхронизации cli-core. Он читает изменения
  с отметки времени с перекрытием, запрашивает каждую базу данных в области синхронизации, раз в день обходит все и
  удаляет страницу только после того, как Notion подтвердит, что ее нет. Большие базы данных читаются целиком, сверх
  ограничения Notion в 10 000 строк на запрос. Элемент, который Notion отказывается отдать, пропускается с
  предупреждением, а прерванная синхронизация продолжается в следующий раз. Пока не поддерживаются страницы внутри
  страниц и страница в роли выбранной папки. Они ждут cli-core. См.
  [описание синхронизации](https://github.com/WireCatLabs/notion-cli/blob/v0.2.0/docs/dev/SYNC.md).
