@ran-sh/dsh-crew 0.3.0

package/README.th.md

@@ -0,0 +1,359 @@
+<p align="center">
+  <img src="./docs/images/dsh-crew-logo.png" alt="DSH Crew" width="120" />
+</p>
+
+<h1 align="center">DSH Crew</h1>
+
+<p align="center">
+  <strong>ปลั๊กอินสำหรับ <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>: ส่งงานให้ DSH agents จาก Claude Code / Codex โดยไม่ต้องสละ subagent UI ดั้งเดิมของโฮสต์</strong><br />
+  <sub>UI แสดงความคืบหน้าแบบเนทีฟ &bull; นโยบาย Tier และการยกระดับ &bull; เซสชัน DSH ในโฮสต์ &bull; การดูภาพและการสร้างภาพ &bull; ติดตั้งในคลิกเดียว</sub>
+</p>
+
+<p align="center">
+  <sub>GitHub: <code>Ran-sh/dsh-crew</code> &middot; เวอร์ชันปลั๊กอินปัจจุบัน: <code>0.1.0-rc.1</code> &middot; ทดสอบกับ DSH <code>0.1.0-rc.6</code></sub>
+</p>
+
+<p align="center">
+  <a href="./README.md"><b>English</b></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">한국어</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"><b>ไทย</b></a> &middot; <a href="./README.vi.md">Tiếng Việt</a> &middot; <a href="./README.id.md">Bahasa Indonesia</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/Ran-sh/dsh-crew/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Ran-sh/dsh-crew?color=64748b" alt="License" /></a>
+</p>
+
+<br />
+
+<p align="center">
+  <img src="./docs/images/dsh-crew-overview.png" alt="DSH Crew — settings page" width="100%" />
+</p>
+<p align="center"><sub>หน้า settings ของ DSH Crew — การเชื่อมต่อโฮสต์ นโยบายการส่งงาน การทำงาน และสะพาน multimodal</sub></p>
+
+## ทำไมต้อง DSH Crew
+
+DSH Crew เป็นปลั๊กอินสำหรับ [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) — agent harness แบบโอเพนซอร์ส มันทำให้ DSH agents ถูกสั่งงานจาก Claude Code และ Codex ได้: orchestrator คงใช้โมเดลของตัวเอง งานรันบน DSH agent จริงพร้อม tools, sandbox, presets และ session history ของ harness นั้น และโฮสต์ยังคงแสดงผลเป็น subagent แบบเนทีฟพร้อมความคืบหน้าแบบเรียลไทม์
+
+สิ่งที่รันงานคือ DSH agent ไม่ใช่การเรียกโมเดลเปล่าๆ Tier (`flash` / `pro`) กำหนดว่า agent นั้นจะได้ capability มากแค่ไหนจาก roster โมเดลที่ตั้งค่าไว้ใน harness — ปัจจุบันคือ DeepSeek V4 Flash และ V4 Pro — ดังนั้นการเปลี่ยนโมเดลใน DSH ไม่ต้องแก้ไขอะไรที่นี่
+
+<table>
+<tr>
+<td width="50%">
+
+### 🧵 UI แสดงความคืบหน้าแบบเนทีฟ
+
+Workers ปรากฏเป็น subagent ปกติใน Claude Code / Codex — จำนวนงานที่ส่ง ขั้นตอนที่กำลังรัน การเรียก tool และการใช้ token แสดงทั้งหมดใน task panel ของโฮสต์เอง พร้อมด้วย claude-hud statusline segment: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3`
+
+</td>
+<td width="50%">
+
+### 🎚️ นโยบาย Tier และการยกระดับ
+
+`flash` สำหรับงานเชิงกลไก `pro` สำหรับงานที่ต้องใช้เหตุผล `effort` ตั้งแต่ `off` ถึง `max` `tier_policy` บังคับให้ทุกการส่งงานใช้ tier เดียวที่ tool layer ได้ และ `escalate_on_failure` จะลองรัน flash ที่ล้มเหลวซ้ำบน pro อีกครั้ง — อิงจากหลักฐานจริง ไม่ใช่การเดาความยากล่วงหน้า
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### 🏛️ เซสชัน DSH ในโฮสต์
+
+เมื่อติดตั้ง bundle ลงใน DSH profile แล้ว worker แต่ละตัวคือ DSH session ชั้นหนึ่ง: มองเห็นได้ใน Web UI จัดกลุ่มตาม working directory และติดตั้งด้วย Agent preset ที่คุณเลือกตาม tier หาก DSH ไม่ได้รันอยู่ การส่งงานจะ fallback ไปยัง DSH runtime แบบ standalone ทำให้ CI และสภาพแวดล้อมแบบ headless ยังทำงานได้
+
+</td>
+<td width="50%">
+
+### 👁️ การดูภาพและการสร้างภาพ
+
+โมเดลของ DSH รองรับเฉพาะข้อความ `describe_image` และ `generate_image` ยืมตาและพู่กันจาก CLI ที่คุณมีอยู่แล้ว — Claude, Codex, Grok, Antigravity — หรือจาก OpenAI-compatible API ใดๆ ที่คุณตั้งค่าไว้ ภาพที่วางเข้ามายังมองเห็นได้ในบทสนทนาและไปถึงโมเดลในรูปของข้อความ
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### 🔌 ผู้ให้บริการแบบกำหนดเอง
+
+นำ endpoint ของคุณเอง (Base URL + API key + models) หรือ command template ในเครื่องมาใช้ ผู้ให้บริการแต่ละรายมีการทดสอบการเชื่อมต่อที่ตรวจสอบการเข้าถึงและ auth จากนั้นส่งคำขอ vision จริงหนึ่งครั้ง เพื่อให้คุณรู้ผลทันที ไม่ใช่กลางคันของงาน
+
+</td>
+<td width="50%">
+
+### 📦 ติดตั้งในคลิกเดียว
+
+หน้า settings ติดตั้งและอัปเดตปลั๊กอิน Claude Code และไฟล์ role ของ Codex ให้คุณ — การลงทะเบียน marketplace, allowlist สิทธิ์, การต่อสาย HUD, absolute path ที่สร้างสำหรับเครื่องนี้ — และกู้คืนได้ง่ายพอๆ กัน ไฟล์ settings ทุกไฟล์ถูกสำรองก่อนเสมอ
+
+</td>
+</tr>
+</table>
+
+## วิธีการทำงาน
+
+```
+Claude Code / Codex (orchestrator, keeps its own model)
+  └─ ds-flash / ds-pro  ← native subagent shell (progress shows in the host's task UI)
+       └─ MCP: dsh_run_worker(tier, effort, cwd)
+            ├─ hub reachable → session inside DSH (visible in the Web UI, grouped by cwd)
+            └─ otherwise     → dsh-jsonrpc-agent runtime (worker.cordis.yml)
+                 └─ DeepSeek V4 Flash / Pro (DSH SDK, event stream → progress and token stats)
+```
+
+## หนึ่งการรัน สองมุมมอง
+
+การ dispatch ขยายออกได้กว้าง ด้านล่างมี worker สิบแปดตัวแปล README นี้พร้อมกัน: ฝั่ง host นับพวกมันเป็น subagent ของตัวเอง ส่วน harness รันพวกมันเป็นเซสชันจริง
+
+<p align="center">
+  <img src="./docs/images/dsh-crew-host.png" alt="Claude Code" width="100%" />
+</p>
+<p align="center"><sub>ใน Claude Code worker ของ dsh-crew ปรากฏเป็น subagent ดั้งเดิม และส่วน statusline แสดง tier ที่กำลังทำงาน เวลาที่ใช้ และ token</sub></p>
+
+<p align="center">
+  <img src="./docs/images/dsh-crew-jobs.png" alt="DSH Crew" width="100%" />
+</p>
+<p align="center"><sub>แผง DSH Crew แสดงการรันเดียวกันจากฝั่ง harness: host ใดส่งงานไหน tier และ effort ความคืบหน้าแบบเรียลไทม์ และการใช้ token</sub></p>
+
+## การติดตั้ง
+
+ติดตั้งจาก GitHub ลงในโปรไฟล์ DSH:
+
+```bash
+node scripts/setup.mjs install   # Safe install: see the canonical Install section of README.md (dedicated Crew home/profile; official web profile is never modified).
+Repository source: github:Ran-sh/dsh-crew
+npx -y @deepseek-ai/dsh web
+```
+
+หรือสำหรับการพัฒนาในเครื่องจากซอร์ส:
+
+```bash
+node scripts/setup.mjs install   # Safe install: see the canonical Install section of README.md (dedicated Crew home/profile; official web profile is never modified).
+Repository source: github:Ran-sh/dsh-crew
+npx -y @deepseek-ai/dsh web
+```
+
+โปรโตคอล `link:` จะ symlink dependency ของโปรไฟล์มาที่รีโพนี้ ทำให้ผลการ rebuild เห็นได้ทันที
+
+### ตั้งค่าข้อมูลรับรองของ DeepSeek (เฉพาะ standalone)
+
+ในโหมด hub — การติดตั้งข้างบน — worker รันภายใน DSH instance และใช้ข้อมูลรับรอง DeepSeek ที่มีการตั้งค่าไว้แล้ว ไม่ต้องตั้งค่าอะไรเพิ่มเติม
+
+เฉพาะ standalone fallback เท่านั้นที่ต้องใช้ key ของตัวเอง: การส่งงานจาก Claude Code / Codex โดยไม่มี DSH instance ทำงานจะเปิดตัว worker runtime เป็นกระบวนการแยกต่างหาก ขอ API key จาก [platform.deepseek.com](https://platform.deepseek.com) และเขียนลงใน `~/.config/dsh-crew/.env`:
+
+```
+DEEPSEEK_API_KEY=sk-...
+```
+
+### ตรวจสอบ
+
+```bash
+node scripts/smoke.mjs
+```
+
+smoke test ส่งงาน job หนึ่งอันราคาถูกผ่านเส้นทางใดๆ ที่มีอยู่ — hub เมื่อ DSH instance ทำงานอยู่ standalone ในกรณีอื่น — และพิมพ์เส้นทางที่ใช้ ภายในประมาณสิบวินาที คุณควรเห็น `smoke test passed — configuration OK` เมื่อล้มเหลว เหตุผลจะถูกพิมพ์ ซึ่งกำหนดไว้สำหรับเส้นทางที่ทดสอบ
+
+จากนั้นเปิด การตั้งค่า → DSH Crew แล้วติดตั้งการเชื่อมต่อ Claude Code / Codex ได้ในคลิกเดียว
+
+## ความเป็นมาและคำศัพท์
+
+- **DSH** (DeepSeek Harness): agent harness โอเพนซอร์สของ DeepSeek เป็น code agent ในรูปแบบ Web UI คล้ายกับ Claude Code แต่ขับเคลื่อนด้วยโมเดลของ DeepSeek
+- **MCP** (Model Context Protocol): โปรโตคอลเชื่อมต่อเครื่องมือ AI ของ Anthropic ช่วยให้ LLM เรียกเครื่องมือภายนอกและแหล่งข้อมูลได้อย่างปลอดภัย
+- **Cordis bundle**: รูปแบบปลั๊กอินของ DSH โปรเจกต์นี้รันแบบ standalone เป็น MCP service ได้ หรือติดตั้งลงใน DSH Web เป็นโหมด hub
+- **tier**: ระดับ capability — worker จะได้รับช่องไหนจาก roster โมเดลที่ตั้งค่าไว้ใน DSH `flash` เร็วและถูก (งานง่าย) `pro` ใช้เหตุผลลึกกว่า (ปัญหาซับซ้อน) ปัจจุบันจับคู่กับ DeepSeek V4 Flash และ V4 Pro หากเปลี่ยนโมเดลใน DSH ที่นี่ก็ไม่ต้องแก้ไขอะไร
+- **worker**: DSH agent ที่ทำงาน — เป็น session เต็มรูปแบบพร้อม tools, sandbox และ preset ของตัวเอง ไม่ใช่การเรียกโมเดลเปล่าๆ
+- **effort**: ระดับความเข้มข้นของการใช้เหตุผล `off` = ไม่ใช้เหตุผล `high` = ลงทุนการใช้เหตุผลสูง `max` = ลงทุนการใช้เหตุผลสูงสุด
+
+## Claude Code
+
+### การติดตั้ง
+
+ติดตั้งในคลิกเดียว (เลือกอย่างใดอย่างหนึ่ง):
+
+- **หน้า settings ของ DSH** (เมื่อติดตั้งโหมด hub แล้ว): Settings → DSH Crew → "Install to Claude Code"
+- **บรรทัดคำสั่ง**: `node src/install/cli.mjs all`
+
+ทั้งสองวิธีทำสิ่งเดียวกัน: ลงทะเบียน marketplace ในเครื่อง (ไดเรกทอรีแม่ `dsh-plugins/` เป็น marketplace root) + `claude plugin install` + allowlist สิทธิ์ของ MCP tool + ตั้งค่า claude-hud worker status segment (สำรอง settings.json อัตโนมัติก่อนแก้ไข และรันซ้ำได้โดยปลอดภัย) **รีสตาร์ท session หลังติดตั้งเพื่อให้การเปลี่ยนแปลงมีผล**
+
+### วิธีใช้งาน
+
+- ในบทสนทนาโดยตรง พูดว่า "dispatch X to ds-flash" หรือ "dispatch X to ds-pro" แล้ว subagent จะรันงานนั้น
+- จำนวนงานที่ส่งและความคืบหน้าแบบเรียลไทม์แสดงใน task UI ของ Claude Code
+- **HUD status line segment**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (tier ปัจจุบัน / เวลาที่ผ่านไป / การใช้ token / จำนวนที่เสร็จ)
+  - สำหรับการพัฒนาในเครื่อง `statusline/statusline.sh` หรือ `statusline/worker-segment.sh` สามารถเชื่อมต่อแยกอิสระได้
+- **งานที่รันนาน**: CC มีการจำกัด timeout ของการเรียก MCP (ปรับ `MCP_TOOL_TIMEOUT` ได้) งานที่ยาวสามารถให้ orchestrator ใช้ `dsh_spawn_worker` + `dsh_worker_result(wait_seconds)` เพื่อ polling ได้
+- **การพัฒนาและดีบักในเครื่อง**: `claude --plugin-dir /path/to/dsh-crew` เพื่อโหลดชั่วคราว
+
+
+### คำสั่งระดับเซสชัน
+
+แทนที่ค่าเริ่มต้นระดับ global เฉพาะเซสชันปัจจุบัน และบังคับใช้ที่ชั้นเครื่องมือ ไม่ใช่ด้วยพรอมป์ต์:
+
+| คำสั่ง | ทำอะไร |
+|---|---|
+| `/dsh-crew:config` | ดูหรือตั้งค่าเริ่มต้นของเซสชัน: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<วินาที>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `reset` |
+| `/dsh-crew:on` · `/dsh-crew:off` | เปิดหรือปิดการ dispatch ของเซสชันนี้ (ปิดคือสวิตช์แข็ง เครื่องมือจะปฏิเสธ) |
+| `/dsh-crew:status` | สถานะสดของงาน worker: tier ความคืบหน้า tokens และเครื่องมือปัจจุบัน |
+
+## Codex
+
+### การติดตั้ง
+
+แนะนำให้ใช้ตัวติดตั้ง (สร้าง path สำหรับเครื่องนี้โดยอัตโนมัติ และคัดลอกคำสั่ง `/dsh-config`, `/dsh-status`):
+
+```bash
+node src/install/cli.mjs codex
+```
+
+หรือคัดลอกด้วยตนเอง (ต้องแก้ไข path เองหลังคัดลอก):
+
+```bash
+cp codex/agents/*.toml ~/.codex/agents/    # global or project-level .codex/agents/
+```
+
+ไฟล์ role ถูกตั้งค่าไว้ล่วงหน้าด้วย:
+
+- การตั้งค่าการ mount MCP server
+- `default_tools_approval_mode = "approve"` (**จำเป็น** มิฉะนั้น tool calls จะถูกยกเลิกอัตโนมัติใน exec mode)
+- `tool_timeout_sec = 3600`
+
+**หมายเหตุ**: เมื่อคัดลอกด้วยตนเอง absolute path ในฟิลด์ `args` ต้องอัปเดตให้ตรงกับตำแหน่งติดตั้งจริง ตัวติดตั้งจัดการส่วนนี้ให้อัตโนมัติ
+
+### วิธีใช้งาน
+
+- ใน TUI แบบอินเทอร์แอกทีฟ เลือก "spawn ds-pro to ..." เพื่อส่งงาน แผง Active/Done แสดงความคืบหน้า
+- โหมด `codex exec` เรียก `dsh_run_worker` ได้โดยตรงเช่นกัน
+
+
+### คำสั่งระดับเซสชัน
+
+ฝั่ง Codex ติดตั้งพรอมป์ต์สองตัวเดียวกัน:
+
+| คำสั่ง | ทำอะไร |
+|---|---|
+| `/dsh-config` | ดูหรือตั้งค่าเริ่มต้นของเซสชัน: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<วินาที>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `reset` |
+| `/dsh-status` | สถานะสดของงาน worker: tier ความคืบหน้า tokens และเครื่องมือปัจจุบัน |
+
+## เครื่องมือ MCP
+
+| เครื่องมือ | คำอธิบาย |
+|---|---|
+| `dsh_run_worker` | ส่งงานแบบ synchronous (`tier`: flash/pro, `effort`: off/high/max, `cwd`) และรอผลลัพธ์ |
+| `dsh_spawn_worker` | ส่งงานแบบ asynchronous คืน job id (สำหรับ fan-out แบบขนาน) |
+| `dsh_worker_status` | สอบถามความคืบหน้าแบบเรียลไทม์ของทุก job (turn/step/tool ปัจจุบัน/token) |
+| `dsh_worker_result` | ดึงผลลัพธ์ ระบุ `wait_seconds` เพื่อรอได้ |
+| `dsh_worker_cancel` | ยกเลิก job ที่ระบุ พร้อมยุติ runtime process ของมัน |
+
+ความคืบหน้าจะถูก mirror ไปยัง `~/.config/dsh-crew/status.d/` พร้อมกัน (หนึ่งไฟล์ shard ต่อผู้เขียนหนึ่งราย statusline / ระบบ monitoring ภายนอกอ่านได้)
+
+## Multimodal: การดูภาพและการสร้างภาพ
+
+**DeepSeek เป็นโมเดลแบบข้อความล้วน** ไม่รองรับการรับภาพหรือการสร้างภาพ ปลั๊กอินนี้ดึง capability เหล่านี้จากภายนอกผ่าน MCP tools:
+
+| เครื่องมือ | คำอธิบาย |
+|---|---|
+| `describe_image` | ตอบคำถามด้วยการดูภาพ (screenshots, ดีไซน์, แผนภูมิ ฯลฯ) ผลลัพธ์ถูกแคชตาม provider + model + image + question |
+| `generate_image` | สร้างภาพจากคำอธิบายข้อความ บันทึกไปยัง absolute path ที่ระบุ ผลลัพธ์เป็น bitmap แบบแบน (ต้องใช้ OpenPencil เพื่อแก้ไขเลเยอร์) |
+
+**การวางภาพใน session**: ใน DSH ให้สลับโมเดลเป็น `DeepSeek (vision) ◉` เพื่อวางภาพโดยตรง ภาพยังคงอยู่ใน session และแสดงผลตามปกติ ปลั๊กอินจะต่อท้ายข้อความที่ถอดความแล้วไว้หลังภาพและตัดภาพออกก่อนส่ง—คุณเห็นภาพ โมเดลอ่านข้อความ
+
+### การตั้งค่า
+
+ใน **หน้า settings ของ DSH → DSH Crew → Multimodal** (หรือแก้ไข `~/.config/dsh-crew/config.json` โดยตรง):
+
+**Vision provider** (การดูภาพ):
+
+- `claude-code` (ค่าเริ่มต้น ใช้ haiku ราคาประหยัด)
+- `codex` (ใช้ GPT ระบุโมเดลเฉพาะได้)
+- `grok` (ใช้ Grok)
+- `agy` (Antigravity)
+- `custom` (OpenAI-compatible API หรือคำสั่งในเครื่อง)
+- `off` (ปิดใช้งาน)
+
+**Image generation provider** (การสร้างภาพ):
+
+- `codex` (`$imagegen`, gpt-image-2)
+- `agy` (Nano Banana)
+- `grok` (Imagine)
+- `custom` (OpenAI-compatible API หรือคำสั่งในเครื่อง)
+- `off` (ปิดใช้งาน)
+
+### ผู้ให้บริการแบบกำหนดเอง
+
+มีสองวิธีในการเชื่อมต่อ:
+
+**API**: endpoint ที่รองรับ OpenAI ใดก็ได้
+- กรอก Base URL, API Key และรายการ models
+- Vision ใช้ `/chat/completions` พร้อมภาพ base64 แบบ inline
+- การสร้างภาพใช้ `/images/generations`
+- **ต้องระบุ "image generation model" จึงจะสร้างภาพได้** มิฉะนั้น provider จะปรากฏเฉพาะในตัวเลือก vision เท่านั้น
+
+**CLI**: command template ในเครื่อง โดย placeholder จะถูกแทนที่ด้วยการอ้างอิงที่ปลอดภัย
+- Vision: `{image} {question} {model}` → stdout เป็นคำตอบ
+- การสร้างภาพ: `{prompt} {output} {size}` → คำสั่งต้องเขียนไฟล์ไปยัง `{output}`
+- กรอกอย่างน้อยหนึ่งคำสั่ง คำสั่งไหนถูกกรอกจะเป็นตัวกำหนด capability
+
+**การทดสอบการเชื่อมต่อ**: ผู้ให้บริการแบบกำหนดเองแต่ละรายมีปุ่มทดสอบ
+- API: ตรวจสอบการเข้าถึง endpoint และ auth พร้อมส่งคำขอ vision จริงเพื่อยืนยัน
+- CLI: ตรวจสอบไฟล์ปฏิบัติการ และรันคำสั่งจริงเพื่อยืนยัน
+- การสร้างภาพ: ตรวจสอบ config เท่านั้น ไม่มีการสร้างภาพจริง
+
+**CLI ที่ยืมมาจาก subscription** (claude / codex / grok / agy) กำหนดให้คุณต้องล็อกอินในเครื่องก่อน ปลั๊กอินจะไม่เลี่ยงการตรวจสอบสิทธิ์ของ CLI เหล่านั้นให้คุณ
+
+## โหมด Hub
+
+แพ็กเกจนี้ยังเป็น DSH bundle ที่สมบูรณ์ด้วย (`dsh.bundle` + `cordis.patch.yml`) หลังจากติดตั้งลงใน DSH Web profile ด้วย `dsh plugin add dsh-crew`:
+
+- **Worker sessions กลายเป็นพลเมืองชั้นหนึ่ง**: รันเป็น session ชั้นหนึ่งในโฮสต์ DSH (`agents.create` + model/effort waterfall ต่อ session + preset เริ่มต้น) ปรากฏในรายการ session ของ Web UI เปิดดูการทำงานทั้งหมดได้ทุกเมื่อ
+- **จัดระเบียบตาม working directory**: จัดการ worker sessions ตาม cwd ใน Web UI
+- **Loopback API**:
+  - `POST/GET /_dsh/dsh-crew/jobs`: สร้างงาน แสดงรายการ long-poll ผลลัพธ์ ยกเลิก
+  - `GET /_dsh/dsh-crew/ping`: ตรวจสุขภาพ (MCP shim ใช้ endpoint นี้ตรวจจับว่า hub ทำงานอยู่หรือไม่)
+  - `POST /_dsh/dsh-crew/install`: ติดตั้งการเชื่อมต่อ Claude Code / Codex ในคลิกเดียว (backend ของ `src/install/`)
+- **การตรวจจับอัตโนมัติ**: MCP shim ของ CC/Codex ตรวจจับ hub โดยอัตโนมัติ (env var `DSH_CREW_HUB` ค่าเริ่มต้น `http://127.0.0.1:3080`)
+  - DSH Web ทำงานอยู่ → jobs เข้าสู่โหมด hub (`mode: "hub"`)
+  - ไม่ได้ทำงานอยู่ → fallback ไปยัง runtime แบบ standalone
+
+## การเลือกแนวทางและข้อจำกัด
+
+### ผู้ใช้แบบ subscription ทั่วไป → แนวทาง shell subagent (แนะนำ)
+
+- **สถานะปัจจุบัน**: Claude Code subagent shell ใช้ haiku เป็นตัวกลาง การส่งงานแต่ละครั้งเพิ่ม token หลายร้อยถึงหลายพัน
+- **ข้อแลกเปลี่ยน**: ใช้ Anthropic token จำนวนเล็กน้อย แลกกับ task UI แบบเนทีฟ การแสดงความคืบหน้าแบบเรียลไทม์ และไม่ต้องตั้งค่าเพิ่มเติม
+- **ข้อแนะนำ**: หากคุณสมัคร Claude Pro อยู่แล้วหรือใช้ Claude Code อยู่ ให้ใช้แนวทางนี้—สะดวกและโปร่งใส
+
+### สภาพแวดล้อมแบบจ่ายตามการใช้งาน / CI → แนวทาง direct router
+
+- **สถานะปัจจุบัน**: frontmatter ของ Claude Code subagent ไม่รองรับการเชื่อมต่อโมเดลบุคคลที่สามโดยตรง การทดลอง router ใน scratchpad ของ repo นี้ต้องใช้ credentials แบบ API-key สำหรับ Claude Code แต่ OAuth แบบ subscription ถูก Anthropic บล็อกไว้ต้นทางด้วย 403
+- **ข้อแนะนำ**:
+  - หากใช้ credentials แบบ API-key (ไม่ใช่ OAuth) และต้องการประหยัด Anthropic token สามารถรัน router ในเครื่องเพื่อเชื่อมต่อ DeepSeek ได้โดยตรง
+  - สภาพแวดล้อม CI มักใช้ API keys เช่นกัน แนวทางนี้ประหยัดกว่า (ใช้ DeepSeek token ทั้งหมด)
+  - ต้องทดสอบการเชื่อมต่อ router ด้วยตนเอง (ไม่ได้รับการสนับสนุนอย่างเป็นทางการ)
+
+### เมื่อ DSH Web ทำงานอยู่ → โหมด hub เปิดใช้อัตโนมัติ
+
+- **สถานะปัจจุบัน**: หากติดตั้ง `dsh plugin add dsh-crew` ลงใน DSH Web profile แล้ว jobs จะรันเป็น session ชั้นหนึ่งในโฮสต์และปรากฏในรายการ session ของ Web UI
+- **ข้อแนะนำ**: ระหว่างการพัฒนาในเครื่อง แนะนำให้เปิดโหมด hub เพราะสามารถสังเกตความคืบหน้าของ worker ได้ครบถ้วนใน Web UI สำหรับการทำงานร่วมกันข้ามเครื่องหรือสภาพแวดล้อมที่ไม่มี Web UI ให้ใช้แนวทาง Claude Code / Codex shell
+
+### เรื่องที่ทราบอยู่แล้ว
+
+- ในทางทฤษฎี Codex role สามารถลองชี้ `model_provider` ไปยัง DeepSeek ได้โดยตรง (ยังไม่ผ่านการตรวจสอบ) สะพานเชื่อมนี้ไม่ได้พึ่งพาสิ่งนั้น
+- ผลลัพธ์ของการสร้างภาพเป็น bitmap แบบแบน การแก้ไขเลเยอร์ต้องใช้ OpenPencil
+- **Runtime dependencies**: มีเพียง `@modelcontextprotocol/sdk` และ `zod` เท่านั้น `@deepseek-ai/*` เป็น peerDependencies (จัดหาโดย DSH host)
+- **Codex ต้องตั้งค่า**: `default_tools_approval_mode = "approve"` มิฉะนั้น tool calls จะถูกยกเลิกอัตโนมัติ
+
+## การพัฒนา
+
+```bash
+pnpm install
+node_modules/.bin/tsdown src/client/index.tsx --format cjs --platform browser \
+  --target es2022 --tsconfig tsconfig.client.json --out-dir .client-build --clean
+node scripts/build-client.mjs   # wraps the bundle for the DSH module loader
+node scripts/smoke.mjs          # dispatches one real flash task end to end
+```
+
+Runtime dependencies มีเพียง `@modelcontextprotocol/sdk` และ `zod` เท่านั้น ทุกแพ็กเกจ `@deepseek-ai/*` เป็น peer dependency ที่ DSH host จัดหาให้ ซึ่งทำให้ปลั๊กอินอยู่ใน module realm เดียวกันของโฮสต์
+
+## ระบบนิเวศ
+
+- [DSH Noema](https://github.com/ZSeven-W/dsh-noema) — หน่วยความจำระยะยาวสำหรับ DSH
+- [DSH OpenPencil](https://github.com/ZSeven-W/dsh-openpencil) — ตรวจดูและแก้ไขเอกสารดีไซน์ `.op` ภายในบทสนทนา
+
+## สัญญาอนุญาต
+
+MIT