# یاد رکھنے کے ٹولز

> MCP کلائنٹ یا dvina کمانڈ سے الفاظ یا لنک محفوظ کریں، اپنی محفوظ کردہ چیزوں کی فہرست دیکھیں اور کسی چیز کو بھلا دیں۔

Dvina کے MCP ٹولز یا `dvina` کمانڈ کے ذریعے کوئی دوسری ایپ آپ کے لیے کسی چیز کو یاد رکھ سکتی ہے، بالکل ایسے ہی جیسے آپ Dvina میں **محفوظ کریں** منتخب کرتے ہیں۔ جو کچھ وہ محفوظ کرتی ہے وہ آپ کا ہے: وہ آپ کی فیڈ میں **محفوظ کردہ** میں نظر آتا ہے، آپ کے پوچھنے پر Dvina اسے تلاش کرتی ہے، اور یہ Dvina کو مناسب وقت پر اسے دوبارہ سامنے لانے میں مدد دے سکتا ہے۔ یاد رکھنے کی سہولت کے بارے میں جاننے کے لیے [یاد رکھیں](/docs/use-dvina/features/keep-in-mind) دیکھیں۔

## ٹولز

| MCP ٹول   | کمانڈ          | یہ کیا کرتا ہے                                                    | کیا پہلے اجازت مانگتا ہے؟ |
| ---------- | ---------------- | --------------------------------------------------------------- | ---------- |
| `kept_add` | `dvina kept add` | الفاظ یا لنک محفوظ کرتا ہے۔                                          | نہیں         |
| `kept_ls`  | `dvina kept ls`  | آپ کی محفوظ کردہ چیزوں کی فہرست دکھاتا ہے، سب سے نئی چیز پہلے، یا صرف وہ چیزیں جو کسی لفظ سے میل کھاتی ہیں۔ | نہیں         |
| `kept_rm`  | `dvina kept rm`  | آپ کی محفوظ کردہ کسی چیز کو بھلا دیتا ہے۔ وہ **حال ہی میں حذف کردہ** میں منتقل ہو جاتی ہے۔   | ہاں        |

## الفاظ یا لنک محفوظ کریں

`kept_add` الفاظ، لنک، یا الفاظ کے ساتھ ان کا اصل لنک محفوظ کرتا ہے۔ کم از کم `text` یا `url` دیں۔

| ان پٹ       | یہ کیا ہے                                                               | حد            |
| ----------- | ------------------------------------------------------------------------ | ---------------- |
| `text`      | محفوظ کرنے کے لیے الفاظ۔                                                       | 5,000 حروف |
| `url`       | وہ صفحہ یا لنک جہاں سے الفاظ لیے گئے ہیں، یا وہ لنک جسے محفوظ کرنا ہے۔ صرف http(s)۔ | 2,048 حروف |
| `title`     | اس ماخذ کا عنوان جہاں سے یہ لیا گیا ہے، مثلاً صفحے یا دستاویز کا عنوان۔     | 500 حروف   |
| `sourceApp` | وہ ایپ جہاں سے یہ لیا گیا ہے، مثلاً آپ کے MCP کلائنٹ کا نام۔                 | 200 حروف   |

یہ محفوظ کردہ آئٹم کا `id`، اس کی `kind` (`text` یا `link`) اور اس کا `title` واپس کرتا ہے۔

```sh
dvina kept add "Bright & Co. includes permits and can start Nov 17." --url https://example.com/quote --title "Kitchen quote"
```

ایک ہی جگہ سے لیے گئے وہی الفاظ دوبارہ محفوظ کرنے سے دوسرا آئٹم نہیں بنتا۔

## اپنی محفوظ کردہ چیزوں کی فہرست دیکھیں

`kept_ls` آپ کے محفوظ کردہ آئٹمز کی فہرست دکھاتا ہے، جس میں سب سے نئے آئٹمز پہلے ہوتے ہیں۔

| ان پٹ    | یہ کیا ہے                                        |
| -------- | ------------------------------------------------- |
| `query`  | صرف وہ آئٹمز جن کے الفاظ، عنوان یا لنک میں یہ موجود ہو۔ |
| `limit`  | کتنے آئٹمز واپس کرنے ہیں، زیادہ سے زیادہ 100۔ پہلے سے طے شدہ تعداد 20 ہے۔ |
| `cursor` | پچھلا صفحہ جہاں ختم ہوا تھا، تاکہ اگلا صفحہ حاصل کیا جا سکے۔  |

ہر آئٹم میں اس کا `id`، `kind` (`text`، `image` یا `link`)، `title`، `text`، `url`، `sourceType` (اسے کہاں محفوظ کیا گیا تھا، مثلاً `chat` یا `mcp`)، `sourceApp` اور `createdAt` شامل ہوتے ہیں۔ اگر مزید آئٹمز ہوں تو نتیجے میں `nextCursor` ہوتا ہے؛ کمانڈ استعمال کرنے پر فہرست کے آخر میں `next: --cursor <c>` آتا ہے۔

```sh
dvina kept ls --query permits --limit 5
```

## اپنی محفوظ کردہ کسی چیز کو بھلا دیں

`kept_rm` کسی ایک محفوظ کردہ آئٹم کو اس کے `id` کے ذریعے بھلا دیتا ہے۔ دوسری تبدیلیوں کی طرح یہ بھی پہلے آپ سے اجازت مانگتا ہے: Dvina آئٹم کا عنوان دکھاتی ہے، اور آپ اسے منظور یا مسترد کرتے ہیں۔ آپ کے منظور کرنے پر وہ **حال ہی میں حذف کردہ** میں منتقل ہو جاتا ہے، جہاں سے آپ اسے 30 دن تک بحال کر سکتے ہیں۔

```sh
dvina kept rm <id>
```

## لاگو ہونے والے اصول

- یہ ٹولز آپ کی حیثیت سے، آپ کے اپنے محفوظ کردہ آئٹمز پر، آپ کے کردار کو حاصل اجازتوں کے مطابق کام کرتے ہیں۔
- کلائنٹ جو کچھ محفوظ کرتا ہے اس پر آپ کی کمپنی کے ڈیٹا کے تحفظ کے اصول لاگو ہوتے ہیں، بالکل ایپ کی طرح۔ اگر کوئی اصول اس کی اجازت نہ دے تو کچھ بھی محفوظ نہیں ہوتا اور کلائنٹ کو وجہ بتا دی جاتی ہے۔
- ان ٹولز سے تصویر محفوظ کرنے کی سہولت دستیاب نہیں ہے۔ تصاویر Dvina میں یا اپنے فون کی شیئر شیٹ سے محفوظ کریں۔

## متعلقہ

- [ذہن میں رکھیں](/docs/use-dvina/features/keep-in-mind)
- [MCP کے ذریعے دوسری ایپس سے Dvina استعمال کریں](/docs/dvina-mcp/overview)
- [dvina کمانڈ استعمال کریں](/docs/dvina-mcp/cli)