# Alat Simpan dalam Ingatan

> Simpan teks atau pautan, senaraikan perkara yang anda simpan dan lupakan sesuatu melalui klien MCP atau perintah dvina.

Dengan alat MCP Dvina atau perintah `dvina`, aplikasi lain boleh menyimpan sesuatu dalam ingatan untuk anda, sama seperti memilih **Simpan** dalam Dvina. Perkara yang disimpan itu milik anda: ia muncul dalam **Disimpan** di Suapan anda, Dvina menemuinya apabila anda bertanya, dan ia boleh membantu Dvina mengingatkan anda semula apabila diperlukan. Untuk mengetahui lebih lanjut tentang ciri Simpan dalam Ingatan, lihat [Simpan dalam Ingatan](/docs/use-dvina/features/keep-in-mind).

## Alat

| Alat MCP   | Perintah          | Fungsinya                                                    | Minta izin dahulu |
| ---------- | ---------------- | --------------------------------------------------------------- | ---------- |
| `kept_add` | `dvina kept add` | Menyimpan teks atau pautan.                                          | Tidak         |
| `kept_ls`  | `dvina kept ls`  | Menyenaraikan perkara yang anda simpan, daripada yang terbaharu, atau hanya yang sepadan dengan perkataan tertentu. | Tidak         |
| `kept_rm`  | `dvina kept rm`  | Melupakan sesuatu yang anda simpan. Item itu dipindahkan ke **Baru Dipadam**.   | Ya        |

## Simpan teks atau pautan

`kept_add` menyimpan teks, pautan, atau teks bersama pautan sumbernya. Berikan sekurang-kurangnya `text` atau `url`.

| Input       | Maksudnya                                                               | Had            |
| ----------- | ------------------------------------------------------------------------ | ---------------- |
| `text`      | Teks yang hendak disimpan.                                                       | 5,000 aksara |
| `url`       | Halaman atau pautan sumber teks, atau pautan yang hendak disimpan. http(s) sahaja. | 2,048 aksara |
| `title`     | Tajuk sumbernya, seperti tajuk halaman atau dokumen.     | 500 aksara   |
| `sourceApp` | Aplikasi sumbernya, seperti nama klien MCP anda.                 | 200 aksara   |

Alat ini mengembalikan `id` item yang disimpan, `kind` (`text` atau `link`) dan `title` item tersebut.

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

Menyimpan teks yang sama daripada sumber yang sama sekali lagi tidak menghasilkan item kedua.

## Senaraikan perkara yang anda simpan

`kept_ls` menyenaraikan item yang anda simpan, daripada yang terbaharu.

| Input    | Maksudnya                                        |
| -------- | ------------------------------------------------- |
| `query`  | Hanya item yang teks, tajuk atau pautannya mengandungi pertanyaan ini. |
| `limit`  | Bilangan item yang hendak dikembalikan, sehingga 100. Nilai lalai ialah 20. |
| `cursor` | Kedudukan akhir halaman sebelumnya, untuk mendapatkan halaman seterusnya.  |

Setiap item mempunyai `id`, `kind` (`text`, `image` atau `link`), `title`, `text`, `url`, `sourceType` (tempat item itu disimpan, seperti `chat` atau `mcp`), `sourceApp` dan `createdAt`. Jika ada lagi item, hasilnya menyertakan `nextCursor`; dengan perintah, senarai berakhir dengan `next: --cursor <c>`.

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

## Lupakan sesuatu yang anda simpan

`kept_rm` melupakan satu item yang disimpan berdasarkan `id` item tersebut. Seperti perubahan lain, alat ini meminta izin anda dahulu: Dvina memaparkan tajuk item, dan anda meluluskan atau menolak permintaan itu. Apabila anda meluluskannya, item itu dipindahkan ke **Baru Dipadam**, dan anda boleh memulihkannya dalam tempoh 30 hari.

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

## Perkara yang perlu diketahui

- Alat ini bertindak sebagai anda, pada item yang anda simpan sendiri, mengikut kebenaran peranan anda.
- Perkara yang disimpan oleh klien tertakluk pada peraturan perlindungan data syarikat anda, sama seperti dalam aplikasi. Jika peraturan tidak membenarkannya, tiada apa-apa disimpan dan klien menerima sebabnya.
- Alat ini tidak menyokong penyimpanan gambar. Simpan gambar dalam Dvina atau melalui menu perkongsian telefon anda.

## Berkaitan

- [Perkara yang perlu diingat](/docs/use-dvina/features/keep-in-mind)
- [Gunakan Dvina daripada app lain dengan MCP](/docs/dvina-mcp/overview)
- [Gunakan perintah dvina](/docs/dvina-mcp/cli)