跳转到正文
编程实战篇约 4 分钟
打开原图 ↗

Cursor 实战上手指南 ​

动手装环境、配 MCP 之前,建议先走一遍官方入门课 Cursor Learn:讲清模型怎么工作、边界在哪,以及和 AI 协作写代码的常见模式。概念对齐后,再按下面的 10 分钟清单落地,少踩「生成了但跑不通」的坑。

Cursor 实战上手指南(10分钟) ​

1. 安装 Cursor 并开通账号 ​

  • 第三方渠道:可在 闲鱼搜索 购买月卡/额度卡(Auto模型,自行甄别风险与售后)。建议先看 PriceAI · Cursor 账号 聚合比价(不参与交易,以原平台为准),再按需下单: 月卡1 、 月卡2 、 月卡3
  • 官方订阅:$20/月(Cursor Pro 的用量通常是“额度池”)。
  • BYOK工具:
    • cursor-byok:本机跑 Cursor 模型网关,接入自有 OpenAI/Anthropic 兼容 API;
    • go-cursor-help:处理免费试用期常见限制。
  • 界面汉化:官方暂无完整中文界面。可用 cursor-localization-zh(可选);
text
帮我汉化cursor,用这个方案https://github.com/vibepm666/cursor-localization-zh

2. 配置 MCP ​

#工具职能与场景必装
1Codegraph本地代码图谱:大仓导航、调用链与影响面分析✅
2Context Mode上下文窗口优化:沙箱化工具输出、会话记忆持久化、跨平台路由✅
3DBX MCP接 DBX 查结构/跑 SQL;自然语言查表查数✅
4Context7注入当前版官方文档;查最新 API、减幻觉✅
5anysearch统一实时搜索(通用/垂域/批量/URL 抽取)✅
6mcp-feedback-enhanced本地反馈增强:长等待、传图、断网重连☐
7Sequential Thinking深度推理;方案推演、复杂 Bug 根因☐
8Time Server精确时间基准;日志时间戳禁止猜测☐
9tavily-remote-mcp网页检索/抽取/爬取/调研(需 API Key)☐
10DeepWiki外部知识检索;补最新文档缺口☐
11Browser ControlWeb 交互与调试;UI/E2E/截图录屏☐
12spec-workflow-mcp规格驱动(需求→设计→任务);审批与进度☐
13Playwright MCP浏览器自动化;E2E/抓取;可与 Browser Control 二选一☐
14Zvec MCP向量库操作(Collection/CRUD/语义搜索);对话内直连 Zvec☐

3. 在 Cursor 中打开项目 ​

  1. 打开 Cursor,选择 Agent 模式
  2. 在项目里建 Codegraph 索引:
bash
codegraph init

首次使用需先全局安装 CLI:npm install -g @colbymchenry/codegraph;codegraph install --target cursor --yes;建图完成后重启 Cursor。

  1. 输入初始化提示词(下方示例面向 Java 项目;其他技术栈可在 Plainraw 自行生成对应 URL):
text
读取并严格执行:https://plainraw.com/raw/yq-project-init
  1. 把项目相关文档放进 Agent 可读的资料目录(常见为 docs/ref/ 或 Init 后规划出的目录),需求/设计/接口说明都往这里丢即可。

Word / PPT / Excel / PDF 等先转成 Markdown,再放进该目录:

  • anydoc:本地/浏览器转 Markdown,14 种办公格式,文件不出设备
  • MinerU 在线解析:复杂 PDF、扫描件、版式文档更合适

5. Cursor Skills 实战 ​

用 Skills 把同一份内容交付为 PPT、公众号、动画、原型。Agent 模式下 @ 引用源文件;未识别时说明「按 SKILL.md 执行」。更多规范见:Agent Skills。

技能管理客户端:Skills Manager(开源桌面端 + CLI)。技能只装一次,可分发给 Cursor、Claude Code、Codex 等;支持从 Git / zip / skills.sh 安装,全局与项目工作区同步。装好后技能落在 ~/.cursor/skills,Cursor 无需额外配置。

推荐先装:Waza(think / write / read / learn 等工程习惯技能,一次分发到 Claude Code、Codex、Cursor):

bash
npx skills add tw93/Waza -a claude-code codex cursor -g -y
Skill交付物安装
dashi-ppt-skill演示文稿 / 可编辑 PPTXnpx dashi-ppt-skill@latest
gzh-design-skill公众号粘贴 HTMLnpx skills add https://github.com/isjiamu/gzh-design-skill -g -y
Jacky Motion16:9 录屏动画 HTMLnpx skills add https://github.com/Jackywxsz/jacky-motion --skill jacky-motion2-0-srt -g -y
remotion-video-toolkit16:9 MP4 教程视频npx skills add https://github.com/shreefentsar/remotion-video-toolkit -g -y
huashu-design可点击 Web/App 原型npx skills add alchaincyf/huashu-design -g -y

发现问题或有实践经验想分享? 参与讨论 ↗

把 AI 从「会聊天」推进到「能稳定交付」