Приложение А. Термины

Приложение А. Шпаргалка по основным терминам

В этом приложении собраны все ключевые термины DeepSeek Harness, с которыми вы столкнулись в учебнике. Термины сгруппированы по темам и приведены с краткими определениями.

Базовые понятия

Термин	Что это
Agent (агент)	Главный исполнитель в DSH. Именно он получает вашу задачу, планирует шаги, вызывает инструменты и выдаёт результат.
Harness	«Упряжь» — среда исполнения, в которой работает агент. Формула DSH: Agent = Model + Harness.
Plugin (плагин)	Отдельный «кирпичик» способностей. В DSH всё — плагин: модель, инструменты, файловая система, даже веб-интерфейс.
Cordis	Движок, который управляет всеми плагинами. Отвечает за три вещи: композицию (сборку плагинов воедино), внедрение зависимостей и обратимость (возможность отключить плагин без перезапуска).
Context (контекст, `ctx`)	«Склад» сервисов, через который плагины общаются друг с другом. Плагин может «занять» место в контексте (например, `ctx.fs` — файловая система), а другой плагин — найти его по ключу и использовать.
Service (сервис)	Именованная способность, которую один плагин предоставляет, а другие — потребляют.
Event (событие)	Типизированный способ общения между плагинами: один плагин отправляет событие (`emit`), другие — подписываются и реагируют.
Effect (эффект)	Обратимая регистрация. Когда плагин регистрирует что-то через `ctx.effect()` или `ctx.on()`, при отключении плагина это автоматически откатывается.
Seam (стык)	«Сменная деталь» — способность, которую можно заменить без перестройки всего остального. Устроена из трёх частей: Service Definition (что это за способность), Provider (конкретная реализация) и Consumer (кто этой способностью пользуется). Классический пример: `dsh-shell` (определение), `dsh-bash-local` и `dsh-bash-sandbox` (реализации), `dsh-tool-bash` (потребитель).
Inject (инъекция)	Способ для плагина заявить: «Мне для работы нужен такой-то сервис». Пока этот сервис не появится, плагин не запустится.

Профили, сборка и запуск

Термин	Что это
Profile (профиль)	Полный «рецепт» запуска DSH. Это папка в `~/.dsh/profiles/`, в которой перечислено, какие Bundle загружать, какие плагины устанавливать и какие настройки применять. Разные профили = разное поведение агента.
Bundle (набор)	Готовый «набор» плагинов и настроек, который можно переиспользовать в разных профилях. Например, `dsh-base` — это ядро с LLM, агентом, сессией и инструментами; `dsh-web-app` добавляет веб-интерфейс.
Preset (пресет)	Настройка для одной сессии агента: какой набор инструментов, какая «личность» (persona), какие ограничения. В отличие от профиля, действует не на весь запуск, а только на конкретный диалог.
Patch	Способ изменить настройки без переписывания всего файла. Работает как «заплатка»: вы указываете ID элемента и новые параметры, и они накладываются поверх базовых.
$DSH_HOME	Главная папка DSH на вашем компьютере. По умолчанию — `~/.dsh`. Здесь хранятся все профили, плагины, настройки и логи.

Работа агента и сессии

Термин	Что это
Session (сессия)	Один непрерывный диалог с агентом. В рамках сессии агент помнит предыдущие сообщения и может выполнять несколько задач подряд.
Goal (цель)	Постоянная задача, привязанная к сессии. У цели есть статус: `active` (выполняется), `paused` (приостановлена), `blocked` (заблокирована) или `complete` (завершена). Агент может автоматически продолжать работу над целью до её завершения.
Turn / Step (ход / шаг)	Step — один запрос к модели и все вызванные им инструменты. Turn — полный цикл обработки одного сообщения пользователя, который может состоять из нескольких шагов.
Scope (область видимости)	Единица регистрации для одного агента. Инструменты и настройки могут быть глобальными (видны всем агентам) или scoped (принадлежат только одному агенту).
Shadowing (затенение)	Механизм, при котором scoped-инструмент «перекрывает» глобальный с тем же именем, но только для этого конкретного агента. Как локальная переменная в программировании.
Subagent (суб-агент)	Дочерний агент, которому можно делегировать часть задачи. Он выполняется в отдельной области видимости и возвращает результат родителю.
Trajectory (траектория)	Полный журнал всех действий агента: каждый запрос к модели, каждый вызов инструмента, каждая ошибка. Главный инструмент отладки.

Git и GitHub

Термин	Что это
Branch (ветка)	Отдельная линия изменений в репозитории. Новые правки обычно делают в `feature/…`, а не сразу в `main`.
Commit (коммит)	Сохранённый снимок изменений с сообщением «зачем это сделали».
Push	Отправка ваших коммитов с компьютера (или сервера) на GitHub.
Pull	Забрать свежие коммиты с GitHub к себе (на ПК или на сервер).
PR (Pull Request, запрос на слияние)	Предложение влить изменения из вашей ветки в другую (обычно в `main`). На GitHub можно посмотреть diff, обсудить правки и нажать merge (принять) или отклонить. Пока PR не принят, `main` не меняется.

Режимы работы

Термин	Что это
Standard	Полный набор инструментов. Режим по умолчанию для большинства задач.
PTC (Programmatic Tool Calling)	То же, что часто называют Code Mode: модель оркестрирует tools через программу/SDK. На длинных задачах может снизить число раундов; не гарантия экономии.
Minimal	Узкий набор (bash + редактор). Для бенчмарков моделей, не для маркетолога.
Creator	Пресет для инспекции runtime и экспериментов с плагинами/пресетами. Не «творческий копирайтинг».
Headless	Запуск без веб-интерфейса — для серверов, CI/CD и скриптов.
DSH_TOOLS_MODE	Env: `native` / `code` / `both` — временный переключатель представления tools на уровне процесса.

Безопасность и данные

Термин	Что это
Sandbox mode (режим песочницы)	Три уровня доступа к файлам: `read-only` (только читать), `workspace-write` (читать и менять только в рабочей папке), `danger-full-access` (полный доступ). Для маркетолога — всегда `workspace-write`.
Credentials (учётные данные)	API-ключи, пароли и токены. Хранятся отдельно от кода, в файле `.credentials.yaml`, чтобы случайно не «засветить» их в репозитории.
AGENTS.md	Файл с инструкциями для агента прямо в корне вашего проекта. Агент читает его при старте и учитывает как долгосрочные правила.
Restriction (ограничение)	Способ отфильтровать инструменты для одного агента: какие можно использовать, какие — нет.
Lineage (родословная)	Данные о том, кто создал текущего агента: ID родительской сессии, глубина делегирования и т.д. Используется для отслеживания цепочек вызовов, но не влияет на видимость инструментов.

Инструменты и расширения

Термин	Что это
MCP (Model Context Protocol)	Стандартный протокол для подключения внешних инструментов к модели. Позволяет подключать всё, что угодно, через единый интерфейс.
Skill (навык)	Готовый шаблон действий, который агент может выполнить по команде. Определяется в файле `SKILL.md` с инструкциями.
Compaction (сжатие, уплотнение)	Когда сессия становится слишком длинной, DSH автоматически «сжимает» ранние сообщения в краткое резюме, чтобы не выходить за лимит токенов.

Памятка для быстрого поиска

Если вы встретили...	...это про
`ctx`	Контекст — общая шина, через которую общаются плагины
`cordis.patch.yml`	Файл ваших личных настроек для профиля
`dsh plugin add`	Команда для установки плагина
`dsh web` / `dsh --profile`	Запуск DSH в веб-интерфейсе или с конкретным профилем
`max_steps` / `max_tokens`	Лимиты в профиле — защита от бесконечных циклов и больших счетов
`--dump-config`	Команда, которая показывает все настройки вашего профиля
`allowBuilds`	Разрешение на выполнение скриптов при установке GitHub-плагина
`dsh-github` + `dsh-github-connect`	Связка для GitHub: ядро/tools + кнопка OAuth в UI (см. гл. 4)
`dsh-ssh`	Плагин доступа к серверу по SSH (см. гл. 5)
PR	Pull Request — запрос на слияние ветки в `main` (или другую ветку) на GitHub

Полная версия официального глоссария DSH доступна в репозитории DeepSeek: docs/glossary.md.