@zoraxylia/dsh-codex-adapter 0.1.0 → 0.1.2
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 +31 -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.id.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>Plugin <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>: dispatch pekerjaan ke agen DSH dari Claude Code / Codex / Antigravity / Grok, tanpa kehilangan UI subagent bawaan host.</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>Halaman pengaturan DSH
|
|
29
|
+
<p align="center"><sub>Halaman pengaturan DSH Adapter — integrasi host, kebijakan dispatch, eksekusi, dan jembatan multimodal</sub></p>
|
|
30
30
|
|
|
31
|
-
## Mengapa DSH
|
|
31
|
+
## Mengapa DSH Adapter
|
|
32
32
|
|
|
33
|
-
DSH
|
|
33
|
+
DSH Adapter adalah plugin untuk [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) — harness agen sumber terbuka. Plugin ini membuat agen DSH dapat di-dispatch dari Claude Code, Codex, Antigravity dan Grok: orchestrator tetap memakai modelnya sendiri, pekerjaan berjalan pada agen DSH sungguhan dengan tools, sandbox, preset, dan riwayat sesi milik harness tersebut, dan host tetap menampilkannya sebagai subagent bawaan dengan progres langsung.
|
|
34
34
|
|
|
35
35
|
Yang menjalankan pekerjaan adalah agen DSH, bukan panggilan model biasa. Tier (`flash` / `pro`) menentukan seberapa besar kapabilitas yang didapat agen tersebut dari roster yang dikonfigurasi di harness — saat ini DeepSeek V4 Flash dan V4 Pro — sehingga pergantian model di DSH tidak memerlukan perubahan apa pun di sini.
|
|
36
36
|
|
|
@@ -79,7 +79,7 @@ Setiap dispatch diperiksa sebelum apa pun dijalankan. Nesting worker→worker di
|
|
|
79
79
|
|
|
80
80
|
### 📋 Papan Job
|
|
81
81
|
|
|
82
|
-
Panel DSH
|
|
82
|
+
Panel DSH Adapter berfungsi ganda sebagai papan job: setiap job worker — berjalan maupun selesai — tercantum dengan tier, effort, progres langsung, dan token, workspace yang dipegang menampilkan pemegangnya, dan job yang hilang di tengah jalan (mis. restart hub) dimunculkan sebagai orphan ghost alih-alih menghilang diam-diam.
|
|
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 bisa melebar. Di bawah ini delapan belas worker menerjemahkan README ini secara paralel: host menghitungnya sebagai subagent miliknya, sementara harness menjalankannya sebagai sesi nyata.
|
|
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>Di Claude Code, worker dsh-
|
|
123
|
+
<p align="center"><sub>Di Claude Code, worker dsh-adapter tampil sebagai subagent native; segmen statusline menampilkan tier yang berjalan, waktu berjalan, dan 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>Panel DSH
|
|
128
|
+
<p align="center"><sub>Panel DSH Adapter melihat eksekusi yang sama dari sisi harness: host mana yang mengirim setiap job, tier dan effort-nya, progres langsung, dan pemakaian token.</sub></p>
|
|
129
129
|
|
|
130
130
|
<p align="center"><sub>Panel ini juga merupakan papan job: job yang berjalan dan yang selesai tetap tercantum dengan tier, progres, dan token, workspace yang dipegang menyebut nama pemegangnya, dan job yang hilang di tengah jalan (restart hub) dimunculkan sebagai orphan ghost alih-alih menghilang diam-diam.</sub></p>
|
|
131
131
|
|
|
@@ -141,7 +141,7 @@ dsh web
|
|
|
141
141
|
Atau, untuk pengembangan lokal langsung dari kode sumber:
|
|
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 @@ Protokol `link:` menautkan dependensi profil ke repositori ini, sehingga hasil r
|
|
|
151
151
|
|
|
152
152
|
Dalam hub mode — instalasi di atas — worker berjalan di dalam instance DSH dan menggunakan kredensial DeepSeek yang sudah dikonfigurasi. Tidak perlu setup apa pun.
|
|
153
153
|
|
|
154
|
-
Hanya fallback standalone yang memerlukan key sendiri: ketika dispatch dari host tanpa instance DSH yang berjalan, worker runtime diluncurkan sebagai proses terpisah. Ambil API key di [platform.deepseek.com](https://platform.deepseek.com) lalu tulis ke `~/.config/dsh-
|
|
154
|
+
Hanya fallback standalone yang memerlukan key sendiri: ketika dispatch dari host tanpa instance DSH yang berjalan, worker runtime diluncurkan sebagai proses terpisah. Ambil API key di [platform.deepseek.com](https://platform.deepseek.com) lalu tulis ke `~/.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 mengirim satu job murah melalui path yang tersedia — hub saat instance DSH sedang berjalan, standalone sebaliknya — dan mencetak path mana yang digunakan. Dalam sekitar sepuluh detik akan muncul `smoke test passed — configuration OK`. Jika gagal, alasannya dicetak dan dibatasi pada path yang diuji.
|
|
167
167
|
|
|
168
|
-
Lalu buka Pengaturan → DSH
|
|
168
|
+
Lalu buka Pengaturan → DSH Adapter dan pasang integrasi host — Claude Code, Codex, Antigravity, Grok — dengan sekali klik, atau jalankan installer yang sama dari baris perintah:
|
|
169
169
|
|
|
170
170
|
```bash
|
|
171
171
|
node src/install/cli.mjs claude # plugin Claude Code: marketplace + izin + segmen HUD
|
|
@@ -192,7 +192,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
192
192
|
|
|
193
193
|
Instalasi sekali klik (pilih salah satu):
|
|
194
194
|
|
|
195
|
-
- **Halaman pengaturan DSH** (saat mode hub terpasang): Settings → DSH
|
|
195
|
+
- **Halaman pengaturan DSH** (saat mode hub terpasang): Settings → DSH Adapter → "Install to Claude Code"
|
|
196
196
|
- **Baris perintah**: `node src/install/cli.mjs all`
|
|
197
197
|
|
|
198
198
|
Keduanya melakukan hal yang sama: mendaftarkan marketplace lokal (direktori induk `dsh-plugins/` sebagai root marketplace) + `claude plugin install` + daftar izin tool MCP + konfigurasi segmen status worker claude-hud (mencadangkan settings.json otomatis sebelum perubahan, idempotent). **Mulai ulang sesi setelah instalasi agar perubahan diterapkan.**
|
|
@@ -204,7 +204,7 @@ Keduanya melakukan hal yang sama: mendaftarkan marketplace lokal (direktori indu
|
|
|
204
204
|
- **Segmen status line HUD**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (tier saat ini / waktu berjalan / penggunaan token / jumlah selesai)
|
|
205
205
|
- Untuk pengembangan lokal, `statusline/statusline.sh` atau `statusline/worker-segment.sh` dapat diintegrasikan secara terpisah
|
|
206
206
|
- **Tugas berdurasi panjang**: CC punya batas timeout pada panggilan MCP (`MCP_TOOL_TIMEOUT` dapat disesuaikan), untuk tugas panjang orchestrator dapat memakai polling `dsh_spawn_worker` + `dsh_worker_result(wait_seconds)`
|
|
207
|
-
- **Pengembangan dan debugging lokal**: `claude --plugin-dir /path/to/dsh-
|
|
207
|
+
- **Pengembangan dan debugging lokal**: `claude --plugin-dir /path/to/dsh-adapter` untuk memuat sementara
|
|
208
208
|
|
|
209
209
|
|
|
210
210
|
### Perintah sesi
|
|
@@ -213,11 +213,11 @@ Hanya menimpa nilai default global untuk sesi saat ini, dan ditegakkan di lapisa
|
|
|
213
213
|
|
|
214
214
|
| Perintah | Fungsinya |
|
|
215
215
|
|---|---|
|
|
216
|
-
| `/dsh-
|
|
216
|
+
| `/dsh-adapter:config` | Tampilkan atau setel default sesi: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<detik>`, `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` | Nyalakan atau matikan dispatch untuk sesi ini (mati adalah saklar keras: tool menolak) |
|
|
219
|
+
| `/dsh-adapter:status` | Status langsung job worker: tier, progres, token, tool saat ini |
|
|
220
|
+
| `/dsh-adapter:playbook` | Praktik terbaik dispatch: memilih flash vs pro, brief yang mandiri, paralelisme, memverifikasi hasil, pagar pembatas |
|
|
221
221
|
|
|
222
222
|
## Codex
|
|
223
223
|
|
|
@@ -268,7 +268,7 @@ Untuk Codex dipasang tiga prompt:
|
|
|
268
268
|
node src/install/cli.mjs agy
|
|
269
269
|
```
|
|
270
270
|
|
|
271
|
-
Mendaftarkan server MCP dsh-
|
|
271
|
+
Mendaftarkan server MCP dsh-adapter di `~/.gemini/config/mcp_config.json` dan memasang agen `ds-flash` / `ds-pro` plus skill `dsh-config`, `dsh-status`, dan `dsh-playbook` ke `~/.gemini/config/` (semua file dicadangkan terlebih dahulu). Mulai ulang sesi setelah instalasi.
|
|
272
272
|
|
|
273
273
|
### Penggunaan
|
|
274
274
|
|
|
@@ -297,7 +297,7 @@ Uninstall: `node src/install/cli.mjs uninstall-agy`
|
|
|
297
297
|
node src/install/cli.mjs grok
|
|
298
298
|
```
|
|
299
299
|
|
|
300
|
-
Menulis bagian `[mcp_servers.dsh-
|
|
300
|
+
Menulis bagian `[mcp_servers.dsh-adapter]` ke `~/.grok/config.toml` dan memasang agen `ds-flash` / `ds-pro` plus perintah `/dsh-config`, `/dsh-status`, dan `/dsh-playbook` ke `~/.grok/` (semua file dicadangkan terlebih dahulu).
|
|
301
301
|
|
|
302
302
|
### Penggunaan
|
|
303
303
|
|
|
@@ -329,7 +329,7 @@ Uninstall: `node src/install/cli.mjs uninstall-grok`
|
|
|
329
329
|
| `dsh_worker_cancel` | Batalkan job tertentu, hentikan proses runtime-nya |
|
|
330
330
|
| `dsh_worker_config` | Baca/setel default sesi (tier, effort, mode, timeout, policy, escalation) dan daftarkan `worker_profiles` |
|
|
331
331
|
|
|
332
|
-
Progres secara bersamaan dicerminkan ke `~/.config/dsh-
|
|
332
|
+
Progres secara bersamaan dicerminkan ke `~/.config/dsh-adapter/status.d/` (satu file shard per penulis, dapat dibaca oleh statusline / pemantauan eksternal).
|
|
333
333
|
|
|
334
334
|
## Pagar Pembatas Dispatch
|
|
335
335
|
|
|
@@ -340,7 +340,7 @@ Setiap dispatch diperiksa sebelum apa pun dijalankan — penolakan adalah error
|
|
|
340
340
|
|
|
341
341
|
## Panduan Dispatch
|
|
342
342
|
|
|
343
|
-
Cara men-dispatch dengan *baik* — flash vs pro, brief yang mandiri, paralelisme yang aman, memverifikasi hasil, dan pagar pembatas di atas — dibundel sebagai panduan per host: `/dsh-
|
|
343
|
+
Cara men-dispatch dengan *baik* — flash vs pro, brief yang mandiri, paralelisme yang aman, memverifikasi hasil, dan pagar pembatas di atas — dibundel sebagai panduan per host: `/dsh-adapter:playbook` (skill Claude Code), `/dsh-playbook` (prompt Codex, skill Antigravity, perintah Grok).
|
|
344
344
|
|
|
345
345
|
## Backend CLI Eksplisit
|
|
346
346
|
|
|
@@ -350,7 +350,7 @@ Cara men-dispatch dengan *baik* — flash vs pro, brief yang mandiri, paralelism
|
|
|
350
350
|
|
|
351
351
|
**DeepSeek adalah model khusus teks** dan tidak mendukung input maupun pembuatan gambar. Plugin ini memperoleh kapabilitas tersebut secara eksternal melalui tool MCP:
|
|
352
352
|
|
|
353
|
-
**Native vision terlebih dahulu**: ketika provider vision adalah CLI bawaan (atau secara eksplisit `native`), `describe_image` pertama-tama mencoba model VL milik DeepSeek `deepseek-v4-flash-vision-exp` (panggilan API langsung; key dari `DEEPSEEK_API_KEY` atau `~/.config/dsh-
|
|
353
|
+
**Native vision terlebih dahulu**: ketika provider vision adalah CLI bawaan (atau secara eksplisit `native`), `describe_image` pertama-tama mencoba model VL milik DeepSeek `deepseek-v4-flash-vision-exp` (panggilan API langsung; key dari `DEEPSEEK_API_KEY` atau `~/.config/dsh-adapter/.env`). Kegagalan apa pun menurun secara halus ke rantai provider CLI di bawah, yang dipertahankan sebagai fallback. Pembuatan gambar tidak tersentuh — model native hanya pernah melihat gambar.
|
|
354
354
|
|
|
355
355
|
| Tool | Deskripsi |
|
|
356
356
|
|---|---|
|
|
@@ -361,7 +361,7 @@ Cara men-dispatch dengan *baik* — flash vs pro, brief yang mandiri, paralelism
|
|
|
361
361
|
|
|
362
362
|
### Konfigurasi
|
|
363
363
|
|
|
364
|
-
Di **halaman pengaturan DSH → DSH
|
|
364
|
+
Di **halaman pengaturan DSH → DSH Adapter → Multimodal** (atau langsung edit `~/.config/dsh-adapter/config.json`):
|
|
365
365
|
|
|
366
366
|
**Provider vision** (melihat gambar):
|
|
367
367
|
|
|
@@ -405,15 +405,15 @@ Dua metode integrasi:
|
|
|
405
405
|
|
|
406
406
|
## Mode Hub
|
|
407
407
|
|
|
408
|
-
Paket ini juga merupakan DSH bundle yang valid (`dsh.bundle` + `cordis.patch.yml`). Setelah dipasang ke profil DSH Web dengan `dsh plugin add dsh-
|
|
408
|
+
Paket ini juga merupakan DSH bundle yang valid (`dsh.bundle` + `cordis.patch.yml`). Setelah dipasang ke profil DSH Web dengan `dsh plugin add dsh-adapter`:
|
|
409
409
|
|
|
410
410
|
- **Sesi worker menjadi warga kelas satu**: berjalan sebagai sesi kelas satu di host DSH (`agents.create` + waterfall model/effort per sesi + preset default), muncul di daftar sesi Web UI, dapat dibuka kapan saja untuk melihat eksekusi lengkap
|
|
411
411
|
- **Kelompokkan menurut direktori kerja**: kelola sesi worker berdasarkan cwd di Web UI
|
|
412
412
|
- **Loopback API**:
|
|
413
|
-
- `POST/GET /_dsh/dsh-
|
|
414
|
-
- `GET /_dsh/dsh-
|
|
415
|
-
- `POST /_dsh/dsh-
|
|
416
|
-
- **Deteksi otomatis**: shim MCP para host mendeteksi hub secara otomatis (env var `
|
|
413
|
+
- `POST/GET /_dsh/dsh-adapter/jobs`: memulai tugas, daftar, long-poll hasil, membatalkan
|
|
414
|
+
- `GET /_dsh/dsh-adapter/ping`: pemeriksaan kesehatan (shim MCP memakai ini untuk mendeteksi apakah hub berjalan)
|
|
415
|
+
- `POST /_dsh/dsh-adapter/install`: instalasi sekali klik integrasi host — Claude Code / Codex / Antigravity / Grok (backend dari `src/install/`)
|
|
416
|
+
- **Deteksi otomatis**: shim MCP para host mendeteksi hub secara otomatis (env var `DSHPLUGIN_ADAPTER_HUB`, default `http://127.0.0.1:3080`)
|
|
417
417
|
- DSH Web berjalan → job masuk mode hub (`mode: "hub"`)
|
|
418
418
|
- Tidak berjalan → fallback ke runtime standalone
|
|
419
419
|
|
|
@@ -437,7 +437,7 @@ Paket ini juga merupakan DSH bundle yang valid (`dsh.bundle` + `cordis.patch.yml
|
|
|
437
437
|
|
|
438
438
|
### Menjalankan DSH Web → mode hub aktif otomatis
|
|
439
439
|
|
|
440
|
-
- **Kondisi saat ini**: Jika `dsh plugin add dsh-
|
|
440
|
+
- **Kondisi saat ini**: Jika `dsh plugin add dsh-adapter` dipasang ke profil DSH Web, job berjalan sebagai sesi kelas satu di host, muncul di daftar sesi Web UI
|
|
441
441
|
- **Rekomendasi**: Selama iterasi pengembangan lokal, disarankan mengaktifkan mode hub; progres worker dapat diamati sepenuhnya di Web UI; untuk kolaborasi lintas mesin atau lingkungan tanpa Web UI, gunakan pendekatan shell host yang men-dispatch
|
|
442
442
|
|
|
443
443
|
### Hal yang Diketahui
|
package/README.ja.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> プラグイン: Claude Code / Codex / Antigravity / Grok から DSH エージェントへ作業をディスパッチします。ホスト本来の 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 設定ページ" 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) のプラグインです。Claude Code、Codex、Antigravity、Grok から DSH エージェントをディスパッチできるようにします。orchestrator は自身のモデルを維持したまま、作業は DSH 本来のツール・サンドボックス・プリセット・セッション履歴を持つ本物の DSH エージェント上で実行され、ホスト側ではライブ進捗付きのネイティブ subagent として表示され続けます。
|
|
34
34
|
|
|
35
35
|
作業を実行するのは DSH エージェントであり、単なるモデル呼び出しではありません。tier (`flash` / `pro`) によって、そのエージェントがハーネスに設定されたモデルロースターからどれだけの能力を得るかが決まります — 現在は DeepSeek V4 Flash と V4 Pro — そのため DSH 側でモデルを変更しても、ここでの変更は不要です。
|
|
36
36
|
|
|
@@ -79,7 +79,7 @@ DSH のモデルはテキストのみです。`describe_image` は、キーが
|
|
|
79
79
|
|
|
80
80
|
### 📋 ジョブボード
|
|
81
81
|
|
|
82
|
-
DSH
|
|
82
|
+
DSH Adapter パネルはジョブボードを兼ねています。実行中・完了を問わず、すべての worker ジョブが 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
|
ディスパッチは横に広がります。下の例では 18 個の 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 から見ると、dsh-
|
|
123
|
+
<p align="center"><sub>Claude Code から見ると、dsh-adapter の worker はネイティブなサブエージェントです。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 パネルから見た同じ実行: どのホストが各ジョブをディスパッチしたか、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 モード — 上記のインストール — では、worker は DSH インスタンス内で実行され、すでに設定されている DSH の DeepSeek 認証情報を使用します。追加の設定は不要です。
|
|
153
153
|
|
|
154
|
-
スタンドアロン フォールバックのみが独自のキーを必要とします。DSH インスタンスが実行されていないホストからディスパッチすると、worker ランタイムが個別のプロセスとして起動します。[platform.deepseek.com](https://platform.deepseek.com) から API キーを取得し、`~/.config/dsh-
|
|
154
|
+
スタンドアロン フォールバックのみが独自のキーを必要とします。DSH インスタンスが実行されていないホストからディスパッチすると、worker ランタイムが個別のプロセスとして起動します。[platform.deepseek.com](https://platform.deepseek.com) から API キーを取得し、`~/.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 テストは利用可能なパスを通じて 1 つの安い job をディスパッチします — DSH インスタンスが実行されているときは hub、それ以外は 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 セグメント
|
|
@@ -192,7 +192,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
192
192
|
|
|
193
193
|
ワンクリックインストール (いずれかを選択):
|
|
194
194
|
|
|
195
|
-
- **DSH 設定ページ** (hub モード導入時): 設定 → DSH
|
|
195
|
+
- **DSH 設定ページ** (hub モード導入時): 設定 → DSH Adapter → "Install to Claude Code"
|
|
196
196
|
- **コマンドライン**: `node src/install/cli.mjs all`
|
|
197
197
|
|
|
198
198
|
どちらも同じことを行います: ローカル marketplace の登録 (親ディレクトリ `dsh-plugins/` を marketplace ルートとして使用) + `claude plugin install` + MCP ツール権限許可リスト + claude-hud worker ステータスセグメント設定 (変更前に settings.json を自動バックアップ、冪等)。**変更を反映するには、インストール後にセッションを再起動してください。**
|
|
@@ -204,7 +204,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
204
204
|
- **HUD ステータスラインセグメント**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (現在の tier / 経過時間 / トークン使用量 / 完了数)
|
|
205
205
|
- ローカル開発では、`statusline/statusline.sh` または `statusline/worker-segment.sh` を単独で組み込むこともできます
|
|
206
206
|
- **長時間実行タスク**: CC には MCP 呼び出しのタイムアウト制限があります (`MCP_TOOL_TIMEOUT` で調整可能)。長時間のタスクでは、orchestrator が `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,10 +213,10 @@ node src/install/cli.mjs uninstall-claude
|
|
|
213
213
|
|
|
214
214
|
| コマンド | 動作 |
|
|
215
215
|
|---|---|
|
|
216
|
-
| `/dsh-
|
|
217
|
-
| `/dsh-
|
|
218
|
-
| `/dsh-
|
|
219
|
-
| `/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
|
+
| `/dsh-adapter:on` · `/dsh-adapter:off` | このセッションのディスパッチを有効/無効にする(無効はハードスイッチでツールが拒否) |
|
|
218
|
+
| `/dsh-adapter:status` | worker ジョブの実況: tier、進捗、トークン、実行中のツール |
|
|
219
|
+
| `/dsh-adapter:playbook` | ディスパッチのベストプラクティス: flash と pro の選び方、自己完結型のブリーフ、並列実行、結果の検証、ガードレール |
|
|
220
220
|
|
|
221
221
|
## Codex
|
|
222
222
|
|
|
@@ -266,7 +266,7 @@ Codex 側には 3 つのプロンプトが入ります:
|
|
|
266
266
|
node src/install/cli.mjs agy
|
|
267
267
|
```
|
|
268
268
|
|
|
269
|
-
dsh-
|
|
269
|
+
dsh-adapter MCP サーバーを `~/.gemini/config/mcp_config.json` に登録し、`ds-flash` / `ds-pro` agent と `dsh-config`、`dsh-status`、`dsh-playbook` スキルを `~/.gemini/config/` にインストールします (すべてのファイルは事前にバックアップされます)。インストール後はセッションを再起動してください。
|
|
270
270
|
|
|
271
271
|
### 使い方
|
|
272
272
|
|
|
@@ -295,7 +295,7 @@ dsh-crew MCP サーバーを `~/.gemini/config/mcp_config.json` に登録し、`
|
|
|
295
295
|
node src/install/cli.mjs grok
|
|
296
296
|
```
|
|
297
297
|
|
|
298
|
-
`[mcp_servers.dsh-
|
|
298
|
+
`[mcp_servers.dsh-adapter]` セクションを `~/.grok/config.toml` に書き込み、`ds-flash` / `ds-pro` agent と `/dsh-config`、`/dsh-status`、`/dsh-playbook` コマンドを `~/.grok/` にインストールします (すべてのファイルは事前にバックアップされます)。
|
|
299
299
|
|
|
300
300
|
### 使い方
|
|
301
301
|
|
|
@@ -327,7 +327,7 @@ node src/install/cli.mjs grok
|
|
|
327
327
|
| `dsh_worker_cancel` | 指定したジョブをキャンセルし、そのランタイムプロセスを終了します |
|
|
328
328
|
| `dsh_worker_config` | セッション既定値 (tier、effort、mode、timeout、policy、escalation) の読み取り/設定と `worker_profiles` の一覧表示 |
|
|
329
329
|
|
|
330
|
-
進捗は同時に `~/.config/dsh-
|
|
330
|
+
進捗は同時に `~/.config/dsh-adapter/status.d/` へミラーリングされます (ライターごとに 1 つのシャードファイル。statusline / 外部監視から読み取れます)。
|
|
331
331
|
|
|
332
332
|
## ディスパッチガードレール
|
|
333
333
|
|
|
@@ -338,7 +338,7 @@ node src/install/cli.mjs grok
|
|
|
338
338
|
|
|
339
339
|
## ディスパッチプレイブック
|
|
340
340
|
|
|
341
|
-
上手にディスパッチする方法 — flash と pro の選び方、自己完結型のブリーフ、安全な並列実行、結果の検証、そして上記のガードレール — は、ホストごとのプレイブックとして同梱されています: `/dsh-
|
|
341
|
+
上手にディスパッチする方法 — flash と pro の選び方、自己完結型のブリーフ、安全な並列実行、結果の検証、そして上記のガードレール — は、ホストごとのプレイブックとして同梱されています: `/dsh-adapter:playbook` (Claude Code スキル)、`/dsh-playbook` (Codex プロンプト、Antigravity スキル、Grok コマンド)。
|
|
342
342
|
|
|
343
343
|
## 明示的な CLI バックエンド
|
|
344
344
|
|
|
@@ -348,7 +348,7 @@ node src/install/cli.mjs grok
|
|
|
348
348
|
|
|
349
349
|
**DeepSeek はテキストのみのモデルであり**、画像入力や生成には対応していません。このプラグインはこれらの能力を MCP ツール経由で外部から調達します:
|
|
350
350
|
|
|
351
|
-
**ネイティブビジョン優先**: ビジョンプロバイダーがビルトイン CLI (または明示的に `native`) の場合、`describe_image` はまず DeepSeek 独自の VL モデル `deepseek-v4-flash-vision-exp` を試します (直接 API 呼び出し。キーは `DEEPSEEK_API_KEY` または `~/.config/dsh-
|
|
351
|
+
**ネイティブビジョン優先**: ビジョンプロバイダーがビルトイン CLI (または明示的に `native`) の場合、`describe_image` はまず DeepSeek 独自の VL モデル `deepseek-v4-flash-vision-exp` を試します (直接 API 呼び出し。キーは `DEEPSEEK_API_KEY` または `~/.config/dsh-adapter/.env` から取得)。失敗した場合はグレースフルに下記の CLI プロバイダーチェーンへフォールバックします (フォールバックとして維持されます)。画像生成には影響しません — ネイティブモデルは画像を見るだけです。
|
|
352
352
|
|
|
353
353
|
| ツール | 説明 |
|
|
354
354
|
|---|---|
|
|
@@ -359,7 +359,7 @@ node src/install/cli.mjs grok
|
|
|
359
359
|
|
|
360
360
|
### 設定
|
|
361
361
|
|
|
362
|
-
**DSH 設定ページ → DSH
|
|
362
|
+
**DSH 設定ページ → DSH Adapter → Multimodal** (または `~/.config/dsh-adapter/config.json` を直接編集):
|
|
363
363
|
|
|
364
364
|
**ビジョンプロバイダー** (画像閲覧):
|
|
365
365
|
|
|
@@ -403,15 +403,15 @@ node src/install/cli.mjs grok
|
|
|
403
403
|
|
|
404
404
|
## Hub モード
|
|
405
405
|
|
|
406
|
-
このパッケージは有効な DSH bundle (`dsh.bundle` + `cordis.patch.yml`) でもあります。`dsh plugin add dsh-
|
|
406
|
+
このパッケージは有効な DSH bundle (`dsh.bundle` + `cordis.patch.yml`) でもあります。`dsh plugin add dsh-adapter` で DSH Web プロファイルにインストールすると:
|
|
407
407
|
|
|
408
408
|
- **worker セッションが第一級市民になります**: DSH ホスト内で第一級セッションとして実行され (`agents.create` + セッションごとの model/effort フォールバック + デフォルトプリセット)、Web UI のセッション一覧に表示され、いつでも開いて実行の全容を確認できます
|
|
409
409
|
- **作業ディレクトリごとに整理**: Web UI で worker セッションを cwd ごとに管理できます
|
|
410
410
|
- **ループバック API**:
|
|
411
|
-
- `POST/GET /_dsh/dsh-
|
|
412
|
-
- `GET /_dsh/dsh-
|
|
413
|
-
- `POST /_dsh/dsh-
|
|
414
|
-
- **自動検出**: ホスト側の MCP shim が hub を自動検出します (`
|
|
411
|
+
- `POST/GET /_dsh/dsh-adapter/jobs`: タスクの起動、一覧、結果のロングポーリング、キャンセル
|
|
412
|
+
- `GET /_dsh/dsh-adapter/ping`: ヘルスチェック (MCP shim が hub の稼働検知に使用)
|
|
413
|
+
- `POST /_dsh/dsh-adapter/install`: ホスト連携のワンクリックインストール — Claude Code / Codex / Antigravity / Grok (`src/install/` のバックエンド)
|
|
414
|
+
- **自動検出**: ホスト側の MCP shim が hub を自動検出します (`DSHPLUGIN_ADAPTER_HUB` 環境変数、デフォルト `http://127.0.0.1:3080`)
|
|
415
415
|
- DSH Web が稼働中 → ジョブは hub モードで実行されます (`mode: "hub"`)
|
|
416
416
|
- 未稼働 → standalone ランタイムにフォールバックします
|
|
417
417
|
|
|
@@ -435,7 +435,7 @@ node src/install/cli.mjs grok
|
|
|
435
435
|
|
|
436
436
|
### DSH Web 稼働中 → hub モードが自動有効
|
|
437
437
|
|
|
438
|
-
- **現状**: `dsh plugin add dsh-
|
|
438
|
+
- **現状**: `dsh plugin add dsh-adapter` で DSH Web プロファイルにインストール済みであれば、ジョブはホスト内で第一級セッションとして実行され、Web UI のセッション一覧に表示されます
|
|
439
439
|
- **推奨**: ローカル開発の反復中は hub モードの有効化を推奨します。worker の進捗を Web UI で完全に観察できます。マシン間の共同作業や Web UI のない環境では、ディスパッチ元ホストのシェル方式を使用してください
|
|
440
440
|
|
|
441
441
|
### 既知の事項
|
package/README.ko.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> plugin: Claude Code / Codex / Antigravity / Grok에서 DSH agent로 작업을 dispatch하며, 호스트의 native 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 — 설정 페이지" 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는 오픈소스 agent harness인 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)의 plugin입니다. Claude Code, Codex, Antigravity, Grok에서 DSH agent를 dispatch할 수 있게 해 줍니다. orchestrator는 자신의 model을 유지하고, 작업은 해당 harness의 tools, sandbox, presets, session history를 갖춘 실제 DSH agent에서 실행되며, 호스트에는 live progress가 표시되는 native subagent로 계속 나타납니다.
|
|
34
34
|
|
|
35
35
|
작업을 실제로 실행하는 것은 DSH agent이지, 단순한 model 호출이 아닙니다. tier(`flash` / `pro`)는 해당 agent가 harness에 설정된 model roster에서 얼마나 많은 capability를 받을지 결정합니다 — 현재는 DeepSeek V4 Flash와 V4 Pro — 따라서 DSH에서 model을 바꿔도 여기서는 변경할 필요가 없습니다.
|
|
36
36
|
|
|
@@ -79,7 +79,7 @@ DSH의 model은 text-only입니다. `describe_image`는 이제 키가 있을 때
|
|
|
79
79
|
|
|
80
80
|
### 📋 작업 보드
|
|
81
81
|
|
|
82
|
-
DSH
|
|
82
|
+
DSH Adapter 패널은 작업 보드 역할도 합니다: 실행 중이든 완료됐든 모든 worker job이 tier, effort, 실시간 진행 상황, 토큰과 함께 나열되고, 점유된 workspace는 보유자를 표시하며, 실행 도중 사라진 job(예: hub 재시작)은 조용히 사라지는 대신 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
|
디스패치는 넓게 펼칠 수 있습니다. 아래에서는 18개의 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에서 dsh-
|
|
123
|
+
<p align="center"><sub>Claude Code에서 dsh-adapter worker는 네이티브 서브에이전트로 보입니다. 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 패널에서 본 같은 실행: 각 작업을 디스패치한 호스트, tier와 effort, 실시간 진행 상황과 토큰 사용량.</sub></p>
|
|
129
129
|
|
|
130
130
|
<p align="center"><sub>패널은 작업 보드이기도 합니다: 실행 중이거나 완료된 job이 tier, 진행 상황, 토큰과 함께 계속 나열되고, 점유된 workspace는 보유자를 표시하며, 실행 도중 사라진 job(hub 재시작)은 조용히 사라지는 대신 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 mode에서 — 위 설치 방식에서 — worker는 DSH instance 내부에서 실행되고 이미 설정된 DSH의 DeepSeek 자격 증명을 사용합니다. 추가 설정이 필요하지 않습니다.
|
|
153
153
|
|
|
154
|
-
standalone 폴백만 자체 키가 필요합니다. DSH instance가 실행 중이 아닌 호스트에서 dispatch하면 worker runtime이 별도 프로세스로 시작됩니다. [platform.deepseek.com](https://platform.deepseek.com)에서 API 키를 받아 `~/.config/dsh-
|
|
154
|
+
standalone 폴백만 자체 키가 필요합니다. DSH instance가 실행 중이 아닌 호스트에서 dispatch하면 worker runtime이 별도 프로세스로 시작됩니다. [platform.deepseek.com](https://platform.deepseek.com)에서 API 키를 받아 `~/.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 테스트는 사용 가능한 경로를 통해 저렴한 job을 dispatch합니다 — DSH instance가 실행 중이면 hub, 그렇지 않으면 standalone — 그리고 사용한 경로를 출력합니다. 약 십 초 안에 `smoke test passed — configuration OK`가 표시되어야 합니다. 실패하면 테스트된 경로에 한정된 오류 이유가 출력됩니다.
|
|
167
167
|
|
|
168
|
-
그다음 설정 → DSH
|
|
168
|
+
그다음 설정 → DSH Adapter에서 호스트 통합(Claude Code, Codex, Antigravity, Grok)을 한 번에 설치하거나, 명령줄에서 같은 installer를 실행합니다:
|
|
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 mode 설치 시): 설정 → DSH
|
|
195
|
+
- **DSH 설정 페이지**(hub mode 설치 시): 설정 → 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` + MCP tool permission allowlist + claude-hud worker status segment 설정(변경 전 settings.json 자동 백업, 멱등). **변경 사항을 적용하려면 설치 후 세션을 다시 시작하세요.**
|
|
@@ -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에는 MCP 호출에 대한 timeout 제한이 있습니다(`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` | 이 세션의 디스패치 켜기·끄기 (끄기는 하드 스위치로 도구가 거부) |
|
|
219
|
+
| `/dsh-adapter:status` | worker 작업 실시간 상태: tier, 진행, 토큰, 현재 도구 |
|
|
220
|
+
| `/dsh-adapter:playbook` | 디스패치 모범 사례: flash vs pro 선택, 자기 완결적인 브리프, 병렬 처리, 결과 검증, 가드레일 |
|
|
221
221
|
|
|
222
222
|
## Codex
|
|
223
223
|
|
|
@@ -268,7 +268,7 @@ Codex에는 세 개의 프롬프트가 설치됩니다:
|
|
|
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` agent와 `dsh-config`, `dsh-status`, `dsh-playbook` 스킬을 `~/.gemini/config/`에 설치합니다(모든 파일은 먼저 백업됨). 설치 후 세션을 다시 시작하세요.
|
|
272
272
|
|
|
273
273
|
### 사용법
|
|
274
274
|
|
|
@@ -297,7 +297,7 @@ dsh-crew MCP server를 `~/.gemini/config/mcp_config.json`에 등록하고 `ds-fl
|
|
|
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` agent와 `/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
|
-
progress는 동시에 `~/.config/dsh-
|
|
332
|
+
progress는 동시에 `~/.config/dsh-adapter/status.d/`에 미러링됩니다(writer마다 shard file 하나, statusline / 외부 모니터링에서 읽을 수 있음).
|
|
333
333
|
|
|
334
334
|
## 디스패치 가드레일
|
|
335
335
|
|
|
@@ -340,7 +340,7 @@ progress는 동시에 `~/.config/dsh-crew/status.d/`에 미러링됩니다(write
|
|
|
340
340
|
|
|
341
341
|
## 디스패치 플레이북
|
|
342
342
|
|
|
343
|
-
dispatch를 *잘* 하는 방법 — flash vs pro 선택, 자기 완결적인 브리프, 안전한 병렬 처리, 결과 검증, 위의 가드레일 — 이 호스트별 플레이북으로 번들되어 있습니다: `/dsh-
|
|
343
|
+
dispatch를 *잘* 하는 방법 — flash vs pro 선택, 자기 완결적인 브리프, 안전한 병렬 처리, 결과 검증, 위의 가드레일 — 이 호스트별 플레이북으로 번들되어 있습니다: `/dsh-adapter:playbook` (Claude Code 스킬), `/dsh-playbook` (Codex 프롬프트, Antigravity 스킬, Grok 명령).
|
|
344
344
|
|
|
345
345
|
## 명시적 CLI 백엔드
|
|
346
346
|
|
|
@@ -350,7 +350,7 @@ dispatch를 *잘* 하는 방법 — flash vs pro 선택, 자기 완결적인 브
|
|
|
350
350
|
|
|
351
351
|
**DeepSeek는 text-only model**이며 image 입력이나 생성을 지원하지 않습니다. 이 plugin은 MCP tool을 통해 이러한 기능을 외부에서 제공받습니다:
|
|
352
352
|
|
|
353
|
-
**네이티브 비전 우선**: vision provider가 내장 CLI(또는 명시적으로 `native`)일 때 `describe_image`는 먼저 DeepSeek 자체 VL model `deepseek-v4-flash-vision-exp`를 시도합니다(직접 API 호출; 키는 `DEEPSEEK_API_KEY` 또는 `~/.config/dsh-
|
|
353
|
+
**네이티브 비전 우선**: vision provider가 내장 CLI(또는 명시적으로 `native`)일 때 `describe_image`는 먼저 DeepSeek 자체 VL model `deepseek-v4-flash-vision-exp`를 시도합니다(직접 API 호출; 키는 `DEEPSEEK_API_KEY` 또는 `~/.config/dsh-adapter/.env`에서). 실패하면 아래 CLI provider 체인으로 우아하게 저하되며, 이 체인은 폴백으로 유지됩니다. 이미지 생성은 영향받지 않습니다 — 네이티브 model은 사진만 볼 뿐입니다.
|
|
354
354
|
|
|
355
355
|
| 도구 | 설명 |
|
|
356
356
|
|---|---|
|
|
@@ -361,7 +361,7 @@ dispatch를 *잘* 하는 방법 — flash vs pro 선택, 자기 완결적인 브
|
|
|
361
361
|
|
|
362
362
|
### 구성
|
|
363
363
|
|
|
364
|
-
**DSH 설정 페이지 → DSH
|
|
364
|
+
**DSH 설정 페이지 → DSH Adapter → Multimodal**(또는 `~/.config/dsh-adapter/config.json` 직접 편집):
|
|
365
365
|
|
|
366
366
|
**Vision provider**(이미지 보기):
|
|
367
367
|
|
|
@@ -405,15 +405,15 @@ dispatch를 *잘* 하는 방법 — flash vs pro 선택, 자기 완결적인 브
|
|
|
405
405
|
|
|
406
406
|
## Hub 모드
|
|
407
407
|
|
|
408
|
-
이 패키지는 유효한 DSH bundle(`dsh.bundle` + `cordis.patch.yml`)이기도 합니다. `dsh plugin add dsh-
|
|
408
|
+
이 패키지는 유효한 DSH bundle(`dsh.bundle` + `cordis.patch.yml`)이기도 합니다. `dsh plugin add dsh-adapter`로 DSH Web profile에 설치하면:
|
|
409
409
|
|
|
410
410
|
- **Worker session이 first-class citizen이 됩니다**: DSH host에서 first-class session으로 실행되고(`agents.create` + session별 model/effort waterfall + 기본 preset), Web UI session 목록에 표시되며, 언제든 열어 전체 실행을 확인할 수 있습니다
|
|
411
411
|
- **작업 디렉터리별 구성**: Web UI에서 worker session을 cwd별로 관리할 수 있습니다
|
|
412
412
|
- **Loopback API**:
|
|
413
|
-
- `POST/GET /_dsh/dsh-
|
|
414
|
-
- `GET /_dsh/dsh-
|
|
415
|
-
- `POST /_dsh/dsh-
|
|
416
|
-
- **자동 감지**: 호스트들의 MCP shim이 hub를 자동 감지합니다(`
|
|
413
|
+
- `POST/GET /_dsh/dsh-adapter/jobs`: 작업 생성, 목록, long-poll 결과, 취소
|
|
414
|
+
- `GET /_dsh/dsh-adapter/ping`: health check(MCP shim이 hub 실행 여부를 감지하는 데 사용)
|
|
415
|
+
- `POST /_dsh/dsh-adapter/install`: 호스트 통합 원클릭 설치 — Claude Code / Codex / Antigravity / Grok(`src/install/`의 backend)
|
|
416
|
+
- **자동 감지**: 호스트들의 MCP shim이 hub를 자동 감지합니다(`DSHPLUGIN_ADAPTER_HUB` 환경 변수, 기본값 `http://127.0.0.1:3080`)
|
|
417
417
|
- DSH Web 실행 중 → job이 hub mode로 실행됩니다(`mode: "hub"`)
|
|
418
418
|
- 실행 중이 아님 → standalone runtime으로 폴백합니다
|
|
419
419
|
|
|
@@ -437,7 +437,7 @@ dispatch를 *잘* 하는 방법 — flash vs pro 선택, 자기 완결적인 브
|
|
|
437
437
|
|
|
438
438
|
### DSH Web 실행 중 → hub mode 자동 활성화
|
|
439
439
|
|
|
440
|
-
- **현재 상태**: `dsh plugin add dsh-
|
|
440
|
+
- **현재 상태**: `dsh plugin add dsh-adapter`를 DSH Web profile에 설치했다면 job은 host에서 first-class session으로 실행되고 Web UI session 목록에 표시됩니다
|
|
441
441
|
- **권장**: 로컬 개발 반복 중에는 hub mode를 활성화하는 것을 권장합니다. worker progress를 Web UI에서 완전히 관찰할 수 있습니다. 머신 간 협업 또는 Web UI가 없는 환경에서는 dispatch 호스트 shell 방식을 사용하세요
|
|
442
442
|
|
|
443
443
|
### 알려진 항목
|