@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.
Files changed (66) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +2 -2
  3. package/.mcp.json +1 -1
  4. package/README.de.md +32 -32
  5. package/README.es.md +32 -32
  6. package/README.fr.md +32 -32
  7. package/README.hi.md +32 -32
  8. package/README.id.md +32 -32
  9. package/README.ja.md +32 -32
  10. package/README.ko.md +32 -32
  11. package/README.md +33 -33
  12. package/README.pt.md +32 -32
  13. package/README.ru.md +32 -32
  14. package/README.th.md +32 -32
  15. package/README.tr.md +32 -32
  16. package/README.vi.md +32 -32
  17. package/README.zh-TW.md +32 -32
  18. package/README.zh.md +33 -33
  19. package/agy/agents/ds-flash.md +1 -1
  20. package/agy/agents/ds-pro.md +1 -1
  21. package/agy/skills/dsh-playbook/SKILL.md +1 -1
  22. package/codex/agents/ds-flash.toml +2 -2
  23. package/codex/agents/ds-pro.toml +2 -2
  24. package/codex/prompts/dsh-playbook.md +1 -1
  25. package/commands/off.md +1 -1
  26. package/commands/playbook.md +1 -1
  27. package/cordis.patch.yml +2 -2
  28. package/grok/agents/ds-flash.md +1 -1
  29. package/grok/agents/ds-pro.md +1 -1
  30. package/grok/commands/dsh-config.md +1 -1
  31. package/grok/commands/dsh-playbook.md +2 -2
  32. package/grok/commands/dsh-status.md +1 -1
  33. package/lib/client.js +37 -27
  34. package/lib/server.mjs +22 -22
  35. package/package.json +6 -5
  36. package/scripts/bump-version.mjs +79 -0
  37. package/scripts/fake-agy.sh +3 -3
  38. package/scripts/release-local.mjs +2 -2
  39. package/scripts/smoke-bundle.mjs +2 -2
  40. package/scripts/smoke-pack.mjs +4 -4
  41. package/scripts/smoke.mjs +3 -3
  42. package/scripts/verify-wpc10-client.mjs +2 -2
  43. package/scripts/verify-wpc14-proc-endpoints.mjs +6 -6
  44. package/scripts/verify-wpc9-guardrails.mjs +10 -10
  45. package/src/cli-workers.mjs +1 -1
  46. package/src/client/index.tsx +34 -32
  47. package/src/cwd-lock.mjs +1 -1
  48. package/src/hub/index.mjs +31 -10
  49. package/src/hub-client.mjs +4 -4
  50. package/src/install/install.mjs +35 -32
  51. package/src/jobs.mjs +2 -2
  52. package/src/multimodal.mjs +18 -18
  53. package/src/origin-guard.mjs +8 -8
  54. package/src/plugin-env.mjs +2 -2
  55. package/src/proc-kill.mjs +5 -5
  56. package/src/provider-probe.mjs +3 -3
  57. package/src/server.mjs +4 -4
  58. package/src/status-shard.mjs +2 -2
  59. package/src/vision-route.mjs +3 -3
  60. package/statusline/statusline.sh +1 -1
  61. package/statusline/worker-segment.sh +3 -3
  62. package/worker.cordis.yml +1 -1
  63. /package/docs/images/{dsh-crew-host.png → dsh-adapter-host.png} +0 -0
  64. /package/docs/images/{dsh-crew-jobs.png → dsh-adapter-jobs.png} +0 -0
  65. /package/docs/images/{dsh-crew-logo.png → dsh-adapter-logo.png} +0 -0
  66. /package/docs/images/{dsh-crew-overview.png → dsh-adapter-overview.png} +0 -0
package/README.tr.md CHANGED
@@ -1,8 +1,8 @@
1
1
  <p align="center">
2
- <img src="./docs/images/dsh-crew-logo.png" alt="DSH Crew" width="120" />
2
+ <img src="./docs/images/dsh-adapter-logo.png" alt="DSH Adapter" width="120" />
3
3
  </p>
4
4
 
5
- <h1 align="center">DSH Crew</h1>
5
+ <h1 align="center">DSH Adapter</h1>
6
6
 
7
7
  <p align="center">
8
8
  <strong>Bir <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> eklentisi: Claude Code / Codex / Antigravity / Grok'tan DSH ajanlarına iş gönderin; host'un yerel subagent arayüzünden vazgeçmeden.</strong><br />
@@ -24,13 +24,13 @@
24
24
  <br />
25
25
 
26
26
  <p align="center">
27
- <img src="./docs/images/dsh-crew-overview.png" alt="DSH Crew — ayarlar sayfası" width="100%" />
27
+ <img src="./docs/images/dsh-adapter-overview.png" alt="DSH Adapter — ayarlar sayfası" width="100%" />
28
28
  </p>
29
- <p align="center"><sub>DSH Crew ayarlar sayfası — host entegrasyonları, gönderim politikası, yürütme ve multimodal köprü</sub></p>
29
+ <p align="center"><sub>DSH Adapter ayarlar sayfası — host entegrasyonları, gönderim politikası, yürütme ve multimodal köprü</sub></p>
30
30
 
31
- ## Neden DSH Crew
31
+ ## Neden DSH Adapter
32
32
 
33
- DSH Crew, [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) için bir eklentidir — açık kaynaklı bir agent harness. DSH ajanlarını Claude Code, Codex, Antigravity ve Grok'tan gönderilebilir hale getirir: orchestrator kendi modelini korur, iş gerçek bir DSH ajanında bu harness'ın araçları, sandbox'ı, preset'leri ve oturum geçmişiyle çalışır; host ise onu canlı ilerlemeyle yerel bir subagent olarak göstermeye devam eder.
33
+ DSH Adapter, [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) için bir eklentidir — açık kaynaklı bir agent harness. DSH ajanlarını Claude Code, Codex, Antigravity ve Grok'tan gönderilebilir hale getirir: orchestrator kendi modelini korur, iş gerçek bir DSH ajanında bu harness'ın araçları, sandbox'ı, preset'leri ve oturum geçmişiyle çalışır; host ise onu canlı ilerlemeyle yerel bir subagent olarak göstermeye devam eder.
34
34
 
35
35
  İşi çalıştıran şey bir DSH ajanıdır, çıplak bir model çağrısı değil. Tier'lar (`flash` / `pro`), ajanın harness'ın yapılandırılmış roster'ından ne kadar yetenek alacağını seçer — bugün DeepSeek V4 Flash ve V4 Pro — yani DSH'de model değişikliği burada hiçbir değişiklik gerektirmez.
36
36
 
@@ -79,7 +79,7 @@ Her gönderim, herhangi bir şey başlamadan önce kontrol edilir. worker→work
79
79
 
80
80
  ### 📋 İş Panosu
81
81
 
82
- DSH Crew paneli aynı zamanda bir iş panosudur: her worker işi — çalışan veya biten — tier, effort, canlı ilerleme ve token'larıyla listelenir, tutulan workspace'ler sahiplerini gösterir ve yol ortasında kaybolan bir iş (ör. hub yeniden başlatma) sessizce kaybolmak yerine yetim bir ghost olarak görünür.
82
+ DSH Adapter paneli aynı zamanda bir iş panosudur: her worker işi — çalışan veya biten — tier, effort, canlı ilerleme ve token'larıyla listelenir, tutulan workspace'ler sahiplerini gösterir ve yol ortasında kaybolan bir iş (ör. hub yeniden başlatma) sessizce kaybolmak yerine yetim bir ghost olarak görünür.
83
83
 
84
84
  </td>
85
85
  </tr>
@@ -118,14 +118,14 @@ Claude Code / Codex / Antigravity / Grok (orchestrator, keeps its own model)
118
118
  Dağıtım yatayda büyür. Aşağıda on sekiz worker bu README'yi paralel olarak çeviriyor: host onları kendi subagent'ları olarak sayarken, harness onları gerçek oturumlar olarak çalıştırır.
119
119
 
120
120
  <p align="center">
121
- <img src="./docs/images/dsh-crew-host.png" alt="Claude Code" width="100%" />
121
+ <img src="./docs/images/dsh-adapter-host.png" alt="Claude Code" width="100%" />
122
122
  </p>
123
- <p align="center"><sub>Claude Code'da dsh-crew worker'ları yerel subagent olarak görünür; statusline bölümü çalışan tier'ları, geçen süreyi ve token'ları gösterir.</sub></p>
123
+ <p align="center"><sub>Claude Code'da dsh-adapter worker'ları yerel subagent olarak görünür; statusline bölümü çalışan tier'ları, geçen süreyi ve token'ları gösterir.</sub></p>
124
124
 
125
125
  <p align="center">
126
- <img src="./docs/images/dsh-crew-jobs.png" alt="DSH Crew" width="100%" />
126
+ <img src="./docs/images/dsh-adapter-jobs.png" alt="DSH Adapter" width="100%" />
127
127
  </p>
128
- <p align="center"><sub>DSH Crew paneli aynı çalışmayı harness tarafından gösterir: her işi hangi host gönderdi, tier ve effort değerleri, canlı ilerleme ve token kullanımı.</sub></p>
128
+ <p align="center"><sub>DSH Adapter paneli aynı çalışmayı harness tarafından gösterir: her işi hangi host gönderdi, tier ve effort değerleri, canlı ilerleme ve token kullanımı.</sub></p>
129
129
 
130
130
  <p align="center"><sub>Panel aynı zamanda iş panosudur: çalışan ve biten işler tier, ilerleme ve token'larıyla listelenmeye devam eder, tutulan workspace'ler sahiplerinin adını söyler ve yol ortasında kaybolan bir iş (hub yeniden başlatma) sessizce kaybolmak yerine yetim bir ghost olarak görünür.</sub></p>
131
131
 
@@ -141,7 +141,7 @@ dsh web
141
141
  Ya da kaynak ağacından yerel geliştirme için:
142
142
 
143
143
  ```bash
144
- dsh plugin --profile web add link:/path/to/dsh-crew
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 modunda — yukarıdaki kurulum — worker'lar DSH örneğinin içinde çalışır ve zaten yapılandırılmış olan DeepSeek kimlik bilgilerini kullanır. Başka bir şey ayarlamaya gerek yok.
153
153
 
154
- Yalnızca standalone geri dönüş yolu kendi anahtarına ihtiyaç duyar: DSH örneği çalışmıyorken bir host'tan iş gönderdiğinizde worker runtime ayrı bir işlem olarak başlatılır. [platform.deepseek.com](https://platform.deepseek.com) adresinden bir API key alın ve `~/.config/dsh-crew/.env` dosyasına yazın:
154
+ Yalnızca standalone geri dönüş yolu kendi anahtarına ihtiyaç duyar: DSH örneği çalışmıyorken bir host'tan iş gönderdiğinizde worker runtime ayrı bir işlem olarak başlatılır. [platform.deepseek.com](https://platform.deepseek.com) adresinden bir API key alın ve `~/.config/dsh-adapter/.env` dosyasına yazın:
155
155
 
156
156
  ```
157
157
  DEEPSEEK_API_KEY=sk-...
@@ -165,7 +165,7 @@ node scripts/smoke.mjs
165
165
 
166
166
  Smoke test, mevcut yol üzerinden ucuz bir iş gönderir — bir DSH örneği çalışıyorsa hub, aksi halde standalone — ve hangisini kullandığını yazdırır. Yaklaşık on saniye içinde `smoke test passed — configuration OK` görmelisiniz. Hata durumunda nedeni yazdırılır; bu neden test edilen yola özgüdür.
167
167
 
168
- Ardından Ayarlar → DSH Crew bölümünden host entegrasyonlarını — Claude Code, Codex, Antigravity, Grok — tek tıkla kurun ya da aynı yükleyiciyi komut satırından sürün:
168
+ Ardından Ayarlar → DSH Adapter bölümünden host entegrasyonlarını — Claude Code, Codex, Antigravity, Grok — tek tıkla kurun ya da aynı yükleyiciyi komut satırından sürün:
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
  Tek tıkla kurulum (birini seçin):
194
194
 
195
- - **DSH ayarlar sayfası** (hub modu kuruluysa): Ayarlar → DSH Crew → "Install to Claude Code"
195
+ - **DSH ayarlar sayfası** (hub modu kuruluysa): Ayarlar → DSH Adapter → "Install to Claude Code"
196
196
  - **Komut satırı**: `node src/install/cli.mjs all`
197
197
 
198
198
  Her ikisi de aynı şeyi yapar: yerel marketplace'i kaydeder (üst dizin `dsh-plugins/` marketplace kökü olarak) + `claude plugin install` + MCP araç izin allowlist'i + claude-hud worker durum bölümü yapılandırması (değişikliklerden önce settings.json otomatik yedeklenir, idempotent). **Değişikliklerin etkili olması için kurulumdan sonra oturumu yeniden başlatın.**
@@ -204,7 +204,7 @@ Her ikisi de aynı şeyi yapar: yerel marketplace'i kaydeder (üst dizin `dsh-pl
204
204
  - **HUD durum satırı bölümü**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (geçerli tier / geçen süre / token kullanımı / tamamlama sayısı)
205
205
  - Yerel geliştirme için `statusline/statusline.sh` veya `statusline/worker-segment.sh` bağımsız olarak entegre edilebilir
206
206
  - **Uzun süren görevler**: CC'nin MCP çağrılarında zaman aşımı limitleri vardır (`MCP_TOOL_TIMEOUT` ayarlanabilir); uzun görevlerde orchestrator, `dsh_spawn_worker` + `dsh_worker_result(wait_seconds)` yoklama kullanabilir
207
- - **Yerel geliştirme ve hata ayıklama**: geçici olarak yüklemek için `claude --plugin-dir /path/to/dsh-crew`
207
+ - **Yerel geliştirme ve hata ayıklama**: geçici olarak yüklemek için `claude --plugin-dir /path/to/dsh-adapter`
208
208
 
209
209
 
210
210
  ### Oturum komutları
@@ -213,11 +213,11 @@ Genel varsayılanları yalnızca geçerli oturum için geçersiz kılar ve promp
213
213
 
214
214
  | Komut | Ne yapar |
215
215
  |---|---|
216
- | `/dsh-crew:config` | Oturumun varsayılanlarını göster ya da ayarla: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<saniye>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `origin_depth_limit=<1-32>`, `preset_flash/preset_pro=<preset id|default>`, `reset` |
216
+ | `/dsh-adapter:config` | Oturumun varsayılanlarını göster ya da ayarla: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<saniye>`, `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-crew:on` · `/dsh-crew:off` | Bu oturumda dağıtımı aç ya da kapat (kapalı sert bir anahtardır: araç reddeder) |
219
- | `/dsh-crew:status` | Worker işlerinin canlı durumu: tier, ilerleme, token, geçerli araç |
220
- | `/dsh-crew:playbook` | Gönderim en iyi uygulamaları: flash ve pro seçimi, kendi kendine yeten brifingler, paralellik, sonuçları doğrulama, koruma korkulukları |
218
+ | `/dsh-adapter:on` · `/dsh-adapter:off` | Bu oturumda dağıtımı aç ya da kapat (kapalı sert bir anahtardır: araç reddeder) |
219
+ | `/dsh-adapter:status` | Worker işlerinin canlı durumu: tier, ilerleme, token, geçerli araç |
220
+ | `/dsh-adapter:playbook` | Gönderim en iyi uygulamaları: flash ve pro seçimi, kendi kendine yeten brifingler, paralellik, sonuçları doğrulama, koruma korkulukları |
221
221
 
222
222
  ## Codex
223
223
 
@@ -268,7 +268,7 @@ Codex için üç prompt kurulur:
268
268
  node src/install/cli.mjs agy
269
269
  ```
270
270
 
271
- dsh-crew MCP sunucusunu `~/.gemini/config/mcp_config.json` dosyasına kaydeder ve `ds-flash` / `ds-pro` agent'larını, `dsh-config`, `dsh-status` ve `dsh-playbook` skill'lerini `~/.gemini/config/` dizinine kurar (tüm dosyalar önce yedeklenir). Kurulumdan sonra oturumu yeniden başlatın.
271
+ dsh-adapter MCP sunucusunu `~/.gemini/config/mcp_config.json` dosyasına kaydeder ve `ds-flash` / `ds-pro` agent'larını, `dsh-config`, `dsh-status` ve `dsh-playbook` skill'lerini `~/.gemini/config/` dizinine kurar (tüm dosyalar önce yedeklenir). Kurulumdan sonra oturumu yeniden başlatın.
272
272
 
273
273
  ### Kullanım
274
274
 
@@ -297,7 +297,7 @@ Kaldırma: `node src/install/cli.mjs uninstall-agy`
297
297
  node src/install/cli.mjs grok
298
298
  ```
299
299
 
300
- `[mcp_servers.dsh-crew]` bölümünü `~/.grok/config.toml` dosyasına yazar ve `ds-flash` / `ds-pro` agent'larını, `/dsh-config`, `/dsh-status` ve `/dsh-playbook` komutlarını `~/.grok/` dizinine kurar (tüm dosyalar önce yedeklenir).
300
+ `[mcp_servers.dsh-adapter]` bölümünü `~/.grok/config.toml` dosyasına yazar ve `ds-flash` / `ds-pro` agent'larını, `/dsh-config`, `/dsh-status` ve `/dsh-playbook` komutlarını `~/.grok/` dizinine kurar (tüm dosyalar önce yedeklenir).
301
301
 
302
302
  ### Kullanım
303
303
 
@@ -329,7 +329,7 @@ Kaldırma: `node src/install/cli.mjs uninstall-grok`
329
329
  | `dsh_worker_cancel` | Belirtilen işi iptal eder, runtime sürecini sonlandırır |
330
330
  | `dsh_worker_config` | Oturum varsayılanlarını oku/ayarla (tier, effort, mode, timeout, policy, escalation) ve `worker_profiles` listele |
331
331
 
332
- İlerleme aynı anda `~/.config/dsh-crew/status.d/` dizinine yansıtılır (yazar başına bir shard dosyası; statusline / harici izleme tarafından okunabilir).
332
+ İlerleme aynı anda `~/.config/dsh-adapter/status.d/` dizinine yansıtılır (yazar başına bir shard dosyası; statusline / harici izleme tarafından okunabilir).
333
333
 
334
334
  ## Gönderim korkulukları
335
335
 
@@ -340,7 +340,7 @@ Her gönderim, herhangi bir şey başlamadan önce kontrol edilir — reddetmele
340
340
 
341
341
  ## Gönderim playbook'u
342
342
 
343
- *İyi* gönderim nasıl yapılır — flash ve pro, kendi kendine yeten brifingler, güvenli paralellik, sonuçları doğrulama ve yukarıdaki koruma korkulukları — host başına bir playbook olarak paketlenmiştir: `/dsh-crew:playbook` (Claude Code skill), `/dsh-playbook` (Codex prompt, Antigravity skill, Grok komutu).
343
+ *İyi* gönderim nasıl yapılır — flash ve pro, kendi kendine yeten brifingler, güvenli paralellik, sonuçları doğrulama ve yukarıdaki koruma korkulukları — host başına bir playbook olarak paketlenmiştir: `/dsh-adapter:playbook` (Claude Code skill), `/dsh-playbook` (Codex prompt, Antigravity skill, Grok komutu).
344
344
 
345
345
  ## Açık CLI arka uçları
346
346
 
@@ -350,7 +350,7 @@ Her gönderim, herhangi bir şey başlamadan önce kontrol edilir — reddetmele
350
350
 
351
351
  **DeepSeek yalnızca metin modelidir** ve görsel girdisini veya üretimini desteklemez. Bu eklenti bu yetenekleri MCP araçları aracılığıyla harici olarak sağlar:
352
352
 
353
- **Önce yerel görüntü inceleme**: Görüntü sağlayıcısı yerleşik bir CLI olduğunda (veya açıkça `native`), `describe_image` önce DeepSeek'in kendi VL modelini `deepseek-v4-flash-vision-exp` dener (doğrudan API çağrısı; key `DEEPSEEK_API_KEY` veya `~/.config/dsh-crew/.env` dosyasından). Herhangi bir hata, fallback olarak korunan aşağıdaki CLI sağlayıcı zincirine sorunsuzca düşer. Görsel üretimi etkilenmez — yerel model yalnızca görsellere bakar.
353
+ **Önce yerel görüntü inceleme**: Görüntü sağlayıcısı yerleşik bir CLI olduğunda (veya açıkça `native`), `describe_image` önce DeepSeek'in kendi VL modelini `deepseek-v4-flash-vision-exp` dener (doğrudan API çağrısı; key `DEEPSEEK_API_KEY` veya `~/.config/dsh-adapter/.env` dosyasından). Herhangi bir hata, fallback olarak korunan aşağıdaki CLI sağlayıcı zincirine sorunsuzca düşer. Görsel üretimi etkilenmez — yerel model yalnızca görsellere bakar.
354
354
 
355
355
  | Araç | Açıklama |
356
356
  |---|---|
@@ -361,7 +361,7 @@ Her gönderim, herhangi bir şey başlamadan önce kontrol edilir — reddetmele
361
361
 
362
362
  ### Yapılandırma
363
363
 
364
- **DSH ayarlar sayfası → DSH Crew → Multimodal** bölümünde (veya doğrudan `~/.config/dsh-crew/config.json` dosyasını düzenleyin):
364
+ **DSH ayarlar sayfası → DSH Adapter → Multimodal** bölümünde (veya doğrudan `~/.config/dsh-adapter/config.json` dosyasını düzenleyin):
365
365
 
366
366
  **Görüntü sağlayıcısı** (görüntü inceleme):
367
367
 
@@ -405,15 +405,15 @@ Her gönderim, herhangi bir şey başlamadan önce kontrol edilir — reddetmele
405
405
 
406
406
  ## Hub modu
407
407
 
408
- Bu paket aynı zamanda geçerli bir DSH bundle'ıdır (`dsh.bundle` + `cordis.patch.yml`). `dsh plugin add dsh-crew` ile DSH Web profiline kurulduktan sonra:
408
+ Bu paket aynı zamanda geçerli bir DSH bundle'ıdır (`dsh.bundle` + `cordis.patch.yml`). `dsh plugin add dsh-adapter` ile DSH Web profiline kurulduktan sonra:
409
409
 
410
410
  - **Worker oturumları birinci sınıf vatandaş olur**: DSH host'unda birinci sınıf oturumlar olarak çalışır (`agents.create` + oturum başına model/effort şelalesi + varsayılan preset), Web UI oturum listesinde görünür ve tam yürütmeyi görmek için istenildiği zaman açılabilir
411
411
  - **Çalışma dizinine göre düzenleme**: Web UI'da worker oturumlarını cwd'ye göre yönetin
412
412
  - **Loopback API**:
413
- - `POST/GET /_dsh/dsh-crew/jobs`: görev başlatma, listeleme, sonuçları long-poll ile bekleme, iptal
414
- - `GET /_dsh/dsh-crew/ping`: sağlık kontrolü (MCP shim, hub'ın çalışıp çalışmadığını anlamak için bunu kullanır)
415
- - `POST /_dsh/dsh-crew/install`: host entegrasyonlarının tek tıkla kurulumu — Claude Code / Codex / Antigravity / Grok (`src/install/` arka ucu)
416
- - **Otomatik algılama**: Host'ların MCP shim'i hub'ı otomatik algılar (`DSHPLUGIN_CREW_HUB` ortam değişkeni, varsayılan `http://127.0.0.1:3080`)
413
+ - `POST/GET /_dsh/dsh-adapter/jobs`: görev başlatma, listeleme, sonuçları long-poll ile bekleme, iptal
414
+ - `GET /_dsh/dsh-adapter/ping`: sağlık kontrolü (MCP shim, hub'ın çalışıp çalışmadığını anlamak için bunu kullanır)
415
+ - `POST /_dsh/dsh-adapter/install`: host entegrasyonlarının tek tıkla kurulumu — Claude Code / Codex / Antigravity / Grok (`src/install/` arka ucu)
416
+ - **Otomatik algılama**: Host'ların MCP shim'i hub'ı otomatik algılar (`DSHPLUGIN_ADAPTER_HUB` ortam değişkeni, varsayılan `http://127.0.0.1:3080`)
417
417
  - DSH Web çalışıyorsa → işler hub moduna girer (`mode: "hub"`)
418
418
  - Çalışmıyorsa → standalone runtime'a geri döner
419
419
 
@@ -437,7 +437,7 @@ Bu paket aynı zamanda geçerli bir DSH bundle'ıdır (`dsh.bundle` + `cordis.pa
437
437
 
438
438
  ### DSH Web çalışıyorsa → hub modu otomatik etkinleşir
439
439
 
440
- - **Güncel durum**: `dsh plugin add dsh-crew` DSH Web profiline kurulduysa, işler host'ta birinci sınıf oturumlar olarak çalışır ve Web UI oturum listesinde görünür
440
+ - **Güncel durum**: `dsh plugin add dsh-adapter` DSH Web profiline kurulduysa, işler host'ta birinci sınıf oturumlar olarak çalışır ve Web UI oturum listesinde görünür
441
441
  - **Öneri**: Yerel geliştirme iterasyonu sırasında hub modunun etkinleştirilmesi önerilir; worker ilerlemesi Web UI'da tamamen izlenebilir; makineler arası iş birliği veya Web UI olmayan ortamlar için gönderim yapan host'un shell yaklaşımını kullanın
442
442
 
443
443
  ### Bilinen konular
package/README.vi.md CHANGED
@@ -1,8 +1,8 @@
1
1
  <p align="center">
2
- <img src="./docs/images/dsh-crew-logo.png" alt="DSH Crew" width="120" />
2
+ <img src="./docs/images/dsh-adapter-logo.png" alt="DSH Adapter" width="120" />
3
3
  </p>
4
4
 
5
- <h1 align="center">DSH Crew</h1>
5
+ <h1 align="center">DSH Adapter</h1>
6
6
 
7
7
  <p align="center">
8
8
  <strong>Một plugin của <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>: điều phối công việc tới các DSH agent từ Claude Code / Codex / Antigravity / Grok mà không phải từ bỏ UI subagent gốc của host.</strong><br />
@@ -24,13 +24,13 @@
24
24
  <br />
25
25
 
26
26
  <p align="center">
27
- <img src="./docs/images/dsh-crew-overview.png" alt="DSH Crew — settings page" width="100%" />
27
+ <img src="./docs/images/dsh-adapter-overview.png" alt="DSH Adapter — settings page" width="100%" />
28
28
  </p>
29
- <p align="center"><sub>Trang cài đặt DSH Crew — tích hợp host, chính sách điều phối, thực thi và cầu nối đa phương thức</sub></p>
29
+ <p align="center"><sub>Trang cài đặt DSH Adapter — tích hợp host, chính sách điều phối, thực thi và cầu nối đa phương thức</sub></p>
30
30
 
31
- ## Vì sao dùng DSH Crew
31
+ ## Vì sao dùng DSH Adapter
32
32
 
33
- DSH Crew là một plugin cho [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) — một agent harness mã nguồn mở. Nó giúp các DSH agent có thể được điều phối từ Claude Code, Codex, Antigravity và Grok: orchestrator giữ model của riêng mình, công việc chạy trên một DSH agent thật với công cụ, sandbox, presets và lịch sử phiên của harness đó, và host vẫn hiển thị nó như một subagent gốc với tiến trình trực tiếp.
33
+ DSH Adapter là một plugin cho [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) — một agent harness mã nguồn mở. Nó giúp các DSH agent có thể được điều phối từ Claude Code, Codex, Antigravity và Grok: orchestrator giữ model của riêng mình, công việc chạy trên một DSH agent thật với công cụ, sandbox, presets và lịch sử phiên của harness đó, và host vẫn hiển thị nó như một subagent gốc với tiến trình trực tiếp.
34
34
 
35
35
  Thứ chạy công việc là một DSH agent, không phải một lời gọi model thuần túy. Tier (`flash` / `pro`) chọn mức năng lực mà agent đó nhận được từ roster model đã cấu hình của harness — hiện là DeepSeek V4 Flash và V4 Pro — nên việc đổi model trong DSH không cần thay đổi gì ở đây.
36
36
 
@@ -79,7 +79,7 @@ Mọi lần điều phối đều được kiểm tra trước khi bất cứ th
79
79
 
80
80
  ### 📋 Bảng Công việc
81
81
 
82
- Panel DSH Crew kiêm luôn vai trò bảng công việc: mọi job worker — đang chạy hay đã xong — đều được liệt kê với tier, effort, tiến độ trực tiếp và token, các workspace bị giữ hiển thị người giữ, và một job biến mất giữa chừng (ví dụ hub restart) hiện ra như một orphan ghost thay vì âm thầm biến mất.
82
+ Panel DSH Adapter kiêm luôn vai trò bảng công việc: mọi job worker — đang chạy hay đã xong — đều được liệt kê với tier, effort, tiến độ trực tiếp và token, các workspace bị giữ hiển thị người giữ, và một job biến mất giữa chừng (ví dụ hub restart) hiện ra như một orphan ghost thay vì âm thầm biến mất.
83
83
 
84
84
  </td>
85
85
  </tr>
@@ -118,14 +118,14 @@ Claude Code / Codex / Antigravity / Grok (orchestrator, keeps its own model)
118
118
  Việc dispatch có thể trải rộng. Bên dưới, mười tám worker dịch song song tài liệu README này: host đếm chúng như subagent của chính nó, còn harness chạy chúng như những phiên thực sự.
119
119
 
120
120
  <p align="center">
121
- <img src="./docs/images/dsh-crew-host.png" alt="Claude Code" width="100%" />
121
+ <img src="./docs/images/dsh-adapter-host.png" alt="Claude Code" width="100%" />
122
122
  </p>
123
- <p align="center"><sub>Trong Claude Code, worker của dsh-crew hiện ra như subagent gốc; đoạn statusline theo dõi tier đang chạy, thời gian trôi qua và token.</sub></p>
123
+ <p align="center"><sub>Trong Claude Code, worker của dsh-adapter hiện ra như subagent gốc; đoạn statusline theo dõi tier đang chạy, thời gian trôi qua và token.</sub></p>
124
124
 
125
125
  <p align="center">
126
- <img src="./docs/images/dsh-crew-jobs.png" alt="DSH Crew" width="100%" />
126
+ <img src="./docs/images/dsh-adapter-jobs.png" alt="DSH Adapter" width="100%" />
127
127
  </p>
128
- <p align="center"><sub>Bảng DSH Crew nhìn cùng lần chạy đó từ phía harness: host nào đã gửi mỗi job, tier và effort của nó, tiến độ trực tiếp và lượng token.</sub></p>
128
+ <p align="center"><sub>Bảng DSH Adapter nhìn cùng lần chạy đó từ phía harness: host nào đã gửi mỗi job, tier và effort của nó, tiến độ trực tiếp và lượng token.</sub></p>
129
129
 
130
130
  <p align="center"><sub>Panel này đồng thời là bảng công việc: các job đang chạy và đã xong vẫn nằm trong danh sách với tier, tiến độ và token, các workspace bị giữ nêu tên người giữ, và một job biến mất giữa chừng (hub restart) hiện ra như một orphan ghost thay vì âm thầm biến mất.</sub></p>
131
131
 
@@ -141,7 +141,7 @@ dsh web
141
141
  Hoặc, để phát triển cục bộ ngay từ mã nguồn:
142
142
 
143
143
  ```bash
144
- dsh plugin --profile web add link:/path/to/dsh-crew
144
+ dsh plugin --profile web add link:/path/to/dsh-adapter
145
145
  dsh web
146
146
  ```
147
147
 
@@ -151,7 +151,7 @@ Giao thức `link:` tạo symlink phụ thuộc của profile tới kho này, n
151
151
 
152
152
  Trong hub mode — cài đặt ở trên — worker chạy bên trong instance DSH và sử dụng thông tin xác thực DeepSeek đã được cấu hình. Không cần setup thêm gì.
153
153
 
154
- Chỉ fallback standalone cần key riêng: khi dispatch từ một host mà không có instance DSH đang chạy, nó sẽ khởi động worker runtime như một process riêng. Lấy API key tại [platform.deepseek.com](https://platform.deepseek.com) và ghi vào `~/.config/dsh-crew/.env`:
154
+ Chỉ fallback standalone cần key riêng: khi dispatch từ một host mà không có instance DSH đang chạy, nó sẽ khởi động worker runtime như một process riêng. Lấy API key tại [platform.deepseek.com](https://platform.deepseek.com) và ghi vào `~/.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 dispatch một job rẻ qua path nào khả dụng — hub khi instance DSH đang chạy, standalone nếu không — và in ra path nào được sử dụng. Trong khoảng mười giây bạn sẽ thấy `smoke test passed — configuration OK`. Nếu lỗi, lý do sẽ được in ra và giới hạn trong path được kiểm tra.
167
167
 
168
- Sau đó mở Cài đặt → DSH Crew và cài tích hợp host — Claude Code, Codex, Antigravity, Grok — chỉ với một cú nhấp, hoặc điều khiển trình cài đặt đó từ dòng lệnh:
168
+ Sau đó mở Cài đặt → DSH Adapter và cài tích hợp host — Claude Code, Codex, Antigravity, Grok — chỉ với một cú nhấp, hoặc điều khiển trình cài đặt đó từ dòng lệnh:
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
  Cài đặt một cú nhấp (chọn một):
194
194
 
195
- - **Trang cài đặt DSH** (khi hub mode được cài): Settings → DSH Crew → "Install to Claude Code"
195
+ - **Trang cài đặt DSH** (khi hub mode được cài): Settings → DSH Adapter → "Install to Claude Code"
196
196
  - **Dòng lệnh**: `node src/install/cli.mjs all`
197
197
 
198
198
  Cả hai làm cùng một việc: đăng ký marketplace cục bộ (thư mục cha `dsh-plugins/` làm marketplace root) + `claude plugin install` + allowlist quyền MCP tool + cấu hình segment trạng thái worker cho claude-hud (tự sao lưu settings.json trước khi thay đổi, idempotent). **Khởi động lại phiên sau khi cài đặt để thay đổi có hiệu lực.**
@@ -204,7 +204,7 @@ Cả hai làm cùng một việc: đăng ký marketplace cục bộ (thư mục
204
204
  - **Segment statusline HUD**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (tier hiện tại / thời gian trôi qua / lượng token / số hoàn thành)
205
205
  - Khi phát triển cục bộ, `statusline/statusline.sh` hoặc `statusline/worker-segment.sh` có thể được tích hợp độc lập
206
206
  - **Tác vụ chạy lâu**: CC có giới hạn timeout trên các lời gọi MCP (`MCP_TOOL_TIMEOUT` có thể điều chỉnh), tác vụ dài có thể để orchestrator dùng `dsh_spawn_worker` + polling `dsh_worker_result(wait_seconds)`
207
- - **Phát triển và gỡ lỗi cục bộ**: `claude --plugin-dir /path/to/dsh-crew` để tải tạm thời
207
+ - **Phát triển và gỡ lỗi cục bộ**: `claude --plugin-dir /path/to/dsh-adapter` để tải tạm thời
208
208
 
209
209
 
210
210
  ### Lệnh phiên
@@ -213,11 +213,11 @@ Chỉ ghi đè giá trị mặc định toàn cục cho phiên hiện tại, và
213
213
 
214
214
  | Lệnh | Tác dụng |
215
215
  |---|---|
216
- | `/dsh-crew:config` | Xem hoặc đặt mặc định của phiên: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<giây>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `origin_depth_limit=<1-32>`, `preset_flash/preset_pro=<preset id|default>`, `reset` |
216
+ | `/dsh-adapter:config` | Xem hoặc đặt mặc định của phiên: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<giây>`, `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-crew:on` · `/dsh-crew:off` | Bật hoặc tắt dispatch cho phiên này (tắt là công tắc cứng: công cụ sẽ từ chối) |
219
- | `/dsh-crew:status` | Trạng thái trực tiếp của job worker: tier, tiến độ, token, công cụ hiện tại |
220
- | `/dsh-crew:playbook` | Thực hành điều phối tốt nhất: chọn flash hay pro, bản mô tả khép kín, song song hóa, xác minh kết quả, guardrail |
218
+ | `/dsh-adapter:on` · `/dsh-adapter:off` | Bật hoặc tắt dispatch cho phiên này (tắt là công tắc cứng: công cụ sẽ từ chối) |
219
+ | `/dsh-adapter:status` | Trạng thái trực tiếp của job worker: tier, tiến độ, token, công cụ hiện tại |
220
+ | `/dsh-adapter:playbook` | Thực hành điều phối tốt nhất: chọn flash hay pro, bản mô tả khép kín, song song hóa, xác minh kết quả, guardrail |
221
221
 
222
222
  ## Codex
223
223
 
@@ -268,7 +268,7 @@ Phía Codex cài ba prompt tương ứng:
268
268
  node src/install/cli.mjs agy
269
269
  ```
270
270
 
271
- Đăng ký dsh-crew MCP server vào `~/.gemini/config/mcp_config.json` và cài các agent `ds-flash` / `ds-pro` cùng các skill `dsh-config`, `dsh-status` và `dsh-playbook` vào `~/.gemini/config/` (mọi tệp được sao lưu trước). Khởi động lại phiên sau khi cài đặt.
271
+ Đăng ký dsh-adapter MCP server vào `~/.gemini/config/mcp_config.json` và cài các agent `ds-flash` / `ds-pro` cùng các skill `dsh-config`, `dsh-status` và `dsh-playbook` vào `~/.gemini/config/` (mọi tệp được sao lưu trước). Khởi động lại phiên sau khi cài đặt.
272
272
 
273
273
  ### Sử dụng
274
274
 
@@ -297,7 +297,7 @@ Gỡ cài đặt: `node src/install/cli.mjs uninstall-agy`
297
297
  node src/install/cli.mjs grok
298
298
  ```
299
299
 
300
- Ghi phần `[mcp_servers.dsh-crew]` vào `~/.grok/config.toml` và cài các agent `ds-flash` / `ds-pro` cùng các lệnh `/dsh-config`, `/dsh-status` và `/dsh-playbook` vào `~/.grok/` (mọi tệp được sao lưu trước).
300
+ Ghi phần `[mcp_servers.dsh-adapter]` vào `~/.grok/config.toml` và cài các agent `ds-flash` / `ds-pro` cùng các lệnh `/dsh-config`, `/dsh-status` và `/dsh-playbook` vào `~/.grok/` (mọi tệp được sao lưu trước).
301
301
 
302
302
  ### Sử dụng
303
303
 
@@ -329,7 +329,7 @@ Gỡ cài đặt: `node src/install/cli.mjs uninstall-grok`
329
329
  | `dsh_worker_cancel` | Hủy job được chỉ định, chấm dứt process runtime của nó |
330
330
  | `dsh_worker_config` | Đọc/đặt mặc định phiên (tier, effort, mode, timeout, policy, escalation) và liệt kê `worker_profiles` |
331
331
 
332
- Tiến trình đồng thời được phản chiếu vào `~/.config/dsh-crew/status.d/` (một tệp shard cho mỗi writer, có thể được đọc bởi statusline / giám sát bên ngoài).
332
+ Tiến trình đồng thời được phản chiếu vào `~/.config/dsh-adapter/status.d/` (một tệp shard cho mỗi writer, có thể được đọc bởi statusline / giám sát bên ngoài).
333
333
 
334
334
  ## Guardrail điều phối
335
335
 
@@ -340,7 +340,7 @@ Mọi lần điều phối đều được kiểm tra trước khi bất cứ th
340
340
 
341
341
  ## Playbook điều phối
342
342
 
343
- Cách điều phối *tốt* — flash hay pro, bản mô tả khép kín, song song hóa an toàn, xác minh kết quả và các guardrail ở trên — được đóng gói theo từng host: `/dsh-crew:playbook` (Claude Code skill), `/dsh-playbook` (Codex prompt, Antigravity skill, Grok command).
343
+ Cách điều phối *tốt* — flash hay pro, bản mô tả khép kín, song song hóa an toàn, xác minh kết quả và các guardrail ở trên — được đóng gói theo từng host: `/dsh-adapter:playbook` (Claude Code skill), `/dsh-playbook` (Codex prompt, Antigravity skill, Grok command).
344
344
 
345
345
  ## Backend CLI tường minh
346
346
 
@@ -350,7 +350,7 @@ Cách điều phối *tốt* — flash hay pro, bản mô tả khép kín, song
350
350
 
351
351
  **DeepSeek là model chỉ xử lý văn bản** và không hỗ trợ nhập ảnh hay tạo ảnh. Plugin này lấy các khả năng đó từ bên ngoài thông qua các MCP tool:
352
352
 
353
- **Native vision trước tiên**: khi vision provider là một CLI tích hợp sẵn (hoặc tường minh `native`), `describe_image` thử trước model VL của chính DeepSeek `deepseek-v4-flash-vision-exp` (gọi API trực tiếp; key từ `DEEPSEEK_API_KEY` hoặc `~/.config/dsh-crew/.env`). Mọi lỗi đều rơi xuống chuỗi CLI provider bên dưới một cách nhẹ nhàng; chuỗi đó được giữ nguyên làm fallback. Tạo ảnh không bị ảnh hưởng — model native chỉ nhìn ảnh.
353
+ **Native vision trước tiên**: khi vision provider là một CLI tích hợp sẵn (hoặc tường minh `native`), `describe_image` thử trước model VL của chính DeepSeek `deepseek-v4-flash-vision-exp` (gọi API trực tiếp; key từ `DEEPSEEK_API_KEY` hoặc `~/.config/dsh-adapter/.env`). Mọi lỗi đều rơi xuống chuỗi CLI provider bên dưới một cách nhẹ nhàng; chuỗi đó được giữ nguyên làm fallback. Tạo ảnh không bị ảnh hưởng — model native chỉ nhìn ảnh.
354
354
 
355
355
  | Công cụ | Mô tả |
356
356
  |---|---|
@@ -361,7 +361,7 @@ Cách điều phối *tốt* — flash hay pro, bản mô tả khép kín, song
361
361
 
362
362
  ### Cấu hình
363
363
 
364
- Trong **trang cài đặt DSH → DSH Crew → Multimodal** (hoặc sửa trực tiếp `~/.config/dsh-crew/config.json`):
364
+ Trong **trang cài đặt DSH → DSH Adapter → Multimodal** (hoặc sửa trực tiếp `~/.config/dsh-adapter/config.json`):
365
365
 
366
366
  **Vision provider** (xem ảnh):
367
367
 
@@ -405,15 +405,15 @@ Hai cách tích hợp:
405
405
 
406
406
  ## Hub mode
407
407
 
408
- Gói này cũng là một DSH bundle hợp lệ (`dsh.bundle` + `cordis.patch.yml`). Sau khi cài vào DSH Web profile bằng `dsh plugin add dsh-crew`:
408
+ Gói này cũng là một DSH bundle hợp lệ (`dsh.bundle` + `cordis.patch.yml`). Sau khi cài vào DSH Web profile bằng `dsh plugin add dsh-adapter`:
409
409
 
410
410
  - **Các phiên worker trở thành công dân hạng nhất**: chạy như các phiên first-class trong DSH host (`agents.create` + waterfall model/effort theo từng phiên + preset mặc định), xuất hiện trong danh sách phiên của Web UI, có thể mở bất cứ lúc nào để xem toàn bộ quá trình thực thi
411
411
  - **Sắp xếp theo thư mục làm việc**: quản lý các phiên worker theo cwd trong Web UI
412
412
  - **Loopback API**:
413
- - `POST/GET /_dsh/dsh-crew/jobs`: tạo tác vụ, liệt kê, long-poll kết quả, hủy
414
- - `GET /_dsh/dsh-crew/ping`: kiểm tra sức khỏe (MCP shim dùng nó để phát hiện hub có đang chạy không)
415
- - `POST /_dsh/dsh-crew/install`: cài đặt tích hợp host một cú nhấp — Claude Code / Codex / Antigravity / Grok (backend của `src/install/`)
416
- - **Tự động phát hiện**: MCP shim của các host tự động phát hiện hub (biến env `DSHPLUGIN_CREW_HUB`, mặc định `http://127.0.0.1:3080`)
413
+ - `POST/GET /_dsh/dsh-adapter/jobs`: tạo tác vụ, liệt kê, long-poll kết quả, hủy
414
+ - `GET /_dsh/dsh-adapter/ping`: kiểm tra sức khỏe (MCP shim dùng nó để phát hiện hub có đang chạy không)
415
+ - `POST /_dsh/dsh-adapter/install`: cài đặt tích hợp host một cú nhấp — Claude Code / Codex / Antigravity / Grok (backend của `src/install/`)
416
+ - **Tự động phát hiện**: MCP shim của các host tự động phát hiện hub (biến env `DSHPLUGIN_ADAPTER_HUB`, mặc định `http://127.0.0.1:3080`)
417
417
  - DSH Web đang chạy → job vào hub mode (`mode: "hub"`)
418
418
  - Không chạy → rơi về standalone runtime
419
419
 
@@ -437,7 +437,7 @@ Gói này cũng là một DSH bundle hợp lệ (`dsh.bundle` + `cordis.patch.ym
437
437
 
438
438
  ### Đang chạy DSH Web → hub mode tự bật
439
439
 
440
- - **Hiện trạng**: Nếu `dsh plugin add dsh-crew` được cài vào DSH Web profile, các job chạy như phiên first-class trong host, xuất hiện trong danh sách phiên của Web UI
440
+ - **Hiện trạng**: Nếu `dsh plugin add dsh-adapter` được cài vào DSH Web profile, các job chạy như phiên first-class trong host, xuất hiện trong danh sách phiên của Web UI
441
441
  - **Khuyến nghị**: Trong các vòng lặp phát triển cục bộ, khuyến nghị bật hub mode; tiến trình worker có thể được quan sát đầy đủ trong Web UI; với cộng tác liên máy hoặc môi trường không có Web UI, dùng phương án shell của host điều phối
442
442
 
443
443
  ### Các mục đã biết
package/README.zh-TW.md CHANGED
@@ -1,8 +1,8 @@
1
1
  <p align="center">
2
- <img src="./docs/images/dsh-crew-logo.png" alt="DSH Crew" width="120" />
2
+ <img src="./docs/images/dsh-adapter-logo.png" alt="DSH Adapter" width="120" />
3
3
  </p>
4
4
 
5
- <h1 align="center">DSH Crew</h1>
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-crew-overview.png" alt="DSH Crew — settings page" width="100%" />
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 Crew 設定頁面 — 主機整合、分派策略、執行與多模態橋接</sub></p>
29
+ <p align="center"><sub>DSH Adapter 設定頁面 — 主機整合、分派策略、執行與多模態橋接</sub></p>
30
30
 
31
- ## 為什麼選擇 DSH Crew
31
+ ## 為什麼選擇 DSH Adapter
32
32
 
33
- DSH Crew 是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)開源代理框架的外掛程式。它使 DSH 代理可從 Claude Code、Codex、Antigravity 與 Grok 分派:協調器保留自己的模型,工作在帶有該框架的工具、沙箱、預設和工作階段歷史紀錄的真正 DSH 代理上執行,主機仍然將其顯示為帶有即時進度的原生 subagent。
33
+ DSH Adapter 是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)開源代理框架的外掛程式。它使 DSH 代理可從 Claude Code、Codex、Antigravity 與 Grok 分派:協調器保留自己的模型,工作在帶有該框架的工具、沙箱、預設和工作階段歷史紀錄的真正 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` 現在只要有 key 就優先使用
79
79
 
80
80
  ### 📋 任務看板
81
81
 
82
- DSH Crew 面板同時是任務看板:每個 worker 任務 — 執行中或已結束 — 都帶著 tier、effort、即時進度與 token 列在板上,被持有的 workspace 會顯示持有者;中途消失的任務(例如 hub 重啟)會作為孤兒 ghost 浮出,而不是無聲消失。
82
+ DSH Adapter 面板同時是任務看板:每個 worker 任務 — 執行中或已結束 — 都帶著 tier、effort、即時進度與 token 列在板上,被持有的 workspace 會顯示持有者;中途消失的任務(例如 hub 重啟)會作為孤兒 ghost 浮出,而不是無聲消失。
83
83
 
84
84
  </td>
85
85
  </tr>
@@ -118,14 +118,14 @@ Claude Code / Codex / Antigravity / Grok(協調器,保留自己的模型)
118
118
  分派是可以鋪開的。下面這次,18 個 worker 並行翻譯這份 README:宿主把它們算作自己的子代理,harness 則把它們當作真實工作階段來跑。
119
119
 
120
120
  <p align="center">
121
- <img src="./docs/images/dsh-crew-host.png" alt="Claude Code" width="100%" />
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-crew worker 就是原生子代理;狀態列區段即時顯示執行中的 tier、耗時與 token。</sub></p>
123
+ <p align="center"><sub>Claude Code 裡,dsh-adapter worker 就是原生子代理;狀態列區段即時顯示執行中的 tier、耗時與 token。</sub></p>
124
124
 
125
125
  <p align="center">
126
- <img src="./docs/images/dsh-crew-jobs.png" alt="DSH Crew" width="100%" />
126
+ <img src="./docs/images/dsh-adapter-jobs.png" alt="DSH Adapter" width="100%" />
127
127
  </p>
128
- <p align="center"><sub>DSH Crew 面板從 harness 一側看同一次執行:每個任務由哪個宿主分派、tier 與 effort、即時進度與 token 用量。</sub></p>
128
+ <p align="center"><sub>DSH Adapter 面板從 harness 一側看同一次執行:每個任務由哪個宿主分派、tier 與 effort、即時進度與 token 用量。</sub></p>
129
129
 
130
130
  <p align="center"><sub>面板同時是任務看板:執行中與已結束的任務都帶著 tier、進度與 token 留在板上,被持有的 workspace 會標出持有者,中途消失的任務(hub 重啟)會作為孤兒 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-crew
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
- 僅 standalone 回落方案需要自己的 key:從主機分派任務而沒有 DSH 實例運行時,會啟動一個獨立的 worker runtime 程序。從 [platform.deepseek.com](https://platform.deepseek.com) 取得 API key,寫入 `~/.config/dsh-crew/.env`:
154
+ 僅 standalone 回落方案需要自己的 key:從主機分派任務而沒有 DSH 實例運行時,會啟動一個獨立的 worker runtime 程序。從 [platform.deepseek.com](https://platform.deepseek.com) 取得 API key,寫入 `~/.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 測試會挑一條可用的路徑派一個廉價任務——DSH 實例在跑就走 hub,否則走 standalone——並印出實際用的是哪條。十幾秒內看到 `smoke test passed — configuration OK` 即設定成功。失敗會印出具體原因,且只針對實際測的那條路徑。
167
167
 
168
- 接著開啟 設定 → DSH Crew,一鍵裝好主機整合 — Claude Code、Codex、Antigravity、Grok,或用命令列驅動同一個安裝器:
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 Crew → "安裝到 Claude Code"
195
+ - **DSH 設定頁面**(hub 模式已安裝時):設定 → DSH Adapter → "安裝到 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` 可調),長工作可讓協調器使用 `dsh_spawn_worker` + `dsh_worker_result(wait_seconds)` 輪詢
207
- - **本機開發與除錯**:`claude --plugin-dir /path/to/dsh-crew` 以暫時載入
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-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
- | `/dsh-crew:on` · `/dsh-crew:off` | 開關本階段的分派(關閉是硬開關,工具層直接拒絕) |
218
- | `/dsh-crew:status` | worker 任務即時狀態:tier、進度、tokens、目前工具 |
219
- | `/dsh-crew:playbook` | 分派最佳實踐:flash vs pro 選擇、自包含任務簡報、平行、結果驗證、護欄 |
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、進度、tokens、目前工具 |
219
+ | `/dsh-adapter:playbook` | 分派最佳實踐:flash vs pro 選擇、自包含任務簡報、平行、結果驗證、護欄 |
220
220
 
221
221
  ## Codex
222
222
 
@@ -266,7 +266,7 @@ Codex 端裝的是三條 prompt:
266
266
  node src/install/cli.mjs agy
267
267
  ```
268
268
 
269
- 把 dsh-crew MCP server 註冊進 `~/.gemini/config/mcp_config.json`,並把 `ds-flash` / `ds-pro` agent 與 `dsh-config`、`dsh-status`、`dsh-playbook` skill 裝進 `~/.gemini/config/`(變更前自動備份)。安裝後重新啟動工作階段生效。
269
+ 把 dsh-adapter MCP server 註冊進 `~/.gemini/config/mcp_config.json`,並把 `ds-flash` / `ds-pro` agent 與 `dsh-config`、`dsh-status`、`dsh-playbook` skill 裝進 `~/.gemini/config/`(變更前自動備份)。安裝後重新啟動工作階段生效。
270
270
 
271
271
  ### 使用方式
272
272
 
@@ -295,7 +295,7 @@ node src/install/cli.mjs agy
295
295
  node src/install/cli.mjs grok
296
296
  ```
297
297
 
298
- 把 `[mcp_servers.dsh-crew]` 區段寫入 `~/.grok/config.toml`,並把 `ds-flash` / `ds-pro` agent 與 `/dsh-config`、`/dsh-status`、`/dsh-playbook` 命令裝進 `~/.grok/`(變更前自動備份)。
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` | 取消指定工作,終止其 runtime 程序 |
328
328
  | `dsh_worker_config` | 檢視/設定本階段預設值(tier、effort、mode、timeout、policy、escalation),並列出 `worker_profiles` |
329
329
 
330
- 進度同時複製到 `~/.config/dsh-crew/status.d/`(每個寫入者一個分片檔案,可由 statusline / 外部監控讀取)。
330
+ 進度同時複製到 `~/.config/dsh-adapter/status.d/`(每個寫入者一個分片檔案,可由 statusline / 外部監控讀取)。
331
331
 
332
332
  ## 分派護欄
333
333
 
@@ -338,7 +338,7 @@ node src/install/cli.mjs grok
338
338
 
339
339
  ## 分派手冊(playbook)
340
340
 
341
- 如何把工作分派得好 — flash vs pro、自包含任務簡報、安全平行、結果驗證,以及上面的護欄 — 隨包按主機分發:`/dsh-crew:playbook`(Claude Code skill)、`/dsh-playbook`(Codex prompt、Antigravity skill、Grok 命令)。
341
+ 如何把工作分派得好 — flash vs pro、自包含任務簡報、安全平行、結果驗證,以及上面的護欄 — 隨包按主機分發:`/dsh-adapter:playbook`(Claude Code skill)、`/dsh-playbook`(Codex prompt、Antigravity skill、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
- **原生視覺優先**:當視覺 provider 是內建 CLI(或顯式 `native`)時,`describe_image` 會先試 DeepSeek 自己的視覺模型 `deepseek-v4-flash-vision-exp`(直接 API 呼叫;key 來自 `DEEPSEEK_API_KEY` 或 `~/.config/dsh-crew/.env`)。任何失敗都會優雅回落到下面的 CLI provider 鏈,這條鏈原樣保留作為兜底。圖片生成不受影響 — 原生模型只看圖。
351
+ **原生視覺優先**:當視覺 provider 是內建 CLI(或顯式 `native`)時,`describe_image` 會先試 DeepSeek 自己的視覺模型 `deepseek-v4-flash-vision-exp`(直接 API 呼叫;key 來自 `DEEPSEEK_API_KEY` 或 `~/.config/dsh-adapter/.env`)。任何失敗都會優雅回落到下面的 CLI provider 鏈,這條鏈原樣保留作為兜底。圖片生成不受影響 — 原生模型只看圖。
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 Crew → Multimodal**(或直接編輯 `~/.config/dsh-crew/config.json`):
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 束(`dsh.bundle` + `cordis.patch.yml`)。使用 `dsh plugin add dsh-crew` 安裝進 DSH Web 設定檔後:
406
+ 此套件也是有效的 DSH 束(`dsh.bundle` + `cordis.patch.yml`)。使用 `dsh plugin add dsh-adapter` 安裝進 DSH Web 設定檔後:
407
407
 
408
408
  - **Worker 工作階段成為一級公民**:在 DSH 主機中作為一級工作階段執行(`agents.create` + 每工作階段模型/effort 瀑布 + 預設預設),出現在 Web UI 工作階段列表中,可隨時開啟以檢視完整執行
409
409
  - **按工作目錄組織**:在 Web UI 中按 cwd 管理 worker 工作階段
410
410
  - **Loopback API**:
411
- - `POST/GET /_dsh/dsh-crew/jobs`:生成工作、列出、長時間輪詢結果、取消
412
- - `GET /_dsh/dsh-crew/ping`:健康檢查(MCP shim 使用此來檢測 hub 是否執行)
413
- - `POST /_dsh/dsh-crew/install`:單鍵安裝主機整合 — Claude Code / Codex / Antigravity / Grok(`src/install/` 的後端)
414
- - **自動偵測**:各主機的 MCP shim 自動偵測 hub(`DSHPLUGIN_CREW_HUB` 環境變數,預設 `http://127.0.0.1:3080`)
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
  - 未執行 → 回落到獨立 runtime
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-crew` 已安裝到 DSH Web 設定檔,工作在主機中作為一級工作階段執行,出現在 Web UI 工作階段列表中
438
+ - **目前狀態**:如果 `dsh plugin add dsh-adapter` 已安裝到 DSH Web 設定檔,工作在主機中作為一級工作階段執行,出現在 Web UI 工作階段列表中
439
439
  - **建議**:在本機開發反覆過程中,建議啟用 hub 模式;worker 進度可在 Web UI 中完全觀察;對於跨機器協作或無 Web UI 的環境,使用分派主機的 shell 方法
440
440
 
441
441
  ### 已知項目