Конфигурация Qwen Code

Уровни конфигурации

Конфигурация применяется в следующем порядке приоритета (нижние номера переопределяются более высокими):

Файлы настроек

Qwen Code использует JSON-файлы настроек для постоянной конфигурации. Существует четыре места для этих файлов:

Каталог .qwen в вашем проекте

В дополнение к файлу настроек проекта, каталог .qwen проекта может содержать другие файлы, специфичные для проекта и связанные с работой Qwen Code, например:

• Пользовательские профили песочницы (например, .qwen/sandbox-macos-custom.sb, .qwen/sandbox.Dockerfile).
• Навыки агента (экспериментальные) в .qwen/skills/ (каждый навык — это каталог, содержащий SKILL.md).

Доступные настройки в settings.json

Настройки организованы по категориям. Все настройки должны быть размещены в соответствующем объекте категории верхнего уровня в вашем файле settings.json.

general

output

ui

ide

privacy

model

Пример model.generationConfig:

{
  "model": {
    "generationConfig": {
      "timeout": 60000,
      "disableCacheControl": false,
      "samplingParams": {
        "temperature": 0.2,
        "top_p": 0.8,
        "max_tokens": 1024
      }
    }
  }
}

Примеры model.openAILoggingDir:

• "~/qwen-logs" - Логи в каталог ~/qwen-logs
• "./custom-logs" - Логи в ./custom-logs относительно текущего каталога
• "/tmp/openai-logs" - Логи в абсолютный путь /tmp/openai-logs

context

Устранение неполадок производительности поиска файлов

Если вы сталкиваетесь с проблемами производительности при поиске файлов (например, при автозаполнении с помощью @), особенно в проектах с очень большим количеством файлов, вот несколько вещей, которые вы можете попробовать в порядке рекомендации:

1. Используйте .qwenignore: Создайте файл .qwenignore в корне вашего проекта, чтобы исключить каталоги, содержащие большое количество файлов, на которые вам не нужно ссылаться (например, артефакты сборки, логи, node_modules). Снижение общего количества файлов, которые просматриваются, является наиболее эффективным способом улучшения производительности.
2. Отключите нечеткий поиск: Если игнорирование файлов не помогает, вы можете отключить нечеткий поиск, установив для параметра disableFuzzySearch значение true в вашем файле settings.json. Это будет использовать более простой, нечеткий алгоритм сопоставления, который может быть быстрее.
3. Отключите рекурсивный поиск файлов: В крайнем случае, вы можете полностью отключить рекурсивный поиск файлов, установив для параметра enableRecursiveFileSearch значение false. Это будет самой быстрой опцией, так как она избегает рекурсивного обхода вашего проекта. Однако это означает, что вам нужно будет вводить полный путь к файлам при использовании автозаполнения с помощью @.

tools

mcp

security

advanced

mcpServers

Настраивает подключения к одному или нескольким серверам Model-Context Protocol (MCP) для обнаружения и использования пользовательских инструментов. Qwen Code пытается подключиться к каждому настроенному серверу MCP для обнаружения доступных инструментов. Если несколько серверов MCP предоставляют инструмент с одинаковым именем, имена инструментов будут дополнены префиксом псевдонима сервера, который вы определили в конфигурации (например, serverAlias__actualToolName), чтобы избежать конфликтов. Обратите внимание, что система может исключить определенные свойства схемы из определений инструментов MCP для обеспечения совместимости. Должно быть указано хотя бы одно из значений: command, url или httpUrl. Если указано несколько значений, порядок приоритета следующий: httpUrl, затем url, затем command.

telemetry

Настройка логирования и сбора метрик для Qwen Code. Дополнительную информацию см. в разделе телеметрия.

Пример settings.json

Вот пример файла settings.json с вложенной структурой, новой с версии v0.3.0:

{
  "general": {
    "vimMode": true,
    "preferredEditor": "code"
  },
  "ui": {
    "theme": "GitHub",
    "hideBanner": true,
    "hideTips": false,
    "customWittyPhrases": [
      "You forget a thousand things every day. Make sure this is one of 'em",
      "Connecting to AGI"
    ]
  },
  "tools": {
    "approvalMode": "yolo",
    "sandbox": "docker",
    "discoveryCommand": "bin/get_tools",
    "callCommand": "bin/call_tool",
    "exclude": ["write_file"]
  },
  "mcpServers": {
    "mainServer": {
      "command": "bin/mcp_server.py"
    },
    "anotherServer": {
      "command": "node",
      "args": ["mcp_server.js", "--verbose"]
    }
  },
  "telemetry": {
    "enabled": true,
    "target": "local",
    "otlpEndpoint": "http://localhost:4317",
    "logPrompts": true
  },
  "privacy": {
    "usageStatisticsEnabled": true
  },
  "model": {
    "name": "qwen3-coder-plus",
    "maxSessionTurns": 10,
    "enableOpenAILogging": false,
    "openAILoggingDir": "~/qwen-logs",
    "summarizeToolOutput": {
      "run_shell_command": {
        "tokenBudget": 100
      }
    }
  },
  "context": {
    "fileName": ["CONTEXT.md", "QWEN.md"],
    "includeDirectories": ["path/to/dir1", "~/path/to/dir2", "../path/to/dir3"],
    "loadFromIncludeDirectories": true,
    "fileFiltering": {
      "respectGitIgnore": false
    }
  },
  "advanced": {
    "excludedEnvVars": ["DEBUG", "DEBUG_MODE", "NODE_ENV"]
  }
}

История командной строки

CLI сохраняет историю команд, которые вы запускаете. Чтобы избежать конфликтов между различными проектами, эта история хранится в каталоге, специфичном для проекта, внутри домашней папки пользователя.

• Расположение: ~/.qwen/tmp/<project_hash>/shell_history
  • <project_hash> — уникальный идентификатор, генерируемый из корневого пути вашего проекта.
  • История хранится в файле с именем shell_history.

Переменные окружения и файлы .env

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

Qwen Code может автоматически загружать переменные окружения из файлов .env. Для переменных, связанных с аутентификацией (например, OPENAI_*) и рекомендуемого подхода с .qwen/.env, см. Аутентификация.

Таблица переменных окружения

Аргументы командной строки

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

Таблица аргументов командной строки

Файлы контекста (иерархический инструктажный контекст)

Хотя файлы контекста (по умолчанию QWEN.md, но настраиваемые через параметр context.fileName) и не являются строго настройками поведения CLI, они важны для настройки инструктажного контекста (также называемого “памятью”). Эта мощная функция позволяет задавать проектные инструкции, руководства по стилю кодирования или любую другую актуальную информацию для ИИ, делая его ответы более персонализированными и точными в соответствии с вашими потребностями. CLI включает элементы пользовательского интерфейса, такие как индикатор в нижнем колонтитуле, показывающий количество загруженных файлов контекста, чтобы держать вас в курсе активного контекста.

• Назначение: Эти файлы Markdown содержат инструкции, рекомендации или контекст, которые вы хотите, чтобы модель Qwen учитывала во время ваших взаимодействий. Система разработана для иерархического управления этим инструктажным контекстом.

Пример содержимого файла контекста (например, QWEN.md)

Вот концептуальный пример того, что может содержаться в файле контекста в корне проекта TypeScript:

# Проект: Моя потрясающая библиотека TypeScript

## Общие инструкции:
- При генерации нового кода TypeScript, пожалуйста, следуйте существующему стилю кодирования.
- Убедитесь, что все новые функции и классы имеют комментарии JSDoc.
- По возможности отдавайте предпочтение парадигмам функционального программирования.
- Весь код должен быть совместим с TypeScript 5.0 и Node.js 20+.

## Стиль кодирования:
- Используйте 2 пробела для отступов.
- Имена интерфейсов должны начинаться с `I` (например, `IUserService`).
- Закрытые члены класса должны начинаться с подчеркивания (`_`).
- Всегда используйте строгое равенство (`===` и `!==`).

## Конкретный компонент: `src/api/client.ts`
- Этот файл обрабатывает все исходящие API-запросы.
- При добавлении новых функций вызова API убедитесь, что они включают надежную обработку ошибок и ведение журнала.
- Используйте существующую утилиту `fetchWithRetry` для всех GET-запросов.

Что касается зависимостей:

• Избегайте введения новых внешних зависимостей, если это не является абсолютно необходимым.
• Если новая зависимость требуется, пожалуйста, укажите причину.

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

- **Иерархическая загрузка и приоритеты:** CLI реализует сложную иерархическую систему памяти, загружая файлы контекста (например, `QWEN.md`) из нескольких мест. Содержимое файлов, находящихся ниже в этом списке (более специфичных), как правило, переопределяет или дополняет содержимое файлов, находящихся выше (более общих). Точный порядок объединения и окончательный контекст можно проверить с помощью команды `/memory show`. Обычный порядок загрузки следующий:
  1. **Глобальный файл контекста:**
     - Расположение: `~/.qwen/<configured-context-filename>` (например, `~/.qwen/QWEN.md` в вашей домашней директории пользователя).
     - Область действия: Предоставляет инструкции по умолчанию для всех ваших проектов.
  2. **Файлы контекста корня проекта и родительских каталогов:**
     - Расположение: CLI ищет настроенный файл контекста в текущем рабочем каталоге, а затем в каждом родительском каталоге вплоть до корня проекта (определяемого по папке `.git`) или вашей домашней директории.
     - Область действия: Предоставляет контекст, относящийся ко всему проекту или значительной его части.
  3. **Файлы контекста подкаталогов (контекстуальные/локальные):**
     - Расположение: CLI также сканирует на наличие настроенного файла контекста подкаталоги _ниже_ текущего рабочего каталога (с учетом общих шаблонов игнорирования, таких как `node_modules`, `.git` и т.д.). Ширина этого поиска по умолчанию ограничена 200 каталогами, но может быть настроена с помощью параметра `context.discoveryMaxDirs` в вашем файле `settings.json`.
     - Область действия: Позволяет задавать очень специфичные инструкции, относящиеся к конкретному компоненту, модулю или подразделу вашего проекта.
- **Объединение и индикация в интерфейсе:** Содержимое всех найденных файлов контекста объединяется (с разделителями, указывающими их происхождение и путь) и предоставляется как часть системного запроса. В нижнем колонтитуле CLI отображается количество загруженных файлов контекста, давая вам быструю визуальную подсказку об активном инструкциональном контексте.
- **Импорт содержимого:** Вы можете модуляризировать свои файлы контекста, импортируя другие файлы Markdown с помощью синтаксиса `@path/to/file.md`. Более подробную информацию см. в [документации процессора импорта памяти](../configuration/memory).
- **Команды для управления памятью:**
  - Используйте `/memory refresh`, чтобы принудительно повторно просканировать и перезагрузить все файлы контекста из всех настроенных мест. Это обновляет инструкциональный контекст ИИ.
  - Используйте `/memory show`, чтобы отобразить объединенный инструкциональный контекст, который в данный момент загружен, позволяя вам проверить иерархию и содержимое, используемое ИИ.
  - Полные сведения о команде `/memory` и ее подкомандах (`show` и `refresh`) см. в [документации по командам](../features/commands).

Понимая и используя эти уровни конфигурации и иерархическую природу файлов контекста, вы можете эффективно управлять памятью ИИ и адаптировать ответы Qwen Code к вашим конкретным потребностям и проектам.

## Песочница

Qwen Code может выполнять потенциально небезопасные операции (например, команды оболочки и изменения файлов) в изолированной среде, чтобы защитить вашу систему.

[Песочница](../features/sandbox) отключена по умолчанию, но вы можете включить её несколькими способами:

- Используя флаг `--sandbox` или `-s`.
- Установив переменную окружения `GEMINI_SANDBOX`.
- Песочница включена по умолчанию при использовании `--yolo` или `--approval-mode=yolo`.

По умолчанию используется предварительно собранный Docker-образ `qwen-code-sandbox`.

Для проектов с особыми требованиями к изоляции вы можете создать пользовательский Dockerfile в файле `.qwen/sandbox.Dockerfile` в корневом каталоге вашего проекта. Этот Dockerfile может быть основан на базовом образе песочницы:

FROM qwen-code-sandbox

Добавьте сюда свои пользовательские зависимости или конфигурации

Например:

RUN apt-get update && apt-get install -y some-package

# COPY ./my-config /app/my-config

Когда существует .qwen/sandbox.Dockerfile, вы можете использовать переменную окружения BUILD_SANDBOX при запуске Qwen Code для автоматического создания пользовательского образа песочницы:

BUILD_SANDBOX=1 qwen -s

Статистика использования

Чтобы помочь нам улучшить Qwen Code, мы собираем анонимную статистику использования. Эти данные помогают нам понять, как используется CLI, выявить распространенные проблемы и определить приоритеты новых функций.

Что мы собираем:

• Вызовы инструментов: Мы регистрируем названия вызываемых инструментов, успешность их выполнения и время выполнения. Мы не собираем аргументы, переданные инструментам, или какие-либо данные, возвращаемые ими.
• Запросы к API: Мы регистрируем модель, использованную для каждого запроса, продолжительность запроса и его успешность. Мы не собираем содержимое запросов или ответов.
• Информация о сессии: Мы собираем информацию о конфигурации CLI, например, включенные инструменты и режим подтверждения.

Что мы НЕ собираем:

• Персонально идентифицируемую информацию (PII): Мы не собираем никакой личной информации, такой как ваше имя, адрес электронной почты или ключи API.
• Содержимое запросов и ответов: Мы не регистрируем содержимое ваших запросов или ответы модели.
• Содержимое файлов: Мы не регистрируем содержимое любых файлов, которые читаются или записываются CLI.

Как отказаться:

Вы можете отказаться от сбора статистики использования в любое время, установив свойство usageStatisticsEnabled в значение false в категории privacy в вашем файле settings.json:

{
  "privacy": {
    "usageStatisticsEnabled": false
  }
}