dsh-superagent на дешёвой модели: из issue в pull request

Вы упоминаете агента в новой issue на GitHub, идёте за чаем и возвращаетесь к готовому pull request. Так работает dsh-superagent от DeepSeek, и запустить его можно на модели CheapTokens через DeepSeek Harness (DSH). Дальше: установка, отдельный аккаунт агента на GitHub, первая тестовая issue и бюджет на один тикет.

Одна оговорка из самого репозитория. В README (проверено 2 ноября 2026) написано, что это исследовательский прототип «только для ознакомления», а не официальный продукт DeepSeek, и в нём могут быть ошибки. Лицензия MIT, на main один коммит, релизов нет. Запускайте на репозитории, где можно экспериментировать.

Что он делает#

dsh-superagent — проактивный агент для одного репозитория GitHub, упакованный как набор для DeepSeek Harness. Он слушает GitHub. Когда человек из разрешённого списка о чём-то просит, агент открывает рабочую единицу (в документации она зовётся Ticket), работает в отдельной сессии и в своей папке и отвечает в исходном обсуждении, например pull request. Веб-панель показывает то, что требует человека.

Итак, одна issue — одна сессия, а сессия — это цикл вызовов модели. Именно в нём уходят токены; если ещё не видели почему, посмотрите почему ИИ-агенты тратят так много токенов — там разобран пример на 20 шагов.

Что нужно заранее#

По документации по развёртыванию:

• Node.js 22.19+ или 24+, pnpm, git 2.32+, tmux, Python 3.8+
• GitHub CLI 2.48+ (через небольшую обёртку, см. ниже)
• репозиторий на github.com (GitHub Enterprise Server не поддерживается)
• DSH в диапазоне версий из engines.dsh в package.json репозитория
• провайдер моделей для DSH

Последний пункт репозиторий оставляет вам: в SETUP.md провайдер назван шагом оператора. Для CheapTokens сначала подключите DeepSeek Harness к CheapTokens, потом возвращайтесь. Id модели — deepseek-ai/DeepSeek-V4-Flash-0731 (полный id; короткое имя из таблиц цен API не принимает), адрес API — https://api.cheaptokens.dev/v1. Подробности — в документации CheapTokens.

На что обратить внимание. По документации, при настройке из окружения вырезаются переменные, в имени которых есть KEY, PASSWORD, SECRET или TOKEN, а GH_TOKEN и GITHUB_TOKEN убираются из окружения воркера. Поэтому ключ провайдера, заданный в оболочке, до воркера не дойдёт; настройте его так, как описано в статье про подключение.

Установка и запуск#

npm install -g @deepseek-ai/dsh@0.2.1-rc.3
git clone https://github.com/deepseek-ai/dsh-superagent-prototype dsh-superagent
cd dsh-superagent
pnpm install && pnpm build

dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"

scripts/dsh-superagent start
scripts/dsh-superagent status

Команда status отвечает кодом выхода: 0 — всё нормально, 1 — может помочь перезапуск, 2 — часть сломалась и перезапуск не поможет, 3 — нужна настройка. Начните с умолчаний: профиль superagent, префикс веток agent/ и режим observe, в котором проактивная работа только записывается, но не выполняется.

Отдельный аккаунт агента на GitHub#

Этот шаг пропускают чаще всего, а потом удивляются, что ничего не происходит. Агенту нужен обычный пользователь GitHub с правом записи в репозиторий; GitHub App на эту роль не подходит.

1. Создайте пользователя и добавьте его в репозиторий с правом записи.
2. Сделайте обёртку ~/.local/bin/gh-agent: GH_CONFIG_DIR="$HOME/.config/gh-agent" exec gh "$@". Так логин агента не смешается с вашим gh.
3. Выполните gh-agent auth login под этим пользователем.
4. В веб-панели откройте Sources, укажите репозиторий (owner/name) и путь к обёртке.
5. В Policy добавьте логины, которым можно ставить агенту задачи, в policy.sources.github.allowed. Пока там никого нет, ничто не станет Ticket.

Первая тестовая issue#

Откройте в репозитории новую issue и напишите что-нибудь маленькое и однозначное, с логином агента в формате кода, например: @<agent login> fix the typo in README.md: "recieve" should be "receive".

Слово «новую» важно. Если отредактировать старую issue и дописать упоминание, оно не подхватится; подхватятся новая issue или новый комментарий. Если в панели появился Ticket, а потом ветка с префиксом agent/, цепочка работает.

Сколько стоит один тикет#

Расход токенов на тикет репозиторий не публикует, поэтому это оценка на явных допущениях. Допустим, небольшой тикет занимает 25 вызовов модели. В каждом уходит растущая переписка: в среднем около 30 000 токенов входа и около 800 токенов ответа (команда, патч, короткая заметка).

На тикет это 30 000 × 25 = 750 000 токенов входа и 800 × 25 = 20 000 токенов выхода. На DeepSeek-V4-Flash по текущим ценам CheapTokens (вход $0.015, выход $0.10 за 1M токенов) такой тикет стоит $0.0133.

Перекос тут главное: вход примерно в 37 раз больше выхода, и для агентов это нормально, ведь каждый шаг заново отправляет всё, что было раньше. Тот же тикет на других моделях:

В таблице есть и GLM-5.3-Flash (контекст 390K, до 8 192 токенов в ответе) — на случай, если тикеты короткие и ответы небольшие. Для длинных цепочек с инструментами у DeepSeek-V4-Flash контекст 380K, до 32 768 токенов в ответе и одна цена в любое время суток. Ваши цифры будут другими, так что подвигайте ползунки:

Если хочется урезать входную часть, в статье как оценить стоимость ИИ-агента собраны самые полезные приёмы.

Держите на коротком поводке#

Первый день оставайтесь в режиме observe: он записывает, что агент сделал бы сам, и вы увидите картину до его действий. Сначала разрешите только свой логин. Первые три pull request прочитайте построчно, а после первого дня посмотрите расход на балансе и умножьте на реальное число тикетов.

В репозитории также сказано, что часть замыслов из статьи DeepSeek ещё не реализована, так что недостающее — это незавершённость, а не ваша ошибка.

Источники#

Все факты о репозитории — из deepseek-ai/dsh-superagent-prototype (README, SETUP.md, docs/006-deployment.md), проверено 2 ноября 2026. На странице репозитория нет даты коммита, а версия DSH 0.2.1-rc.3 — релиз-кандидат, поэтому перед установкой сверьтесь с документом ещё раз.