---
title: Поверхности изменений
description: Где записываются изменения — capability-changelog агентской поверхности, релиз-ноты модулей, версии пайплайнов и собственные content-хэши портала — и как потреблять каждую.
locale: ru
version: 0.2.0
canonical: https://enterium-developer-docs.pages.dev/developers/ru/reference/changelog/
---

> Documentation index: https://enterium-developer-docs.pages.dev/developers/llms.txt — every page of this portal has a Markdown twin at <route>.md; the frozen API contract is at https://enterium-developer-docs.pages.dev/developers/api/openapi.json.

Платформа фиксирует изменения на четырёх независимых поверхностях. Какая
нужна тебе — зависит от того, что ты потребляешь.

## 1. Capability-changelog агентской поверхности (обязателен агентам)

Агентская read-поверхность (API + MCP) несёт собственную версию — она
видна как `serverInfo.version` при MCP-подключении и эхом в туле
`start_here`. Отличается от закэшированной — поверхность изменилась.

- **Как потреблять:** передай кэшированное значение как
  `last_seen_version` в `start_here`; поле `whats_new` перечислит ровно
  те записи, которые ты ещё не принял. Полная история — MCP-ресурс
  `changelog://entherium`.
- **Контракт:** записи структурированы (`added` / `changed` /
  `deprecated`), новые первыми, версии монотонные с якорем-датой.

## 2. Релиз-ноты модулей

Модули платформы (бэкенд, web UI, contracts, сервисы, этот портал)
версионируются по SemVer независимо, автоматически из истории коммитов.
Каждый модуль несёт свой `CHANGELOG.md` в репозитории; зонтичная версия
платформы отслеживает целое.

## 3. Версии пайплайнов

Collect / Generate / Localize версионируются отдельно в каталоге
пайплайнов — это намеренно другая ось, нежели релизы модулей (см.
[Жизненный цикл версий](../../pipelines/versioning/)). Обоснование новой
версии пайплайна записывается прямо в запись каталога.

## 4. Собственные content-хэши этого портала

Каждая сборка документации эмитит `manifest.json` — карту роут →
content-хэш по всем страницам. Агент, закэшировавший доку, сравнивает
свою карту с текущей и перечитывает только те роуты, у которых хэш
сдвинулся; остальное тянуть не нужно. См.
[For LLM agents](../../for-llm-agents/).

## Правило, которое держит changelog честным

Записи пишутся для **потребителей** («теперь ты можешь читать доску»,
«смысл этого поля изменился») — никогда как дайджест коммитов. Если
изменение не меняет того, что потребитель может сделать или наблюдать,
ему не место на поверхностях 1 и 4.