Приложение Б. Команды CLI

Приложение Б. Шпаргалка по командам терминала (CLI)

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

Важное правило: флаги запуска (--profile, --patch и т.д.) всегда должны идти первыми. Всё, что после них, — это параметры самого приложения.

Запуск и основные команды

Команда	Что делает
`npx @deepseek-ai/dsh web`	Запускает веб-интерфейс (Web UI). Самый частый способ начать работу
`dsh web`	То же самое, если DSH уже установлен глобально
`dsh --profile <имя>`	Запускает указанный профиль (например, `dsh --profile мой_сайт`)
`dsh --profile headless "задача"`	Запускает агента в фоновом режиме для одной задачи. Печатает ответ и завершается
`dsh --profile acp`	Запускает профиль для автоматизации через ACP-протокол
`dsh --profile sdk`	Запускает профиль для работы через Python SDK по JSON-RPC
`dsh --help`	Показывает справку по командам самого запускатора
`dsh --profile web --help`	Показывает справку по параметрам веб-интерфейса

Управление плагинами

Команда	Что делает
`dsh plugin --profile <имя> add <пакет>`	Устанавливает плагин в указанный профиль
`dsh plugin --profile <имя> remove <пакет>`	Удаляет плагин из профиля
`dsh plugin --profile <имя> list`	Показывает список установленных плагинов
`dsh plugin --profile <имя> update`	Обновляет все плагины в профиле

Примеры:

dsh plugin --profile web add dsh-automation
dsh plugin --profile web add github:dmz2922990/dsh-ssh.git
dsh plugin --profile web list

Диагностика и отладка

Команда	Что делает
`dsh --dump-config`	Показывает итоговую конфигурацию после применения всех настроек
`dsh --dump-default-config`	Показывает встроенную конфигурацию без ваших изменений
`dsh --patch <файл>`	Запускает DSH с временной конфигурацией, не изменяя файлы профиля
`dsh --profile web --dump-config`	Показывает конфигурацию конкретного профиля

Эти команды полезны, когда агент ведёт себя странно — вы сразу видите, какие плагины загружены и какие настройки активны.

Параметры и флаги

Флаг	Что делает	Пример
`--port <номер>`	Меняет порт для веб-интерфейса (по умолчанию 3080)	`dsh web --port 8090`
`--profile <имя>`	Выбирает профиль для запуска	`dsh --profile мой_сайт`
`--patch <файл>`	Применяет временную конфигурацию	`dsh --patch ./temp.yml`

Режим агента (Standard / PTC / Minimal / Creator) в актуальных сборках чаще выбирают пресетом сессии в Web UI, а не флагом --mode. Для отладки/headless смотрите env DSH_TOOLS_MODE=native|code|both (глава 8). Если в вашей версии есть --mode, сверяйте dsh --profile web --help.

Важно: --port — параметр приложения, его указывают после флагов запускатора (--profile и т.п.).

Интерактивные команды (slash-команды)

В веб-интерфейсе или терминальном чате доступны команды, начинающиеся с /. Они вводятся прямо в диалоге с агентом.

Команда	Что делает
`/compact`	Сжимает длинный диалог в краткое резюме, чтобы не выходить за лимит токенов
`/export`	Скачивает текущий диалог в виде Markdown-файла
`/goal <текст>`	Устанавливает долгосрочную цель. Агент будет держать её в фокусе
`/goal`	Показывает текущую цель
`/goal pause` / `/goal resume`	Приостанавливает или возобновляет работу над целью
`/goal clear`	Удаляет текущую цель
`/plan <текст>`	Включает «режим планирования» — агент сначала составит план и покажет вам, прежде чем начать действовать
`/plan off`	Отключает режим планирования
`/permission`	Показывает или меняет настройки прав доступа для текущей сессии
`/new`	Начинает новый пустой диалог
`/resume <id>`	Возобновляет ранее сохранённую сессию
`/status`	Показывает информацию о текущей сессии
`/cost`	Показывает, сколько токенов потрачено в текущей сессии

Полезные сочетания и советы

Ситуация	Что делать
Хотите быстро попробовать DSH	`npx @deepseek-ai/dsh web`
Нужно выполнить задачу без браузера	`dsh --profile headless "задача"`
Порт 3080 занят	`dsh web --port 8090`
Не помните, какой профиль используете	`dsh --dump-config \\| grep profile`
Хотите проверить установку	`dsh --version`
Обновить DSH до последней версии	`npm update -g @deepseek-ai/dsh`

Коды завершения (exit codes)

При работе в headless-режиме DSH возвращает коды завершения, которые можно использовать в скриптах:

Код	Что означает
`0`	Задача успешно завершена
`1`	Ошибка (конфигурация, запуск, выполнение задачи)
`130`	Прервано пользователем (Ctrl+C)

Пример использования в скрипте:

if dsh --profile headless "задача"; then
  echo "Успешно!"
else
  echo "Ошибка!" >&2
fi

Откуда брать справку

Команда	Что покажет
`dsh --help`	Справку по самому запускатору
`dsh --profile web --help`	Справку по параметрам веб-интерфейса
`dsh --profile headless --help`	Справку по параметрам headless-режима

Где хранятся ваши профили: ~/.dsh/profiles/ (на Windows — %USERPROFILE%\.dsh\profiles\).

Главное правило: запускатор DSH (dsh) — это просто «пускатель» профилей. Он не знает, что внутри вашего профиля. Поэтому флаги самого dsh (например, --profile, --dump-config) должны стоять перед флагами приложения.