# ابزارهای به خاطر سپردن

> از طریق یک کلاینت MCP یا با فرمان dvina، متن یا پیوندی را نگه دارید، مواردی را که نگه داشته‌اید فهرست کنید و موردی را از یاد ببرید.

با ابزارهای MCP در Dvina یا فرمان `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)
- [استفاده از Dvina در برنامه‌های دیگر با MCP](/docs/dvina-mcp/overview)
- [استفاده از دستور dvina](/docs/dvina-mcp/cli)