dsh-dispatcher
Удалённое управление вопросами агента в DSH: вопрос из ask_user_question уходит
в мессенджер (Telegram, затем MAX), а ответ возвращается в ту же сессию — с
маркировкой проекта, задачи и роли. Не форк и не патч ядра: плагин встаёт в
штатный waterfall user-questions/request.
English — Remote control for DeepSeek Harness (DSH) agent questions: an agent that blocks on
ask_user_questiongets its question delivered to Telegram / MAX / a self-hosted Rust relay, and the answer (button or text) is returned into the very same session. No core patches — the plugin registers an answerer on the standarduser-questions/requestwaterfall. It also covers tool approvals (approval/request): allow-once / reject / leave-to-GUI, with fail-closed timeout policy. Bundled: a Rust relay with end-to-end encrypted payloads, Android and iOS clients, and a kanban workflow for orchestrator / worker / reviewer / verifier sessions. Quick start:bin/install-remote.sh --dry-run, then/remote connect.
Зачем: агент, дойдя до развилки, блокируется до ответа человека. Если человек не за клавиатурой, работа стоит. С плагином вопрос приходит на телефон, а ответ кнопкой или текстом возвращается в сессию — ноутбук может быть закрыт.
Из чего состоит
| Часть | Что это | Где |
|---|---|---|
Плагин dsh-remote |
host-половина (перехват вопросов, transport, /remote, устойчивость, панель) и клиентский таб «Удалённое управление» |
dsh-remote/ |
Плагин dsh-kanban |
доска агентских задач в правом сайдбаре; читает .kanban/tasks/*.md, умеет асайн из backlog |
внешний проект (~/projects/dsh-kanban), в профиле DSH |
| Доска задач | .kanban/tasks/*.md: статусы, владельцы, спеки, заметки ревью |
.kanban/ |
| Протокол ролей | как несколько агентов работают параллельно и не пересекаются | AGENTS.md |
| Установщик и диагностика | bin/install-remote.sh, /remote doctor, панель |
bin/, dsh-remote/README.md |
| Релей (Rust) | свой сервер вместо мессенджера: WS + long-poll, TTL, привязка устройств; e2e-шифрование тела вопроса | relay/ |
| Клиенты | Android (Kotlin/Compose) и iOS (SwiftUI) — привязка, вопросы, ответы, оффлайн-очередь | apps/ |
| Подтверждения | удалённые approval/request: разрешить один раз / отклонить / оставить GUI, аудит, политика |
docs/approvals.md |
| Эксплуатация | /remote doctor --json, /remote stats, миграции состояния, ротация журналов, RUNBOOK |
docs/RUNBOOK.md |
Состояние и секреты живут вне репозитория: ~/.dsh/remote-control/
(state.json, log.jsonl), токены — только через ctx.credentials.
Быстрый старт
bin/install-remote.sh --dry-run # план установки, ничего не меняет
bin/install-remote.sh # поставить плагин в профиль web
# перезапустить профиль: dsh web (или закрыть/открыть приложение)
В сессии DSH:
/remote connect # транспорт → токен @BotFather → код из сессии отправить боту → режим
/remote on # включить для текущего проекта (--all — для всех)
/remote test # проверить, что сообщение доходит
/remote doctor # диагностика: токен, getMe, поллеры, канал, состояние
Пошаговая инструкция для человека (бот → подключение → вопрос, FAQ, безопасность):
docs/user-guide.md.
Документация
docs/CONCEPT.md— концепция системы и границы первой очереди;.kanban/specs/001.md— спека первой очереди;AGENTS.md— протокол работы агентов, роли, жизненный цикл задачи;docs/user-guide.md— инструкция пользователя;docs/acceptance.md— чек-лист живой приёмки (бот, телефон, отказы);dsh-remote/README.md— плагин: установка, панель,/remote;docs/RUNBOOK.md— эксплуатация: инциденты, диагностика, SLO;docs/approvals.md— удалённые подтверждения и политика;docs/relay/PROTOCOL.md— контракт плагин↔релей;docs/relay/CRYPTO.md— e2e-шифрование и тест-векторы;docs/research/— разбор хуков DSH и Bot API мессенджеров;.kanban/specs/— пять спек, по которым проект собран.
Структура репозитория
dsh-remote/ плагин DSH (host + клиентский бандл, тесты `node --test`)
.kanban/ доска: tasks/, specs/, board.json
bin/ скрипты: установщик, доска, задачи, тесты
docs/ концепция, руководство пользователя, research/
worktrees/<id>/ рабочие деревья задач (ветка feature/<id> | bug/<id>)
AGENTS.md протокол ролей и карточек
KANBAN.md шпаргалка по доске
Тесты
node --test dsh-remote/test # 666 тестов плагина (node:test, без сети)
./bin/test.sh # скрипты + тесты набора
cd relay && cargo test # релей: 7 unit + 18 интеграционных
cd apps/ios && swift test # iOS-клиент: 19 тестов
cd apps/android && ./gradlew test
cd docs/relay/impl/kotlin && ./gradlew test # крипто-векторы (Kotlin)
cd docs/relay/impl/swift && swift test # крипто-векторы (Swift)
./bin/ci.sh # всё сразу: плагин, скрипты, релей, Swift, Kotlin
./bin/ci.sh --fast # только плагин и скрипты (секунды)
./bin/ci.sh --android # плюс юнит-тесты Android
CI — локальный: bin/ci.sh прогоняет те же проверки, что и будущий
workflow (плагин и скрипты, релей, оба Swift-пакета, крипто-векторы Kotlin,
опционально Android). Готовый файл GitHub Actions лежит в
docs/ci/github-actions-ci.yml: он не
активирован, потому что у токена gh нет scope workflow; скопируйте его в
.github/workflows/ci.yml — и он заработает как есть.
Пуш в remote делает оркестратор (GitHub делегирован ему человеком), после
bin/ci.sh; роли — исполнитель, ревьювер, тестировщик — не пушат, а скрипты
набора пушат только по явной команде.
Ветвление
main релизная ветка: сюда попадает только develop, через bin/release.sh (+ тег vX.Y.Z)
└─ develop рабочая ветка: сюда вливаются задачи и баги через bin/task-commit.sh
├─ feature/<id> задача с доски (bin/task-new.sh "…")
└─ bug/<id> баг (bin/task-new.sh "…" --type bug)
- Ветка задачи создаётся от
develop, карточка живёт в ней. - Перед сдачей в ревью исполнитель делает
git rebase developв каталоге задачи и прогоняет тесты заново — иначе ревьювер вернёт «ребейзнись». - Слияние задачи —
bin/task-commit.sh <id>(только вdevelop; вmainскрипт откажет). - Релиз —
bin/release.sh --tag vX.Y.Z: проверяет чистое дерево, гоняетbin/test.sh, мержитdevelop→mainи ставит тег. Пуш — человек.
Безопасность
Токены ботов и ключи устройств живут вне репозитория: ctx.credentials
(ссылка на переменную окружения или ~/.dsh/.credentials.yaml), состояние — в
~/.dsh/remote-control/ с правами 600. Удалённые подтверждения по умолчанию
не дают allowed-once по таймауту (fail closed), опасные инструменты
(bash, git push, удаление файлов) подтверждаются только в GUI. Тела вопросов
проходят через redact, а релей при e2e-шифровании видит только конверт.
Лицензия
MIT © 2026 Victor Kozachek.
No comments yet. Be the first to write one.