《Cursor文檔》-深度鏈接

通過深度鏈接,您可以與他人分享prompt、命令和規則,促進團隊和社區間的協作與知識共享。

鏈接也可以通過 cursor.com 打開。只需在 URL 末尾附加路徑和 URL 參數,例如:cursor.com/link/prompt?text=…

分享前請務必檢查prompt和命令,確保其中不含 API 密鑰、密碼或專有代碼等敏感信息。

prompt

分享prompt,幫助他人快速開始完成特定任務或工作流。點擊prompt深度鏈接後,Cursor 會打開,並在聊天中預填該prompt。用戶必須先查看並確認prompt,才能執行。深度鏈接絕不會自動執行。

研究並找出此代碼庫中的一個缺陷

演練場

TypeScript

const IS_WEB = false; // 設置爲 true 以使用網頁端格式

function generatePromptDeeplink(promptText: string): string {
  const baseUrl = IS_WEB
    ? 'https://cursor.com/link/prompt'
    : 'cursor://anysphere.cursor-deeplink/prompt';
  const url = new URL(baseUrl);
  url.searchParams.set('text', promptText);
  return url.toString();
}

const deeplink = generatePromptDeeplink("創建用於用戶身份驗證的 React 組件");
console.log(deeplink);

Python

from urllib.parse import urlencode, urlparse, urlunparse

IS_WEB = False  # 設置爲 True 以使用網頁端格式

def generate_prompt_deeplink(prompt_text: str) -> str:
    base_url = "https://cursor.com/link/prompt" if IS_WEB else "cursor://anysphere.cursor-deeplink/prompt"
    params = {"text": prompt_text}
    query_string = urlencode(params)
    return f"{base_url}?{query_string}"

deeplink = generate_prompt_deeplink("創建用於用戶身份驗證的 React 組件")
print(deeplink)

命令

分享可供他人直接在其 Cursor 環境中執行的命令。命令深度鏈接可讓您分享在 .cursor/commands 目錄中定義的自定義命令。用戶點擊命令深度鏈接後,會打開 Cursor 並創建一個具有指定名稱和內容的新命令。執行前,用戶必須先評審並確認該命令。

debug-api

添加 console.log 日誌語句以調試 API 響應

演練場

TypeScript

const IS_WEB = false; // 設置爲 true 以使用網頁端格式

function generateCommandDeeplink(commandName: string, commandContent: string): string {
  const baseUrl = IS_WEB
    ? 'https://cursor.com/link/command'
    : 'cursor://anysphere.cursor-deeplink/command';
  const url = new URL(baseUrl);
  url.searchParams.set('name', commandName);
  url.searchParams.set('text', commandContent);
  return url.toString();
}

const deeplink = generateCommandDeeplink("debug-api", "Add console.log statements to debug API responses");
console.log(deeplink);

Python

from urllib.parse import urlencode, urlparse, urlunparse

IS_WEB = False  # 設置爲 True 以使用網頁端格式

def generate_command_deeplink(command_name: str, command_content: str) -> str:
    base_url = "https://cursor.com/link/command" if IS_WEB else "cursor://anysphere.cursor-deeplink/command"
    params = {"name": command_name, "text": command_content}
    query_string = urlencode(params)
    return f"{base_url}?{query_string}"

deeplink = generate_command_deeplink("debug-api", "Add console.log statements to debug API responses")
print(deeplink)

規則

分享他人可添加到其 Cursor 環境中的規則。規則深度鏈接可用於分享 .cursor/rules 目錄中定義的自定義規則。用戶點擊規則深度鏈接後,Cursor 會打開並使用指定的名稱和內容創建新規則。用戶必須評審並確認該規則,才能將其添加。

typescript-strict

始終使用嚴格的 TypeScript 類型,避免使用 ‘any’

演練場

TypeScript

const IS_WEB = false; // 爲網頁端格式設爲 true

function generateRuleDeeplink(ruleName: string, ruleContent: string): string {
  const baseUrl = IS_WEB
    ? 'https://cursor.com/link/rule'
    : 'cursor://anysphere.cursor-deeplink/rule';
  const url = new URL(baseUrl);
  url.searchParams.set('name', ruleName);
  url.searchParams.set('text', ruleContent);
  return url.toString();
}

const deeplink = generateRuleDeeplink("typescript-strict", "Always use strict TypeScript types and avoid 'any'");
console.log(deeplink);

Python

from urllib.parse import urlencode, urlparse, urlunparse

IS_WEB = False  # 爲網頁端格式設爲 True

def generate_rule_deeplink(rule_name: str, rule_content: str) -> str:
    base_url = "https://cursor.com/link/rule" if IS_WEB else "cursor://anysphere.cursor-deeplink/rule"
    params = {"name": rule_name, "text": rule_content}
    query_string = urlencode(params)
    return f"{base_url}?{query_string}"

deeplink = generate_rule_deeplink("typescript-strict", "Always use strict TypeScript types and avoid 'any'")
print(deeplink)

常見問題

深度鏈接 URL 的最大長度是多少?

深度鏈接 URL 最長爲 8,000 個字符。以編程方式生成深度鏈接時,請確保內容經過 URL 編碼後不超過此限制。輸入時,上方的交互式生成器會顯示當前 URL 長度和剩餘字符數。

如何在網頁端而非 Cursor app 中使用深度鏈接?

將基礎 URL 從 cursor://anysphere.cursor-deeplink/ 改爲 https://cursor.com/link/,即可將深度鏈接協議替換爲網頁鏈接。例如:

cursor://anysphere.cursor-deeplink/prompt?text=Hello%20world
https://cursor.com/link/prompt?text=Hello%20world

網頁鏈接會將用戶重定向到 cursor.com,用戶可在瀏覽器中打開深度鏈接,或複製後在 Cursor 中使用。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜