# ใช้คำสั่ง dvina

> เรียนรู้ว่าคำสั่ง dvina ทำอะไรเมื่อ Dvina รันโค้ดให้คุณ มีคำสั่งใดบ้าง และคำสั่งใดต้องขออนุมัติจากคุณ

เมื่อ Dvina รันโค้ดหรือคำสั่งให้คุณ จะมีคำสั่งของตัวเองชื่อ `dvina` คำสั่งนี้ช่วยให้สคริปต์หรือขั้นตอนที่ทำต่อเนื่องกันค้นหาใน Dvina ของคุณ อ่านและเพิ่มเอกสาร ความจำ และงาน รวมถึงตรวจสอบว่าใครมีสิทธิ์เข้าถึงรายการหนึ่งได้ โดยดำเนินการในนามของคุณ

คุณไม่ต้องติดตั้งหรือลงชื่อเข้าใช้เพิ่มเติม Dvina จะใช้คำสั่งนี้เมื่อจำเป็นต่อคำขอของคุณ และคุณก็ขอให้ใช้ได้ เช่น "ใช้ dvina เพื่อแสดงรายการงานของฉัน แล้วเขียนสรุปเป็นโน้ต"

## วิธีทำงาน

- `dvina` ทำงานบน Dvina ของคุณในนามของคุณ ตามสิทธิ์ที่บทบาทของคุณอนุญาตและภายในขีดจำกัดการใช้งานตามปกติของคุณ
- สิทธิ์เข้าถึงจะมีอยู่เฉพาะช่วงที่ Dvina ดำเนินการตามคำขอของคุณ เมื่อจบคำตอบ คำสั่งนี้จะไม่สามารถเข้าถึง Dvina ของคุณได้อีก
- คำสั่งจะอ่านไฟล์หรือโฟลเดอร์เฉพาะเมื่อมีการระบุไว้ในคำสั่ง เช่น ไฟล์ที่จะอัปโหลด

## คำสั่ง

คำสั่งแบ่งเป็นกลุ่ม โดยใช้รูปแบบ `dvina <group> <command>` ตามด้วยอาร์กิวเมนต์และแฟล็กของคำสั่งนั้น

| กลุ่ม      | คำสั่ง                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: ค้นหาแชต เอกสาร ความจำ และโลกของคุณพร้อมกัน                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: แสดงรายการ อ่าน เพิ่ม หรือแก้ไขไฟล์ความจำของคุณ                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: หัวข้อของคุณ สิ่งที่ Dvina รู้เกี่ยวกับเรื่องหนึ่ง และ Feed ของคุณ                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: เอกสารและโฟลเดอร์ใน Library ของคุณ |
| `canvas`   | `ls`, `show`, `create`, `write-page`: แสดงรายการ อ่าน สร้าง หรือเขียนหน้าแคนวาสใหม่                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: งานเบื้องหลังของคุณ                                                        |
| `goals`    | `show`, `start`: งานที่ดำเนินการเพื่อบรรลุเป้าหมาย                                                                          |
| `schedule` | `ls`, `add`, `cancel`: ข้อความและการเตือนที่ตั้งเวลาไว้ ทั้งแบบครั้งเดียวหรือแบบเกิดซ้ำ                                              |
| `agents`   | `ls`, `show`, `create`, `update`: เอเจนต์ของคุณ                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: ทักษะของคุณ                                                                                |
| `projects` | `ls`, `show`: โปรเจ็กต์ของคุณ                                                                                             |
| `settings` | `get`, `set`: การตั้งค่าของคุณ เช่น การเปิดหรือปิดความจำ                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: ผู้ที่มีสิทธิ์เข้าถึงรายการ สิ่งที่ผู้อื่นแชร์กับคุณ และการให้หรือถอนสิทธิ์เข้าถึง  |

`dvina` ไม่สามารถลบสิ่งใดอย่างถาวร เปิดลิงก์สาธารณะ เชื่อมต่อหรือยกเลิกการเชื่อมต่อแอป หรือเปลี่ยนการตั้งค่าผู้ดูแลระบบหรือการเรียกเก็บเงินได้

### ความช่วยเหลือและผลลัพธ์

- `dvina --help` แสดงรายการกลุ่ม, `dvina <group> --help` แสดงรายการคำสั่งในกลุ่ม และ `dvina <group> <command> --help` แสดงรายการอาร์กิวเมนต์และแฟล็กของคำสั่ง
- ผลลัพธ์เป็นข้อความสั้นๆ เพิ่ม `--json` เพื่อรับผลลัพธ์เป็น JSON หรือใช้ `--fields` ตามด้วยรายการที่คั่นด้วยจุลภาค เช่น `--fields id,title` เพื่อเก็บเฉพาะบางฟิลด์
- รายการที่ยาวจะลงท้ายด้วย `next: --cursor <c>` รันคำสั่งอีกครั้งพร้อม `--cursor` นั้นเพื่อรับหน้าถัดไป
- หากต้องการอ่านค่าจากไฟล์ ให้เติม `-file` ต่อท้ายแฟล็กของค่านั้น เช่น `--content-file notes.md` คำสั่ง `dvina docs upload <file>` ใช้อัปโหลดไฟล์ และ `dvina skills add <folder>` ใช้เพิ่มโฟลเดอร์ทักษะพร้อมไฟล์ SKILL.md ของโฟลเดอร์นั้น

### รหัสออก

| รหัส | ความหมาย                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | เสร็จสิ้น                                                                         |
| `1`  | เกิดข้อผิดพลาดอื่น                                                    |
| `2`  | คำสั่งไม่ถูกต้อง ตรวจสอบ `--help` ของคำสั่ง                                     |
| `3`  | ไม่พบ                                                                    |
| `4`  | ถูกปฏิเสธ: สิทธิ์เข้าถึงของคุณ กฎของบริษัท หรือการคุ้มครองข้อมูลไม่อนุญาตให้ดำเนินการ |
| `5`  | ต้องได้รับการอนุมัติจากคุณ                                                       |
| `6`  | คุณถึงขีดจำกัดการใช้งานแล้ว                                              |

## อนุมัติการเปลี่ยนแปลง

- คำสั่งที่อ่านข้อมูลจะทำงานโดยไม่ขออนุมัติ
- คำสั่งที่เพิ่มสิ่งใหม่ เช่น `docs create`, `memory add` หรือ `tasks start` จะทำงานโดยไม่ขออนุมัติ คำสั่งเหล่านี้จะไม่เปลี่ยนแปลงสิ่งที่มีอยู่แล้ว
- คำสั่งที่เปลี่ยนแปลงหรือนำสิ่งใดออกจะขออนุมัติจากคุณก่อน ได้แก่ การย้าย การเปลี่ยนชื่อ การย้ายไปถังขยะ การแทนที่โน้ตหรือไฟล์ความจำ การเขียนหน้าแคนวาสใหม่ การเปลี่ยนแปลงเอเจนต์หรือทักษะ การหยุดงาน การยกเลิกข้อความที่ตั้งเวลาไว้ และการแชร์ Dvina จะแสดงการ์ดขออนุมัติในแชตพร้อมสรุปการเปลี่ยนแปลงที่ Dvina เขียนขึ้นเอง และจะขออนุมัติทุกครั้ง หากคุณปฏิเสธ จะไม่มีการเปลี่ยนแปลงใดๆ

สิ่งที่ `dvina` เพิ่มหรือเปลี่ยนแปลงจะผ่านการตรวจสอบตามกฎการคุ้มครองข้อมูลของบริษัทคุณ และบันทึกไว้ใน[บันทึกการตรวจสอบ](/docs/teams/audit-log) เช่นเดียวกับการดำเนินการอื่นๆ ของ Dvina

## ที่เกี่ยวข้อง

- [ใช้ Dvina จากแอปอื่นผ่าน MCP](/docs/dvina-mcp/overview)
- [งาน](/docs/use-dvina/features/tasks)
- [ภาพรวมตัวเชื่อมต่อ](/docs/connectors/overview)