@zoraxylia/dsh-codex-adapter 0.0.0-stage โ†’ 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (87) hide show
  1. package/.claude-plugin/marketplace.json +15 -0
  2. package/.claude-plugin/plugin.json +8 -0
  3. package/.mcp.json +8 -0
  4. package/LICENSE +21 -0
  5. package/README.de.md +480 -0
  6. package/README.es.md +480 -0
  7. package/README.fr.md +480 -0
  8. package/README.hi.md +480 -0
  9. package/README.id.md +480 -0
  10. package/README.ja.md +478 -0
  11. package/README.ko.md +480 -0
  12. package/README.md +483 -2
  13. package/README.pt.md +480 -0
  14. package/README.ru.md +480 -0
  15. package/README.th.md +480 -0
  16. package/README.tr.md +480 -0
  17. package/README.vi.md +480 -0
  18. package/README.zh-TW.md +478 -0
  19. package/README.zh.md +482 -0
  20. package/agents/ds-flash.md +17 -0
  21. package/agents/ds-pro.md +17 -0
  22. package/agy/agents/ds-flash.md +18 -0
  23. package/agy/agents/ds-pro.md +18 -0
  24. package/agy/skills/dsh-config/SKILL.md +6 -0
  25. package/agy/skills/dsh-playbook/SKILL.md +65 -0
  26. package/agy/skills/dsh-status/SKILL.md +6 -0
  27. package/codex/agents/ds-flash.toml +23 -0
  28. package/codex/agents/ds-pro.toml +23 -0
  29. package/codex/prompts/dsh-config.md +3 -0
  30. package/codex/prompts/dsh-playbook.md +60 -0
  31. package/codex/prompts/dsh-status.md +1 -0
  32. package/commands/config.md +9 -0
  33. package/commands/off.md +5 -0
  34. package/commands/on.md +5 -0
  35. package/commands/playbook.md +64 -0
  36. package/commands/status.md +5 -0
  37. package/cordis.patch.yml +4 -0
  38. package/docs/images/dsh-crew-host.png +0 -0
  39. package/docs/images/dsh-crew-jobs.png +0 -0
  40. package/docs/images/dsh-crew-logo.png +0 -0
  41. package/docs/images/dsh-crew-overview.png +0 -0
  42. package/grok/agents/ds-flash.md +19 -0
  43. package/grok/agents/ds-pro.md +19 -0
  44. package/grok/commands/dsh-config.md +9 -0
  45. package/grok/commands/dsh-playbook.md +66 -0
  46. package/grok/commands/dsh-status.md +5 -0
  47. package/lib/client.js +2684 -0
  48. package/lib/server.mjs +15417 -0
  49. package/package.json +137 -4
  50. package/scripts/build-client.mjs +23 -0
  51. package/scripts/build-mcp.mjs +43 -0
  52. package/scripts/fake-agy.sh +23 -0
  53. package/scripts/release-local.mjs +87 -0
  54. package/scripts/smoke-bundle.mjs +166 -0
  55. package/scripts/smoke-cwd.mjs +41 -0
  56. package/scripts/smoke-pack.mjs +285 -0
  57. package/scripts/smoke.mjs +79 -0
  58. package/scripts/verify-cli-workers.mjs +133 -0
  59. package/scripts/verify-wpc10-client.mjs +237 -0
  60. package/scripts/verify-wpc14-proc-endpoints.mjs +356 -0
  61. package/scripts/verify-wpc9-guardrails.mjs +432 -0
  62. package/src/cli-workers.mjs +396 -0
  63. package/src/client/index.tsx +1133 -0
  64. package/src/client/jobs-view.ts +374 -0
  65. package/src/cwd-lock.mjs +91 -0
  66. package/src/hub/index.mjs +643 -0
  67. package/src/hub-client.mjs +72 -0
  68. package/src/i18n.mjs +19 -0
  69. package/src/install/cli.mjs +34 -0
  70. package/src/install/install.mjs +577 -0
  71. package/src/jobs.mjs +289 -0
  72. package/src/multimodal.mjs +744 -0
  73. package/src/origin-guard.mjs +133 -0
  74. package/src/paths.mjs +43 -0
  75. package/src/plugin-env.mjs +65 -0
  76. package/src/proc-kill.mjs +208 -0
  77. package/src/process-info.mjs +60 -0
  78. package/src/provider-probe.mjs +35 -0
  79. package/src/server.mjs +438 -0
  80. package/src/status-shard.mjs +95 -0
  81. package/src/tier-binding.mjs +63 -0
  82. package/src/vision-route.mjs +139 -0
  83. package/src/worker-profiles.mjs +95 -0
  84. package/src/worker-question.mjs +22 -0
  85. package/statusline/statusline.sh +14 -0
  86. package/statusline/worker-segment.sh +35 -0
  87. package/worker.cordis.yml +77 -0
package/README.ko.md ADDED
@@ -0,0 +1,480 @@
1
+ <p align="center">
2
+ <img src="./docs/images/dsh-crew-logo.png" alt="DSH Crew" width="120" />
3
+ </p>
4
+
5
+ <h1 align="center">DSH Crew</h1>
6
+
7
+ <p align="center">
8
+ <strong><a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> plugin: Claude Code / Codex / Antigravity / Grok์—์„œ DSH agent๋กœ ์ž‘์—…์„ dispatchํ•˜๋ฉฐ, ํ˜ธ์ŠคํŠธ์˜ native subagent UI๋Š” ๊ทธ๋Œ€๋กœ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค.</strong><br />
9
+ <sub>๋„ค์ดํ‹ฐ๋ธŒ ์ง„ํ–‰ UI &bull; Tier ์ •์ฑ… &amp; ์—์Šค์ปฌ๋ ˆ์ด์…˜ &bull; ๋””์ŠคํŒจ์น˜ ๊ฐ€๋“œ๋ ˆ์ผ &bull; ์ž‘์—… ๋ณด๋“œ &bull; ํ˜ธ์ŠคํŠธ ๋‚ด DSH ์„ธ์…˜ &bull; ๋น„์ „ &amp; ์ด๋ฏธ์ง€ ์ƒ์„ฑ(๋„ค์ดํ‹ฐ๋ธŒ ์šฐ์„ ) &bull; ์›ํด๋ฆญ ์„ค์น˜</sub>
10
+ </p>
11
+
12
+ <p align="center">
13
+ <sub>npm: <code>@zoraxylia/dsh-codex-adapter</code> &middot; ํ˜„์žฌ plugin ๋ฆด๋ฆฌ์Šค: <code>0.1.0-rc.11</code> &middot; DSH <code>0.1.1-rc.1</code>์—์„œ ํ…Œ์ŠคํŠธ๋จ</sub>
14
+ </p>
15
+
16
+ <p align="center">
17
+ <a href="./README.md">English</a> &middot; <a href="./README.zh.md">็ฎ€ไฝ“ไธญๆ–‡</a> &middot; <a href="./README.zh-TW.md">็น้ซ”ไธญๆ–‡</a> &middot; <a href="./README.ja.md">ๆ—ฅๆœฌ่ชž</a> &middot; <a href="./README.ko.md"><b>ํ•œ๊ตญ์–ด</b></a> &middot; <a href="./README.fr.md">Franรงais</a> &middot; <a href="./README.es.md">Espaรฑol</a> &middot; <a href="./README.de.md">Deutsch</a> &middot; <a href="./README.pt.md">Portuguรชs</a> &middot; <a href="./README.ru.md">ะ ัƒััะบะธะน</a> &middot; <a href="./README.hi.md">เคนเคฟเคจเฅเคฆเฅ€</a> &middot; <a href="./README.tr.md">Tรผrkรงe</a> &middot; <a href="./README.th.md">เน„เธ—เธข</a> &middot; <a href="./README.vi.md">Tiแบฟng Viแป‡t</a> &middot; <a href="./README.id.md">Bahasa Indonesia</a>
18
+ </p>
19
+
20
+ <p align="center">
21
+ <a href="https://github.com/ZSeven-W/dsh-crew/blob/main/LICENSE"><img src="https://img.shields.io/github/license/ZSeven-W/dsh-crew?color=64748b" alt="License" /></a>
22
+ </p>
23
+
24
+ <br />
25
+
26
+ <p align="center">
27
+ <img src="./docs/images/dsh-crew-overview.png" alt="DSH Crew โ€” ์„ค์ • ํŽ˜์ด์ง€" width="100%" />
28
+ </p>
29
+ <p align="center"><sub>DSH Crew ์„ค์ • ํŽ˜์ด์ง€ โ€” ํ˜ธ์ŠคํŠธ ํ†ตํ•ฉ, ๋””์ŠคํŒจ์น˜ ์ •์ฑ…, ์‹คํ–‰ ๋ฐ ๋ฉ€ํ‹ฐ๋ชจ๋‹ฌ ๋ธŒ๋ฆฌ์ง€</sub></p>
30
+
31
+ ## DSH Crew๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ์ด์œ 
32
+
33
+ DSH Crew๋Š” ์˜คํ”ˆ์†Œ์Šค 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
+
35
+ ์ž‘์—…์„ ์‹ค์ œ๋กœ ์‹คํ–‰ํ•˜๋Š” ๊ฒƒ์€ DSH agent์ด์ง€, ๋‹จ์ˆœํ•œ model ํ˜ธ์ถœ์ด ์•„๋‹™๋‹ˆ๋‹ค. tier(`flash` / `pro`)๋Š” ํ•ด๋‹น agent๊ฐ€ harness์— ์„ค์ •๋œ model roster์—์„œ ์–ผ๋งˆ๋‚˜ ๋งŽ์€ capability๋ฅผ ๋ฐ›์„์ง€ ๊ฒฐ์ •ํ•ฉ๋‹ˆ๋‹ค โ€” ํ˜„์žฌ๋Š” DeepSeek V4 Flash์™€ V4 Pro โ€” ๋”ฐ๋ผ์„œ DSH์—์„œ model์„ ๋ฐ”๊ฟ”๋„ ์—ฌ๊ธฐ์„œ๋Š” ๋ณ€๊ฒฝํ•  ํ•„์š”๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค.
36
+
37
+ <table>
38
+ <tr>
39
+ <td width="50%">
40
+
41
+ ### ๐Ÿงต ๋„ค์ดํ‹ฐ๋ธŒ ์ง„ํ–‰ UI
42
+
43
+ worker๋Š” Claude Code / Codex / Antigravity / Grok์—์„œ ์ผ๋ฐ˜ subagent๋กœ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค. dispatch ์ˆ˜, ์‹คํ–‰ ์ค‘์ธ step, tool ํ˜ธ์ถœ, token ์‚ฌ์šฉ๋Ÿ‰์ด ๋ชจ๋‘ ํ˜ธ์ŠคํŠธ ์ž์ฒด task panel์— ํ‘œ์‹œ๋˜๋ฉฐ, claude-hud statusline segment๋„ ํฌํ•จ๋ฉ๋‹ˆ๋‹ค: `โš™dsh 1โ–ถpro 2m14s 21.7k/606 โœ“3`.
44
+
45
+ </td>
46
+ <td width="50%">
47
+
48
+ ### ๐ŸŽš๏ธ Tier ์ •์ฑ… ๋ฐ ์—์Šค์ปฌ๋ ˆ์ด์…˜
49
+
50
+ ๊ธฐ๊ณ„์ ์ธ ์ž‘์—…์—๋Š” `flash`, ์ถ”๋ก ์ด ํ•„์š”ํ•œ ์ž‘์—…์—๋Š” `pro`, `effort`๋Š” `off`๋ถ€ํ„ฐ `max`๊นŒ์ง€ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. `tier_policy`๋Š” tool ๊ณ„์ธต์—์„œ ๋ชจ๋“  dispatch๋ฅผ ๋‹จ์ผ tier๋กœ ๊ณ ์ •ํ•  ์ˆ˜ ์žˆ๊ณ , `escalate_on_failure`๋Š” ์‹คํŒจํ•œ flash ์‹คํ–‰์„ pro์—์„œ ํ•œ ๋ฒˆ ์žฌ์‹œ๋„ํ•ฉ๋‹ˆ๋‹ค โ€” ์‚ฌ์ „์— ๋‚œ์ด๋„๋ฅผ ์ถ”์ธกํ•˜๋Š” ๊ฒƒ์ด ์•„๋‹ˆ๋ผ ์‹ค์ œ ์ฆ๊ฑฐ์— ๊ธฐ๋ฐ˜ํ•ฉ๋‹ˆ๋‹ค.
51
+
52
+ </td>
53
+ </tr>
54
+ <tr>
55
+ <td width="50%">
56
+
57
+ ### ๐Ÿ›๏ธ ํ˜ธ์ŠคํŠธ ๋‚ด DSH ์„ธ์…˜
58
+
59
+ bundle์„ DSH profile์— ์„ค์น˜ํ•˜๋ฉด ๊ฐ worker๋Š” first-class DSH session์ด ๋ฉ๋‹ˆ๋‹ค. Web UI์— ํ‘œ์‹œ๋˜๊ณ , ์ž‘์—… ๋””๋ ‰ํ„ฐ๋ฆฌ๋ณ„๋กœ ๊ทธ๋ฃนํ™”๋˜๋ฉฐ, tier๋ณ„๋กœ ์„ ํƒํ•œ Agent preset์œผ๋กœ ๋งˆ์šดํŠธ๋ฉ๋‹ˆ๋‹ค. DSH๊ฐ€ ์‹คํ–‰ ์ค‘์ด ์•„๋‹ˆ๋ฉด standalone DSH runtime์œผ๋กœ ํด๋ฐฑํ•˜๋ฏ€๋กœ CI ๋ฐ headless ํ™˜๊ฒฝ์—์„œ๋„ ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค.
60
+
61
+ </td>
62
+ <td width="50%">
63
+
64
+ ### ๐Ÿ‘๏ธ ๋น„์ „ ๋ฐ ์ด๋ฏธ์ง€ ์ƒ์„ฑ
65
+
66
+ DSH์˜ model์€ text-only์ž…๋‹ˆ๋‹ค. `describe_image`๋Š” ์ด์ œ ํ‚ค๊ฐ€ ์žˆ์„ ๋•Œ๋งˆ๋‹ค DeepSeek ์ž์ฒด VL model(`deepseek-v4-flash-vision-exp`)์„ ๋จผ์ € ์‹œ๋„ํ•˜๊ณ , ๊ทธ๋‹ค์Œ ์ด๋ฏธ ๋ณด์œ ํ•œ CLI โ€” Claude, Codex, Grok, Antigravity โ€” ๋˜๋Š” ์„ค์ •ํ•œ OpenAI ํ˜ธํ™˜ API๋กœ ํด๋ฐฑํ•ฉ๋‹ˆ๋‹ค. `generate_image`๋Š” ๊ฐ™์€ CLI์˜ ๋ถ“์„ ๋นŒ๋ ค ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ๋ถ™์—ฌ๋„ฃ์€ image๋Š” ๋Œ€ํ™”์— ๊ณ„์† ํ‘œ์‹œ๋˜๊ณ  model์—๋Š” text๋กœ ์ „๋‹ฌ๋ฉ๋‹ˆ๋‹ค.
67
+
68
+ </td>
69
+ </tr>
70
+ <tr>
71
+ <td width="50%">
72
+
73
+ ### ๐Ÿ›ก๏ธ ๋””์ŠคํŒจ์น˜ ๊ฐ€๋“œ๋ ˆ์ผ
74
+
75
+ ๋ชจ๋“  dispatch๋Š” ๋ฌด์—‡์ด๋“  ์‹คํ–‰๋˜๊ธฐ ์ „์— ๊ฒ€์‚ฌ๋ฉ๋‹ˆ๋‹ค. workerโ†’worker ์ค‘์ฒฉ์€ origin-chain ๊นŠ์ด 3์œผ๋กœ ์ œํ•œ๋˜๊ณ  ์ˆœํ™˜์€ ๊ฑฐ๋ถ€๋ฉ๋‹ˆ๋‹ค. ๋‹ค๋ฅธ job์ด ์ด๋ฏธ ๋ณด์œ ํ•œ workspace์— ๋Œ€ํ•œ ๋‘ ๋ฒˆ์งธ worker๋Š” ๋ณด์œ ์ž ์ •๋ณด์™€ ํ•จ๊ป˜ ๊ฑฐ๋ถ€๋ฉ๋‹ˆ๋‹ค โ€” ์กฐ์šฉํžˆ ๋Œ€๊ธฐ์—ด์— ๋„ฃ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๊ฑฐ๋ถ€๋Š” ์ฝ์„ ์ˆ˜ ์žˆ๋Š” ์˜ค๋ฅ˜์ž…๋‹ˆ๋‹ค: ๊ธฐ๋‹ค๋ฆฌ๊ฑฐ๋‚˜ ๋ฒ”์œ„๋ฅผ ๋‹ค์‹œ ์žก์œผ์„ธ์š”. ์šฐํšŒํ•˜์ง€ ๋งˆ์„ธ์š”.
76
+
77
+ </td>
78
+ <td width="50%">
79
+
80
+ ### ๐Ÿ“‹ ์ž‘์—… ๋ณด๋“œ
81
+
82
+ DSH Crew ํŒจ๋„์€ ์ž‘์—… ๋ณด๋“œ ์—ญํ• ๋„ ํ•ฉ๋‹ˆ๋‹ค: ์‹คํ–‰ ์ค‘์ด๋“  ์™„๋ฃŒ๋๋“  ๋ชจ๋“  worker job์ด tier, effort, ์‹ค์‹œ๊ฐ„ ์ง„ํ–‰ ์ƒํ™ฉ, ํ† ํฐ๊ณผ ํ•จ๊ป˜ ๋‚˜์—ด๋˜๊ณ , ์ ์œ ๋œ workspace๋Š” ๋ณด์œ ์ž๋ฅผ ํ‘œ์‹œํ•˜๋ฉฐ, ์‹คํ–‰ ๋„์ค‘ ์‚ฌ๋ผ์ง„ job(์˜ˆ: hub ์žฌ์‹œ์ž‘)์€ ์กฐ์šฉํžˆ ์‚ฌ๋ผ์ง€๋Š” ๋Œ€์‹  orphan ghost๋กœ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.
83
+
84
+ </td>
85
+ </tr>
86
+ <tr>
87
+ <td width="50%">
88
+
89
+ ### ๐Ÿ”Œ ์‚ฌ์šฉ์ž ์ง€์ • provider
90
+
91
+ ์ž์ฒด endpoint(Base URL + API key + models)๋‚˜ ๋กœ์ปฌ command template์„ ๊ฐ€์ ธ์˜ฌ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ฐ provider์—๋Š” connectivity test๊ฐ€ ์žˆ์–ด reachability์™€ auth๋ฅผ ํ™•์ธํ•œ ํ›„ ์‹ค์ œ vision ํ˜ธ์ถœ์„ ํ•œ ๋ฒˆ ์ˆ˜ํ–‰ํ•˜๋ฏ€๋กœ, ์ž‘์—… ๋„์ค‘์ด ์•„๋‹ˆ๋ผ ์ง€๊ธˆ ๋ฌธ์ œ๋ฅผ ๋ฐœ๊ฒฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
92
+
93
+ </td>
94
+ <td width="50%">
95
+
96
+ ### ๐Ÿ“ฆ ์›ํด๋ฆญ ์„ค์น˜
97
+
98
+ ์„ค์ • ํŽ˜์ด์ง€์—์„œ Claude Code plugin, Codex role ํŒŒ์ผ, Antigravity / Grok agent, ์Šคํ‚ฌ, ๋ช…๋ น์„ ์„ค์น˜ํ•˜๊ณ  ์—…๋ฐ์ดํŠธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค โ€” marketplace ๋“ฑ๋ก, permission allowlist, HUD wiring, ์ด ๋จธ์‹ ์— ๋งž๊ฒŒ ์ƒ์„ฑ๋œ absolute path โ€” ๊ทธ๋ฆฌ๊ณ  ๋ณต์›๋„ ์‰ฝ๊ฒŒ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋ชจ๋“  ์„ค์ • ํŒŒ์ผ์€ ๋จผ์ € ๋ฐฑ์—…๋ฉ๋‹ˆ๋‹ค.
99
+
100
+ </td>
101
+ </tr>
102
+ </table>
103
+
104
+ ## ์ž‘๋™ ๋ฐฉ์‹
105
+
106
+ ```
107
+ Claude Code / Codex / Antigravity / Grok (orchestrator, keeps its own model)
108
+ โ””โ”€ ds-flash / ds-pro โ† native subagent shell (progress shows in the host's task UI)
109
+ โ””โ”€ MCP: dsh_run_worker(tier, effort, cwd, worker=)
110
+ โ”œโ”€ worker="agy"/"grok" โ†’ that external CLI runs the task (explicit opt-in)
111
+ โ”œโ”€ hub reachable โ†’ session inside DSH (visible in the Web UI, grouped by cwd)
112
+ โ””โ”€ otherwise โ†’ dsh-jsonrpc-agent runtime (worker.cordis.yml)
113
+ โ””โ”€ DeepSeek V4 Flash / Pro (DSH SDK, event stream โ†’ progress and token stats)
114
+ ```
115
+
116
+ ## ํ•œ ๋ฒˆ์˜ ์‹คํ–‰, ๋‘ ๊ฐœ์˜ ๊ด€์ 
117
+
118
+ ๋””์ŠคํŒจ์น˜๋Š” ๋„“๊ฒŒ ํŽผ์น  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์•„๋ž˜์—์„œ๋Š” 18๊ฐœ์˜ worker๊ฐ€ ์ด README๋ฅผ ๋ณ‘๋ ฌ๋กœ ๋ฒˆ์—ญํ•ฉ๋‹ˆ๋‹ค. ํ˜ธ์ŠคํŠธ๋Š” ์ด๋“ค์„ ์ž์‹ ์˜ ์„œ๋ธŒ์—์ด์ „ํŠธ๋กœ ์„ธ๊ณ , harness๋Š” ์‹ค์ œ ์„ธ์…˜์œผ๋กœ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
119
+
120
+ <p align="center">
121
+ <img src="./docs/images/dsh-crew-host.png" alt="Claude Code" width="100%" />
122
+ </p>
123
+ <p align="center"><sub>Claude Code์—์„œ dsh-crew worker๋Š” ๋„ค์ดํ‹ฐ๋ธŒ ์„œ๋ธŒ์—์ด์ „ํŠธ๋กœ ๋ณด์ž…๋‹ˆ๋‹ค. statusline ์„ธ๊ทธ๋จผํŠธ๊ฐ€ ์‹คํ–‰ ์ค‘์ธ tier, ๊ฒฝ๊ณผ ์‹œ๊ฐ„, ํ† ํฐ์„ ํ‘œ์‹œํ•ฉ๋‹ˆ๋‹ค.</sub></p>
124
+
125
+ <p align="center">
126
+ <img src="./docs/images/dsh-crew-jobs.png" alt="DSH Crew" width="100%" />
127
+ </p>
128
+ <p align="center"><sub>DSH Crew ํŒจ๋„์—์„œ ๋ณธ ๊ฐ™์€ ์‹คํ–‰: ๊ฐ ์ž‘์—…์„ ๋””์ŠคํŒจ์น˜ํ•œ ํ˜ธ์ŠคํŠธ, tier์™€ effort, ์‹ค์‹œ๊ฐ„ ์ง„ํ–‰ ์ƒํ™ฉ๊ณผ ํ† ํฐ ์‚ฌ์šฉ๋Ÿ‰.</sub></p>
129
+
130
+ <p align="center"><sub>ํŒจ๋„์€ ์ž‘์—… ๋ณด๋“œ์ด๊ธฐ๋„ ํ•ฉ๋‹ˆ๋‹ค: ์‹คํ–‰ ์ค‘์ด๊ฑฐ๋‚˜ ์™„๋ฃŒ๋œ job์ด tier, ์ง„ํ–‰ ์ƒํ™ฉ, ํ† ํฐ๊ณผ ํ•จ๊ป˜ ๊ณ„์† ๋‚˜์—ด๋˜๊ณ , ์ ์œ ๋œ workspace๋Š” ๋ณด์œ ์ž๋ฅผ ํ‘œ์‹œํ•˜๋ฉฐ, ์‹คํ–‰ ๋„์ค‘ ์‚ฌ๋ผ์ง„ job(hub ์žฌ์‹œ์ž‘)์€ ์กฐ์šฉํžˆ ์‚ฌ๋ผ์ง€๋Š” ๋Œ€์‹  orphan ghost๋กœ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.</sub></p>
131
+
132
+ ## ์„ค์น˜
133
+
134
+ npm์—์„œ DSH ํ”„๋กœํ•„๋กœ ์„ค์น˜:
135
+
136
+ ```bash
137
+ dsh plugin --profile web add @zoraxylia/dsh-codex-adapter@latest
138
+ dsh web
139
+ ```
140
+
141
+ ์†Œ์Šค ํŠธ๋ฆฌ์—์„œ ๋กœ์ปฌ ๊ฐœ๋ฐœํ•˜๋ ค๋ฉด:
142
+
143
+ ```bash
144
+ dsh plugin --profile web add link:/path/to/dsh-crew
145
+ dsh web
146
+ ```
147
+
148
+ `link:` ํ”„๋กœํ† ์ฝœ์€ ํ”„๋กœํ•„ ์˜์กด์„ฑ์„ ์ด ์ €์žฅ์†Œ๋กœ ์‹ฌ๋ณผ๋ฆญ ๋งํฌํ•˜๋ฏ€๋กœ ๋‹ค์‹œ ๋นŒ๋“œํ•˜๋ฉด ๋ฐ”๋กœ ๋ฐ˜์˜๋ฉ๋‹ˆ๋‹ค.
149
+
150
+ ### DeepSeek ์ž๊ฒฉ ์ฆ๋ช… ์„ค์ •(standalone ์ „์šฉ)
151
+
152
+ hub mode์—์„œ โ€” ์œ„ ์„ค์น˜ ๋ฐฉ์‹์—์„œ โ€” worker๋Š” DSH instance ๋‚ด๋ถ€์—์„œ ์‹คํ–‰๋˜๊ณ  ์ด๋ฏธ ์„ค์ •๋œ DSH์˜ DeepSeek ์ž๊ฒฉ ์ฆ๋ช…์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์ถ”๊ฐ€ ์„ค์ •์ด ํ•„์š”ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
153
+
154
+ standalone ํด๋ฐฑ๋งŒ ์ž์ฒด ํ‚ค๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. DSH instance๊ฐ€ ์‹คํ–‰ ์ค‘์ด ์•„๋‹Œ ํ˜ธ์ŠคํŠธ์—์„œ dispatchํ•˜๋ฉด worker runtime์ด ๋ณ„๋„ ํ”„๋กœ์„ธ์Šค๋กœ ์‹œ์ž‘๋ฉ๋‹ˆ๋‹ค. [platform.deepseek.com](https://platform.deepseek.com)์—์„œ API ํ‚ค๋ฅผ ๋ฐ›์•„ `~/.config/dsh-crew/.env`์— ์”๋‹ˆ๋‹ค:
155
+
156
+ ```
157
+ DEEPSEEK_API_KEY=sk-...
158
+ ```
159
+
160
+ ### ํ™•์ธ
161
+
162
+ ```bash
163
+ node scripts/smoke.mjs
164
+ ```
165
+
166
+ smoke ํ…Œ์ŠคํŠธ๋Š” ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๊ฒฝ๋กœ๋ฅผ ํ†ตํ•ด ์ €๋ ดํ•œ job์„ dispatchํ•ฉ๋‹ˆ๋‹ค โ€” DSH instance๊ฐ€ ์‹คํ–‰ ์ค‘์ด๋ฉด hub, ๊ทธ๋ ‡์ง€ ์•Š์œผ๋ฉด standalone โ€” ๊ทธ๋ฆฌ๊ณ  ์‚ฌ์šฉํ•œ ๊ฒฝ๋กœ๋ฅผ ์ถœ๋ ฅํ•ฉ๋‹ˆ๋‹ค. ์•ฝ ์‹ญ ์ดˆ ์•ˆ์— `smoke test passed โ€” configuration OK`๊ฐ€ ํ‘œ์‹œ๋˜์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์‹คํŒจํ•˜๋ฉด ํ…Œ์ŠคํŠธ๋œ ๊ฒฝ๋กœ์— ํ•œ์ •๋œ ์˜ค๋ฅ˜ ์ด์œ ๊ฐ€ ์ถœ๋ ฅ๋ฉ๋‹ˆ๋‹ค.
167
+
168
+ ๊ทธ๋‹ค์Œ ์„ค์ • โ†’ DSH Crew์—์„œ ํ˜ธ์ŠคํŠธ ํ†ตํ•ฉ(Claude Code, Codex, Antigravity, Grok)์„ ํ•œ ๋ฒˆ์— ์„ค์น˜ํ•˜๊ฑฐ๋‚˜, ๋ช…๋ น์ค„์—์„œ ๊ฐ™์€ installer๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค:
169
+
170
+ ```bash
171
+ node src/install/cli.mjs claude # Claude Code plugin: marketplace + permissions + HUD segment
172
+ node src/install/cli.mjs codex # Codex agents + prompts
173
+ node src/install/cli.mjs agy # Antigravity MCP config + agents + skills
174
+ node src/install/cli.mjs grok # Grok MCP config + agents + commands
175
+ node src/install/cli.mjs all # all four hosts at once
176
+ # uninstall symmetrically (uninstall-claude | uninstall-codex | uninstall-agy | uninstall-grok):
177
+ node src/install/cli.mjs uninstall-claude
178
+ ```
179
+
180
+ ## ๋ฐฐ๊ฒฝ ๋ฐ ์šฉ์–ด
181
+
182
+ - **DSH** (DeepSeek Harness): DeepSeek์˜ ์˜คํ”ˆ์†Œ์Šค agent harness๋กœ, Web UI ํ˜•ํƒœ์˜ code agent์ด๋ฉฐ Claude Code์™€ ๋น„์Šทํ•˜์ง€๋งŒ DeepSeek model์„ ๊ตฌ๋™ํ•ฉ๋‹ˆ๋‹ค.
183
+ - **MCP** (Model Context Protocol): Anthropic์˜ AI tool ํ†ตํ•ฉ ํ”„๋กœํ† ์ฝœ๋กœ, LLM์ด ์™ธ๋ถ€ tool๊ณผ data source๋ฅผ ์•ˆ์ „ํ•˜๊ฒŒ ํ˜ธ์ถœํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค.
184
+ - **Cordis bundle**: DSH์˜ plugin ํ˜•์‹์ž…๋‹ˆ๋‹ค. ์ด ํ”„๋กœ์ ํŠธ๋Š” standalone MCP service๋กœ ์‹คํ–‰ํ•˜๊ฑฐ๋‚˜ hub mode๋กœ DSH Web์— ์„ค์น˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
185
+ - **tier**: capability tier โ€” worker๊ฐ€ DSH์— ๊ตฌ์„ฑ๋œ model roster ์ค‘ ์–ด๋–ค slot์„ ๋ฐ›๋Š”์ง€๋ฅผ ๋‚˜ํƒ€๋ƒ…๋‹ˆ๋‹ค. `flash`๋Š” ๋น ๋ฅด๊ณ  ์ €๋ ดํ•˜๋ฉฐ(๋‹จ์ˆœ ์ž‘์—…), `pro`๋Š” ๋” ๊นŠ์ด ์ถ”๋ก ํ•ฉ๋‹ˆ๋‹ค(๋ณต์žกํ•œ ๋ฌธ์ œ). ํ˜„์žฌ๋Š” ๊ฐ๊ฐ DeepSeek V4 Flash์™€ V4 Pro์— ๋งคํ•‘๋ฉ๋‹ˆ๋‹ค. DSH์—์„œ model์„ ๊ต์ฒดํ•ด๋„ ์—ฌ๊ธฐ์„œ๋Š” ๋ณ€๊ฒฝํ•  ๊ฒƒ์ด ์—†์Šต๋‹ˆ๋‹ค.
186
+ - **worker**: ์ž‘์—…์„ ์ˆ˜ํ–‰ํ•˜๋Š” DSH agent โ€” ์ž์ฒด tools, sandbox, preset์„ ๊ฐ€์ง„ ์ „์ฒด session์ด๋ฉฐ, ๋‹จ์ˆœํ•œ model ํ˜ธ์ถœ์ด ์•„๋‹™๋‹ˆ๋‹ค.
187
+ - **effort**: ์ถ”๋ก  ๊ฐ•๋„. `off` = ์ถ”๋ก  ์—†์Œ, `high` = ๋†’์€ ์ถ”๋ก  ํˆฌ์ž, `max` = ์ตœ๋Œ€ ์ถ”๋ก  ํˆฌ์ž.
188
+
189
+ ## Claude Code
190
+
191
+ ### ์„ค์น˜
192
+
193
+ ์›ํด๋ฆญ ์„ค์น˜(ํ•˜๋‚˜๋ฅผ ์„ ํƒํ•˜์„ธ์š”):
194
+
195
+ - **DSH ์„ค์ • ํŽ˜์ด์ง€**(hub mode ์„ค์น˜ ์‹œ): ์„ค์ • โ†’ DSH Crew โ†’ "Install to Claude Code"
196
+ - **๋ช…๋ น์ค„**: `node src/install/cli.mjs all`
197
+
198
+ ๋‘˜ ๋‹ค ๋™์ผํ•œ ์ž‘์—…์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค: ๋กœ์ปฌ marketplace ๋“ฑ๋ก(์ƒ์œ„ ๋””๋ ‰ํ„ฐ๋ฆฌ `dsh-plugins/`๋ฅผ marketplace root๋กœ ์‚ฌ์šฉ) + `claude plugin install` + MCP tool permission allowlist + claude-hud worker status segment ์„ค์ •(๋ณ€๊ฒฝ ์ „ settings.json ์ž๋™ ๋ฐฑ์—…, ๋ฉฑ๋“ฑ). **๋ณ€๊ฒฝ ์‚ฌํ•ญ์„ ์ ์šฉํ•˜๋ ค๋ฉด ์„ค์น˜ ํ›„ ์„ธ์…˜์„ ๋‹ค์‹œ ์‹œ์ž‘ํ•˜์„ธ์š”.**
199
+
200
+ ### ์‚ฌ์šฉ๋ฒ•
201
+
202
+ - ๋Œ€ํ™”์—์„œ ์ง์ ‘ "dispatch X to ds-flash" ๋˜๋Š” "dispatch X to ds-pro"๋ผ๊ณ  ๋งํ•˜๋ฉด subagent๊ฐ€ ์ž‘์—…์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค
203
+ - dispatch ์ˆ˜์™€ ์‹ค์‹œ๊ฐ„ progress๊ฐ€ Claude Code task UI์— ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค
204
+ - **HUD status line segment**: `โš™dsh 1โ–ถpro 2m14s 21.7k/606 โœ“3` (ํ˜„์žฌ tier / ๊ฒฝ๊ณผ ์‹œ๊ฐ„ / token ์‚ฌ์šฉ๋Ÿ‰ / ์™„๋ฃŒ ์ˆ˜)
205
+ - ๋กœ์ปฌ ๊ฐœ๋ฐœ์—์„œ๋Š” `statusline/statusline.sh` ๋˜๋Š” `statusline/worker-segment.sh`๋ฅผ ๋…๋ฆฝ์ ์œผ๋กœ ํ†ตํ•ฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค
206
+ - **์žฅ๊ธฐ ์‹คํ–‰ ์ž‘์—…**: CC์—๋Š” MCP ํ˜ธ์ถœ์— ๋Œ€ํ•œ timeout ์ œํ•œ์ด ์žˆ์Šต๋‹ˆ๋‹ค(`MCP_TOOL_TIMEOUT`์œผ๋กœ ์กฐ์ • ๊ฐ€๋Šฅ). ๊ธด ์ž‘์—…์€ orchestrator๊ฐ€ `dsh_spawn_worker` + `dsh_worker_result(wait_seconds)` polling์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค
207
+ - **๋กœ์ปฌ ๊ฐœ๋ฐœ ๋ฐ ๋””๋ฒ„๊น…**: `claude --plugin-dir /path/to/dsh-crew`๋กœ ์ž„์‹œ ๋กœ๋“œํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค
208
+
209
+
210
+ ### ์„ธ์…˜ ๋ช…๋ น
211
+
212
+ ํ˜„์žฌ ์„ธ์…˜์—๋งŒ ์ „์—ญ ๊ธฐ๋ณธ๊ฐ’์„ ๋ฎ์–ด์“ฐ๋ฉฐ, ํ”„๋กฌํ”„ํŠธ๊ฐ€ ์•„๋‹ˆ๋ผ ๋„๊ตฌ ๊ณ„์ธต์—์„œ ๊ฐ•์ œ๋ฉ๋‹ˆ๋‹ค:
213
+
214
+ | ๋ช…๋ น | ๋™์ž‘ |
215
+ |---|---|
216
+ | `/dsh-crew:config` | ์ด ์„ธ์…˜์˜ ๊ธฐ๋ณธ๊ฐ’ ์กฐํšŒยท์„ค์ •: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<์ดˆ>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `origin_depth_limit=<1-32>`, `preset_flash/preset_pro=<preset id|default>`, `reset` |
217
+
218
+ | `/dsh-crew:on` ยท `/dsh-crew:off` | ์ด ์„ธ์…˜์˜ ๋””์ŠคํŒจ์น˜ ์ผœ๊ธฐยท๋„๊ธฐ (๋„๊ธฐ๋Š” ํ•˜๋“œ ์Šค์œ„์น˜๋กœ ๋„๊ตฌ๊ฐ€ ๊ฑฐ๋ถ€) |
219
+ | `/dsh-crew:status` | worker ์ž‘์—… ์‹ค์‹œ๊ฐ„ ์ƒํƒœ: tier, ์ง„ํ–‰, ํ† ํฐ, ํ˜„์žฌ ๋„๊ตฌ |
220
+ | `/dsh-crew:playbook` | ๋””์ŠคํŒจ์น˜ ๋ชจ๋ฒ” ์‚ฌ๋ก€: flash vs pro ์„ ํƒ, ์ž๊ธฐ ์™„๊ฒฐ์ ์ธ ๋ธŒ๋ฆฌํ”„, ๋ณ‘๋ ฌ ์ฒ˜๋ฆฌ, ๊ฒฐ๊ณผ ๊ฒ€์ฆ, ๊ฐ€๋“œ๋ ˆ์ผ |
221
+
222
+ ## Codex
223
+
224
+ ### ์„ค์น˜
225
+
226
+ installer ์‚ฌ์šฉ์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค(์ด ๋จธ์‹ ์— ๋งž๊ฒŒ path๋ฅผ ์ž๋™ ์ƒ์„ฑํ•˜๊ณ  `/dsh-config`, `/dsh-status`, `/dsh-playbook` ํ”„๋กฌํ”„ํŠธ๋ฅผ ๋ณต์‚ฌํ•ฉ๋‹ˆ๋‹ค):
227
+
228
+ ```bash
229
+ node src/install/cli.mjs codex
230
+ ```
231
+
232
+ ๋˜๋Š” ์ˆ˜๋™์œผ๋กœ ๋ณต์‚ฌ(๋ณต์‚ฌ ํ›„ path ์ˆ˜๋™ ์ˆ˜์ • ํ•„์š”):
233
+
234
+ ```bash
235
+ cp codex/agents/*.toml ~/.codex/agents/ # global or project-level .codex/agents/
236
+ ```
237
+
238
+ role ํŒŒ์ผ์—๋Š” ๋‹ค์Œ์ด ๊ธฐ๋ณธ ๊ตฌ์„ฑ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค:
239
+
240
+ - MCP server ๋งˆ์šดํŠธ ๊ตฌ์„ฑ
241
+ - `default_tools_approval_mode = "approve"` (**ํ•„์ˆ˜**, ๊ทธ๋ ‡์ง€ ์•Š์œผ๋ฉด exec mode์—์„œ tool ํ˜ธ์ถœ์ด ์ž๋™ ์ทจ์†Œ๋ฉ๋‹ˆ๋‹ค)
242
+ - `tool_timeout_sec = 3600`
243
+
244
+ **์ฐธ๊ณ **: ์ˆ˜๋™ ๋ณต์‚ฌ ์‹œ `args` ํ•„๋“œ์˜ absolute path๋ฅผ ์‹ค์ œ ์„ค์น˜ ์œ„์น˜์— ๋งž๊ฒŒ ์—…๋ฐ์ดํŠธํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. installer๋Š” ์ด๋ฅผ ์ž๋™์œผ๋กœ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.
245
+
246
+ ### ์‚ฌ์šฉ๋ฒ•
247
+
248
+ - ๋Œ€ํ™”ํ˜• TUI์—์„œ "spawn ds-pro to ..."๋ฅผ ์„ ํƒํ•˜์—ฌ ์ž‘์—…์„ dispatchํ•ฉ๋‹ˆ๋‹ค. Active/Done panel์— progress๊ฐ€ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค
249
+ - `codex exec` mode์—์„œ๋„ `dsh_run_worker`๋ฅผ ์ง์ ‘ ํ˜ธ์ถœํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค
250
+
251
+
252
+ ### ์„ธ์…˜ ๋ช…๋ น
253
+
254
+ Codex์—๋Š” ์„ธ ๊ฐœ์˜ ํ”„๋กฌํ”„ํŠธ๊ฐ€ ์„ค์น˜๋ฉ๋‹ˆ๋‹ค:
255
+
256
+ | ๋ช…๋ น | ๋™์ž‘ |
257
+ |---|---|
258
+ | `/dsh-config` | ์ด ์„ธ์…˜์˜ ๊ธฐ๋ณธ๊ฐ’ ์กฐํšŒยท์„ค์ •: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<์ดˆ>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `origin_depth_limit=<1-32>`, `preset_flash/preset_pro=<preset id|default>`, `reset` |
259
+
260
+ | `/dsh-status` | worker ์ž‘์—… ์‹ค์‹œ๊ฐ„ ์ƒํƒœ: tier, ์ง„ํ–‰, ํ† ํฐ, ํ˜„์žฌ ๋„๊ตฌ |
261
+ | `/dsh-playbook` | ๋””์ŠคํŒจ์น˜ ๋ชจ๋ฒ” ์‚ฌ๋ก€: flash vs pro ์„ ํƒ, ์ž๊ธฐ ์™„๊ฒฐ์ ์ธ ๋ธŒ๋ฆฌํ”„, ๋ณ‘๋ ฌ ์ฒ˜๋ฆฌ, ๊ฒฐ๊ณผ ๊ฒ€์ฆ, ๊ฐ€๋“œ๋ ˆ์ผ |
262
+
263
+ ## Antigravity (agy)
264
+
265
+ ### ์„ค์น˜
266
+
267
+ ```bash
268
+ node src/install/cli.mjs agy
269
+ ```
270
+
271
+ dsh-crew MCP server๋ฅผ `~/.gemini/config/mcp_config.json`์— ๋“ฑ๋กํ•˜๊ณ  `ds-flash` / `ds-pro` agent์™€ `dsh-config`, `dsh-status`, `dsh-playbook` ์Šคํ‚ฌ์„ `~/.gemini/config/`์— ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค(๋ชจ๋“  ํŒŒ์ผ์€ ๋จผ์ € ๋ฐฑ์—…๋จ). ์„ค์น˜ ํ›„ ์„ธ์…˜์„ ๋‹ค์‹œ ์‹œ์ž‘ํ•˜์„ธ์š”.
272
+
273
+ ### ์‚ฌ์šฉ๋ฒ•
274
+
275
+ - ์ž‘์—…์„ dispatchํ•  agent๋กœ `ds-flash` ๋˜๋Š” `ds-pro`๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค
276
+ - `dsh_worker_config`๊ฐ€ ์„ธ์…˜ ๊ธฐ๋ณธ๊ฐ’์„ ์ฝ๊ฑฐ๋‚˜ ๋ฎ์–ด์”๋‹ˆ๋‹ค
277
+
278
+ ### ์„ธ์…˜ ์Šคํ‚ฌ
279
+
280
+ | ์Šคํ‚ฌ | ๋™์ž‘ |
281
+ |---|---|
282
+ | `/dsh-config` | ์ด ์„ธ์…˜์˜ ๊ธฐ๋ณธ๊ฐ’ ์กฐํšŒยท์„ค์ •(tier / effort / mode / timeout / policy / escalation / reset) |
283
+ | `/dsh-status` | worker ์ž‘์—… ์‹ค์‹œ๊ฐ„ ์ƒํƒœ: tier, ์ง„ํ–‰, ํ† ํฐ, ํ˜„์žฌ ๋„๊ตฌ |
284
+ | `/dsh-playbook` | ๋””์ŠคํŒจ์น˜ ๋ชจ๋ฒ” ์‚ฌ๋ก€: flash vs pro ์„ ํƒ, ์ž๊ธฐ ์™„๊ฒฐ์ ์ธ ๋ธŒ๋ฆฌํ”„, ๋ณ‘๋ ฌ ์ฒ˜๋ฆฌ, ๊ฒฐ๊ณผ ๊ฒ€์ฆ, ๊ฐ€๋“œ๋ ˆ์ผ |
285
+
286
+ ### ์ฃผ์˜ ์‚ฌํ•ญ
287
+
288
+ - agy๋Š” worker๋ฅผ **์ „์ฒด ์Šน์ธ**(full approval)์œผ๋กœ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค(`--dangerously-skip-permissions` + accept-edits): agy 1.1.16์—๋Š” workspace-scoped permission mode๊ฐ€ ์—†์œผ๋ฏ€๋กœ headless worker๊ฐ€ tool ์š”์ฒญ์„ ์ž๋™ ์Šน์ธํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
289
+
290
+ ์ œ๊ฑฐ: `node src/install/cli.mjs uninstall-agy`
291
+
292
+ ## Grok
293
+
294
+ ### ์„ค์น˜
295
+
296
+ ```bash
297
+ node src/install/cli.mjs grok
298
+ ```
299
+
300
+ `[mcp_servers.dsh-crew]` ์„น์…˜์„ `~/.grok/config.toml`์— ์“ฐ๊ณ  `ds-flash` / `ds-pro` agent์™€ `/dsh-config`, `/dsh-status`, `/dsh-playbook` ๋ช…๋ น์„ `~/.grok/`์— ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค(๋ชจ๋“  ํŒŒ์ผ์€ ๋จผ์ € ๋ฐฑ์—…๋จ).
301
+
302
+ ### ์‚ฌ์šฉ๋ฒ•
303
+
304
+ - ์ž‘์—…์„ dispatchํ•  agent๋กœ `ds-flash` ๋˜๋Š” `ds-pro`๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค
305
+
306
+ ### ์„ธ์…˜ ๋ช…๋ น
307
+
308
+ | ๋ช…๋ น | ๋™์ž‘ |
309
+ |---|---|
310
+ | `/dsh-config` | ์ด ์„ธ์…˜์˜ ๊ธฐ๋ณธ๊ฐ’ ์กฐํšŒยท์„ค์ •(tier / effort / mode / timeout / policy / escalation / reset) |
311
+ | `/dsh-status` | worker ์ž‘์—… ์‹ค์‹œ๊ฐ„ ์ƒํƒœ: tier, ์ง„ํ–‰, ํ† ํฐ, ํ˜„์žฌ ๋„๊ตฌ |
312
+ | `/dsh-playbook` | ๋””์ŠคํŒจ์น˜ ๋ชจ๋ฒ” ์‚ฌ๋ก€: flash vs pro ์„ ํƒ, ์ž๊ธฐ ์™„๊ฒฐ์ ์ธ ๋ธŒ๋ฆฌํ”„, ๋ณ‘๋ ฌ ์ฒ˜๋ฆฌ, ๊ฒฐ๊ณผ ๊ฒ€์ฆ, ๊ฐ€๋“œ๋ ˆ์ผ |
313
+
314
+ ### ์ฃผ์˜ ์‚ฌํ•ญ
315
+
316
+ - ๋ณด์•ˆ ์„ค๊ณ„์ƒ grok์€ ์‹ ๋ขฐํ•  ์ˆ˜ ์—†๋Š” ํ”„๋กœ์ ํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ repo-level MCP server๋ฅผ ์‹œ์ž‘ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค(`grok mcp doctor`๊ฐ€ "folder untrusted"๋กœ ๋ณด๊ณ ). global ์„ค์น˜๋Š” ์˜ํ–ฅ๋ฐ›์ง€ ์•Š์Šต๋‹ˆ๋‹ค โ€” ๋””๋ ‰ํ„ฐ๋ฆฌ๋ฅผ ๋ฐ”๊พธ๊ฑฐ๋‚˜ `--trust`๋ฅผ ์ „๋‹ฌํ•˜์„ธ์š”.
317
+ - grok worker๋Š” `bypassPermissions`๋กœ ์‹คํ–‰๋ฉ๋‹ˆ๋‹ค(ํ•ญ์ƒ ์Šน์ธ โ€” grok ๋ฌธ์„œ๊ฐ€ headless ์ž๋™ํ™”์— ๊ถŒ์žฅํ•˜๋Š” ๋ฐฉ์‹). deny ๊ทœ์น™๊ณผ hook์€ ๊ณ„์† ์ ์šฉ๋ฉ๋‹ˆ๋‹ค.
318
+
319
+ ์ œ๊ฑฐ: `node src/install/cli.mjs uninstall-grok`
320
+
321
+ ## MCP ๋„๊ตฌ
322
+
323
+ | ๋„๊ตฌ | ์„ค๋ช… |
324
+ |---|---|
325
+ | `dsh_run_worker` | ๋ธ”๋กœํ‚น ์ž‘์—… dispatch(`tier`: flash/pro, `effort`: off/high/max, `cwd`, `worker`), ๊ฒฐ๊ณผ๋ฅผ ๊ธฐ๋‹ค๋ฆฝ๋‹ˆ๋‹ค |
326
+ | `dsh_spawn_worker` | ๋น„๋™๊ธฐ dispatch, job id ๋ฐ˜ํ™˜(๋ณ‘๋ ฌ fan-out์šฉ); ๊ฒฐ๊ณผ๋Š” `dsh_worker_result`๋กœ ์ˆ˜์ง‘ |
327
+ | `dsh_worker_status` | ๋ชจ๋“  job์˜ ์‹ค์‹œ๊ฐ„ progress ์กฐํšŒ(turn/step/ํ˜„์žฌ tool/token) + cwd advisory lock |
328
+ | `dsh_worker_result` | ๊ฒฐ๊ณผ ๊ฐ€์ ธ์˜ค๊ธฐ, `wait_seconds` ์ง€์ • ๊ฐ€๋Šฅ |
329
+ | `dsh_worker_cancel` | ์ง€์ •ํ•œ job ์ทจ์†Œ ๋ฐ ํ•ด๋‹น runtime process ์ข…๋ฃŒ |
330
+ | `dsh_worker_config` | ์„ธ์…˜ ๊ธฐ๋ณธ๊ฐ’(tier, effort, mode, timeout, policy, escalation) ์กฐํšŒยท์„ค์ • ๋ฐ `worker_profiles` ๋‚˜์—ด |
331
+
332
+ progress๋Š” ๋™์‹œ์— `~/.config/dsh-crew/status.d/`์— ๋ฏธ๋Ÿฌ๋ง๋ฉ๋‹ˆ๋‹ค(writer๋งˆ๋‹ค shard file ํ•˜๋‚˜, statusline / ์™ธ๋ถ€ ๋ชจ๋‹ˆํ„ฐ๋ง์—์„œ ์ฝ์„ ์ˆ˜ ์žˆ์Œ).
333
+
334
+ ## ๋””์ŠคํŒจ์น˜ ๊ฐ€๋“œ๋ ˆ์ผ
335
+
336
+ ๋ชจ๋“  dispatch๋Š” ๋ฌด์—‡์ด๋“  ์‹คํ–‰๋˜๊ธฐ ์ „์— ๊ฒ€์‚ฌ๋ฉ๋‹ˆ๋‹ค โ€” ๊ฑฐ๋ถ€๋Š” ์ฝ์„ ์ˆ˜ ์žˆ๋Š” ์˜ค๋ฅ˜์ด๋ฉฐ ๊ฒฐ์ฝ” ์กฐ์šฉํ•œ ๋Œ€๊ธฐ์—ด์ด ์•„๋‹™๋‹ˆ๋‹ค:
337
+
338
+ - **Origin chain**: ๊ฐ dispatch๋Š” workerโ†’worker origin chain์— hop์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค. ์ œํ•œ(`origin_depth_limit`, ๊ธฐ๋ณธ๊ฐ’ 3)๋ณด๋‹ค ๊นŠ์€ ์ค‘์ฒฉ์€ ๊ฑฐ๋ถ€๋˜๊ณ , ์ˆœํ™˜(๊ฐ™์€ backend + cwd๊ฐ€ ๋‘ ๋ฒˆ ๋‚˜ํƒ€๋‚จ)๋„ ๊ฑฐ๋ถ€๋ฉ๋‹ˆ๋‹ค โ€” ์žฌ๊ท€์  worker ์ž๊ธฐ ์ฆํญ์„ ๋ง‰๋Š” ๊ฐ€๋“œ์ž…๋‹ˆ๋‹ค.
339
+ - **cwd advisory lock**: workspace๋‹น ์‹คํ–‰ ์ค‘์ธ worker ํ•˜๋‚˜. ์ ์œ ๋œ workspace์— ๋Œ€ํ•œ ๋‘ ๋ฒˆ์งธ dispatch๋Š” ๋ณด์œ ์ž์˜ job id, backend, ์‹œ์ž‘ ์‹œ๊ฐ„๊ณผ ํ•จ๊ป˜ ๊ฑฐ๋ถ€๋ฉ๋‹ˆ๋‹ค โ€” ๋๋‚  ๋•Œ๊นŒ์ง€ ๊ธฐ๋‹ค๋ฆฌ๊ฑฐ๋‚˜, `dsh_worker_cancel`๋กœ ์ทจ์†Œํ•˜๊ฑฐ๋‚˜, `allow_concurrent_cwd: true`๋ฅผ ์ „๋‹ฌํ•˜์„ธ์š”(์ฝ๊ธฐ ์ „์šฉ ์ž‘์—…์—๋งŒ).
340
+
341
+ ## ๋””์ŠคํŒจ์น˜ ํ”Œ๋ ˆ์ด๋ถ
342
+
343
+ dispatch๋ฅผ *์ž˜* ํ•˜๋Š” ๋ฐฉ๋ฒ• โ€” flash vs pro ์„ ํƒ, ์ž๊ธฐ ์™„๊ฒฐ์ ์ธ ๋ธŒ๋ฆฌํ”„, ์•ˆ์ „ํ•œ ๋ณ‘๋ ฌ ์ฒ˜๋ฆฌ, ๊ฒฐ๊ณผ ๊ฒ€์ฆ, ์œ„์˜ ๊ฐ€๋“œ๋ ˆ์ผ โ€” ์ด ํ˜ธ์ŠคํŠธ๋ณ„ ํ”Œ๋ ˆ์ด๋ถ์œผ๋กœ ๋ฒˆ๋“ค๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค: `/dsh-crew:playbook` (Claude Code ์Šคํ‚ฌ), `/dsh-playbook` (Codex ํ”„๋กฌํ”„ํŠธ, Antigravity ์Šคํ‚ฌ, Grok ๋ช…๋ น).
344
+
345
+ ## ๋ช…์‹œ์  CLI ๋ฐฑ์—”๋“œ
346
+
347
+ `worker="agy"` / `worker="grok"`๋Š” dispatch๋ฅผ DSH tier ๋กœ์ง ๋Œ€์‹  ํ•ด๋‹น ์™ธ๋ถ€ CLI(backend ร— model ร— effort)์— ๊ณ ์ •ํ•ฉ๋‹ˆ๋‹ค. ๋ช…์‹œ์  opt-in์ž…๋‹ˆ๋‹ค โ€” ๊ธฐ๋ณธ๊ฐ’์ด ์—†์œผ๋ฏ€๋กœ ์‚ฌ์šฉ์ž๊ฐ€ ํ•ด๋‹น CLI๋ฅผ ์š”์ฒญํ•  ๋•Œ๋งŒ ์„ค์ •ํ•˜์„ธ์š”. ์ฃผ์˜ ์‚ฌํ•ญ: grok์€ ์‹ ๋ขฐํ•  ์ˆ˜ ์—†๋Š” ํด๋”์—์„œ repo-local MCP server ์‹œ์ž‘์„ ๊ฑฐ๋ถ€ํ•˜๊ณ , agy๋Š” worker๋ฅผ ์ „์ฒด ์Šน์ธ์œผ๋กœ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค(workspace-scoped permission mode ์—†์Œ).
348
+
349
+ ## ๋ฉ€ํ‹ฐ๋ชจ๋‹ฌ: ๋น„์ „ ๋ฐ ์ด๋ฏธ์ง€ ์ƒ์„ฑ
350
+
351
+ **DeepSeek๋Š” text-only model**์ด๋ฉฐ image ์ž…๋ ฅ์ด๋‚˜ ์ƒ์„ฑ์„ ์ง€์›ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์ด plugin์€ MCP tool์„ ํ†ตํ•ด ์ด๋Ÿฌํ•œ ๊ธฐ๋Šฅ์„ ์™ธ๋ถ€์—์„œ ์ œ๊ณต๋ฐ›์Šต๋‹ˆ๋‹ค:
352
+
353
+ **๋„ค์ดํ‹ฐ๋ธŒ ๋น„์ „ ์šฐ์„ **: vision provider๊ฐ€ ๋‚ด์žฅ CLI(๋˜๋Š” ๋ช…์‹œ์ ์œผ๋กœ `native`)์ผ ๋•Œ `describe_image`๋Š” ๋จผ์ € DeepSeek ์ž์ฒด VL model `deepseek-v4-flash-vision-exp`๋ฅผ ์‹œ๋„ํ•ฉ๋‹ˆ๋‹ค(์ง์ ‘ API ํ˜ธ์ถœ; ํ‚ค๋Š” `DEEPSEEK_API_KEY` ๋˜๋Š” `~/.config/dsh-crew/.env`์—์„œ). ์‹คํŒจํ•˜๋ฉด ์•„๋ž˜ CLI provider ์ฒด์ธ์œผ๋กœ ์šฐ์•„ํ•˜๊ฒŒ ์ €ํ•˜๋˜๋ฉฐ, ์ด ์ฒด์ธ์€ ํด๋ฐฑ์œผ๋กœ ์œ ์ง€๋ฉ๋‹ˆ๋‹ค. ์ด๋ฏธ์ง€ ์ƒ์„ฑ์€ ์˜ํ–ฅ๋ฐ›์ง€ ์•Š์Šต๋‹ˆ๋‹ค โ€” ๋„ค์ดํ‹ฐ๋ธŒ model์€ ์‚ฌ์ง„๋งŒ ๋ณผ ๋ฟ์ž…๋‹ˆ๋‹ค.
354
+
355
+ | ๋„๊ตฌ | ์„ค๋ช… |
356
+ |---|---|
357
+ | `describe_image` | ์ด๋ฏธ์ง€(์Šคํฌ๋ฆฐ์ƒท, ๋””์ž์ธ, ์ฐจํŠธ ๋“ฑ)๋ฅผ ๋ณด๊ณ  ์งˆ๋ฌธ์— ๋‹ตํ•ฉ๋‹ˆ๋‹ค. ๊ฒฐ๊ณผ๋Š” provider + model + image + question๋ณ„๋กœ ์บ์‹œ๋ฉ๋‹ˆ๋‹ค |
358
+ | `generate_image` | ํ…์ŠคํŠธ ์„ค๋ช…์—์„œ ์ด๋ฏธ์ง€๋ฅผ ์ƒ์„ฑํ•˜๊ณ  ์ง€์ •๋œ absolute path์— ์ €์žฅํ•ฉ๋‹ˆ๋‹ค. ์ถœ๋ ฅ์€ flat bitmap์ž…๋‹ˆ๋‹ค(๋ ˆ์ด์–ด ํŽธ์ง‘์—๋Š” OpenPencil ํ•„์š”) |
359
+
360
+ **์„ธ์…˜ ์ด๋ฏธ์ง€ ๋ถ™์—ฌ๋„ฃ๊ธฐ**: DSH์—์„œ model์„ `DeepSeek (vision) โ—‰`๋กœ ์ „ํ™˜ํ•˜๋ฉด ์ด๋ฏธ์ง€๋ฅผ ์ง์ ‘ ๋ถ™์—ฌ๋„ฃ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด๋ฏธ์ง€๋Š” session์— ๋‚จ์•„ ์ •์ƒ์ ์œผ๋กœ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค. plugin์€ ์ด๋ฏธ์ง€ ๋’ค์— ์ „์‚ฌ๋œ ํ…์ŠคํŠธ๋ฅผ ์ถ”๊ฐ€ํ•˜๊ณ  ์ „์†ก ์ „์— ์ด๋ฏธ์ง€๋ฅผ ์ œ๊ฑฐํ•ฉ๋‹ˆ๋‹ค โ€” ์‚ฌ์šฉ์ž๋Š” ์ด๋ฏธ์ง€๋ฅผ ๋ณด๊ณ , model์€ ํ…์ŠคํŠธ๋ฅผ ์ฝ์Šต๋‹ˆ๋‹ค. ์ „์‚ฌ๋Š” ๋™์ผํ•œ ๋„ค์ดํ‹ฐ๋ธŒ ์šฐ์„  ์‚ฌ๋‹ค๋ฆฌ๋ฅผ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค: ํ‚ค๊ฐ€ ์žˆ์„ ๋•Œ๋Š” DeepSeek์˜ VL model, ๊ทธ๋‹ค์Œ์—๋Š” ์„ค์ •ํ•œ CLI provider.
361
+
362
+ ### ๊ตฌ์„ฑ
363
+
364
+ **DSH ์„ค์ • ํŽ˜์ด์ง€ โ†’ DSH Crew โ†’ Multimodal**(๋˜๋Š” `~/.config/dsh-crew/config.json` ์ง์ ‘ ํŽธ์ง‘):
365
+
366
+ **Vision provider**(์ด๋ฏธ์ง€ ๋ณด๊ธฐ):
367
+
368
+ - `native` / `deepseek-native` (DeepSeek ์ž์ฒด VL model โ€” ๋ชจ๋“  ๋‚ด์žฅ provider์—์„œ ํ‚ค๊ฐ€ ์žˆ์„ ๋•Œ๋งˆ๋‹ค ์ž๋™์œผ๋กœ ๋จผ์ € ์‹œ๋„๋จ)
369
+ - `claude-code` (๊ธฐ๋ณธ๊ฐ’, haiku ์‚ฌ์šฉ, ์ €๋น„์šฉ)
370
+ - `codex` (GPT ์‚ฌ์šฉ, ํŠน์ • model ์ง€์ • ๊ฐ€๋Šฅ)
371
+ - `grok` (Grok ์‚ฌ์šฉ)
372
+ - `agy` (Antigravity)
373
+ - `custom` (OpenAI ํ˜ธํ™˜ API ๋˜๋Š” ๋กœ์ปฌ ๋ช…๋ น)
374
+ - `off` (๋น„ํ™œ์„ฑํ™”)
375
+
376
+ **Image generation provider**(์ด๋ฏธ์ง€ ์ƒ์„ฑ):
377
+
378
+ - `codex` (`$imagegen`, gpt-image-2)
379
+ - `agy` (Nano Banana)
380
+ - `grok` (Imagine)
381
+ - `custom` (OpenAI ํ˜ธํ™˜ API ๋˜๋Š” ๋กœ์ปฌ ๋ช…๋ น)
382
+ - `off` (๋น„ํ™œ์„ฑํ™”)
383
+
384
+ ### ์‚ฌ์šฉ์ž ์ง€์ • provider
385
+
386
+ ๋‘ ๊ฐ€์ง€ ํ†ตํ•ฉ ๋ฐฉ๋ฒ•์ด ์žˆ์Šต๋‹ˆ๋‹ค:
387
+
388
+ **API**: ๋ชจ๋“  OpenAI ํ˜ธํ™˜ endpoint
389
+ - Base URL, API Key, model list ์ž…๋ ฅ
390
+ - Vision์€ ์ธ๋ผ์ธ base64 ์ด๋ฏธ์ง€์™€ ํ•จ๊ป˜ `/chat/completions`๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค
391
+ - Image generation์€ `/images/generations`๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค
392
+ - ์ƒ์„ฑ ๊ธฐ๋Šฅ์„ ์‚ฌ์šฉํ•˜๋ ค๋ฉด **"image generation model"์„ ๋ฐ˜๋“œ์‹œ ์ง€์ •ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค**. ๊ทธ๋ ‡์ง€ ์•Š์œผ๋ฉด provider๋Š” vision ์„ ํƒ ํ•ญ๋ชฉ์—๋งŒ ๋‚˜ํƒ€๋‚ฉ๋‹ˆ๋‹ค
393
+
394
+ **CLI**: ๋กœ์ปฌ command template. placeholder๋Š” ์•ˆ์ „ํ•œ ์ฐธ์กฐ๋กœ ๋Œ€์ฒด๋ฉ๋‹ˆ๋‹ค
395
+ - Vision: `{image} {question} {model}` โ†’ stdout์ด ๋‹ต๋ณ€์ด ๋ฉ๋‹ˆ๋‹ค
396
+ - Image generation: `{prompt} {output} {size}` โ†’ ๋ช…๋ น์ด `{output}`์— ํŒŒ์ผ์„ ์จ์•ผ ํ•ฉ๋‹ˆ๋‹ค
397
+ - ์ตœ์†Œํ•œ ํ•˜๋‚˜์˜ command๋ฅผ ์ž…๋ ฅํ•˜์„ธ์š”. ์ž…๋ ฅ๋œ command์— ๋”ฐ๋ผ capability๊ฐ€ ๊ฒฐ์ •๋ฉ๋‹ˆ๋‹ค
398
+
399
+ **Connectivity test**: ๊ฐ custom provider์—๋Š” ํ…Œ์ŠคํŠธ ๋ฒ„ํŠผ์ด ์žˆ์Šต๋‹ˆ๋‹ค
400
+ - API: endpoint reachability์™€ auth๋ฅผ ํ™•์ธํ•˜๊ณ  ์‹ค์ œ vision ์š”์ฒญ์„ ๋ณด๋‚ด ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค
401
+ - CLI: ์‹คํ–‰ ํŒŒ์ผ์„ ํ™•์ธํ•˜๊ณ  ์‹ค์ œ ๋ช…๋ น์„ ์‹คํ–‰ํ•ด ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค
402
+ - Image generation: ๊ตฌ์„ฑ๋งŒ ๊ฒ€์ฆํ•˜๊ณ  ์‹ค์ œ ์ด๋ฏธ์ง€๋ฅผ ์ถœ๋ ฅํ•˜์ง€๋Š” ์•Š์Šต๋‹ˆ๋‹ค
403
+
404
+ **๋นŒ๋ ค ์“ฐ๋Š” subscription CLI**(claude / codex / grok / agy)๋Š” ๋กœ์ปฌ์— ๋กœ๊ทธ์ธ๋˜์–ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. plugin์ด ํ•ด๋‹น ๊ถŒํ•œ์„ ๋Œ€์‹  ์šฐํšŒํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
405
+
406
+ ## Hub ๋ชจ๋“œ
407
+
408
+ ์ด ํŒจํ‚ค์ง€๋Š” ์œ ํšจํ•œ DSH bundle(`dsh.bundle` + `cordis.patch.yml`)์ด๊ธฐ๋„ ํ•ฉ๋‹ˆ๋‹ค. `dsh plugin add dsh-crew`๋กœ DSH Web profile์— ์„ค์น˜ํ•˜๋ฉด:
409
+
410
+ - **Worker session์ด first-class citizen์ด ๋ฉ๋‹ˆ๋‹ค**: DSH host์—์„œ first-class session์œผ๋กœ ์‹คํ–‰๋˜๊ณ (`agents.create` + session๋ณ„ model/effort waterfall + ๊ธฐ๋ณธ preset), Web UI session ๋ชฉ๋ก์— ํ‘œ์‹œ๋˜๋ฉฐ, ์–ธ์ œ๋“  ์—ด์–ด ์ „์ฒด ์‹คํ–‰์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค
411
+ - **์ž‘์—… ๋””๋ ‰ํ„ฐ๋ฆฌ๋ณ„ ๊ตฌ์„ฑ**: Web UI์—์„œ worker session์„ cwd๋ณ„๋กœ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค
412
+ - **Loopback API**:
413
+ - `POST/GET /_dsh/dsh-crew/jobs`: ์ž‘์—… ์ƒ์„ฑ, ๋ชฉ๋ก, long-poll ๊ฒฐ๊ณผ, ์ทจ์†Œ
414
+ - `GET /_dsh/dsh-crew/ping`: health check(MCP shim์ด hub ์‹คํ–‰ ์—ฌ๋ถ€๋ฅผ ๊ฐ์ง€ํ•˜๋Š” ๋ฐ ์‚ฌ์šฉ)
415
+ - `POST /_dsh/dsh-crew/install`: ํ˜ธ์ŠคํŠธ ํ†ตํ•ฉ ์›ํด๋ฆญ ์„ค์น˜ โ€” Claude Code / Codex / Antigravity / Grok(`src/install/`์˜ backend)
416
+ - **์ž๋™ ๊ฐ์ง€**: ํ˜ธ์ŠคํŠธ๋“ค์˜ MCP shim์ด hub๋ฅผ ์ž๋™ ๊ฐ์ง€ํ•ฉ๋‹ˆ๋‹ค(`DSHPLUGIN_CREW_HUB` ํ™˜๊ฒฝ ๋ณ€์ˆ˜, ๊ธฐ๋ณธ๊ฐ’ `http://127.0.0.1:3080`)
417
+ - DSH Web ์‹คํ–‰ ์ค‘ โ†’ job์ด hub mode๋กœ ์‹คํ–‰๋ฉ๋‹ˆ๋‹ค(`mode: "hub"`)
418
+ - ์‹คํ–‰ ์ค‘์ด ์•„๋‹˜ โ†’ standalone runtime์œผ๋กœ ํด๋ฐฑํ•ฉ๋‹ˆ๋‹ค
419
+
420
+ **Windows ํ”„๋กœ์„ธ์Šค ์กฐํšŒ:** ํ˜ธ์ถœ ์ถœ์ฒ˜ ์‹๋ณ„๊ณผ ๊ฒ€์ฆ๋œ ๋‹จ์ผ ํ”„๋กœ์„ธ์Šค ์ข…๋ฃŒ์—๋Š” PowerShell/CIM์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ๊ณ ๋ฆฝ ํ”„๋กœ์„ธ์Šค API๋Š” ํ”„๋กœ์„ธ์Šค ๊ทธ๋ฃน ์ข…๋ฃŒ๋ฅผ `unsupported-platform`์œผ๋กœ ๊ฑฐ๋ถ€ํ•˜๋ฉฐ ์‹ ํ˜ธ๋ฅผ ๋ณด๋‚ด์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
421
+
422
+ ## ์†”๋ฃจ์…˜ ์„ ํƒ ๋ฐ ์ œํ•œ ์‚ฌํ•ญ
423
+
424
+ ### ์ผ๋ฐ˜ ๊ตฌ๋…์ž โ†’ shell subagent ๋ฐฉ์‹(๊ถŒ์žฅ)
425
+
426
+ - **ํ˜„์žฌ ์ƒํƒœ**: Claude Code subagent shell์€ ์ค‘๊ฐ„ ๋งค๊ฐœ์ฒด๋กœ haiku๋ฅผ ์‚ฌ์šฉํ•˜๋ฏ€๋กœ dispatch๋งˆ๋‹ค ์ˆ˜๋ฐฑ~์ˆ˜์ฒœ token์ด ์ถ”๊ฐ€๋ฉ๋‹ˆ๋‹ค
427
+ - **ํŠธ๋ ˆ์ด๋“œ์˜คํ”„**: ์†Œ๋Ÿ‰์˜ Anthropic token์„ ์‚ฌ์šฉํ•˜๋Š” ๋Œ€์‹  native task UI, ์‹ค์‹œ๊ฐ„ progress ํ‘œ์‹œ, ์ถ”๊ฐ€ ๊ตฌ์„ฑ ๋ถˆํ•„์š”๋ผ๋Š” ์ด์ ์„ ์–ป์Šต๋‹ˆ๋‹ค
428
+ - **๊ถŒ์žฅ**: ์ด๋ฏธ Claude Pro๋ฅผ ๊ตฌ๋… ์ค‘์ด๊ฑฐ๋‚˜ Claude Code๋ฅผ ์‚ฌ์šฉํ•œ๋‹ค๋ฉด ์ด ๋ฐฉ์‹์ด ํŽธ๋ฆฌํ•˜๊ณ  ํˆฌ๋ช…ํ•ฉ๋‹ˆ๋‹ค
429
+
430
+ ### ์ข…๋Ÿ‰์ œ / CI ํ™˜๊ฒฝ โ†’ ์ง์ ‘ router ๋ฐฉ์‹
431
+
432
+ - **ํ˜„์žฌ ์ƒํƒœ**: Claude Code subagent frontmatter๋Š” ํƒ€์‚ฌ model ์ง์ ‘ ์—ฐ๊ฒฐ์„ ์ง€์›ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์ด ์ €์žฅ์†Œ์˜ scratchpad์— ์žˆ๋Š” router ์‹คํ—˜์€ Claude Code์— API-key ์ž๊ฒฉ ์ฆ๋ช…์ด ํ•„์š”ํ•˜์ง€๋งŒ, subscription OAuth๋Š” Anthropic ์ƒ์œ„ ๋‹จ๊ณ„์—์„œ 403์œผ๋กœ ์ฐจ๋‹จ๋ฉ๋‹ˆ๋‹ค
433
+ - **๊ถŒ์žฅ**:
434
+ - API-key ์ž๊ฒฉ ์ฆ๋ช…(OAuth ์•„๋‹˜)์„ ์‚ฌ์šฉํ•˜๊ณ  Anthropic token์„ ์ ˆ์•ฝํ•˜๋ ค๋ฉด ๋กœ์ปฌ router๋ฅผ ์‹คํ–‰ํ•ด DeepSeek์— ์ง์ ‘ ์—ฐ๊ฒฐํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค
435
+ - CI ํ™˜๊ฒฝ๋„ ์ผ๋ฐ˜์ ์œผ๋กœ API key๋ฅผ ์‚ฌ์šฉํ•˜๋ฏ€๋กœ ์ด ๋ฐฉ์‹์ด ๋” ๊ฒฝ์ œ์ ์ž…๋‹ˆ๋‹ค(๋ชจ๋‘ DeepSeek token)
436
+ - router ํ†ตํ•ฉ์— ๋Œ€ํ•œ ์ž์ฒด ํ…Œ์ŠคํŠธ๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค(๊ณต์‹ ์ง€์›๋˜์ง€ ์•Š์Œ)
437
+
438
+ ### DSH Web ์‹คํ–‰ ์ค‘ โ†’ hub mode ์ž๋™ ํ™œ์„ฑํ™”
439
+
440
+ - **ํ˜„์žฌ ์ƒํƒœ**: `dsh plugin add dsh-crew`๋ฅผ DSH Web profile์— ์„ค์น˜ํ–ˆ๋‹ค๋ฉด job์€ host์—์„œ first-class session์œผ๋กœ ์‹คํ–‰๋˜๊ณ  Web UI session ๋ชฉ๋ก์— ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค
441
+ - **๊ถŒ์žฅ**: ๋กœ์ปฌ ๊ฐœ๋ฐœ ๋ฐ˜๋ณต ์ค‘์—๋Š” hub mode๋ฅผ ํ™œ์„ฑํ™”ํ•˜๋Š” ๊ฒƒ์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค. worker progress๋ฅผ Web UI์—์„œ ์™„์ „ํžˆ ๊ด€์ฐฐํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋จธ์‹  ๊ฐ„ ํ˜‘์—… ๋˜๋Š” Web UI๊ฐ€ ์—†๋Š” ํ™˜๊ฒฝ์—์„œ๋Š” dispatch ํ˜ธ์ŠคํŠธ shell ๋ฐฉ์‹์„ ์‚ฌ์šฉํ•˜์„ธ์š”
442
+
443
+ ### ์•Œ๋ ค์ง„ ํ•ญ๋ชฉ
444
+
445
+ - Codex role์€ ์ด๋ก ์ ์œผ๋กœ DeepSeek์„ ์ง์ ‘ ๊ฐ€๋ฆฌํ‚ค๋Š” `model_provider`๋ฅผ ์‹œ๋„ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค(๋ฏธ๊ฒ€์ฆ). ์ด bridge๋Š” ๊ทธ๊ฒƒ์— ์˜์กดํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค
446
+ - Image generation ์ถœ๋ ฅ์€ flat bitmap์ž…๋‹ˆ๋‹ค. ๋ ˆ์ด์–ด ํŽธ์ง‘์—๋Š” OpenPencil์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค
447
+ - **Runtime dependencies**: `@modelcontextprotocol/sdk`์™€ `zod`๋งŒ ์žˆ์Šต๋‹ˆ๋‹ค. `@deepseek-ai/*`๋Š” ํ˜ธ์ŠคํŠธ ๋Ÿฐํƒ€์ž„์ž…๋‹ˆ๋‹ค(DSH host๊ฐ€ ์ œ๊ณต; ์ผ๋ฐ˜ npm ์„ค์น˜๋Š” ์ด๋ฅผ ๊ฐ€์ ธ์˜ค์ง€ ์•Š์Œ)
448
+ - **Codex ํ•„์ˆ˜ ๊ตฌ์„ฑ**: `default_tools_approval_mode = "approve"`, ๊ทธ๋ ‡์ง€ ์•Š์œผ๋ฉด tool ํ˜ธ์ถœ์ด ์ž๋™ ์ทจ์†Œ๋ฉ๋‹ˆ๋‹ค
449
+
450
+ ## ๊ฐœ๋ฐœ
451
+
452
+ ```bash
453
+ pnpm install
454
+ node_modules/.bin/tsdown src/client/index.tsx --format cjs --platform browser \
455
+ --target es2022 --tsconfig tsconfig.client.json --out-dir .client-build --clean
456
+ node scripts/build-client.mjs # wraps the bundle for the DSH module loader
457
+ node scripts/smoke.mjs # dispatches one real flash task end to end
458
+ ```
459
+
460
+ Runtime dependencies๋Š” `@modelcontextprotocol/sdk`์™€ `zod`๋ฟ์ž…๋‹ˆ๋‹ค. ๋ชจ๋“  `@deepseek-ai/*` ํŒจํ‚ค์ง€๋Š” DSH host๊ฐ€ ์ œ๊ณตํ•˜๋Š” ํ˜ธ์ŠคํŠธ ๋Ÿฐํƒ€์ž„์ด๋ฉฐ(package.json์˜ dshHostRuntime ํ•„๋“œ์— ๋ฌธ์„œํ™”๋˜๊ณ  peerDependencies์—๋Š” ์—†์œผ๋ฏ€๋กœ ์ผ๋ฐ˜ npm ์„ค์น˜๊ฐ€ ์ด๋ฅผ ๊ฐ€์ ธ์˜ค์ง€ ์•Š์Œ), plugin์„ host์˜ ๋‹จ์ผ module realm ์•ˆ์— ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค.
461
+
462
+ ## ์—์ฝ”์‹œ์Šคํ…œ
463
+
464
+ - [DSH Android](https://github.com/ZSeven-W/dsh-android) โ€” ๋Œ€ํ™” ์•ˆ์—์„œ ๋™์ž‘ํ•˜๋Š” Android ์—๋ฎฌ๋ ˆ์ดํ„ฐ์™€ USB ์—ฐ๊ฒฐ ๊ธฐ๊ธฐ โ€” ์ „๋ถ€ adb๋กœ ๊ตฌ๋™
465
+ - [DSH iOS](https://github.com/ZSeven-W/dsh-ios) โ€” ๋Œ€ํ™” ์•ˆ์—์„œ ๋™์ž‘ํ•˜๋Š” iOS ์‹œ๋ฎฌ๋ ˆ์ดํ„ฐ์™€ USB ์—ฐ๊ฒฐ iPhone
466
+ - [DSH Noema](https://github.com/ZSeven-W/dsh-noema) โ€” DSH๋ฅผ ์œ„ํ•œ ์žฅ๊ธฐ ๋ฉ”๋ชจ๋ฆฌ
467
+ - [DSH OpenPencil](https://github.com/ZSeven-W/dsh-openpencil) โ€” ๋Œ€ํ™” ์ค‘ `.op` ๋””์ž์ธ ๋ฌธ์„œ๋ฅผ ๊ฒ€์‚ฌํ•˜๊ณ  ํŽธ์ง‘
468
+
469
+ ## ๋ผ์ด์„ ์Šค
470
+
471
+ MIT
472
+
473
+
474
+ ### `dsh_worker_probe` / `needs_input`
475
+
476
+ `dsh_worker_probe`๋Š” DSH์— ์„ค์ •๋œ ๊ฒฝ๋กœ์— ์ œํ•œ ์‹œ๊ฐ„ ๋‚ด ๋ถ€์ž‘์šฉ ์—†๋Š” ๋„๊ตฌ ํ˜ธ์ถœ์„ ํ•œ ๋ฒˆ ๋ณด๋‚ด๋ฉฐ worker ์ƒ์„ฑ์ด๋‚˜ ๋ฐ”์ธ๋”ฉ ๋ณ€๊ฒฝ์„ ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋ชจ๋ธ token์ด ์‚ฌ์šฉ๋  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋ฏธ์‘๋‹ต ์งˆ๋ฌธ์€ `needs_input`์œผ๋กœ ๋ฉˆ์ถ”๊ณ  ์‚ฌ์šฉ์ž ๋‹ต๋ณ€ ํ›„ ๋‹ค์‹œ ๋ฐฐ์ •ํ•ฉ๋‹ˆ๋‹ค. ํ˜ธ์ŠคํŠธ ๊ถŒํ•œ์„ ์ƒ์†ํ•˜๋ฉฐ ์ƒˆ OS ์ƒŒ๋“œ๋ฐ•์Šค๋ฅผ ์ œ๊ณตํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
477
+
478
+ ```js
479
+ dsh_worker_probe({ tier: "flash" })
480
+ ```