# 记住工具

> 通过 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)