# 記在心上工具

> 透過 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)