Chat

一、概念速览（只看思路、不看细节）

二、操作速查（What → Why → How）

使用顺序推荐

1. 打开 Chat (⌘ L) → 选择合适模式 (⌘ .)
2. 描述需求
3. Review → Apply → Accept（如需）
4. 若不满意：Restore Checkpoint 回滚

Tool

一、概念速览

二、操作速查（What → Why → How）

阅读技巧

1. Search 类

2. Edit 类

3. Run 类

4. MCP Servers

5. Advanced Options

推荐实践流程

1. 搜索：先用 Search 工具锁定目标文件/目录/规则。
2. 编辑：用 Edit & Reapply 或 Delete File 执行改动。
3. 运行验证：让 Terminal 或 Auto‑run 跑测试。
4. MCP 集成：需要外部服务时再 Toggle MCP。
5. 高级自动化：在 Custom Mode 中开启 Auto‑apply/Auto‑fix 提升效率。

记得监控工具调用次数，上限 25 次，点Continue

CMD+ K

一、CMD K Prompt Bar

1. 概念速览

2. 操作速查

二、Terminal CMD K

1. 概念速览

2. 操作速查

推荐实际用法

1. 编码时:
   • ⌘ K → “实现一个 debounce 函数” → 生成新代码
   • 后续 ⌘ K （选中函数）→ “重命名参数并添加类型注解”
2. 终端操作:
   • 在终端 ⌘ K → “启动本地 PostgreSQL 并查看日志” → 生成命令 → ⌘ Enter 运行
   • 出现错误时按 ⌘ K → “解决端口占用并重试”

这样即可在 编辑区和终端 都用一键 Prompt Bar 获取 AI 助手，提升开发速度。

快捷键

General

Chat

These shortcuts work while focused on the chat input box.

Cmd+K

Code Selection & Context

Tab

Terminal

NotePads

如果没有显示NotePads区域，把菜单全部收起，右键空白地方，显示

一、概念速览

二、操作速查（What → Why → How）

使用建议

• 将 项目架构、接口规范、代码模板 等长期有效内容放入 Notepads。
• 临时备忘或敏感信息不要写在 Notepads。

三、典型场景

1. 动态脚手架：保存常用文件/目录模板，创建新功能时一句 @Frontend Scaffold 即可生成骨架。
2. 团队开发规范：把代码风格、Commit 规范写进 Notepad，让新人快速对齐。
3. 系统架构文档：集中维护微服务、数据模型、API 设计，随时 @Architecture Notes 引用。

四、Notepad 示例代码

下面是一份面向 Web API 项目 的 Notepad 模板，可直接贴到 Cursor 的 Notepad 编辑器中使用：

# API Development Guidelines

## Endpoint Structure
- Use RESTful conventions
- Base URL: `/api/v1`
- Resource naming in plural form

## Authentication
- JWT-based authentication
- Token format: Bearer {token}
- Refresh token mechanism required

## Response Format
{
  "status": "success|error",
  "data": {},
  "message": "Optional message"
} 

## Attached References
@api-specs.yaml
@auth-flow.md

Rules

一、概念速览

二、操作速查（What → Why → How）

最佳实践

• 聚焦单一主题，<500 行为佳；大块内容拆分多条 Rule。
• 提供示例或 @file.ts 引用，让 AI 有可执行上下文。
• 重复用到的提示都写成 Rule，减少手打 prompt。

三、MDC 规则示例

将以下内容保存为 .cursor/rules/api-validation.mdc：

---
description: API 验证标准
globs:
  - "src/api/**"
alwaysApply: false           # Manual 规则；需手动 @api-validation
---

## API 验证规范
1. **统一使用 zod** 定义请求与返回值。
2. 每个接口必须导出 `type ApiResponse`。
3. 对错误返回使用 `status: "error"`，并附错误码。

@error-codes.ts            # 引用常用错误码枚举

使用方式

1. 任何时候在 Chat / Cmd K 输入 @api-validation，该 Rule 与 error-codes.ts 会被一并注入上下文
2. 若想自动触发，可改 alwaysApply: true 或改为 Agent Requested 并添加描述字段。