@zoraxylia/dsh-codex-adapter 0.1.0 → 0.1.1
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 +2 -2
- package/.claude-plugin/plugin.json +2 -2
- package/.mcp.json +1 -1
- package/README.de.md +32 -32
- package/README.es.md +32 -32
- package/README.fr.md +32 -32
- package/README.hi.md +32 -32
- package/README.id.md +32 -32
- package/README.ja.md +32 -32
- package/README.ko.md +32 -32
- package/README.md +33 -33
- package/README.pt.md +32 -32
- package/README.ru.md +32 -32
- package/README.th.md +32 -32
- package/README.tr.md +32 -32
- package/README.vi.md +32 -32
- package/README.zh-TW.md +32 -32
- package/README.zh.md +33 -33
- package/agy/agents/ds-flash.md +1 -1
- package/agy/agents/ds-pro.md +1 -1
- package/agy/skills/dsh-playbook/SKILL.md +1 -1
- package/codex/agents/ds-flash.toml +2 -2
- package/codex/agents/ds-pro.toml +2 -2
- package/codex/prompts/dsh-playbook.md +1 -1
- package/commands/off.md +1 -1
- package/commands/playbook.md +1 -1
- package/cordis.patch.yml +2 -2
- package/grok/agents/ds-flash.md +1 -1
- package/grok/agents/ds-pro.md +1 -1
- package/grok/commands/dsh-config.md +1 -1
- package/grok/commands/dsh-playbook.md +2 -2
- package/grok/commands/dsh-status.md +1 -1
- package/lib/client.js +37 -27
- package/lib/server.mjs +22 -22
- package/package.json +6 -5
- package/scripts/bump-version.mjs +79 -0
- package/scripts/fake-agy.sh +3 -3
- package/scripts/release-local.mjs +2 -2
- package/scripts/smoke-bundle.mjs +2 -2
- package/scripts/smoke-pack.mjs +4 -4
- package/scripts/smoke.mjs +3 -3
- package/scripts/verify-wpc10-client.mjs +2 -2
- package/scripts/verify-wpc14-proc-endpoints.mjs +6 -6
- package/scripts/verify-wpc9-guardrails.mjs +10 -10
- package/src/cli-workers.mjs +1 -1
- package/src/client/index.tsx +34 -32
- package/src/cwd-lock.mjs +1 -1
- package/src/hub/index.mjs +10 -10
- package/src/hub-client.mjs +4 -4
- package/src/install/install.mjs +35 -32
- package/src/jobs.mjs +2 -2
- package/src/multimodal.mjs +18 -18
- package/src/origin-guard.mjs +8 -8
- package/src/plugin-env.mjs +2 -2
- package/src/proc-kill.mjs +5 -5
- package/src/provider-probe.mjs +3 -3
- package/src/server.mjs +4 -4
- package/src/status-shard.mjs +2 -2
- package/src/vision-route.mjs +3 -3
- package/statusline/statusline.sh +1 -1
- package/statusline/worker-segment.sh +3 -3
- package/worker.cordis.yml +1 -1
- /package/docs/images/{dsh-crew-host.png → dsh-adapter-host.png} +0 -0
- /package/docs/images/{dsh-crew-jobs.png → dsh-adapter-jobs.png} +0 -0
- /package/docs/images/{dsh-crew-logo.png → dsh-adapter-logo.png} +0 -0
- /package/docs/images/{dsh-crew-overview.png → dsh-adapter-overview.png} +0 -0
package/README.ru.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="./docs/images/dsh-
|
|
2
|
+
<img src="./docs/images/dsh-adapter-logo.png" alt="DSH Adapter" width="120" />
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
|
-
<h1 align="center">DSH
|
|
5
|
+
<h1 align="center">DSH Adapter</h1>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
8
|
<strong>Плагин <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>: отправляйте работу агентам DSH из Claude Code / Codex / Antigravity / Grok, не отказываясь от встроенного интерфейса субагентов хоста.</strong><br />
|
|
@@ -24,13 +24,13 @@
|
|
|
24
24
|
<br />
|
|
25
25
|
|
|
26
26
|
<p align="center">
|
|
27
|
-
<img src="./docs/images/dsh-
|
|
27
|
+
<img src="./docs/images/dsh-adapter-overview.png" alt="DSH Adapter — settings page" width="100%" />
|
|
28
28
|
</p>
|
|
29
|
-
<p align="center"><sub>Страница настроек DSH
|
|
29
|
+
<p align="center"><sub>Страница настроек DSH Adapter — интеграции хоста, политика отправки, выполнение и мультимодальный мост</sub></p>
|
|
30
30
|
|
|
31
|
-
## Зачем нужен DSH
|
|
31
|
+
## Зачем нужен DSH Adapter
|
|
32
32
|
|
|
33
|
-
DSH
|
|
33
|
+
DSH Adapter — плагин для [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH), опенсорсного агентского харнесса. Он позволяет отправлять работу агентам DSH из Claude Code, Codex, Antigravity и Grok: оркестратор сохраняет собственную модель, работа выполняется на настоящем агенте DSH с инструментами, песочницей, пресетами и историей сессий этого харнесса, а хост по-прежнему отображает его как встроенного субагента с живым прогрессом.
|
|
34
34
|
|
|
35
35
|
Работу выполняет агент DSH, а не голый вызов модели. Уровни (`flash` / `pro`) определяют, какой объём возможностей получает агент из настроенного списка моделей харнесса — сегодня это DeepSeek V4 Flash и V4 Pro, — поэтому смена модели в DSH не требует изменений здесь.
|
|
36
36
|
|
|
@@ -79,7 +79,7 @@ DSH Crew — плагин для [DeepSeek Harness](https://github.com/deepseek-
|
|
|
79
79
|
|
|
80
80
|
### 📋 Доска задач
|
|
81
81
|
|
|
82
|
-
Панель DSH
|
|
82
|
+
Панель DSH Adapter работает и как доска задач: каждое задание воркера — выполняющееся или завершённое — отображается с tier, effort, живым прогрессом и токенами; занятые рабочие директории показывают своих владельцев, а задание, исчезнувшее на лету (например, перезапуск hub), всплывает как осиротевший призрак, а не исчезает молча.
|
|
83
83
|
|
|
84
84
|
</td>
|
|
85
85
|
</tr>
|
|
@@ -118,14 +118,14 @@ Claude Code / Codex / Antigravity / Grok (orchestrator, keeps its own model)
|
|
|
118
118
|
Диспетчеризация масштабируется вширь. Ниже восемнадцать worker'ов параллельно переводят этот README: хост считает их своими субагентами, а harness выполняет их как настоящие сессии.
|
|
119
119
|
|
|
120
120
|
<p align="center">
|
|
121
|
-
<img src="./docs/images/dsh-
|
|
121
|
+
<img src="./docs/images/dsh-adapter-host.png" alt="Claude Code" width="100%" />
|
|
122
122
|
</p>
|
|
123
|
-
<p align="center"><sub>В Claude Code worker'ы dsh-
|
|
123
|
+
<p align="center"><sub>В Claude Code worker'ы dsh-adapter выглядят как нативные субагенты; сегмент statusline показывает работающие tier'ы, время и токены.</sub></p>
|
|
124
124
|
|
|
125
125
|
<p align="center">
|
|
126
|
-
<img src="./docs/images/dsh-
|
|
126
|
+
<img src="./docs/images/dsh-adapter-jobs.png" alt="DSH Adapter" width="100%" />
|
|
127
127
|
</p>
|
|
128
|
-
<p align="center"><sub>Панель DSH
|
|
128
|
+
<p align="center"><sub>Панель DSH Adapter показывает тот же запуск со стороны harness: какой хост отправил задачу, её tier и effort, прогресс и расход токенов.</sub></p>
|
|
129
129
|
|
|
130
130
|
<p align="center"><sub>Панель — это ещё и доска задач: выполняющиеся и завершённые задания остаются в списке с tier, прогрессом и токенами, занятые рабочие директории называют своих владельцев, а задание, исчезнувшее на лету (перезапуск hub), всплывает как осиротевший призрак, а не исчезает молча.</sub></p>
|
|
131
131
|
|
|
@@ -141,7 +141,7 @@ dsh web
|
|
|
141
141
|
Или для локальной разработки прямо из исходников:
|
|
142
142
|
|
|
143
143
|
```bash
|
|
144
|
-
dsh plugin --profile web add link:/path/to/dsh-
|
|
144
|
+
dsh plugin --profile web add link:/path/to/dsh-adapter
|
|
145
145
|
dsh web
|
|
146
146
|
```
|
|
147
147
|
|
|
@@ -151,7 +151,7 @@ dsh web
|
|
|
151
151
|
|
|
152
152
|
В режиме hub — установке выше — воркеры работают внутри экземпляра DSH и используют учётные данные DeepSeek, которые уже для него настроены. Ничего больше не нужно настраивать.
|
|
153
153
|
|
|
154
|
-
Только standalone-режим (резервный вариант) требует собственного ключа: отправка с хоста без запущенного экземпляра DSH запускает worker runtime в отдельном процессе. Получите API-ключ на [platform.deepseek.com](https://platform.deepseek.com) и запишите его в `~/.config/dsh-
|
|
154
|
+
Только standalone-режим (резервный вариант) требует собственного ключа: отправка с хоста без запущенного экземпляра DSH запускает worker runtime в отдельном процессе. Получите API-ключ на [platform.deepseek.com](https://platform.deepseek.com) и запишите его в `~/.config/dsh-adapter/.env`:
|
|
155
155
|
|
|
156
156
|
```
|
|
157
157
|
DEEPSEEK_API_KEY=sk-...
|
|
@@ -165,7 +165,7 @@ node scripts/smoke.mjs
|
|
|
165
165
|
|
|
166
166
|
Smoke test отправляет одно дешёвое задание по доступному пути — hub, если запущен экземпляр DSH, иначе standalone — и выводит, какой из них был использован. Примерно через десять секунд должно появиться `smoke test passed — configuration OK`. При ошибке печатается причина, относящаяся к проверенному пути.
|
|
167
167
|
|
|
168
|
-
Затем откройте Настройки → DSH
|
|
168
|
+
Затем откройте Настройки → DSH Adapter и установите интеграции хостов — Claude Code, Codex, Antigravity, Grok — одним щелчком или запустите тот же установщик из командной строки:
|
|
169
169
|
|
|
170
170
|
```bash
|
|
171
171
|
node src/install/cli.mjs claude # Claude Code plugin: marketplace + permissions + HUD segment
|
|
@@ -192,7 +192,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
192
192
|
|
|
193
193
|
Установка в один клик (выберите один вариант):
|
|
194
194
|
|
|
195
|
-
- **Страница настроек DSH** (когда установлен режим hub): Settings → DSH
|
|
195
|
+
- **Страница настроек DSH** (когда установлен режим hub): Settings → DSH Adapter → "Install to Claude Code"
|
|
196
196
|
- **Командная строка**: `node src/install/cli.mjs all`
|
|
197
197
|
|
|
198
198
|
Оба варианта делают одно и то же: регистрируют локальный маркетплейс (родительская директория `dsh-plugins/` как корень маркетплейса) + `claude plugin install` + список разрешений инструментов MCP + настройка сегмента статуса воркеров claude-hud (автоматическое резервное копирование settings.json перед изменениями, идемпотентно). **После установки перезапустите сессию, чтобы изменения вступили в силу.**
|
|
@@ -204,7 +204,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
204
204
|
- **Сегмент статусной строки HUD**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (текущий уровень / затраченное время / расход токенов / количество завершённых)
|
|
205
205
|
- При локальной разработке `statusline/statusline.sh` или `statusline/worker-segment.sh` можно интегрировать отдельно
|
|
206
206
|
- **Длительные задачи**: у CC есть лимиты таймаута для вызовов MCP (`MCP_TOOL_TIMEOUT` настраивается); для долгих задач оркестратор может использовать `dsh_spawn_worker` + опрос через `dsh_worker_result(wait_seconds)`
|
|
207
|
-
- **Локальная разработка и отладка**: `claude --plugin-dir /path/to/dsh-
|
|
207
|
+
- **Локальная разработка и отладка**: `claude --plugin-dir /path/to/dsh-adapter` для временной загрузки
|
|
208
208
|
|
|
209
209
|
|
|
210
210
|
### Команды сессии
|
|
@@ -213,11 +213,11 @@ node src/install/cli.mjs uninstall-claude
|
|
|
213
213
|
|
|
214
214
|
| Команда | Что делает |
|
|
215
215
|
|---|---|
|
|
216
|
-
| `/dsh-
|
|
216
|
+
| `/dsh-adapter: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
217
|
|
|
218
|
-
| `/dsh-
|
|
219
|
-
| `/dsh-
|
|
220
|
-
| `/dsh-
|
|
218
|
+
| `/dsh-adapter:on` · `/dsh-adapter:off` | Включить или выключить диспетчеризацию в этой сессии (выключено — жёсткий запрет: инструмент отказывает) |
|
|
219
|
+
| `/dsh-adapter:status` | Статус worker-задач в реальном времени: tier, прогресс, токены, текущий инструмент |
|
|
220
|
+
| `/dsh-adapter:playbook` | Лучшие практики диспетчеризации: выбор flash или pro, самодостаточные задания, параллелизм, проверка результатов, ограждения |
|
|
221
221
|
|
|
222
222
|
## Codex
|
|
223
223
|
|
|
@@ -268,7 +268,7 @@ cp codex/agents/*.toml ~/.codex/agents/ # global or project-level .codex/agen
|
|
|
268
268
|
node src/install/cli.mjs agy
|
|
269
269
|
```
|
|
270
270
|
|
|
271
|
-
Регистрирует MCP-сервер dsh-
|
|
271
|
+
Регистрирует MCP-сервер dsh-adapter в `~/.gemini/config/mcp_config.json` и устанавливает агентов `ds-flash` / `ds-pro` вместе с навыками `dsh-config`, `dsh-status` и `dsh-playbook` в `~/.gemini/config/` (все файлы предварительно резервируются). После установки перезапустите сессию.
|
|
272
272
|
|
|
273
273
|
### Использование
|
|
274
274
|
|
|
@@ -297,7 +297,7 @@ node src/install/cli.mjs agy
|
|
|
297
297
|
node src/install/cli.mjs grok
|
|
298
298
|
```
|
|
299
299
|
|
|
300
|
-
Записывает секцию `[mcp_servers.dsh-
|
|
300
|
+
Записывает секцию `[mcp_servers.dsh-adapter]` в `~/.grok/config.toml` и устанавливает агентов `ds-flash` / `ds-pro` вместе с командами `/dsh-config`, `/dsh-status` и `/dsh-playbook` в `~/.grok/` (все файлы предварительно резервируются).
|
|
301
301
|
|
|
302
302
|
### Использование
|
|
303
303
|
|
|
@@ -329,7 +329,7 @@ node src/install/cli.mjs grok
|
|
|
329
329
|
| `dsh_worker_cancel` | Отмена указанного задания и завершение его процесса рантайма |
|
|
330
330
|
| `dsh_worker_config` | Чтение и задание значений по умолчанию сессии (tier, effort, mode, timeout, policy, escalation), а также список `worker_profiles` |
|
|
331
331
|
|
|
332
|
-
Прогресс одновременно зеркалируется в `~/.config/dsh-
|
|
332
|
+
Прогресс одновременно зеркалируется в `~/.config/dsh-adapter/status.d/` (по одному файлу-шарду на источник записи; его может читать statusline или внешний мониторинг).
|
|
333
333
|
|
|
334
334
|
## Ограждения диспетчеризации
|
|
335
335
|
|
|
@@ -340,7 +340,7 @@ node src/install/cli.mjs grok
|
|
|
340
340
|
|
|
341
341
|
## Плейбук диспетчеризации
|
|
342
342
|
|
|
343
|
-
Как отправлять задачи *хорошо* — выбор flash или pro, самодостаточные задания, безопасный параллелизм, проверка результатов и описанные выше ограждения — собрано в плейбук для каждого хоста: `/dsh-
|
|
343
|
+
Как отправлять задачи *хорошо* — выбор flash или pro, самодостаточные задания, безопасный параллелизм, проверка результатов и описанные выше ограждения — собрано в плейбук для каждого хоста: `/dsh-adapter:playbook` (навык Claude Code), `/dsh-playbook` (промпт Codex, навык Antigravity, команда Grok).
|
|
344
344
|
|
|
345
345
|
## Явные CLI-бэкенды
|
|
346
346
|
|
|
@@ -350,7 +350,7 @@ node src/install/cli.mjs grok
|
|
|
350
350
|
|
|
351
351
|
**DeepSeek — текстовая модель**, не поддерживающая ввод и генерацию изображений. Этот плагин получает эти возможности извне через инструменты MCP:
|
|
352
352
|
|
|
353
|
-
**Сначала нативное зрение**: когда провайдер зрения — встроенный CLI (или явно `native`), `describe_image` сначала пробует собственную VL-модель DeepSeek `deepseek-v4-flash-vision-exp` (прямой вызов API; ключ из `DEEPSEEK_API_KEY` или `~/.config/dsh-
|
|
353
|
+
**Сначала нативное зрение**: когда провайдер зрения — встроенный CLI (или явно `native`), `describe_image` сначала пробует собственную VL-модель DeepSeek `deepseek-v4-flash-vision-exp` (прямой вызов API; ключ из `DEEPSEEK_API_KEY` или `~/.config/dsh-adapter/.env`). Любая ошибка плавно деградирует к цепочке CLI-провайдеров ниже, которая остаётся резервным вариантом. Генерация изображений не затрагивается — нативная модель только смотрит на изображения.
|
|
354
354
|
|
|
355
355
|
| Инструмент | Описание |
|
|
356
356
|
|---|---|
|
|
@@ -361,7 +361,7 @@ node src/install/cli.mjs grok
|
|
|
361
361
|
|
|
362
362
|
### Конфигурация
|
|
363
363
|
|
|
364
|
-
На **странице настроек DSH → DSH
|
|
364
|
+
На **странице настроек DSH → DSH Adapter → Multimodal** (или отредактируйте `~/.config/dsh-adapter/config.json` напрямую):
|
|
365
365
|
|
|
366
366
|
**Провайдер зрения** (просмотр изображений):
|
|
367
367
|
|
|
@@ -405,15 +405,15 @@ node src/install/cli.mjs grok
|
|
|
405
405
|
|
|
406
406
|
## Режим hub
|
|
407
407
|
|
|
408
|
-
Этот пакет также является полноценным бандлом DSH (`dsh.bundle` + `cordis.patch.yml`). После установки в профиль DSH Web командой `dsh plugin add dsh-
|
|
408
|
+
Этот пакет также является полноценным бандлом DSH (`dsh.bundle` + `cordis.patch.yml`). После установки в профиль DSH Web командой `dsh plugin add dsh-adapter`:
|
|
409
409
|
|
|
410
410
|
- **Сессии воркеров становятся полноценными**: выполняются как полноценные сессии в хосте DSH (`agents.create` + каскад модель/effort для каждой сессии + пресет по умолчанию), появляются в списке сессий веб-интерфейса, их можно открыть в любой момент, чтобы просмотреть полный ход выполнения
|
|
411
411
|
- **Организация по рабочей директории**: управление сессиями воркеров по cwd в веб-интерфейсе
|
|
412
412
|
- **Loopback API**:
|
|
413
|
-
- `POST/GET /_dsh/dsh-
|
|
414
|
-
- `GET /_dsh/dsh-
|
|
415
|
-
- `POST /_dsh/dsh-
|
|
416
|
-
- **Автоопределение**: MCP-прослойка хостов автоматически определяет hub (переменная окружения `
|
|
413
|
+
- `POST/GET /_dsh/dsh-adapter/jobs`: запуск задач, список, ожидание результатов (long-poll), отмена
|
|
414
|
+
- `GET /_dsh/dsh-adapter/ping`: проверка работоспособности (MCP-прослойка использует её, чтобы определить, запущен ли hub)
|
|
415
|
+
- `POST /_dsh/dsh-adapter/install`: установка интеграций хостов в один клик — Claude Code / Codex / Antigravity / Grok (бэкенд `src/install/`)
|
|
416
|
+
- **Автоопределение**: MCP-прослойка хостов автоматически определяет hub (переменная окружения `DSHPLUGIN_ADAPTER_HUB`, по умолчанию `http://127.0.0.1:3080`)
|
|
417
417
|
- DSH Web запущен → задания выполняются в режиме hub (`mode: "hub"`)
|
|
418
418
|
- Не запущен → переключение на автономный рантайм
|
|
419
419
|
|
|
@@ -437,7 +437,7 @@ node src/install/cli.mjs grok
|
|
|
437
437
|
|
|
438
438
|
### Запущенный DSH Web → режим hub включается автоматически
|
|
439
439
|
|
|
440
|
-
- **Текущее положение**: если `dsh plugin add dsh-
|
|
440
|
+
- **Текущее положение**: если `dsh plugin add dsh-adapter` установлен в профиль DSH Web, задания выполняются как полноценные сессии в хосте и появляются в списке сессий веб-интерфейса
|
|
441
441
|
- **Рекомендация**: при итерациях локальной разработки рекомендуется включать режим hub — прогресс воркеров можно полностью наблюдать в веб-интерфейсе; для совместной работы на разных машинах или сред без веб-интерфейса используйте подход с оболочкой хоста-отправителя
|
|
442
442
|
|
|
443
443
|
### Известные моменты
|
package/README.th.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="./docs/images/dsh-
|
|
2
|
+
<img src="./docs/images/dsh-adapter-logo.png" alt="DSH Adapter" width="120" />
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
|
-
<h1 align="center">DSH
|
|
5
|
+
<h1 align="center">DSH Adapter</h1>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
8
|
<strong>ปลั๊กอินสำหรับ <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>: ส่งงานให้ DSH agents จาก Claude Code / Codex / Antigravity / Grok โดยไม่ต้องสละ subagent UI ดั้งเดิมของโฮสต์</strong><br />
|
|
@@ -24,13 +24,13 @@
|
|
|
24
24
|
<br />
|
|
25
25
|
|
|
26
26
|
<p align="center">
|
|
27
|
-
<img src="./docs/images/dsh-
|
|
27
|
+
<img src="./docs/images/dsh-adapter-overview.png" alt="DSH Adapter — settings page" width="100%" />
|
|
28
28
|
</p>
|
|
29
|
-
<p align="center"><sub>หน้า settings ของ DSH
|
|
29
|
+
<p align="center"><sub>หน้า settings ของ DSH Adapter — การเชื่อมต่อโฮสต์ นโยบายการส่งงาน การทำงาน และสะพาน multimodal</sub></p>
|
|
30
30
|
|
|
31
|
-
## ทำไมต้อง DSH
|
|
31
|
+
## ทำไมต้อง DSH Adapter
|
|
32
32
|
|
|
33
|
-
DSH
|
|
33
|
+
DSH Adapter เป็นปลั๊กอินสำหรับ [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) — agent harness แบบโอเพนซอร์ส มันทำให้ DSH agents ถูกสั่งงานจาก Claude Code, Codex, Antigravity และ Grok ได้: orchestrator คงใช้โมเดลของตัวเอง งานรันบน DSH agent จริงพร้อม tools, sandbox, presets และ session history ของ harness นั้น และโฮสต์ยังคงแสดงผลเป็น subagent แบบเนทีฟพร้อมความคืบหน้าแบบเรียลไทม์
|
|
34
34
|
|
|
35
35
|
สิ่งที่รันงานคือ DSH agent ไม่ใช่การเรียกโมเดลเปล่าๆ Tier (`flash` / `pro`) กำหนดว่า agent นั้นจะได้ capability มากแค่ไหนจาก roster โมเดลที่ตั้งค่าไว้ใน harness — ปัจจุบันคือ DeepSeek V4 Flash และ V4 Pro — ดังนั้นการเปลี่ยนโมเดลใน DSH ไม่ต้องแก้ไขอะไรที่นี่
|
|
36
36
|
|
|
@@ -79,7 +79,7 @@ Workers ปรากฏเป็น subagent ปกติใน Claude Code / Co
|
|
|
79
79
|
|
|
80
80
|
### 📋 กระดานงาน
|
|
81
81
|
|
|
82
|
-
แผง DSH
|
|
82
|
+
แผง DSH Adapter ทำหน้าที่เป็นกระดานงานด้วย: งาน worker ทุกงาน — กำลังรันหรือเสร็จแล้ว — ถูกแสดงพร้อม tier, effort, ความคืบหน้าแบบเรียลไทม์และ tokens workspace ที่ถูกถือครองแสดงผู้ถือของมัน และงานที่หายไประหว่างทาง (เช่น hub restart) จะถูกแสดงเป็น orphan ghost แทนที่จะหายไปเงียบๆ
|
|
83
83
|
|
|
84
84
|
</td>
|
|
85
85
|
</tr>
|
|
@@ -118,14 +118,14 @@ Claude Code / Codex / Antigravity / Grok (orchestrator, keeps its own model)
|
|
|
118
118
|
การ dispatch ขยายออกได้กว้าง ด้านล่างมี worker สิบแปดตัวแปล README นี้พร้อมกัน: ฝั่ง host นับพวกมันเป็น subagent ของตัวเอง ส่วน harness รันพวกมันเป็นเซสชันจริง
|
|
119
119
|
|
|
120
120
|
<p align="center">
|
|
121
|
-
<img src="./docs/images/dsh-
|
|
121
|
+
<img src="./docs/images/dsh-adapter-host.png" alt="Claude Code" width="100%" />
|
|
122
122
|
</p>
|
|
123
|
-
<p align="center"><sub>ใน Claude Code worker ของ dsh-
|
|
123
|
+
<p align="center"><sub>ใน Claude Code worker ของ dsh-adapter ปรากฏเป็น subagent ดั้งเดิม และส่วน statusline แสดง tier ที่กำลังทำงาน เวลาที่ใช้ และ token</sub></p>
|
|
124
124
|
|
|
125
125
|
<p align="center">
|
|
126
|
-
<img src="./docs/images/dsh-
|
|
126
|
+
<img src="./docs/images/dsh-adapter-jobs.png" alt="DSH Adapter" width="100%" />
|
|
127
127
|
</p>
|
|
128
|
-
<p align="center"><sub>แผง DSH
|
|
128
|
+
<p align="center"><sub>แผง DSH Adapter แสดงการรันเดียวกันจากฝั่ง harness: host ใดส่งงานไหน tier และ effort ความคืบหน้าแบบเรียลไทม์ และการใช้ token</sub></p>
|
|
129
129
|
|
|
130
130
|
<p align="center"><sub>แผงนี้ยังเป็นกระดานงานด้วย: งานที่กำลังรันและที่เสร็จแล้วยังคงแสดงอยู่ในรายการพร้อม tier ความคืบหน้าและ tokens workspace ที่ถูกถือครองระบุชื่อผู้ถือ และงานที่หายไประหว่างทาง (hub restart) จะปรากฏเป็น orphan ghost แทนที่จะหายไปเงียบๆ</sub></p>
|
|
131
131
|
|
|
@@ -141,7 +141,7 @@ dsh web
|
|
|
141
141
|
หรือสำหรับการพัฒนาในเครื่องจากซอร์ส:
|
|
142
142
|
|
|
143
143
|
```bash
|
|
144
|
-
dsh plugin --profile web add link:/path/to/dsh-
|
|
144
|
+
dsh plugin --profile web add link:/path/to/dsh-adapter
|
|
145
145
|
dsh web
|
|
146
146
|
```
|
|
147
147
|
|
|
@@ -151,7 +151,7 @@ dsh web
|
|
|
151
151
|
|
|
152
152
|
ในโหมด hub — การติดตั้งข้างบน — worker รันภายใน DSH instance และใช้ข้อมูลรับรอง DeepSeek ที่มีการตั้งค่าไว้แล้ว ไม่ต้องตั้งค่าอะไรเพิ่มเติม
|
|
153
153
|
|
|
154
|
-
เฉพาะ standalone fallback เท่านั้นที่ต้องใช้ key ของตัวเอง: การส่งงานจากโฮสต์ที่ไม่มี DSH instance ทำงานจะเปิดตัว worker runtime เป็นกระบวนการแยกต่างหาก ขอ API key จาก [platform.deepseek.com](https://platform.deepseek.com) และเขียนลงใน `~/.config/dsh-
|
|
154
|
+
เฉพาะ standalone fallback เท่านั้นที่ต้องใช้ key ของตัวเอง: การส่งงานจากโฮสต์ที่ไม่มี DSH instance ทำงานจะเปิดตัว worker runtime เป็นกระบวนการแยกต่างหาก ขอ API key จาก [platform.deepseek.com](https://platform.deepseek.com) และเขียนลงใน `~/.config/dsh-adapter/.env`:
|
|
155
155
|
|
|
156
156
|
```
|
|
157
157
|
DEEPSEEK_API_KEY=sk-...
|
|
@@ -165,7 +165,7 @@ node scripts/smoke.mjs
|
|
|
165
165
|
|
|
166
166
|
smoke test ส่งงาน job หนึ่งอันราคาถูกผ่านเส้นทางใดๆ ที่มีอยู่ — hub เมื่อ DSH instance ทำงานอยู่ standalone ในกรณีอื่น — และพิมพ์เส้นทางที่ใช้ ภายในประมาณสิบวินาที คุณควรเห็น `smoke test passed — configuration OK` เมื่อล้มเหลว เหตุผลจะถูกพิมพ์ ซึ่งกำหนดไว้สำหรับเส้นทางที่ทดสอบ
|
|
167
167
|
|
|
168
|
-
จากนั้นเปิด การตั้งค่า → DSH
|
|
168
|
+
จากนั้นเปิด การตั้งค่า → DSH Adapter แล้วติดตั้งการเชื่อมต่อของโฮสต์ — Claude Code, Codex, Antigravity, Grok — ด้วยคลิกเดียว หรือเรียกใช้ตัวติดตั้งเดียวกันจากบรรทัดคำสั่ง:
|
|
169
169
|
|
|
170
170
|
```bash
|
|
171
171
|
node src/install/cli.mjs claude # ปลั๊กอิน Claude Code: marketplace + สิทธิ์ + HUD segment
|
|
@@ -192,7 +192,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
192
192
|
|
|
193
193
|
ติดตั้งในคลิกเดียว (เลือกอย่างใดอย่างหนึ่ง):
|
|
194
194
|
|
|
195
|
-
- **หน้า settings ของ DSH** (เมื่อติดตั้งโหมด hub แล้ว): Settings → DSH
|
|
195
|
+
- **หน้า settings ของ DSH** (เมื่อติดตั้งโหมด hub แล้ว): Settings → DSH Adapter → "Install to Claude Code"
|
|
196
196
|
- **บรรทัดคำสั่ง**: `node src/install/cli.mjs all`
|
|
197
197
|
|
|
198
198
|
ทั้งสองวิธีทำสิ่งเดียวกัน: ลงทะเบียน marketplace ในเครื่อง (ไดเรกทอรีแม่ `dsh-plugins/` เป็น marketplace root) + `claude plugin install` + allowlist สิทธิ์ของ MCP tool + ตั้งค่า claude-hud worker status segment (สำรอง settings.json อัตโนมัติก่อนแก้ไข และรันซ้ำได้โดยปลอดภัย) **รีสตาร์ท session หลังติดตั้งเพื่อให้การเปลี่ยนแปลงมีผล**
|
|
@@ -204,7 +204,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
204
204
|
- **HUD status line segment**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (tier ปัจจุบัน / เวลาที่ผ่านไป / การใช้ token / จำนวนที่เสร็จ)
|
|
205
205
|
- สำหรับการพัฒนาในเครื่อง `statusline/statusline.sh` หรือ `statusline/worker-segment.sh` สามารถเชื่อมต่อแยกอิสระได้
|
|
206
206
|
- **งานที่รันนาน**: CC มีการจำกัด timeout ของการเรียก MCP (ปรับ `MCP_TOOL_TIMEOUT` ได้) งานที่ยาวสามารถให้ orchestrator ใช้ `dsh_spawn_worker` + `dsh_worker_result(wait_seconds)` เพื่อ polling ได้
|
|
207
|
-
- **การพัฒนาและดีบักในเครื่อง**: `claude --plugin-dir /path/to/dsh-
|
|
207
|
+
- **การพัฒนาและดีบักในเครื่อง**: `claude --plugin-dir /path/to/dsh-adapter` เพื่อโหลดชั่วคราว
|
|
208
208
|
|
|
209
209
|
|
|
210
210
|
### คำสั่งระดับเซสชัน
|
|
@@ -213,11 +213,11 @@ node src/install/cli.mjs uninstall-claude
|
|
|
213
213
|
|
|
214
214
|
| คำสั่ง | ทำอะไร |
|
|
215
215
|
|---|---|
|
|
216
|
-
| `/dsh-
|
|
216
|
+
| `/dsh-adapter: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
217
|
|
|
218
|
-
| `/dsh-
|
|
219
|
-
| `/dsh-
|
|
220
|
-
| `/dsh-
|
|
218
|
+
| `/dsh-adapter:on` · `/dsh-adapter:off` | เปิดหรือปิดการ dispatch ของเซสชันนี้ (ปิดคือสวิตช์แข็ง เครื่องมือจะปฏิเสธ) |
|
|
219
|
+
| `/dsh-adapter:status` | สถานะสดของงาน worker: tier ความคืบหน้า tokens และเครื่องมือปัจจุบัน |
|
|
220
|
+
| `/dsh-adapter:playbook` | แนวปฏิบัติที่ดีที่สุดในการ dispatch: การเลือก flash vs pro, บรีฟที่ครบถ้วนในตัวเอง, การทำงานแบบขนาน, การตรวจสอบผลลัพธ์, ราวกันตก |
|
|
221
221
|
|
|
222
222
|
## Codex
|
|
223
223
|
|
|
@@ -268,7 +268,7 @@ cp codex/agents/*.toml ~/.codex/agents/ # global or project-level .codex/agen
|
|
|
268
268
|
node src/install/cli.mjs agy
|
|
269
269
|
```
|
|
270
270
|
|
|
271
|
-
ลงทะเบียน dsh-
|
|
271
|
+
ลงทะเบียน dsh-adapter MCP server ใน `~/.gemini/config/mcp_config.json` และติดตั้ง `ds-flash` / `ds-pro` agents พร้อม skill `dsh-config`, `dsh-status` และ `dsh-playbook` ลงใน `~/.gemini/config/` (สำรองไฟล์ทั้งหมดก่อนแก้ไข) รีสตาร์ทเซสชันหลังการติดตั้ง
|
|
272
272
|
|
|
273
273
|
### วิธีใช้งาน
|
|
274
274
|
|
|
@@ -297,7 +297,7 @@ node src/install/cli.mjs agy
|
|
|
297
297
|
node src/install/cli.mjs grok
|
|
298
298
|
```
|
|
299
299
|
|
|
300
|
-
เขียนส่วน `[mcp_servers.dsh-
|
|
300
|
+
เขียนส่วน `[mcp_servers.dsh-adapter]` ลงใน `~/.grok/config.toml` และติดตั้ง `ds-flash` / `ds-pro` agents พร้อมคำสั่ง `/dsh-config`, `/dsh-status` และ `/dsh-playbook` ลงใน `~/.grok/` (สำรองไฟล์ทั้งหมดก่อนแก้ไข)
|
|
301
301
|
|
|
302
302
|
### วิธีใช้งาน
|
|
303
303
|
|
|
@@ -329,7 +329,7 @@ node src/install/cli.mjs grok
|
|
|
329
329
|
| `dsh_worker_cancel` | ยกเลิก job ที่ระบุ พร้อมยุติ runtime process ของมัน |
|
|
330
330
|
| `dsh_worker_config` | อ่าน/ตั้งค่าเริ่มต้นของเซสชัน (tier, effort, mode, timeout, policy, escalation) และแสดงรายการ `worker_profiles` |
|
|
331
331
|
|
|
332
|
-
ความคืบหน้าจะถูก mirror ไปยัง `~/.config/dsh-
|
|
332
|
+
ความคืบหน้าจะถูก mirror ไปยัง `~/.config/dsh-adapter/status.d/` พร้อมกัน (หนึ่งไฟล์ shard ต่อผู้เขียนหนึ่งราย statusline / ระบบ monitoring ภายนอกอ่านได้)
|
|
333
333
|
|
|
334
334
|
## ราวกันตกของการ Dispatch
|
|
335
335
|
|
|
@@ -340,7 +340,7 @@ node src/install/cli.mjs grok
|
|
|
340
340
|
|
|
341
341
|
## เพลย์บุ๊กการ Dispatch
|
|
342
342
|
|
|
343
|
-
วิธี dispatch ให้ *ดี* — flash vs pro, บรีฟที่ครบถ้วนในตัวเอง, การทำงานแบบขนานที่ปลอดภัย, การตรวจสอบผลลัพธ์ และราวกันตกข้างบน — รวมอยู่ใน playbook ประจำโฮสต์: `/dsh-
|
|
343
|
+
วิธี dispatch ให้ *ดี* — flash vs pro, บรีฟที่ครบถ้วนในตัวเอง, การทำงานแบบขนานที่ปลอดภัย, การตรวจสอบผลลัพธ์ และราวกันตกข้างบน — รวมอยู่ใน playbook ประจำโฮสต์: `/dsh-adapter:playbook` (Claude Code skill), `/dsh-playbook` (Codex prompt, Antigravity skill, Grok command)
|
|
344
344
|
|
|
345
345
|
## แบ็กเอนด์ CLI แบบระบุเจาะจง
|
|
346
346
|
|
|
@@ -350,7 +350,7 @@ node src/install/cli.mjs grok
|
|
|
350
350
|
|
|
351
351
|
**DeepSeek เป็นโมเดลแบบข้อความล้วน** ไม่รองรับการรับภาพหรือการสร้างภาพ ปลั๊กอินนี้ดึง capability เหล่านี้จากภายนอกผ่าน MCP tools:
|
|
352
352
|
|
|
353
|
-
**Native vision ก่อนเสมอ**: เมื่อ vision provider เป็น CLI ในตัว (หรือระบุ `native` อย่างชัดเจน) `describe_image` จะลองใช้ VL model ของ DeepSeek เอง `deepseek-v4-flash-vision-exp` ก่อน (เรียก API โดยตรง; key จาก `DEEPSEEK_API_KEY` หรือ `~/.config/dsh-
|
|
353
|
+
**Native vision ก่อนเสมอ**: เมื่อ vision provider เป็น CLI ในตัว (หรือระบุ `native` อย่างชัดเจน) `describe_image` จะลองใช้ VL model ของ DeepSeek เอง `deepseek-v4-flash-vision-exp` ก่อน (เรียก API โดยตรง; key จาก `DEEPSEEK_API_KEY` หรือ `~/.config/dsh-adapter/.env`) ความล้มเหลวใดๆ จะลดระดับลงไปยังสาย CLI provider ด้านล่างอย่างนุ่มนวล ซึ่งยังคงเก็บไว้เป็น fallback การสร้างภาพไม่ถูกแตะต้อง — native model ใช้ดูภาพเท่านั้น
|
|
354
354
|
|
|
355
355
|
| เครื่องมือ | คำอธิบาย |
|
|
356
356
|
|---|---|
|
|
@@ -361,7 +361,7 @@ node src/install/cli.mjs grok
|
|
|
361
361
|
|
|
362
362
|
### การตั้งค่า
|
|
363
363
|
|
|
364
|
-
ใน **หน้า settings ของ DSH → DSH
|
|
364
|
+
ใน **หน้า settings ของ DSH → DSH Adapter → Multimodal** (หรือแก้ไข `~/.config/dsh-adapter/config.json` โดยตรง):
|
|
365
365
|
|
|
366
366
|
**Vision provider** (การดูภาพ):
|
|
367
367
|
|
|
@@ -405,15 +405,15 @@ node src/install/cli.mjs grok
|
|
|
405
405
|
|
|
406
406
|
## โหมด Hub
|
|
407
407
|
|
|
408
|
-
แพ็กเกจนี้ยังเป็น DSH bundle ที่สมบูรณ์ด้วย (`dsh.bundle` + `cordis.patch.yml`) หลังจากติดตั้งลงใน DSH Web profile ด้วย `dsh plugin add dsh-
|
|
408
|
+
แพ็กเกจนี้ยังเป็น DSH bundle ที่สมบูรณ์ด้วย (`dsh.bundle` + `cordis.patch.yml`) หลังจากติดตั้งลงใน DSH Web profile ด้วย `dsh plugin add dsh-adapter`:
|
|
409
409
|
|
|
410
410
|
- **Worker sessions กลายเป็นพลเมืองชั้นหนึ่ง**: รันเป็น session ชั้นหนึ่งในโฮสต์ DSH (`agents.create` + model/effort waterfall ต่อ session + preset เริ่มต้น) ปรากฏในรายการ session ของ Web UI เปิดดูการทำงานทั้งหมดได้ทุกเมื่อ
|
|
411
411
|
- **จัดระเบียบตาม working directory**: จัดการ worker sessions ตาม cwd ใน Web UI
|
|
412
412
|
- **Loopback API**:
|
|
413
|
-
- `POST/GET /_dsh/dsh-
|
|
414
|
-
- `GET /_dsh/dsh-
|
|
415
|
-
- `POST /_dsh/dsh-
|
|
416
|
-
- **การตรวจจับอัตโนมัติ**: MCP shim ของโฮสต์ต่างๆ ตรวจจับ hub โดยอัตโนมัติ (env var `
|
|
413
|
+
- `POST/GET /_dsh/dsh-adapter/jobs`: สร้างงาน แสดงรายการ long-poll ผลลัพธ์ ยกเลิก
|
|
414
|
+
- `GET /_dsh/dsh-adapter/ping`: ตรวจสุขภาพ (MCP shim ใช้ endpoint นี้ตรวจจับว่า hub ทำงานอยู่หรือไม่)
|
|
415
|
+
- `POST /_dsh/dsh-adapter/install`: ติดตั้งการเชื่อมต่อของโฮสต์ — Claude Code / Codex / Antigravity / Grok ในคลิกเดียว (backend ของ `src/install/`)
|
|
416
|
+
- **การตรวจจับอัตโนมัติ**: MCP shim ของโฮสต์ต่างๆ ตรวจจับ hub โดยอัตโนมัติ (env var `DSHPLUGIN_ADAPTER_HUB` ค่าเริ่มต้น `http://127.0.0.1:3080`)
|
|
417
417
|
- DSH Web ทำงานอยู่ → jobs เข้าสู่โหมด hub (`mode: "hub"`)
|
|
418
418
|
- ไม่ได้ทำงานอยู่ → fallback ไปยัง runtime แบบ standalone
|
|
419
419
|
|
|
@@ -437,7 +437,7 @@ node src/install/cli.mjs grok
|
|
|
437
437
|
|
|
438
438
|
### เมื่อ DSH Web ทำงานอยู่ → โหมด hub เปิดใช้อัตโนมัติ
|
|
439
439
|
|
|
440
|
-
- **สถานะปัจจุบัน**: หากติดตั้ง `dsh plugin add dsh-
|
|
440
|
+
- **สถานะปัจจุบัน**: หากติดตั้ง `dsh plugin add dsh-adapter` ลงใน DSH Web profile แล้ว jobs จะรันเป็น session ชั้นหนึ่งในโฮสต์และปรากฏในรายการ session ของ Web UI
|
|
441
441
|
- **ข้อแนะนำ**: ระหว่างการพัฒนาในเครื่อง แนะนำให้เปิดโหมด hub เพราะสามารถสังเกตความคืบหน้าของ worker ได้ครบถ้วนใน Web UI สำหรับการทำงานร่วมกันข้ามเครื่องหรือสภาพแวดล้อมที่ไม่มี Web UI ให้ใช้แนวทาง shell ของโฮสต์ที่ส่งงาน
|
|
442
442
|
|
|
443
443
|
### เรื่องที่ทราบอยู่แล้ว
|