> For the complete documentation index, see [llms.txt](https://dsg-3.gitbook.io/dsg-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dsg-3.gitbook.io/dsg-docs/dsg-one-or-start-here.md).

# เริ่มใช้งาน DSG ONE | Start Here

เริ่ม DSG ONE ได้ในหนึ่งหน้า: ผู้ใช้, Agent, ผู้ดูแล, งานอนุมัติ และ Evidence

**เริ่มงานจากหน้าเดียว:** [เปิด DSG OS Workspace](https://dsg-one-public-recovery-g35ayy.v2.appdeploy.ai/workspace/) แล้วเลือก **ไทย** หรือ **English** จากเมนูภาษา ระบบจะจดจำภาษาที่เลือก และมีปุ่ม **ตั้งค่าให้อัตโนมัติ** เพื่อตรวจบัญชี สิทธิ์ และการเชื่อมต่อ Workroom โดยไม่ขอ API Key จากผู้ใช้

{% hint style="info" %}
**Cinema Browser:** เมื่อยังไม่มีเซสชันภาพสดที่ได้รับอนุญาต หน้า Workspace จะไม่แสดงภาพจำลอง การดูแท็บบนเครื่องเป็นภาพตัวอย่างเฉพาะเครื่อง ไม่ได้ส่งภาพให้ Agent โดยอัตโนมัติ คำสั่งเปิดเว็บ คลิก กรอกข้อความ และจับภาพถูกเตรียมเป็นงานผ่าน Workroom และตรวจ Policy/Approval ก่อน Execute จริง
{% endhint %}

**เลือกงานที่ต้องการทำ ไม่ต้องเลือก API หรือ Provider เอง**

| ฉันต้องการ…                         | เข้าใช้งานที่                                                                                        | ผลที่ควรเห็น                                            |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| **สั่ง Agent ด้วยภาษาธรรมชาติ**     | [เปิด DSG Workroom](https://dsg.pics/dsg/workroom)                                                   | เป้าหมาย → แผน → สถานะงาน → ผล/หลักฐาน                  |
| **ตรวจหรือควบคุมงานในฐานะผู้ดูแล**  | [เปิด DSG OS Workspace หน้าเดียว](https://dsg-one-public-recovery-g35ayy.v2.appdeploy.ai/workspace/) | ลงชื่อเข้าใช้ → ตรวจ Operator → ตรวจ Workroom → ส่งงาน  |
| **เชื่อม Agent ผ่าน MCP**           | [DSG Spacetime MCP](https://aws.dsg.pics/mcp)                                                        | Discover → Compose → Policy → Execute → Evidence        |
| **ดูสถานะระบบโดยไม่เข้าถึงความลับ** | [ตรวจ Workroom Health](https://dsg.pics/control/health)                                              | HTTP 200 + `ok=true` + `workroom_store=true` เมื่อพร้อม |

{% hint style="info" %}
หากเข้าหน้า Workroom แล้วต้องเข้าสู่ระบบ ให้ใช้บัญชีที่ได้รับสิทธิ์ตามปกติ ไม่ต้องขอ Token, Key หรือรหัสผ่านผ่านแชต
{% endhint %}

## สำหรับผู้ใช้ — 3 ขั้นตอน

1. **พิมพ์ผลลัพธ์ที่ต้องการ** เช่น “ตรวจสถานะงานของฉันและแสดงรายการที่ต้องอนุมัติ” แทนการเลือกเครื่องมือ
2. **ตรวจขั้นตอนที่ขออนุมัติ** เฉพาะเมื่อแสดง `WAITING_APPROVAL`; ดูผู้กระทำ, Provider, เป้าหมาย และผลกระทบก่อนกดยืนยัน
3. **อ่านผลพร้อมหลักฐาน**: `COMPLETED` เฉพาะเมื่อ Provider ทำสำเร็จและมี Evidence; `BLOCKED`, `WAITING_PERMISSION` หรือ `FAILED` ห้ามเปลี่ยนเป็นสำเร็จเอง

[เปิด Workroom แล้วเริ่มงาน](https://dsg.pics/dsg/workroom)

## สำหรับ Agent — สัญญาการใช้งานหนึ่งเส้นทาง

**Goal → Proposal → Spacetime Plan/Route/Policy → Approval (เมื่อจำเป็น) → Provider → Signed Evidence → User-visible Result**

* Agent เสนอแผนและเรียก Capability ผ่าน DSG Spacetime; **ไม่เรียก Provider/Secrets โดยตรง**
* Discover Route ก่อน Compose; หาก Route ต้องผูก Payload ให้ผูกค่าเดียวกันตอน Execute
* ไม่มี Route/สิทธิ์/Provider จริง: แสดง `BLOCKED` หรือ `WAITING_PERMISSION` พร้อมเหตุผล ไม่สร้างผลจำลอง
* ใช้ OAuth Principal ของผู้ที่ลงชื่อเข้าใช้จริง ไม่สวมสิทธิ์หรือขยาย Scope
* ตรวจ `decision`, `result`, `evidence_hash` และลายเซ็นก่อนรายงานว่างานสำเร็จ
* ตัวอย่าง Route **ที่พิสูจน์ E2E แล้ว**: `repo.metadata.read` กับ Fixed Public Target `tdealer01-crypto/DSG-Spacetime-Source`. **ไม่ใช่** สิทธิ์อ่าน Repository ใดก็ได้

## สถานะที่ผู้ใช้ต้องเข้าใจ

| สถานะ                   | หมายความว่า                                 | สิ่งที่ควรทำ                               |
| ----------------------- | ------------------------------------------- | ------------------------------------------ |
| **READY**               | ส่วนที่กำลังตรวจผ่าน Health Readback ล่าสุด | เริ่มงานได้ในขอบเขตสิทธิ์ของตน             |
| **WAITING\_APPROVAL**   | มีการกระทำที่ต้องอนุมัติเฉพาะรายการ         | อ่านรายละเอียดแล้วอนุมัติ/ปฏิเสธ           |
| **WAITING\_PERMISSION** | ยังไม่มีสิทธิ์หรือ Scope                    | ใช้บัญชี/สิทธิ์ที่ได้รับอนุญาต             |
| **BLOCKED**             | Policy/Route/Provider ปฏิเสธ                | อ่านเหตุผล แก้เฉพาะจุดที่ติด ไม่รันทดสอบวน |
| **FAILED**              | Provider หรือการตรวจหลักฐานล้มเหลว          | ดู Error + Evidence แล้วแก้                |
| **COMPLETED**           | มี Provider Result และ Evidence รองรับ      | เปิดผลลัพธ์/Receipt                        |

## หลักฐาน Production ล่าสุด (14 ต.ค. 2026)

* Owner UI-only Workroom Restart: [GitHub Actions #38572195491](https://github.com/tdealer01-crypto/DSG-Private-Production-Runtime/actions/runs/38572195491) **SUCCESS**.
* AWS SSM Independent Readback: Local Desktop UI และ Public `/control/health` ตอบ **HTTP 200** โดย `workroom_store=true`; Spacetime, Cinema, DSG ONE, Relay **Healthy**; UI/Spacetime ใช้ Immutable Image เดิม
* Governed Spacetime Provider Read-only: `route.github-public.repo-metadata-read` **ALLOW + real result + Ed25519 signature verified against AWS-pinned key**; Evidence Chain **valid=true, 167 records** ในรอบตรวจนั้น
* **ยังไม่อ้างว่าผ่าน:** Native UI-origin Human Approval → Signed Permit → Browser/Device Execute → Evidence และ XR/Quest Full-System E2E. แยกหลักฐานตามขอบเขตเสมอ

**หลักฐานละเอียด:** [Production Issue #677](https://github.com/tdealer01-crypto/DSG-Private-Production-Runtime/issues/677#issuecomment-6169655413)

## แก้ปัญหาโดยไม่วนขั้นตอนเดิม

* เปิดเว็บแล้ว **503**: ตรวจ [Health](https://dsg.pics/control/health) ก่อน; อย่ารัน Build/Deploy ใหม่เพียงเพราะหน้าเว็บไม่เปิด
* **ขออนุมัติไม่ได้**: ดู OAuth Principal และ Scope ปัจจุบัน; การเชื่อมต่อได้ไม่ได้แปลว่ามีสิทธิ์ Execute
* **Provider ไม่พร้อม**: ตรวจสถานะ Route/Provider เฉพาะตัว ไม่ถือว่า Health ของ Spacetime พิสูจน์ว่า Cinema/RDC Execute ได้
* **ไม่พบ Evidence**: คงสถานะ `NOT_VERIFIED` จนได้หลักฐานจาก Run จริง

คู่มือเต็มและเอกสารเชิงสถาปัตยกรรมเป็นข้อมูลประกอบ **หลังเริ่มใช้งาน** ไม่ใช่เงื่อนไขให้ทำงานได้