# Глоссарий DSH → русский

Единый источник терминологии для пакета `dsh-locale-ru`. Перевод **обязан** следовать таблице; линтер проверяет запрещённые варианты.

Правила чтения:

- **Термин** — английский оригинал, **Перевод** — как писать в интерфейсе.
- **Не переводить как** — запрещённые варианты (проверяются линтером).
- Регистр подсказывает форма: строчная — внутри фразы, с заглавной — самостоятельная подпись кнопки/заголовка.

## Продукт и платформа

| Термин | Перевод | Не переводить как | Заметки |
|---|---|---|---|
| DeepSeek Harness | DeepSeek Harness | Харнесс, DeepSeek Харнесс | Название продукта не переводится |
| Harness | Harness | харнесс, обвязка, каркас | В интерфейсе практически не встречается вне названия |
| agent | агент | ИИ-агент | |
| subagent | субагент | под-агент, вложенный агент | |
| agent loop | цикл агента | петля агента | |
| skill | навык | скилл, умение | |
| plugin | плагин | модуль, расширение | ⚠️ «extension» ниже — другой термин |
| extension | расширение | плагин | Только когда исходно `extension` |
| tool | инструмент | тул, утилита | |
| MCP | MCP | МСР | Аббревиатура не переводится |
| SDK / API / CLI / JSON / JSONL / HMR | без изменений | — | Аббревиатуры сохраняются |
| Cordis | Cordis | Кордис | |
| Typert | Typert | Типерт | |

## Сессии и работа агента

| Термин | Перевод | Не переводить как | Заметки |
|---|---|---|---|
| session | сессия | беседа, чат | |
| conversation | диалог | беседа, разговор | ⚠️ не «сессия» |
| chat | чат | беседа | |
| message | сообщение | письмо | |
| turn | ход | раунд, оборот, турн | Один цикл «запрос → ответ» |
| step | шаг | этап | Отдельный шаг внутри хода |
| tool call | вызов инструмента | тул-колл | |
| tool result | результат инструмента | — | |
| prompt | промпт | подсказка, запрос | `системный промпт` — system prompt |
| system prompt | системный промпт | системная подсказка | |
| reasoning | рассуждения | размышления, мысли | |
| reasoning effort | глубина рассуждений | усилие рассуждений | |
| token | токен | — | `расход токенов` — token usage |
| context | контекст | — | |
| compaction / compact | сжатие контекста | компактификация, уплотнение | Команда: `Сжать` |
| transcript | стенограмма | транскрипт | Лента диалога |
| trajectory | траектория | трек, путь | |
| checkpoint | контрольная точка | чекпойнт | |
| snapshot | снимок | снапшот | |
| retry | повтор | ретрай | Кнопка: `Повторить` |
| resume | продолжить | возобновить, резюмировать | |
| fork (session) | ответвление | форк | Кнопка: `Ответвить` |
| queue | очередь | — | `в очереди` |
| stream | поток | стрим | `потоковая выдача` |
| history | история | — | |
| session log | журнал сессии | лог сессии, протокол | |
| snapshot / replay | воспроизведение | реплей | Только глагол replay |
| background job | фоновая задача | бэкграунд-джоб | |
| goal | цель | — | |
| plan (режим) | план | — | `режим планирования` — plan mode |
| todo | список задач | тудушка | |
| schedule | расписание | шедулер | Элемент: `напоминание` |
| reminder | напоминание | — | |
| workflow | рабочий процесс | воркфлоу, процесс-воркфлоу | |
| deliverable | результат | деливерабл, поставка | Панель результатов хода |
| attachment | вложение | аттач | |
| reference | ссылка | референс | Ссылка на файл в промпте |
| review | проверка | ревью, обзор | `на проверке` |
| diff | изменения | дифф | |
| feedback | отзыв | фидбек, обратная связь | |

## Рабочая область и файлы

| Термин | Перевод | Не переводить как | Заметки |
|---|---|---|---|
| workspace | рабочая область | рабочее пространство, воркспейс | ⚠️ строго единообразно |
| directory | каталог | директория | ⚠️ не «папка» |
| folder | папка | каталог | Только когда исходно `folder` |
| file | файл | — | |
| path | путь | — | |
| root | корень | рут | `корень рабочей области` |
| branch | ветка | бранч | |
| worktree | рабочее дерево | ворктри | |
| repository / repo | репозиторий | репа | |
| commit | коммит | — | |
| merge | слияние | мерж | |
| sandbox | песочница | сандбокс | `в песочнице` |
| shell | оболочка | шелл | |
| terminal | терминал | — | |
| Bash / PowerShell | Bash / PowerShell | Баш | Названия оболочек не переводятся |
| file change | изменение файла | правка файла | |

## Доступ и безопасность

| Термин | Перевод | Не переводить как | Заметки |
|---|---|---|---|
| permission | разрешение | пермишн, право доступа | |
| approval | подтверждение | апрув, одобрение | `запрос подтверждения` |
| permission preset | набор разрешений | пресет разрешений | |
| agent preset | пресет агента | набор агента | ⚠️ «preset» вне разрешений — «пресет» |
| read-only | только чтение | только для чтения, ридонли | Название режима |
| workspace write | запись в рабочей области | — | Название режима |
| full access | полный доступ | фулл-аксесс | Название режима |
| credential | учётные данные | креды | |
| API key | ключ API | апи-ключ | |
| account | учётная запись | аккаунт | |
| sign in | вход | логин, войти в систему | `Войти` — кнопка |

## Интерфейс

| Термин | Перевод | Не переводить как | Заметки |
|---|---|---|---|
| settings | настройки | параметры, сеттинги | |
| plugin inventory | состав плагинов | инвентарь плагинов | |
| model provider | провайдер модели | поставщик модели | |
| model selection | выбор модели | селект модели | |
| server | сервер | — | |
| client | клиент | — | |
| toast | уведомление | тост | |
| tooltip | подсказка | тултип | |
| placeholder | подсказка | плейсхолдер | Если это текст-заполнитель ввода |
| dialog | окно | диалог, модалка | ⚠️ «диалог» занято conversation |
| panel | панель | — | |
| tab | вкладка | таб | |
| scroll | прокрутка | скролл | |
| zoom | масштаб | зум | |
| font size | размер шрифта | — | |
| theme | тема | — | light / dark / system → `светлая` / `тёмная` / `системная` |
| warning | предупреждение | варнинг | |
| error | ошибка | — | |
| enable / disable | включить / выключить | активировать, задизейблить | |
| default | по умолчанию | дефолтный | |
| custom | свой | кастомный | `свой пресет` |
| advanced | дополнительные | продвинутые, расширенные | Заголовок раздела настроек |
| copy | копировать | — | |
| download / upload | скачать / загрузить | выгрузить | `download` ≠ «выгрузить» |
| export / import | экспорт / импорт | — | |

## Чего не делаем

- Не переводим имена собственные, идентификаторы, названия плагинов, инструментов, команд, флагов, файлов и путей.
- Не переводим аббревиатуры из первой таблицы.
- Не добавляем вежливое «Пожалуйста» там, где его нет в оригинале.
- Не превращаем короткие подписи в предложения.

## Уточнения после вычитки

Эти решения приняты при рецензировании перевода и обязательны для новых строк.

| Термин | Перевод | Не переводить как | Заметки |
|---|---|---|---|
| Host | Хост | сервер, бэкенд, хост-процесс | В оригинале это сущность с заглавной буквы — процесс-хост DSH |
| deployment | развёртывание | установка, инсталляция | «Установка» закреплена за установкой плагина |
| install (плагина) | установка | развёртывание | |
| bundle (плагинный) | набор | бандл, пакет | «Набор разрешений» — permission preset, контекст различает |
| secret | секрет | пароль, ключ | `Show secret` → `Показать секрет` |
| relay | ретранслятор | релей, прокси | |
| carrier | механизм встраивания | носитель, карьер | Только про способ доставки UI |
| with your permissions | от вашего имени | с вашими разрешениями | Про действия агента от лица пользователя |
| Show more | Показать ещё | Развернуть | «Развернуть» — expand, для одного элемента списка |
| Failed to load | Не удалось загрузить | Не загрузился | В бейджах состояния допустимо «Не загрузился» |
| Command line {n} | Строка команды {n} | {n}-я строка команды | Единая форма для всех namespace |
| Access mode, current: {name} | Текущий режим доступа: {name} | Режим доступа, текущий: {name} | |
| Reload | Перезагрузить / Обновить / Перечитать | — | Модель — «Перезагрузить», список файлов — «Обновить», документ — «Перечитать» |
| EXP | EXP | Опытный, эксперимент | Бейдж экспериментальных плагинов остаётся токеном |

## Метаданные плагинов

Описания и названия пакетов-плагинов приходят из их `package.json` как `LocalizedText` и попадают в интерфейс через `LocaleRuntime.resolveText`. Пакет переводит их отдельной таблицей (`dictionary/plugin-meta.json`, ключ — английский текст), поэтому:

| Термин | Перевод | Заметки |
|---|---|---|
| capability seam | шов возможностей | Архитектурный термин проекта; «<x> seam (ctx.y)» → «шов <x> (ctx.y)» |
| read-only (в прозе) | только для чтения | В названии режима разрешений остаётся «Только чтение» |
| composer | поле ввода | Не «композер» |
| custom ( markets ) | пользовательские | Исключение из «свой» — только для «custom plugin markets» |
| spill storage | хранилище переполнения | Глагол spill — «сбрасывается во временный файл» |
| occupant | заполнитель | Занимающий слот плагин |
| facet | фасет | |

### Короткие подписи в тесных контейнерах

Названия карточек пресетов и бейдж «основной пресет» делят строку с бейджем и идентификатором, поэтому на Linux (шрифтовые метрики шире) длинные формы обрезаются. Закреплены короткие варианты:

| Английский | Русский | Почему не длиннее |
|---|---|---|
| Standard mode | Стандарт | контейнер ~81 px |
| Minimal mode | Минимум | делит строку с идентификатором `minimal` |
| Creator mode | Создание | делит строку с идентификатором `cordis` |
| PTC mode | Режим PTC | помещается |
| New task default | Основной | бейдж отнимает место у названия |