Cursor 官方教程中文版

這一部分不是逐字翻譯，而是把 Cursor 官方資料按中文開發者常見問題重組。每頁都保留官方來源，方便你回到原始事實核驗。

閱讀方式：先看判斷和路徑，再進入具體章節。Cursor 的資料變化很快，模型、價格、用量和企業策略以官方頁面為準。

入門與賬號

入口層。先確認 Cursor 是什麼、怎麼安裝、怎麼遷移、模型和價格怎麼核驗，再進入 Agent 工作流。

Agent 工作流

執行層。Cursor Agent 把 instructions、tools、model 和 checkpoints 組合成一個可規劃、可執行、可回退的編碼迴圈。

上下文與定製

上下文層。Rules、MCP、Skills、Subagents、Hooks、Commands 和 Plugins 決定 Agent 能看見什麼、遵守什麼、什麼時候自動觸發。

CLI 與自動化

自動化層。Cursor CLI 把編輯器裡的 Agent 工作流帶到終端、指令碼和 CI 場景。

雲端 Agent

非同步執行層。Cloud Agents（原 Background Agents）、Bugbot、review 和遠端入口適合把長任務從本機切到雲端繼續跑。

整合、API 與 SDK

擴充套件層。Slack、GitHub、Linear、Admin API、Dashboard API、Marketplace 和 deeplinks 把 Cursor 接進外部系統。

團隊與企業治理

治理層。Team、Enterprise、SSO、SCIM、成員管理、隱私、analytics 和 billing groups 決定組織怎麼安全擴充套件 Cursor。

幫助與排障

排障層。Help Center、故障頁、網路頁、Agent Tab、賬號計費和模型用量頁用來定位真實問題。

總體學習路徑

這套官方教程中文版按“從個人使用到團隊治理”組織：

入門與賬號：先跑通低風險專案。
Agent 工作流：把一次編碼任務做成可規劃、可執行、可回退的迴圈。
上下文與定製：把 Rules、MCP、Skills、Subagents、Hooks 變成穩定上下文。
CLI 與自動化：把 Agent 能力帶到終端、指令碼和 CI。
雲端 Agent：把長任務、PR、issue 和非同步協作放到雲端執行。
整合、API 與 SDK：接入 GitHub、Slack、Linear、Admin API、SDK 和 Deep Links。
團隊與企業治理：處理身份、許可權、隱私、網路、模型、成本、審計。
幫助與排障：按賬號、網路、索引、Agent、工具、雲端任務分層定位問題。

這個順序能避免直接從高階能力開始。Cursor 的能力很多，但商業專案更關心可控、可驗證、可審計。

使用原則

查事實：回官方來源。
做任務：先讀 Agent 工作流。
反覆提醒：寫進 Rules 或 Skills。
接外部系統：先做許可權和網路審查。
團隊上線：先做 SSO、成員、隱私、用量和審計。
出問題：按排障層分診，不要直接重灌。

所有高波動內容，例如模型、價格、用量、企業策略和功能命名，都應回 Cursor 官方頁面核驗。

質量標準

每篇官方教程頁都應該保留三層資訊：官方事實、中文使用判斷、真實專案驗收。只有官方事實會變成手冊，只有判斷會變成隨筆；二者結合，才適合作為教程。

如何回查來源

Cursor 官方資料分散在 Docs、Help Center、llms.txt、dashboard 入口和企業文件中。本站頁面只承接穩定事實和中文結構，遇到這些內容必須回官方確認：

模型、價格、usage pools、Max Mode 和 billing。
GitHub、Slack、Linear、Cloud Agent、Bugbot 的許可權和觸發語法。
Team、Enterprise、SSO、SCIM、Privacy Mode、audit logs、service accounts。
網路 allowlist、proxy、HTTP compatibility、remote connection。
SDK public beta、API 變更、Deep Links 限制。

如果官方入口和站內教程衝突，以官方入口為準，再回本站修正文案。教程站不能替代官方狀態頁、dashboard 或合同條款。

更新邊界

維護這組教程時，優先更新會改變真實操作的內容，例如許可權、配置、命令、API、觸發方式、排障步驟和驗收標準。隻影響營銷文案、截圖位置、按鈕名稱輕微變化的內容，可以等下一輪集中維護。