# 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` جو بھی چیز شامل یا تبدیل کرتی ہے، اس پر آپ کی کمپنی کے ڈیٹا کے تحفظ کے قواعد لاگو ہوتے ہیں اور اسے آپ کے [آڈٹ لاگ](/docs/teams/audit-log) میں درج کیا جاتا ہے، بالکل Dvina کے دوسرے اقدامات کی طرح۔

## متعلقہ صفحات

- [MCP کے ذریعے دوسری ایپس سے Dvina استعمال کریں](/docs/dvina-mcp/overview)
- [ٹاسکس](/docs/use-dvina/features/tasks)
- [کنیکٹرز کا جائزہ](/docs/connectors/overview)
