Cursor AI编辑器：深度使用指南

from dataclasses import dataclass, fieldfrom typing import List, Dict, Optionalfrom enum import Enum class EditMode(Enum):    TAB_COMPLETE = "tab_complete"    INLINE_EDIT = "inline_edit"    CHAT = "chat"    AGENT = "agent" class ContextSource(Enum):    CURRENT_FILE = "current_file"    OPEN_FILES = "open_files"    CODEBASE_INDEX = "codebase_index"    WEB_SEARCH = "web_search"    RULES_FILE = "rules_file"    DOC_REF = "doc_ref" @dataclassclass CursorContext:    sources: List[ContextSource] = field(default_factory=list)    codebase_indexed: bool = False    rules_file: Optional[str] = None    referenced_docs: List[str] = field(default_factory=list)     def build_prompt(self, user_input: str) -> str:        parts = [user_input]        if ContextSource.CODEBASE_INDEX in self.sources and self.codebase_indexed:            parts.append("[Context: Codebase indexed - AI has full project understanding]")        if self.rules_file:            parts.append(f"[Rules: {self.rules_file}]")        for doc in self.referenced_docs:            parts.append(f"[Doc ref: {doc}]")        return "\n".join(parts) @dataclassclass EditResult:    mode: EditMode    files_modified: List[str]    lines_added: int    lines_removed: int    success: bool    review_notes: str = "" class CursorAgent:    def __init__(self, context: CursorContext):        self.context = context        self.execution_log: List[Dict] = []     def execute_task(self, task_desc: str, mode: EditMode) -> EditResult:        prompt = self.context.build_prompt(task_desc)        self.execution_log.append({            "step": len(self.execution_log) + 1,            "action": "analyze_task",            "mode": mode.value,            "prompt_length": len(prompt)        })        if mode == EditMode.AGENT:            return self._run_agent_mode(task_desc)        elif mode == EditMode.CHAT:            return self._run_chat_mode(task_desc)        elif mode == EditMode.INLINE_EDIT:            return self._run_inline_edit(task_desc)        else:            return self._run_tab_complete(task_desc)     def _run_agent_mode(self, task_desc: str) -> EditResult:        steps = []        steps.append("Parse task and identify affected files")        steps.append("Read dependencies via codebase index")        steps.append("Generate modification plan")        steps.append("Apply changes to all target files")        steps.append("Verify interface consistency")        for s in steps:            self.execution_log.append({"step": len(self.execution_log) + 1, "action": s})        return EditResult(            mode=EditMode.AGENT,            files_modified=["user_service.py", "auth_controller.py", "models/user.py"],            lines_added=45,            lines_removed=12,            success=True,            review_notes="Agent auto-modified 3 files maintaining interface consistency"        )     def _run_chat_mode(self, task_desc: str) -> EditResult:        self.execution_log.append({"step": len(self.execution_log) + 1, "action": "generate_explanation"})        return EditResult(            mode=EditMode.CHAT,            files_modified=[],            lines_added=0,            lines_removed=0,            success=True,            review_notes="Chat provided code explanation, no files modified"        )     def _run_inline_edit(self, task_desc: str) -> EditResult:        self.execution_log.append({"step": len(self.execution_log) + 1, "action": "apply_inline_diff"})        return EditResult(            mode=EditMode.INLINE_EDIT,            files_modified=["main.py"],            lines_added=8,            lines_removed=3,            success=True,            review_notes="Inline edit applied to single file"        )     def _run_tab_complete(self, task_desc: str) -> EditResult:        return EditResult(            mode=EditMode.TAB_COMPLETE,            files_modified=["main.py"],            lines_added=1,            lines_removed=0,            success=True,            review_notes="Single line completion via Tab"        )     def get_execution_summary(self) -> Dict:        return {            "total_steps": len(self.execution_log),            "steps": self.execution_log,            "context_sources": [s.value for s in self.context.sources]        } class CodebaseIndexer:    def __init__(self):        self.index: Dict[str, Dict] = {}        self.index_version = 0     def index_file(self, path: str, content: str, imports: List[str]):        self.index[path] = {            "content_hash": hash(content),            "imports": imports,            "symbols": self._extract_symbols(content),            "lines": len(content.splitlines())        }        self.index_version += 1     def _extract_symbols(self, content: str) -> List[str]:        symbols = []        for line in content.splitlines():            stripped = line.strip()        return symbols     def find_dependents(self, target_file: str) -> List[str]:        dependents = []        for path, info in self.index.items():            if target_file in info.get("imports", []):                dependents.append(path)        return dependents     def is_stale(self, file_path: str, current_hash: int) -> bool:        info = self.index.get(file_path)        if not info:            return True        return info["content_hash"] != current_hash if __name__ == '__main__':    ctx = CursorContext(        sources=[ContextSource.CODEBASE_INDEX, ContextSource.RULES_FILE, ContextSource.DOC_REF],        codebase_indexed=True,        rules_file=".cursorrules",        referenced_docs=["@api_design.md"]    )    agent = CursorAgent(ctx)    result = agent.execute_task("Refactor user authentication to use JWT tokens", EditMode.AGENT)    print(f"Mode: {result.mode.value}")    print(f"Files modified: {result.files_modified}")    print(f"Lines: +{result.lines_added} -{result.lines_removed}")    print(f"Review: {result.review_notes}")    print(f"\nExecution summary:")    print(json.dumps(agent.get_execution_summary(), indent=2, ensure_ascii=False))