@zoraxylia/dsh-codex-adapter 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +15 -0
- package/.claude-plugin/plugin.json +8 -0
- package/.mcp.json +8 -0
- package/LICENSE +21 -0
- package/README.de.md +480 -0
- package/README.es.md +480 -0
- package/README.fr.md +480 -0
- package/README.hi.md +480 -0
- package/README.id.md +480 -0
- package/README.ja.md +478 -0
- package/README.ko.md +480 -0
- package/README.md +483 -2
- package/README.pt.md +480 -0
- package/README.ru.md +480 -0
- package/README.th.md +480 -0
- package/README.tr.md +480 -0
- package/README.vi.md +480 -0
- package/README.zh-TW.md +478 -0
- package/README.zh.md +482 -0
- package/agents/ds-flash.md +17 -0
- package/agents/ds-pro.md +17 -0
- package/agy/agents/ds-flash.md +18 -0
- package/agy/agents/ds-pro.md +18 -0
- package/agy/skills/dsh-config/SKILL.md +6 -0
- package/agy/skills/dsh-playbook/SKILL.md +65 -0
- package/agy/skills/dsh-status/SKILL.md +6 -0
- package/codex/agents/ds-flash.toml +23 -0
- package/codex/agents/ds-pro.toml +23 -0
- package/codex/prompts/dsh-config.md +3 -0
- package/codex/prompts/dsh-playbook.md +60 -0
- package/codex/prompts/dsh-status.md +1 -0
- package/commands/config.md +9 -0
- package/commands/off.md +5 -0
- package/commands/on.md +5 -0
- package/commands/playbook.md +64 -0
- package/commands/status.md +5 -0
- package/cordis.patch.yml +4 -0
- package/docs/images/dsh-crew-host.png +0 -0
- package/docs/images/dsh-crew-jobs.png +0 -0
- package/docs/images/dsh-crew-logo.png +0 -0
- package/docs/images/dsh-crew-overview.png +0 -0
- package/grok/agents/ds-flash.md +19 -0
- package/grok/agents/ds-pro.md +19 -0
- package/grok/commands/dsh-config.md +9 -0
- package/grok/commands/dsh-playbook.md +66 -0
- package/grok/commands/dsh-status.md +5 -0
- package/lib/client.js +2684 -0
- package/lib/server.mjs +15417 -0
- package/package.json +137 -4
- package/scripts/build-client.mjs +23 -0
- package/scripts/build-mcp.mjs +43 -0
- package/scripts/fake-agy.sh +23 -0
- package/scripts/release-local.mjs +87 -0
- package/scripts/smoke-bundle.mjs +166 -0
- package/scripts/smoke-cwd.mjs +41 -0
- package/scripts/smoke-pack.mjs +285 -0
- package/scripts/smoke.mjs +79 -0
- package/scripts/verify-cli-workers.mjs +133 -0
- package/scripts/verify-wpc10-client.mjs +237 -0
- package/scripts/verify-wpc14-proc-endpoints.mjs +356 -0
- package/scripts/verify-wpc9-guardrails.mjs +432 -0
- package/src/cli-workers.mjs +396 -0
- package/src/client/index.tsx +1133 -0
- package/src/client/jobs-view.ts +374 -0
- package/src/cwd-lock.mjs +91 -0
- package/src/hub/index.mjs +643 -0
- package/src/hub-client.mjs +72 -0
- package/src/i18n.mjs +19 -0
- package/src/install/cli.mjs +34 -0
- package/src/install/install.mjs +577 -0
- package/src/jobs.mjs +289 -0
- package/src/multimodal.mjs +744 -0
- package/src/origin-guard.mjs +133 -0
- package/src/paths.mjs +43 -0
- package/src/plugin-env.mjs +65 -0
- package/src/proc-kill.mjs +208 -0
- package/src/process-info.mjs +60 -0
- package/src/provider-probe.mjs +35 -0
- package/src/server.mjs +438 -0
- package/src/status-shard.mjs +95 -0
- package/src/tier-binding.mjs +63 -0
- package/src/vision-route.mjs +139 -0
- package/src/worker-profiles.mjs +95 -0
- package/src/worker-question.mjs +22 -0
- package/statusline/statusline.sh +14 -0
- package/statusline/worker-segment.sh +35 -0
- package/worker.cordis.yml +77 -0
package/README.ru.md
ADDED
|
@@ -0,0 +1,480 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="./docs/images/dsh-crew-logo.png" alt="DSH Crew" width="120" />
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<h1 align="center">DSH Crew</h1>
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
<strong>Плагин <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>: отправляйте работу агентам DSH из Claude Code / Codex / Antigravity / Grok, не отказываясь от встроенного интерфейса субагентов хоста.</strong><br />
|
|
9
|
+
<sub>Встроенный интерфейс прогресса • Политика уровней и эскалация • Ограждения диспетчеризации • Доска задач • Сессии DSH внутри хоста • Зрение и генерация изображений (сначала нативные) • Установка в один клик</sub>
|
|
10
|
+
</p>
|
|
11
|
+
|
|
12
|
+
<p align="center">
|
|
13
|
+
<sub>npm: <code>@zoraxylia/dsh-codex-adapter</code> · Текущий релиз плагина: <code>0.1.0-rc.11</code> · Проверено с DSH <code>0.1.1-rc.1</code></sub>
|
|
14
|
+
</p>
|
|
15
|
+
|
|
16
|
+
<p align="center">
|
|
17
|
+
<a href="./README.md">English</a> · <a href="./README.zh.md">简体中文</a> · <a href="./README.zh-TW.md">繁體中文</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.ko.md">한국어</a> · <a href="./README.fr.md">Français</a> · <a href="./README.es.md">Español</a> · <a href="./README.de.md">Deutsch</a> · <a href="./README.pt.md">Português</a> · <a href="./README.ru.md"><b>Русский</b></a> · <a href="./README.hi.md">हिन्दी</a> · <a href="./README.tr.md">Türkçe</a> · <a href="./README.th.md">ไทย</a> · <a href="./README.vi.md">Tiếng Việt</a> · <a href="./README.id.md">Bahasa Indonesia</a>
|
|
18
|
+
</p>
|
|
19
|
+
|
|
20
|
+
<p align="center">
|
|
21
|
+
<a href="https://github.com/ZSeven-W/dsh-crew/blob/main/LICENSE"><img src="https://img.shields.io/github/license/ZSeven-W/dsh-crew?color=64748b" alt="License" /></a>
|
|
22
|
+
</p>
|
|
23
|
+
|
|
24
|
+
<br />
|
|
25
|
+
|
|
26
|
+
<p align="center">
|
|
27
|
+
<img src="./docs/images/dsh-crew-overview.png" alt="DSH Crew — settings page" width="100%" />
|
|
28
|
+
</p>
|
|
29
|
+
<p align="center"><sub>Страница настроек DSH Crew — интеграции хоста, политика отправки, выполнение и мультимодальный мост</sub></p>
|
|
30
|
+
|
|
31
|
+
## Зачем нужен DSH Crew
|
|
32
|
+
|
|
33
|
+
DSH Crew — плагин для [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH), опенсорсного агентского харнесса. Он позволяет отправлять работу агентам DSH из Claude Code, Codex, Antigravity и Grok: оркестратор сохраняет собственную модель, работа выполняется на настоящем агенте DSH с инструментами, песочницей, пресетами и историей сессий этого харнесса, а хост по-прежнему отображает его как встроенного субагента с живым прогрессом.
|
|
34
|
+
|
|
35
|
+
Работу выполняет агент DSH, а не голый вызов модели. Уровни (`flash` / `pro`) определяют, какой объём возможностей получает агент из настроенного списка моделей харнесса — сегодня это DeepSeek V4 Flash и V4 Pro, — поэтому смена модели в DSH не требует изменений здесь.
|
|
36
|
+
|
|
37
|
+
<table>
|
|
38
|
+
<tr>
|
|
39
|
+
<td width="50%">
|
|
40
|
+
|
|
41
|
+
### 🧵 Встроенный интерфейс прогресса
|
|
42
|
+
|
|
43
|
+
Воркеры отображаются как обычные субагенты в Claude Code / Codex / Antigravity / Grok — счётчик отправок, текущий шаг, вызовы инструментов и расход токенов видны в собственной панели задач хоста, а также сегмент статусной строки claude-hud: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3`.
|
|
44
|
+
|
|
45
|
+
</td>
|
|
46
|
+
<td width="50%">
|
|
47
|
+
|
|
48
|
+
### 🎚️ Политика уровней и эскалация
|
|
49
|
+
|
|
50
|
+
`flash` для механической работы, `pro` для решения сложных задач, `effort` от `off` до `max`. `tier_policy` может ограничить каждую отправку одним уровнем на уровне инструмента, а `escalate_on_failure` один раз повторяет неудачный запуск flash на pro — на основе фактов, а не предположений о сложности заранее.
|
|
51
|
+
|
|
52
|
+
</td>
|
|
53
|
+
</tr>
|
|
54
|
+
<tr>
|
|
55
|
+
<td width="50%">
|
|
56
|
+
|
|
57
|
+
### 🏛️ Сессии DSH внутри хоста
|
|
58
|
+
|
|
59
|
+
Когда бандл установлен в профиле DSH, каждый воркер — это полноценная сессия DSH: она видна в веб-интерфейсе, сгруппирована по рабочей директории и подключена с выбранным вами пресетом Agent для каждого уровня. Если DSH не запущен, отправка переключается на автономный рантайм DSH, поэтому CI и среды без графического интерфейса продолжают работать.
|
|
60
|
+
|
|
61
|
+
</td>
|
|
62
|
+
<td width="50%">
|
|
63
|
+
|
|
64
|
+
### 👁️ Зрение и генерация изображений
|
|
65
|
+
|
|
66
|
+
Модели DSH работают только с текстом. `describe_image` теперь предпочитает собственную VL-модель DeepSeek (`deepseek-v4-flash-vision-exp`), когда доступен ключ, а затем откатывается на уже имеющиеся у вас CLI — Claude, Codex, Grok, Antigravity — или на любой настроенный вами OpenAI-совместимый API. `generate_image` заимствует «кисть» тех же CLI. Вставленные изображения остаются видимыми в диалоге и доходят до модели в виде текста.
|
|
67
|
+
|
|
68
|
+
</td>
|
|
69
|
+
</tr>
|
|
70
|
+
<tr>
|
|
71
|
+
<td width="50%">
|
|
72
|
+
|
|
73
|
+
### 🛡️ Ограждения диспетчеризации
|
|
74
|
+
|
|
75
|
+
Каждая отправка проверяется до того, как что-либо будет запущено. Вложенность воркер→воркер ограничена глубиной цепочки происхождения 3, а циклы отклоняются; второй воркер в рабочей директории, которую уже удерживает другое задание, отклоняется с данными владельца — никогда не ставится в очередь молча. Отказы — читаемые ошибки: подождите или пересмотрите охват задачи, не обходите их.
|
|
76
|
+
|
|
77
|
+
</td>
|
|
78
|
+
<td width="50%">
|
|
79
|
+
|
|
80
|
+
### 📋 Доска задач
|
|
81
|
+
|
|
82
|
+
Панель DSH Crew работает и как доска задач: каждое задание воркера — выполняющееся или завершённое — отображается с tier, effort, живым прогрессом и токенами; занятые рабочие директории показывают своих владельцев, а задание, исчезнувшее на лету (например, перезапуск hub), всплывает как осиротевший призрак, а не исчезает молча.
|
|
83
|
+
|
|
84
|
+
</td>
|
|
85
|
+
</tr>
|
|
86
|
+
<tr>
|
|
87
|
+
<td width="50%">
|
|
88
|
+
|
|
89
|
+
### 🔌 Собственные провайдеры
|
|
90
|
+
|
|
91
|
+
Подключите собственную конечную точку (Base URL + API-ключ + модели) или шаблон локальной команды. У каждого провайдера есть тест подключения: он проверяет доступность и авторизацию, а затем делает один реальный вызов зрения — чтобы вы узнали о проблемах сейчас, а не посреди задачи.
|
|
92
|
+
|
|
93
|
+
</td>
|
|
94
|
+
<td width="50%">
|
|
95
|
+
|
|
96
|
+
### 📦 Установка в один клик
|
|
97
|
+
|
|
98
|
+
Страница настроек устанавливает и обновляет за вас плагин Claude Code, файлы ролей Codex и агентов, навыки и команды Antigravity / Grok — регистрация маркетплейса, список разрешений, подключение HUD, абсолютные пути, сформированные для этой машины, — и так же легко их восстанавливает. Перед изменениями все файлы настроек резервируются.
|
|
99
|
+
|
|
100
|
+
</td>
|
|
101
|
+
</tr>
|
|
102
|
+
</table>
|
|
103
|
+
|
|
104
|
+
## Как это работает
|
|
105
|
+
|
|
106
|
+
```
|
|
107
|
+
Claude Code / Codex / Antigravity / Grok (orchestrator, keeps its own model)
|
|
108
|
+
└─ ds-flash / ds-pro ← native subagent shell (progress shows in the host's task UI)
|
|
109
|
+
└─ MCP: dsh_run_worker(tier, effort, cwd, worker=)
|
|
110
|
+
├─ worker="agy"/"grok" → that external CLI runs the task (explicit opt-in)
|
|
111
|
+
├─ hub reachable → session inside DSH (visible in the Web UI, grouped by cwd)
|
|
112
|
+
└─ otherwise → dsh-jsonrpc-agent runtime (worker.cordis.yml)
|
|
113
|
+
└─ DeepSeek V4 Flash / Pro (DSH SDK, event stream → progress and token stats)
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
## Один запуск, два взгляда
|
|
117
|
+
|
|
118
|
+
Диспетчеризация масштабируется вширь. Ниже восемнадцать worker'ов параллельно переводят этот README: хост считает их своими субагентами, а harness выполняет их как настоящие сессии.
|
|
119
|
+
|
|
120
|
+
<p align="center">
|
|
121
|
+
<img src="./docs/images/dsh-crew-host.png" alt="Claude Code" width="100%" />
|
|
122
|
+
</p>
|
|
123
|
+
<p align="center"><sub>В Claude Code worker'ы dsh-crew выглядят как нативные субагенты; сегмент statusline показывает работающие tier'ы, время и токены.</sub></p>
|
|
124
|
+
|
|
125
|
+
<p align="center">
|
|
126
|
+
<img src="./docs/images/dsh-crew-jobs.png" alt="DSH Crew" width="100%" />
|
|
127
|
+
</p>
|
|
128
|
+
<p align="center"><sub>Панель DSH Crew показывает тот же запуск со стороны harness: какой хост отправил задачу, её tier и effort, прогресс и расход токенов.</sub></p>
|
|
129
|
+
|
|
130
|
+
<p align="center"><sub>Панель — это ещё и доска задач: выполняющиеся и завершённые задания остаются в списке с tier, прогрессом и токенами, занятые рабочие директории называют своих владельцев, а задание, исчезнувшее на лету (перезапуск hub), всплывает как осиротевший призрак, а не исчезает молча.</sub></p>
|
|
131
|
+
|
|
132
|
+
## Установка
|
|
133
|
+
|
|
134
|
+
Установить из npm в профиль DSH:
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
dsh plugin --profile web add @zoraxylia/dsh-codex-adapter@latest
|
|
138
|
+
dsh web
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
Или для локальной разработки прямо из исходников:
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
dsh plugin --profile web add link:/path/to/dsh-crew
|
|
145
|
+
dsh web
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
Протокол `link:` делает симлинк зависимости профиля на этот репозиторий, поэтому пересборка видна сразу.
|
|
149
|
+
|
|
150
|
+
### Настроить учётные данные DeepSeek (только standalone)
|
|
151
|
+
|
|
152
|
+
В режиме hub — установке выше — воркеры работают внутри экземпляра DSH и используют учётные данные DeepSeek, которые уже для него настроены. Ничего больше не нужно настраивать.
|
|
153
|
+
|
|
154
|
+
Только standalone-режим (резервный вариант) требует собственного ключа: отправка с хоста без запущенного экземпляра DSH запускает worker runtime в отдельном процессе. Получите API-ключ на [platform.deepseek.com](https://platform.deepseek.com) и запишите его в `~/.config/dsh-crew/.env`:
|
|
155
|
+
|
|
156
|
+
```
|
|
157
|
+
DEEPSEEK_API_KEY=sk-...
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
### Проверка
|
|
161
|
+
|
|
162
|
+
```bash
|
|
163
|
+
node scripts/smoke.mjs
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
Smoke test отправляет одно дешёвое задание по доступному пути — hub, если запущен экземпляр DSH, иначе standalone — и выводит, какой из них был использован. Примерно через десять секунд должно появиться `smoke test passed — configuration OK`. При ошибке печатается причина, относящаяся к проверенному пути.
|
|
167
|
+
|
|
168
|
+
Затем откройте Настройки → DSH Crew и установите интеграции хостов — Claude Code, Codex, Antigravity, Grok — одним щелчком или запустите тот же установщик из командной строки:
|
|
169
|
+
|
|
170
|
+
```bash
|
|
171
|
+
node src/install/cli.mjs claude # Claude Code plugin: marketplace + permissions + HUD segment
|
|
172
|
+
node src/install/cli.mjs codex # Codex agents + prompts
|
|
173
|
+
node src/install/cli.mjs agy # Antigravity MCP config + agents + skills
|
|
174
|
+
node src/install/cli.mjs grok # Grok MCP config + agents + commands
|
|
175
|
+
node src/install/cli.mjs all # all four hosts at once
|
|
176
|
+
# uninstall symmetrically (uninstall-claude | uninstall-codex | uninstall-agy | uninstall-grok):
|
|
177
|
+
node src/install/cli.mjs uninstall-claude
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
## Контекст и терминология
|
|
181
|
+
|
|
182
|
+
- **DSH** (DeepSeek Harness): опенсорсный агентский харнесс DeepSeek, кодовый агент в форме веб-интерфейса, похожий на Claude Code, но работающий на моделях DeepSeek.
|
|
183
|
+
- **MCP** (Model Context Protocol): протокол интеграции ИИ-инструментов от Anthropic, позволяет LLM безопасно вызывать внешние инструменты и источники данных.
|
|
184
|
+
- **Cordis bundle**: формат плагинов DSH; этот проект может работать автономно как MCP-сервис или устанавливаться в DSH Web в режиме hub.
|
|
185
|
+
- **tier**: уровень возможностей — какой слот из настроенного списка моделей DSH получает воркер. `flash` — быстрый и дешёвый (простые задачи), `pro` — глубже рассуждает (сложные задачи). Сейчас они соответствуют DeepSeek V4 Flash и V4 Pro; поменяйте модели в DSH — и здесь ничего менять не нужно.
|
|
186
|
+
- **worker**: агент DSH, выполняющий работу, — полноценная сессия со своими инструментами, песочницей и пресетом, а не голый вызов модели.
|
|
187
|
+
- **effort**: сила рассуждений, `off` = без рассуждений, `high` = высокие вложения в рассуждения, `max` = максимальные вложения в рассуждения.
|
|
188
|
+
|
|
189
|
+
## Claude Code
|
|
190
|
+
|
|
191
|
+
### Установка
|
|
192
|
+
|
|
193
|
+
Установка в один клик (выберите один вариант):
|
|
194
|
+
|
|
195
|
+
- **Страница настроек DSH** (когда установлен режим hub): Settings → DSH Crew → "Install to Claude Code"
|
|
196
|
+
- **Командная строка**: `node src/install/cli.mjs all`
|
|
197
|
+
|
|
198
|
+
Оба варианта делают одно и то же: регистрируют локальный маркетплейс (родительская директория `dsh-plugins/` как корень маркетплейса) + `claude plugin install` + список разрешений инструментов MCP + настройка сегмента статуса воркеров claude-hud (автоматическое резервное копирование settings.json перед изменениями, идемпотентно). **После установки перезапустите сессию, чтобы изменения вступили в силу.**
|
|
199
|
+
|
|
200
|
+
### Использование
|
|
201
|
+
|
|
202
|
+
- Прямо в диалоге скажите "dispatch X to ds-flash" или "dispatch X to ds-pro", и субагент выполнит задачу
|
|
203
|
+
- Счётчик отправок и прогресс в реальном времени отображаются в интерфейсе задач Claude Code
|
|
204
|
+
- **Сегмент статусной строки HUD**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (текущий уровень / затраченное время / расход токенов / количество завершённых)
|
|
205
|
+
- При локальной разработке `statusline/statusline.sh` или `statusline/worker-segment.sh` можно интегрировать отдельно
|
|
206
|
+
- **Длительные задачи**: у CC есть лимиты таймаута для вызовов MCP (`MCP_TOOL_TIMEOUT` настраивается); для долгих задач оркестратор может использовать `dsh_spawn_worker` + опрос через `dsh_worker_result(wait_seconds)`
|
|
207
|
+
- **Локальная разработка и отладка**: `claude --plugin-dir /path/to/dsh-crew` для временной загрузки
|
|
208
|
+
|
|
209
|
+
|
|
210
|
+
### Команды сессии
|
|
211
|
+
|
|
212
|
+
Переопределяют глобальные значения только для текущей сессии и применяются на уровне инструмента, а не через промпт:
|
|
213
|
+
|
|
214
|
+
| Команда | Что делает |
|
|
215
|
+
|---|---|
|
|
216
|
+
| `/dsh-crew:config` | Показать или задать значения по умолчанию для сессии: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<секунды>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `origin_depth_limit=<1-32>`, `preset_flash/preset_pro=<preset id|default>`, `reset` |
|
|
217
|
+
|
|
218
|
+
| `/dsh-crew:on` · `/dsh-crew:off` | Включить или выключить диспетчеризацию в этой сессии (выключено — жёсткий запрет: инструмент отказывает) |
|
|
219
|
+
| `/dsh-crew:status` | Статус worker-задач в реальном времени: tier, прогресс, токены, текущий инструмент |
|
|
220
|
+
| `/dsh-crew:playbook` | Лучшие практики диспетчеризации: выбор flash или pro, самодостаточные задания, параллелизм, проверка результатов, ограждения |
|
|
221
|
+
|
|
222
|
+
## Codex
|
|
223
|
+
|
|
224
|
+
### Установка
|
|
225
|
+
|
|
226
|
+
Рекомендуется использовать установщик (автоматически формирует пути для этой машины, копирует промпты `/dsh-config`, `/dsh-status` и `/dsh-playbook`):
|
|
227
|
+
|
|
228
|
+
```bash
|
|
229
|
+
node src/install/cli.mjs codex
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
Либо скопируйте вручную (после копирования потребуется вручную исправить пути):
|
|
233
|
+
|
|
234
|
+
```bash
|
|
235
|
+
cp codex/agents/*.toml ~/.codex/agents/ # global or project-level .codex/agents/
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
Файлы ролей поставляются с готовыми настройками:
|
|
239
|
+
|
|
240
|
+
- конфигурация подключения MCP-сервера
|
|
241
|
+
- `default_tools_approval_mode = "approve"` (**обязательно**, иначе вызовы инструментов автоматически отменяются в режиме exec)
|
|
242
|
+
- `tool_timeout_sec = 3600`
|
|
243
|
+
|
|
244
|
+
**Примечание**: при ручном копировании абсолютные пути в поле `args` нужно привести в соответствие с фактическим расположением установки; установщик делает это автоматически.
|
|
245
|
+
|
|
246
|
+
### Использование
|
|
247
|
+
|
|
248
|
+
- В интерактивном TUI выберите "spawn ds-pro to ...", чтобы отправить задачи; панели Active/Done показывают прогресс
|
|
249
|
+
- Режим `codex exec` также может напрямую вызывать `dsh_run_worker`
|
|
250
|
+
|
|
251
|
+
|
|
252
|
+
### Команды сессии
|
|
253
|
+
|
|
254
|
+
Для Codex устанавливаются три промпта:
|
|
255
|
+
|
|
256
|
+
| Команда | Что делает |
|
|
257
|
+
|---|---|
|
|
258
|
+
| `/dsh-config` | Показать или задать значения по умолчанию для сессии: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<секунды>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `origin_depth_limit=<1-32>`, `preset_flash/preset_pro=<preset id|default>`, `reset` |
|
|
259
|
+
|
|
260
|
+
| `/dsh-status` | Статус worker-задач в реальном времени: tier, прогресс, токены, текущий инструмент |
|
|
261
|
+
| `/dsh-playbook` | Лучшие практики диспетчеризации: выбор flash или pro, самодостаточные задания, параллелизм, проверка результатов, ограждения |
|
|
262
|
+
|
|
263
|
+
## Antigravity (agy)
|
|
264
|
+
|
|
265
|
+
### Установка
|
|
266
|
+
|
|
267
|
+
```bash
|
|
268
|
+
node src/install/cli.mjs agy
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
Регистрирует MCP-сервер dsh-crew в `~/.gemini/config/mcp_config.json` и устанавливает агентов `ds-flash` / `ds-pro` вместе с навыками `dsh-config`, `dsh-status` и `dsh-playbook` в `~/.gemini/config/` (все файлы предварительно резервируются). После установки перезапустите сессию.
|
|
272
|
+
|
|
273
|
+
### Использование
|
|
274
|
+
|
|
275
|
+
- Выберите `ds-flash` или `ds-pro` как агента для отправки задач
|
|
276
|
+
- `dsh_worker_config` читает или переопределяет значения по умолчанию сессии
|
|
277
|
+
|
|
278
|
+
### Навыки сессии
|
|
279
|
+
|
|
280
|
+
| Навык | Что делает |
|
|
281
|
+
|---|---|
|
|
282
|
+
| `/dsh-config` | Показать или задать значения по умолчанию для сессии (tier / effort / mode / timeout / policy / escalation / reset) |
|
|
283
|
+
| `/dsh-status` | Статус worker-задач в реальном времени: tier, прогресс, токены, текущий инструмент |
|
|
284
|
+
| `/dsh-playbook` | Лучшие практики диспетчеризации: выбор flash или pro, самодостаточные задания, параллелизм, проверка результатов, ограждения |
|
|
285
|
+
|
|
286
|
+
### Оговорки
|
|
287
|
+
|
|
288
|
+
- agy запускает воркеров с **полным одобрением** (`--dangerously-skip-permissions` + accept-edits): у agy 1.1.16 нет режима разрешений, ограниченного рабочей директорией, поэтому headless-воркер должен автоматически одобрять запросы инструментов.
|
|
289
|
+
|
|
290
|
+
Удаление: `node src/install/cli.mjs uninstall-agy`
|
|
291
|
+
|
|
292
|
+
## Grok
|
|
293
|
+
|
|
294
|
+
### Установка
|
|
295
|
+
|
|
296
|
+
```bash
|
|
297
|
+
node src/install/cli.mjs grok
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
Записывает секцию `[mcp_servers.dsh-crew]` в `~/.grok/config.toml` и устанавливает агентов `ds-flash` / `ds-pro` вместе с командами `/dsh-config`, `/dsh-status` и `/dsh-playbook` в `~/.grok/` (все файлы предварительно резервируются).
|
|
301
|
+
|
|
302
|
+
### Использование
|
|
303
|
+
|
|
304
|
+
- Выберите `ds-flash` или `ds-pro` как агента для отправки задач
|
|
305
|
+
|
|
306
|
+
### Команды сессии
|
|
307
|
+
|
|
308
|
+
| Команда | Что делает |
|
|
309
|
+
|---|---|
|
|
310
|
+
| `/dsh-config` | Показать или задать значения по умолчанию для сессии (tier / effort / mode / timeout / policy / escalation / reset) |
|
|
311
|
+
| `/dsh-status` | Статус worker-задач в реальном времени: tier, прогресс, токены, текущий инструмент |
|
|
312
|
+
| `/dsh-playbook` | Лучшие практики диспетчеризации: выбор flash или pro, самодостаточные задания, параллелизм, проверка результатов, ограждения |
|
|
313
|
+
|
|
314
|
+
### Оговорки
|
|
315
|
+
|
|
316
|
+
- Из соображений безопасности grok не запускает MCP-серверы уровня репозитория в недоверенных директориях проекта (`grok mcp doctor` сообщает "folder untrusted"); глобальная установка не затрагивается — смените директорию или передайте `--trust`.
|
|
317
|
+
- Воркеры grok работают с `bypassPermissions` (всегда одобрять, как рекомендуют документы grok для headless-автоматизации); запрещающие правила и хуки по-прежнему применяются.
|
|
318
|
+
|
|
319
|
+
Удаление: `node src/install/cli.mjs uninstall-grok`
|
|
320
|
+
|
|
321
|
+
## Инструменты MCP
|
|
322
|
+
|
|
323
|
+
| Инструмент | Описание |
|
|
324
|
+
|---|---|
|
|
325
|
+
| `dsh_run_worker` | Блокирующая отправка задачи (`tier`: flash/pro, `effort`: off/high/max, `cwd`, `worker`), ожидает результат |
|
|
326
|
+
| `dsh_spawn_worker` | Асинхронная отправка задачи, возвращает id задания (для параллельного веера); результаты собираются с помощью `dsh_worker_result` |
|
|
327
|
+
| `dsh_worker_status` | Прогресс всех заданий в реальном времени (ход/шаг/текущий инструмент/токены) + рекомендательные блокировки cwd |
|
|
328
|
+
| `dsh_worker_result` | Получение результата, можно указать `wait_seconds` для ожидания |
|
|
329
|
+
| `dsh_worker_cancel` | Отмена указанного задания и завершение его процесса рантайма |
|
|
330
|
+
| `dsh_worker_config` | Чтение и задание значений по умолчанию сессии (tier, effort, mode, timeout, policy, escalation), а также список `worker_profiles` |
|
|
331
|
+
|
|
332
|
+
Прогресс одновременно зеркалируется в `~/.config/dsh-crew/status.d/` (по одному файлу-шарду на источник записи; его может читать statusline или внешний мониторинг).
|
|
333
|
+
|
|
334
|
+
## Ограждения диспетчеризации
|
|
335
|
+
|
|
336
|
+
Каждая отправка проверяется до того, как что-либо будет запущено, — отказы это читаемые ошибки, а не молчаливые очереди:
|
|
337
|
+
|
|
338
|
+
- **Цепочка происхождения**: каждая отправка добавляет шаг в цепочку происхождения воркер→воркер. Вложенность глубже лимита (`origin_depth_limit`, по умолчанию 3) отклоняется, как и любой цикл (один и тот же бэкенд + cwd встречается дважды) — это защита, которая останавливает рекурсивное самоусиление воркеров.
|
|
339
|
+
- **Рекомендательная блокировка cwd**: один работающий воркер на рабочую директорию. Вторая отправка в занятую рабочую директорию отклоняется с id задания, бэкендом и временем старта владельца — дождитесь её завершения, отмените через `dsh_worker_cancel` или передайте `allow_concurrent_cwd: true` (только для задач только на чтение).
|
|
340
|
+
|
|
341
|
+
## Плейбук диспетчеризации
|
|
342
|
+
|
|
343
|
+
Как отправлять задачи *хорошо* — выбор flash или pro, самодостаточные задания, безопасный параллелизм, проверка результатов и описанные выше ограждения — собрано в плейбук для каждого хоста: `/dsh-crew:playbook` (навык Claude Code), `/dsh-playbook` (промпт Codex, навык Antigravity, команда Grok).
|
|
344
|
+
|
|
345
|
+
## Явные CLI-бэкенды
|
|
346
|
+
|
|
347
|
+
`worker="agy"` / `worker="grok"` привязывает отправку к этому внешнему CLI (бэкенд × модель × effort) вместо логики уровней DSH. Это явный opt-in — значения по умолчанию нет, поэтому задавайте его только тогда, когда пользователь просит именно этот CLI. Оговорки: grok отказывается запускать локальные для репозитория MCP-серверы в недоверенных папках, а agy запускает воркеров с полным одобрением (нет режима разрешений, ограниченного рабочей директорией).
|
|
348
|
+
|
|
349
|
+
## Мультимодальность: зрение и генерация изображений
|
|
350
|
+
|
|
351
|
+
**DeepSeek — текстовая модель**, не поддерживающая ввод и генерацию изображений. Этот плагин получает эти возможности извне через инструменты MCP:
|
|
352
|
+
|
|
353
|
+
**Сначала нативное зрение**: когда провайдер зрения — встроенный CLI (или явно `native`), `describe_image` сначала пробует собственную VL-модель DeepSeek `deepseek-v4-flash-vision-exp` (прямой вызов API; ключ из `DEEPSEEK_API_KEY` или `~/.config/dsh-crew/.env`). Любая ошибка плавно деградирует к цепочке CLI-провайдеров ниже, которая остаётся резервным вариантом. Генерация изображений не затрагивается — нативная модель только смотрит на изображения.
|
|
354
|
+
|
|
355
|
+
| Инструмент | Описание |
|
|
356
|
+
|---|---|
|
|
357
|
+
| `describe_image` | Отвечает на вопросы, просматривая изображения (скриншоты, макеты, диаграммы и т. д.), результаты кэшируются по ключу провайдер + модель + изображение + вопрос |
|
|
358
|
+
| `generate_image` | Генерирует изображение по текстовому описанию, сохраняет по указанному абсолютному пути; результат — плоский растр (для редактирования слоёв требуется OpenPencil) |
|
|
359
|
+
|
|
360
|
+
**Вставка изображений в сессию**: в DSH переключите модель на `DeepSeek (vision) ◉`, чтобы вставлять изображения напрямую. Изображения остаются в сессии и отображаются как обычно; плагин добавляет распознанный текст после них и удаляет изображения перед отправкой — вы видите изображение, модель читает текст. Транскрипция проходит по той же цепочке «сначала нативные»: VL-модель DeepSeek, когда доступен ключ, затем настроенный вами CLI-провайдер.
|
|
361
|
+
|
|
362
|
+
### Конфигурация
|
|
363
|
+
|
|
364
|
+
На **странице настроек DSH → DSH Crew → Multimodal** (или отредактируйте `~/.config/dsh-crew/config.json` напрямую):
|
|
365
|
+
|
|
366
|
+
**Провайдер зрения** (просмотр изображений):
|
|
367
|
+
|
|
368
|
+
- `native` / `deepseek-native` (собственная VL-модель DeepSeek — автоматически пробуется первой для каждого встроенного провайдера, когда доступен ключ)
|
|
369
|
+
- `claude-code` (по умолчанию, использует haiku, недорого)
|
|
370
|
+
- `codex` (использует GPT, можно указать конкретную модель)
|
|
371
|
+
- `grok` (использует Grok)
|
|
372
|
+
- `agy` (Antigravity)
|
|
373
|
+
- `custom` (OpenAI-совместимый API или локальная команда)
|
|
374
|
+
- `off` (отключено)
|
|
375
|
+
|
|
376
|
+
**Провайдер генерации изображений** (генерация изображений):
|
|
377
|
+
|
|
378
|
+
- `codex` (`$imagegen`, gpt-image-2)
|
|
379
|
+
- `agy` (Nano Banana)
|
|
380
|
+
- `grok` (Imagine)
|
|
381
|
+
- `custom` (OpenAI-совместимый API или локальная команда)
|
|
382
|
+
- `off` (отключено)
|
|
383
|
+
|
|
384
|
+
### Собственный провайдер
|
|
385
|
+
|
|
386
|
+
Два способа интеграции:
|
|
387
|
+
|
|
388
|
+
**API**: любая OpenAI-совместимая конечная точка
|
|
389
|
+
- Заполните Base URL, API Key, список моделей
|
|
390
|
+
- Зрение использует `/chat/completions` со встроенными base64-изображениями
|
|
391
|
+
- Генерация изображений использует `/images/generations`
|
|
392
|
+
- **Чтобы получить возможность генерации, необходимо указать "image generation model"**, иначе провайдер появится только в списке выбора зрения
|
|
393
|
+
|
|
394
|
+
**CLI**: шаблон локальной команды, плейсхолдеры подставляются безопасными ссылками
|
|
395
|
+
- Зрение: `{image} {question} {model}` → ответ из stdout
|
|
396
|
+
- Генерация изображений: `{prompt} {output} {size}` → команда должна записать файл в `{output}`
|
|
397
|
+
- Заполните хотя бы одну команду; какая из них заполнена — та и определяет возможность
|
|
398
|
+
|
|
399
|
+
**Тест подключения**: у каждого собственного провайдера есть кнопка проверки
|
|
400
|
+
- API: проверка доступности конечной точки и авторизации, отправка реального запроса зрения для проверки
|
|
401
|
+
- CLI: проверка исполняемого файла, запуск реальной команды для проверки
|
|
402
|
+
- Генерация изображений: только валидация конфигурации, без реального вывода изображения
|
|
403
|
+
|
|
404
|
+
**Заимствованные CLI по подписке** (claude / codex / grok / agy) требуют локального входа в систему; плагин не будет обходить их разрешения за вас.
|
|
405
|
+
|
|
406
|
+
## Режим hub
|
|
407
|
+
|
|
408
|
+
Этот пакет также является полноценным бандлом DSH (`dsh.bundle` + `cordis.patch.yml`). После установки в профиль DSH Web командой `dsh plugin add dsh-crew`:
|
|
409
|
+
|
|
410
|
+
- **Сессии воркеров становятся полноценными**: выполняются как полноценные сессии в хосте DSH (`agents.create` + каскад модель/effort для каждой сессии + пресет по умолчанию), появляются в списке сессий веб-интерфейса, их можно открыть в любой момент, чтобы просмотреть полный ход выполнения
|
|
411
|
+
- **Организация по рабочей директории**: управление сессиями воркеров по cwd в веб-интерфейсе
|
|
412
|
+
- **Loopback API**:
|
|
413
|
+
- `POST/GET /_dsh/dsh-crew/jobs`: запуск задач, список, ожидание результатов (long-poll), отмена
|
|
414
|
+
- `GET /_dsh/dsh-crew/ping`: проверка работоспособности (MCP-прослойка использует её, чтобы определить, запущен ли hub)
|
|
415
|
+
- `POST /_dsh/dsh-crew/install`: установка интеграций хостов в один клик — Claude Code / Codex / Antigravity / Grok (бэкенд `src/install/`)
|
|
416
|
+
- **Автоопределение**: MCP-прослойка хостов автоматически определяет hub (переменная окружения `DSHPLUGIN_CREW_HUB`, по умолчанию `http://127.0.0.1:3080`)
|
|
417
|
+
- DSH Web запущен → задания выполняются в режиме hub (`mode: "hub"`)
|
|
418
|
+
- Не запущен → переключение на автономный рантайм
|
|
419
|
+
|
|
420
|
+
**Проверка процессов Windows:** определение источника и проверенное завершение отдельного процесса используют PowerShell/CIM. API осиротевших процессов отклоняет завершение группы с `unsupported-platform`, не отправляя сигнал.
|
|
421
|
+
|
|
422
|
+
## Выбор решения и ограничения
|
|
423
|
+
|
|
424
|
+
### Обычные подписчики → подход с субагентом-оболочкой (рекомендуется)
|
|
425
|
+
|
|
426
|
+
- **Текущее положение**: оболочка субагента Claude Code использует haiku как посредника; каждая отправка добавляет от сотен до тысяч токенов
|
|
427
|
+
- **Компромисс**: небольшое количество токенов Anthropic в обмен на встроенный интерфейс задач, отображение прогресса в реальном времени и отсутствие дополнительной настройки
|
|
428
|
+
- **Рекомендация**: если у вас уже есть подписка Claude Pro или вы используете Claude Code, выбирайте этот подход — удобно и прозрачно
|
|
429
|
+
|
|
430
|
+
### Оплата по факту / CI-среды → подход с прямым роутером
|
|
431
|
+
|
|
432
|
+
- **Текущее положение**: frontmatter субагента Claude Code не поддерживает прямое подключение сторонних моделей; эксперимент с роутером в scratchpad этого репозитория требует учётных данных API-ключа для Claude Code, но OAuth по подписке блокируется на стороне Anthropic ошибкой 403
|
|
433
|
+
- **Рекомендации**:
|
|
434
|
+
- Если вы используете учётные данные API-ключа (не OAuth) и хотите экономить токены Anthropic, можно запустить локальный роутер для прямого подключения к DeepSeek
|
|
435
|
+
- CI-среды обычно тоже используют API-ключи; этот подход экономичнее (все токены — DeepSeek)
|
|
436
|
+
- Требуется самостоятельная проверка интеграции роутера (официально не поддерживается)
|
|
437
|
+
|
|
438
|
+
### Запущенный DSH Web → режим hub включается автоматически
|
|
439
|
+
|
|
440
|
+
- **Текущее положение**: если `dsh plugin add dsh-crew` установлен в профиль DSH Web, задания выполняются как полноценные сессии в хосте и появляются в списке сессий веб-интерфейса
|
|
441
|
+
- **Рекомендация**: при итерациях локальной разработки рекомендуется включать режим hub — прогресс воркеров можно полностью наблюдать в веб-интерфейсе; для совместной работы на разных машинах или сред без веб-интерфейса используйте подход с оболочкой хоста-отправителя
|
|
442
|
+
|
|
443
|
+
### Известные моменты
|
|
444
|
+
|
|
445
|
+
- Роль Codex теоретически может попробовать `model_provider`, указывающий напрямую на DeepSeek (не проверено); этот мост от него не зависит
|
|
446
|
+
- Результат генерации изображений — плоский растр; для редактирования слоёв требуется OpenPencil
|
|
447
|
+
- **Зависимости рантайма**: только `@modelcontextprotocol/sdk` и `zod`; `@deepseek-ai/*` — рантайм хоста (предоставляется хостом DSH; обычная установка npm их не ставит)
|
|
448
|
+
- **Для Codex обязательно настроить**: `default_tools_approval_mode = "approve"`, иначе вызовы инструментов автоматически отменяются
|
|
449
|
+
|
|
450
|
+
## Разработка
|
|
451
|
+
|
|
452
|
+
```bash
|
|
453
|
+
pnpm install
|
|
454
|
+
node_modules/.bin/tsdown src/client/index.tsx --format cjs --platform browser \
|
|
455
|
+
--target es2022 --tsconfig tsconfig.client.json --out-dir .client-build --clean
|
|
456
|
+
node scripts/build-client.mjs # wraps the bundle for the DSH module loader
|
|
457
|
+
node scripts/smoke.mjs # dispatches one real flash task end to end
|
|
458
|
+
```
|
|
459
|
+
|
|
460
|
+
Зависимости рантайма — только `@modelcontextprotocol/sdk` и `zod`; каждый пакет `@deepseek-ai/*` является рантаймом хоста, предоставляемым хостом DSH (задокументирован в поле dshHostRuntime пакета, а не в peerDependencies, поэтому обычная установка npm их не ставит), что удерживает плагин в едином пространстве модулей хоста.
|
|
461
|
+
|
|
462
|
+
## Экосистема
|
|
463
|
+
|
|
464
|
+
- [DSH Android](https://github.com/ZSeven-W/dsh-android) — живой эмулятор Android или устройство по USB прямо в диалоге, полностью под управлением adb
|
|
465
|
+
- [DSH iOS](https://github.com/ZSeven-W/dsh-ios) — живой симулятор iOS — и iPhone по USB — прямо в диалоге
|
|
466
|
+
- [DSH Noema](https://github.com/ZSeven-W/dsh-noema) — долговременная память для DSH
|
|
467
|
+
- [DSH OpenPencil](https://github.com/ZSeven-W/dsh-openpencil) — просмотр и редактирование дизайн-документов `.op` прямо в диалоге
|
|
468
|
+
|
|
469
|
+
## Лицензия
|
|
470
|
+
|
|
471
|
+
MIT
|
|
472
|
+
|
|
473
|
+
|
|
474
|
+
### `dsh_worker_probe` / `needs_input`
|
|
475
|
+
|
|
476
|
+
`dsh_worker_probe` отправляет один ограниченный по времени вызов без побочных эффектов настроенному маршруту DSH, не создавая worker и не меняя привязки. Возможен расход токенов. Неотвеченный вопрос останавливает worker с `needs_input`; после ответа пользователя отправьте задачу снова. Права хоста наследуются, новый OS sandbox не добавляется.
|
|
477
|
+
|
|
478
|
+
```js
|
|
479
|
+
dsh_worker_probe({ tier: "flash" })
|
|
480
|
+
```
|