Skip to content

CLI

news-recap управляется через CLI-команды, сгруппированные по этапам работы.

Карта Команд

  • ingest: один цикл ingestion из RSS/Atom источников.
  • create: создать дайджест новостей из последних статей.
  • prompt: экспорт LLM-промпта из последних статей.
  • info: показать важные пути приложения.
  • list: показать завершённые дайджесты и непокрытые периоды.
  • delete: удалить дайджест, чтобы его статьи стали доступны для следующего.
  • serve: запуск веб-просмотрщика дайджестов.
  • configure: просмотр и редактирование пользовательских настроек.
  • schedule set: установить или обновить ежедневный автозапуск.
  • schedule get: показать текущую конфигурацию расписания.
  • schedule delete: удалить ежедневный автозапуск.

Общие Замечания

  • Каталог данных задаётся переменной NEWS_RECAP_DATA_DIR (по умолчанию ~/.news_recap_data).
  • Данные хранятся в JSON-файлах с ежедневным разбиением; старые партиции удаляются автоматически по значению NEWS_RECAP_GC_RETENTION_DAYS.

Ingestion

ingest

Один цикл ingestion из RSS/Atom источников.

news-recap ingest
news-recap ingest --rss https://example.com/feed.xml

Ключевые опции: - --rss (повторяемая)

Если --rss не указан, фиды берутся из: - NEWS_RECAP_RSS_FEED_URLS - NEWS_RECAP_RSS_FEED_URL

Команды пайплайна дайджеста

create

Создать дайджест новостей из последних статей.

Пайплайн проходит следующие этапы: classify → load_resources → enrich → deduplicate → oneshot_digest (параллельные батчи + детерминистический дедуп блоков + объединение секций) → refine_layout (опциональная консолидация секций).

Каждый этап чекпоинтится, поэтому повторный запуск пропускает уже выполненные этапы.

news-recap create
news-recap create --api
news-recap create --agent claude --stop-after classify
news-recap create --limit 50
news-recap create --from-digest 3

Ключевые опции: - --agent (codex, claude или gemini) - --limit (ограничить число загружаемых статей) - --max-days (максимум дней для выборки статей; по умолчанию 2, переменная NEWS_RECAP_DIGEST_LOOKBACK_DAYS) - --all (игнорировать предыдущие дайджесты; брать все статьи в пределах окна) - --api (использовать прямой Anthropic API вместо CLI-агентов) - --fresh (игнорировать незавершённый пайплайн и начать новый) - --from-digest N (использовать статьи из существующего дайджеста по ID, как показано в news-recap list; бизнес-дата берётся из исходного дайджеста) - --use-api-key (не удалять ключи API вендоров из окружения агента-подпроцесса; по умолчанию ключи удаляются, чтобы агент использовал лимиты подписки) - --stop-after (classify, load_resources, enrich, deduplicate, oneshot_digest, refine_layout)

info

Показать важные пути приложения: каталог данных, workdir, metadata расписания и логи.

news-recap info

list

Показать завершённые дайджесты с количеством статей, временным охватом и непокрытыми периодами (промежутки между дайджестами).

news-recap list

Вывод — таблица (от новых к старым) с колонками: числовой ID (#1 = самый новый), бизнес-дата, число статей, временной период статей, время запуска пайплайна, затраченное время, размер промптов, размер ответов и токены (если доступны). ID можно использовать с news-recap serve N или news-recap delete N.

Если между дайджестами есть временные промежутки не покрытые статьями, они показываются в разделе «Uncovered periods».

Старые каталоги пайплайнов автоматически удаляются (тот же срок хранения, что и у статей, управляется NEWS_RECAP_GC_RETENTION_DAYS).

delete

Удалить дайджест, чтобы его статьи стали доступны для следующего.

news-recap delete 1

Аргументы: - DIGEST_ID — ID дайджеста (как показано в news-recap list).

serve

Запуск веб-просмотрщика для конкретного дайджеста.

news-recap serve
news-recap serve 2

Аргументы: - DIGEST_ID (необязательный) — ID дайджеста (1 = самый новый, как показано в news-recap list). По умолчанию — последний завершённый дайджест.

Ключевые опции: - --host — хост для привязки (по умолчанию 127.0.0.1). - --port — порт для привязки (по умолчанию 8080).

configure

Просмотр и редактирование пользовательских настроек: язык, исключаемые темы, отслеживаемые темы и LLM-агент по умолчанию.

Настройки хранятся в config.json в каталоге данных (показывается командой news-recap info). Они используются как значения по умолчанию для команд create и prompt — флаги CLI по-прежнему имеют приоритет.

news-recap configure

Команда показывает текущие значения (с пометкой (default) для полей, которые ещё не были заданы), затем предлагает выбрать поля для обновления:

Current settings:
  1. Language:      ru (default)
  2. Exclude:       horoscopes, medical advice, sports (except Russia), ... (default)
  3. Follow:        Russia, Serbia, war in Ukraine (default)
  4. Default Agent: codex (default)

Select fields to update (comma-separated numbers, 'all', or Enter to skip):

Приоритет значений (от высшего к низшему):

  1. Флаги CLI (--language, --agent)
  2. Файл конфигурации (config.json)
  3. Значения по умолчанию в коде

API-режим

По умолчанию пайплайн дайджеста выполняет LLM-задачи через запуск CLI-агентов (codex, claude, gemini). API-режим заменяет вызовы подпроцессов прямыми вызовами через Anthropic SDK — CLI-агенты не нужны.

API-режим v1 поддерживает только Anthropic. Codex и Gemini работают только через CLI.

Быстрый старт

export ANTHROPIC_API_KEY=sk-ant-...
news-recap create --api

Флаг --api автоматически задаёт backend=api и agent=claude. Других переменных окружения не требуется.

Таблица моделей по задачам

По умолчанию все задачи используют claude-haiku-4-5-20251001. Для переопределения отдельных задач используйте NEWS_RECAP_API_MODEL_MAP (пары task_type=model_id через запятую):

export NEWS_RECAP_API_MODEL_MAP="recap_oneshot_digest=claude-sonnet-4-6,recap_classify=claude-haiku-4-5-20251001"

Переменные окружения API-режима

  • NEWS_RECAP_EXECUTION_BACKEND — cli (по умолчанию) или api.
  • NEWS_RECAP_API_MODEL_MAP — переопределения модели по задачам (task_type=model_id,...).
  • NEWS_RECAP_API_MAX_PARALLEL — начальный лимит параллелизма (по умолчанию 5). Автоматически снижается при ошибках rate-limit и восстанавливается после успешных вызовов.
  • NEWS_RECAP_API_TIMEOUT_SECONDS — таймаут одного вызова (по умолчанию 120).
  • NEWS_RECAP_API_CONCURRENCY_RECOVERY_SUCCESSES — число последовательных успехов для увеличения лимита параллелизма на 1 после снижения (по умолчанию 10).
  • NEWS_RECAP_API_RETRY_MAX_BACKOFF_SECONDS — потолок экспоненциальной задержки (по умолчанию 60).
  • NEWS_RECAP_API_RETRY_JITTER_SECONDS — равномерный джиттер для каждой задержки (по умолчанию 5).
  • NEWS_RECAP_API_DOWNSHIFT_PAUSE_SECONDS — дополнительная пауза после снижения лимита перед следующей попыткой захвата слота (по умолчанию 2).

Автозапуск

Подробная настройка, платформенные детали, логи и диагностика: Автозапуск.

Важные Переменные Окружения

Данные и хранение

  • NEWS_RECAP_DATA_DIR — корневой каталог для всех файлов данных (по умолчанию ~/.news_recap_data).
  • NEWS_RECAP_GC_RETENTION_DAYS — сколько дней хранить партиции статей (по умолчанию 7).
  • NEWS_RECAP_DIGEST_LOOKBACK_DAYS — максимум дней для выборки статей в дайджест (по умолчанию 2). По умолчанию окно начинается от даты последнего успешного дайджеста; --all отключает эту привязку.

RSS-фиды

  • NEWS_RECAP_RSS_FEED_URLS — список URL фидов через запятую.
  • NEWS_RECAP_RSS_FEED_URL — один URL фида (для удобства).
  • NEWS_RECAP_RSS_DEFAULT_ITEMS_PER_FEED — максимум элементов на фид.
  • NEWS_RECAP_RSS_FEED_ITEMS — переопределения числа элементов по фидам (<feed_url>|<items>,...).

LLM-агенты

Подписка vs API-биллинг. При запуске CLI-агентов (claude, codex, gemini) как подпроцессов news-recap create по умолчанию удаляет ключи API вендоров (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, GOOGLE_API_KEY) из окружения подпроцесса — чтобы агент использовал лимиты подписки, а не тарифицировал вызовы через API-аккаунт.

В режиме --api ключ API нужен SDK и не удаляется. Флаг --use-api-key в этом режиме не влияет на работу.

Чтобы явно передать ключ CLI-агенту (оплата за токены), используйте --use-api-key:

news-recap create --use-api-key
  • NEWS_RECAP_LLM_DEFAULT_AGENT — агент по умолчанию (codex, claude или gemini).
  • NEWS_RECAP_LLM_TASK_MODEL_MAP — переопределения модели по типу задачи и агенту (task_type:agent=model_flags,...).

Help

news-recap --help
news-recap ingest --help
news-recap create --help
news-recap prompt --help
news-recap info --help
news-recap list --help
news-recap delete --help
news-recap serve --help
news-recap configure --help
news-recap schedule --help
news-recap schedule set --help