# 「記住」工具

> 透過 MCP 用戶端或 dvina 指令，記住文字或連結、列出已記住的內容，以及忘記內容。

透過 Dvina 的 MCP 工具或 `dvina` 指令，其他 app 可以替你記住內容，就像在 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` | 來源 app，例如你的 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>
```

## 適用規則

- 工具會以你的身分操作你自己的已記住項目，權限取決於你的角色。
- 用戶端記住的內容會經過你公司的資料保護規則檢查，與在 app 中一樣。如果規則不允許，便不會記住任何內容，用戶端也會收到原因。
- 這些工具不支援記住圖片。請在 Dvina 中或透過手機的分享選單記住圖片。

## 相關內容

- [記住重點](/docs/use-dvina/features/keep-in-mind)
- [透過 MCP 在其他 app 中使用 Dvina](/docs/dvina-mcp/overview)
- [使用 dvina 指令](/docs/dvina-mcp/cli)