wiki-ingest batch 9: ChinaTextbook/Clonezilla/Cursor2.0/VibeCoding

wiki/sources/Cursor-2-0初学者使用指南.md

@@ -1,50 +1,70 @@
 ---
 title: "Cursor 2.0 初学者使用指南"
 type: source
-tags: [ai, cursor, ide, mcp, vibe-coding]
-date: 2026-04-15
+tags: [AI编程, Cursor, IDE, AI代理]
+date: 2025-12-19
 ---
 
 ## Source File
 - [[raw/Vibe Coding/Cursor 2.0初学者使用指南.md]]
 
 ## Summary
-- 核心主题：Cursor 2.0 AI 代码编辑器功能与使用方法，面向初学者
-- 问题域：如何高效使用 AI 辅助编程工具完成项目开发
-- 方法/机制：明确需求 → AI 规划 → 代码生成 → 多代理并行执行 → Diff 审查 → Git 版本控制
-- 结论/价值：Cursor 2.0 将 AI 编程效率提升至"想法→可维护代码"的可审计流水线
+- 核心主题：Cursor 2.0 AI 代码编辑器完整入门教程
+- 问题域：初学者如何高效使用 AI 辅助编程工具
+- 方法/机制：规划驱动 → 多代理并行 → Diff 审查 → Git 版本控制
+- 结论/价值：Cursor 2.0 将 AI 代码生成整合进 VS Code，通过 Plan/Agent/Ask 三种模式实现精准控制
 
 ## Key Claims
-- Cursor 2.0 的 Composer 模型生成速度比同类模型快 4 倍
-- 多代理并行（Plan/Agent/Ask 三模式）可同时运行不同任务，互不干扰
-- AI 生成代码即写入文件，必须先测试再确认，未点撤销前持续保留
-- Diff 视图是代码审查核心功能，支持逐文件审查或整体接收
+- Cursor 内置自研 [[Composer模型]]，生成速度比同类模型快 4 倍
+- AI 生成代码在 Diff 确认前已写入文件，**不是草稿状态**，需先测试再接受
+- [[MCP服务器]]（Model Context Protocol）允许 AI 代理集成外部 API 和工具，扩展能力边界
+- 多代理并行时，每个代理有独立上下文；继续同一任务应在同一代理内继续，避免上下文混乱
 
-## Key Quotes
-> "在向 AI 代理发出生成代码请求前，需明确项目目标" — 规划重要性
-> "代码生成即写入文件，先测试再保存" — 易错点提醒
-> "Agent 模式会修改代码，Ask 模式仅提供文本答案，不会改动代码" — 模式区分
+## Agent Modes（三核心模式）
+| 模式 | 行为 | 风险 |
+|------|------|------|
+| Plan | AI 生成开发计划（Markdown），用户可修改 | 无副作用，仅生成文本 |
+| Agent | AI 执行计划，读写文件，执行命令 | **会修改代码**，需审查 |
+| Ask | AI 回答问题，提供解释 | 无副作用，仅返回文本 |
 
-## Key Concepts
-- [[AI代码编辑器]]：集成 AI 辅助的代码编辑器（Cursor/Windsurf/Trae）
-- [[Composer模型]]：Cursor 自研 AI 生成模型，主打速度优势
-- [[多代理并行]]：多个 AI 代理同时运行不同任务，提升生成效率
-- [[Diff审查]]：通过文件对比视图审查 AI 生成代码改动的机制
-- [[项目规则]]：可自定义的 AI 行为规范文件（如强制生成 Doc 注释）
-- [[MCP服务器]]：通过 Model Context Protocol 集成外部工具
+## 核心工作流
+
+### 规划驱动开发
+1. 明确项目目标（游戏/网站/后端工具）
+2. 用语音或文字向 AI 描述需求
+3. AI 生成 Plan 模式开发计划（Markdown 形式）
+4. 用户修改或批准计划
+
+### 代码生成与审查
+1. 启动 Agent 模式执行计划
+2. 代码生成即写入文件（**非草稿**）
+3. Diff 视图逐文件审查改动
+4. 运行测试，确认无误后接受
+5. 未点"撤销"前可随时回退
+
+### 多代理并行
+- 场景：同时开发游戏核心逻辑和 Landing Page
+- 每个代理有独立上下文，不相互干扰
+- 同一任务在同一代理内继续效果更佳
 
 ## Key Entities
-- [[Cursor]]：基于 VS Code 的 AI 代码编辑器
-- [[Git]]：版本控制系统，Cursor 推荐结合使用
-- [[VS Code]]：Cursor 的底层编辑器框架
-- [[MCP]]：Model Context Protocol，工具集成协议
+- [[Cursor]]：基于 VS Code 的 AI 增强代码编辑器，集成多 AI 模型
+- [[Composer模型]]：Cursor 自研 AI 模型，主打生成速度
+- [[MCP服务器]]：Model Context Protocol，AI 代理外部工具集成协议
+- [[Karpathy]]：提出"Vibe Coding"概念（AI 调整氛围，代码自动长出）
+
+## Key Concepts
+- [[Vibe Coding]]：以产品逻辑和用户流程为导向，将代码体力活交给 AI，自己做导演而非打字员
+- [[Diff审查]]：AI 生成代码后逐文件审查改动的视图机制
+- [[Git版本控制]]：AI 生成代码风险更高，建议立即 commit，配合撤销按钮实现安全回滚
+- [[项目规则文件]]：可在项目目录添加规则文件（如强制 Doc Strings），AI 自动遵守
 
 ## Connections
 - [[Cursor]] ← 基于 ← [[VS Code]]
-- [[Cursor]] ← 包含 ← [[Composer模型]]
-- [[Cursor]] ← 支持 ← [[MCP服务器]]
-- [[AI代码编辑器]] ← 包含 ← [[Cursor]] / [[Windsurf]] / [[Trae]]
-- [[Cursor]] ← 建议结合 ← [[Git]]（版本控制）
+- [[Cursor]] ← 集成 ← [[Composer模型]]
+- [[Cursor]] ← 扩展协议 ← [[MCP服务器]]
+- [[Vibe Coding]] ← 理论起源 ← [[Karpathy]]
 
 ## Contradictions
-
+- AI 生成即写入 vs 传统草稿模式：传统 AI 助手是"建议"，Cursor 是"直接执行"；用户需理解这是真实文件变更而非预览
+- Agent 模式 vs Ask 模式：Ask 仅文本回答不会改文件，但用户可能误用 Ask 去要求生成代码而得到不完整结果