dsh-dispatcher
DiscoveredRemote control for DSH agent questions: route ask_user_question to Telegram/MAX or a self-hosted Rust relay and answer from your phone. Kanban multi-agent workflow included.
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.
Comments
Loading…
Similar plugins
Remote-control your dsh agent from Telegram: chat, skills, workspace browsing, and file transfer.
★ 0
dsh plugin --profile web add dsh-telegram-bridgeby aleksvega
Drive a dsh agent from Telegram: one chat topic per project directory, voice and photo input, ordered per-topic job queue, per-topic goals and task checklists, live progress message, command menu in e
★ 6
↓ 4.6k/wk
MIT
JavaScript
Nov 21, 2026
dsh plugin --profile web add dsh-tg-bridgeby xingzhen199186
DSH 极简风远程移动端:只把「指令」和「回复」送到手机,隐藏执行步骤。
★ 5
↓ 539/wk
MIT
JavaScript
Oct 21, 2026
dsh plugin --profile web add dsh-mini-remoteby PerryLink
Pushes DSH approval and question cards to IM channels (WeChat first) and answers them from chat, with a session console, per-channel security, and an open push service.
★ 4
↓ 581/wk
Apache-2.0
TypeScript
Nov 18, 2026
dsh plugin --profile web add dsh-reachby songofhawk
Multi-machine, multi-agent orchestration and control plane for DSH: discovers Agents and workspaces across devices, routes tasks by machine, repository, capability, and load to local or remote Agent r
★ 4
↓ 193/wk
JavaScript
Sep 29, 2026
dsh plugin --profile web add dsh-alphaby mazov2love
给dsh像user一样以后端逻辑操控另一个本机dsh实例的能力
★ 6
↓ 256/wk
MIT
JavaScript
Oct 28, 2026
dsh plugin --profile web add @mazov2love/dsh-remote-control