Память

Каждый сеанс Qwen Code начинается с чистого контекстного окна. Два механизма переносят знания между сеансами, чтобы вам не приходилось каждый раз объяснять всё заново:

• QWEN.md — инструкции, которые вы пишете один раз, а Qwen читает в каждом сеансе
• Auto-memory — заметки, которые Qwen создаёт самостоятельно на основе того, что узнаёт от вас

QWEN.md: ваши инструкции для Qwen

QWEN.md — это обычный текстовый файл, где вы записываете информацию о проекте или свои предпочтения, которые Qwen должен знать всегда. Считайте это постоянным брифингом, который загружается в начале каждого разговора.

Что добавить в QWEN.md

Добавляйте то, что иначе пришлось бы повторять в каждом сеансе:

• Команды сборки и тестирования (npm run test, make build)
• Соглашения по написанию кода, принятые в вашей команде («все новые файлы должны содержать комментарии JSDoc»)
• Архитектурные решения («мы используем паттерн Repository, никогда не вызываем базу данных напрямую из контроллеров»)
• Личные предпочтения («всегда используй pnpm, а не npm`)

Не включайте то, что Qwen может понять, прочитав ваш код. QWEN.md работает лучше всего, когда он короткий и конкретный: чем он длиннее, тем менее надёжно Qwen его соблюдает.

Где создать QWEN.md

Вы можете использовать оба варианта. При запуске сеанса Qwen загружает все найденные файлы QWEN.md — ваш личный и все файлы в проекте.

Если в вашем репозитории уже есть файл AGENTS.md для других ИИ-инструментов, Qwen прочитает и его. Дублировать инструкции не нужно.

Автоматическая генерация с помощью /init

Выполните /init, и Qwen проанализирует вашу кодовую базу, чтобы создать стартовый QWEN.md с командами сборки, инструкциями по тестированию и найденными соглашениями. Если файл уже существует, Qwen предложит дополнения вместо перезаписи.

Ссылки на другие файлы

Вы можете указать в QWEN.md на другие файлы, чтобы Qwen прочитал и их:

See @README.md for project overview.
 
# Conventions
 
- Git workflow: @docs/git-workflow.md

Используйте @path/to/file в любом месте QWEN.md. Относительные пути разрешаются относительно самого файла QWEN.md.

Auto-memory: что Qwen узнаёт о вас

Auto-memory работает в фоновом режиме. После каждого разговора Qwen незаметно сохраняет полезную информацию, которую узнал: ваши предпочтения, оставленные вами отзывы, контекст проекта — чтобы использовать её в будущих сеансах без необходимости повторять всё заново.

Это отличается от QWEN.md: вы его не пишете, это делает Qwen.

Что сохраняет Qwen

Qwen ищет четыре типа информации, которые стоит запомнить:

Qwen сохраняет не всё — только то, что действительно пригодится в следующий раз.

Где это хранится

Файлы Auto-memory находятся в ~/.qwen/projects/<project>/memory/. Все ветки и worktrees одного репозитория используют одну папку памяти, поэтому информация, которую Qwen узнал в одной ветке, доступна и в других.

Всё сохранённое хранится в формате обычного Markdown — вы можете открыть, отредактировать или удалить любой файл в любое время.

Периодическая очистка

Qwen периодически просматривает сохранённые воспоминания, чтобы удалить дубликаты и очистить устаревшие записи. Этот процесс запускается автоматически в фоновом режиме раз в день после накопления достаточного количества сеансов. Вы можете запустить его вручную с помощью /dream, если нужно выполнить очистку прямо сейчас.

Пока идёт очистка, в углу экрана появляется ✦ dreaming. Ваш сеанс продолжается в обычном режиме.

Включение и отключение

Auto-memory включён по умолчанию. Чтобы переключить его, откройте /memory и используйте переключатели вверху. Вы можете отключить только автоматическое сохранение, только периодическую очистку или оба параметра.

Вы также можете настроить их в ~/.qwen/settings.json (применяется ко всем проектам) или .qwen/settings.json (только для текущего проекта):

{
  "memory": {
    "enableManagedAutoMemory": true,
    "enableManagedAutoDream": true
  }
}

Команды

/memory

Открывает панель Memory. Отсюда вы можете:

• Включить или отключить сохранение auto-memory
• Включить или отключить периодическую очистку (dream)
• Открыть ваш личный QWEN.md (~/.qwen/QWEN.md)
• Открыть QWEN.md проекта
• Просмотреть папку auto-memory

/init

Генерирует стартовый QWEN.md для вашего проекта. Qwen анализирует кодовую базу и заполняет команды сборки, инструкции по тестированию и обнаруженные соглашения.

/remember <text>

Немедленно сохраняет информацию в auto-memory, не дожидаясь автоматического обнаружения Qwen:

/remember always use snake_case for Python variable names
/remember the staging environment is at staging.example.com

/forget <text>

Удаляет записи auto-memory, соответствующие вашему описанию:

/forget old workaround for the login bug

/dream

Запускает очистку памяти прямо сейчас, не дожидаясь автоматического расписания:

/dream

Устранение неполадок

Qwen не следует моему QWEN.md

Откройте /memory, чтобы увидеть, какие файлы загружены. Если вашего файла нет в списке, Qwen его не видит — убедитесь, что он находится в корне проекта или в ~/.qwen/.

Инструкции работают лучше, когда они конкретны:

• ✓ Используй отступы в 2 пробела для файлов TypeScript
• ✗ Форматируй код красиво

Если у вас несколько файлов QWEN.md с противоречивыми инструкциями, поведение Qwen может быть нестабильным. Проверьте их и устраните все противоречия.

Я хочу посмотреть, что сохранил Qwen

Выполните /memory и выберите Open auto-memory folder. Все сохранённые воспоминания — это читаемые Markdown-файлы, которые можно просматривать, редактировать или удалять.

Qwen постоянно забывает информацию

Если auto-memory включён, но Qwen не запоминает информацию между сеансами, попробуйте выполнить /dream, чтобы принудительно запустить очистку. Также проверьте /memory, чтобы убедиться, что оба переключателя включены.

Для информации, которую Qwen должен запоминать всегда, добавляйте её в QWEN.md — auto-memory работает по принципу best-effort, а QWEN.md гарантирует выполнение.