[Cursor] Notepads

官方描述：

Craft and share context between chat and composers

在聊天和代码编辑器之间构建并共享上下文。

• Notepad：笔记本，你可以在笔记本里面记录一些内容，供 AI 作为参考信息。

首先在资源管理器需要开启 Notepads，如下图：

笔记内容会自动注入到 AI 的上下文中，影响它对代码、问题和对话的理解。简单说，就是帮 AI“提前看过项目文档”。

1. 使用场景举例

假设创建一个如下的 Notepad

📌 模块：用户管理模块

✅ 接口：GET /api/users

- 返回活跃用户列表（isActive = true）
- 支持通过 query 参数筛选 role
- 默认分页大小为 20，最大为 100

📦 响应字段说明：

- id: string，用户唯一标识
- name: string，用户名
- roles: string[]，可包含 "admin" | "editor" | "viewer"
- createdAt: ISO8601 字符串
- isActive: boolean，是否处于激活状态

⚠️ 注意事项：

- 部分老用户的 `roles` 字段可能为 null，请使用空数组兜底处理
- 若无数据，返回空数组 `[]`，不会返回 null

📍 示例请求：
GET /api/users?role=editor&page=2

给 AI 提问

“为什么我的 `users.length` 总是比预期少？”

“你请求的是 `/api/users`，根据笔记说明它只返回 `isActive = true` 的用户，建议确认是否有部分用户是未激活状态。”

2. 如何创建 Notepads？

3. 和 CursorRules 的区别

• Notepads 就像你平时写的一些项目备注（比如接口参数说明、组件行为约定、状态流程图解等），可以作为 Notepad 保存。

• 启用这个功能后，你每次打开 Chat 与 AI 对话时，Cursor 会自动把这些 Notepad 笔记传给 AI 模型；

• 这样 AI 就像提前“读过你写的文档”，它可以在回答你的问题时参考这些内容，给出更准确、更符合项目上下文的回答。

• Rules：行为规范，指导 AI 应该怎么做。

• Notepads：上下文信息，告诉 AI 发生了什么，你结合这个背景信息，自己去判断该做什么。

---

-EOF-