Workspace Prompt Deeplink

通过一条 deeplink 同时完成：打开指定工作区 + 预填 Cursor AI Chat 提示词。

Deeplink 格式

cursor://gateai.cursor-workspace-prompt/open?folder=<绝对路径或git远程地址>&text=<提示词>

示例

本地路径：

cursor://gateai.cursor-workspace-prompt/open?folder=%2fUsers%2fmiquel%2fDocuments%2fmy-project&text=帮我分析这个模块的性能问题

Git 远程地址（自动匹配本地仓库）：

cursor://gateai.cursor-workspace-prompt/open?folder=git%40github.com%3Aorg%2fmy-project.git&text=帮我分析这个项目

前端调用（TypeScript）

function openInCursor(folder: string, prompt: string): void {
  const url = new URL('cursor://gateai.cursor-workspace-prompt/open')
  url.searchParams.set('folder', folder)
  url.searchParams.set('text', prompt)
  window.location.href = url.toString()
}

// 本地路径
openInCursor('/Users/miquel/Documents/my-project', '帮我找这个模块的 bug')

// Git 远程地址
openInCursor('git@github.com:org/my-project.git', '帮我找这个模块的 bug')

工作原理

1. 浏览器触发 cursor:// deeplink（用户确认一次）
2. 如果 folder 是 git 远程地址，插件会在配置的 searchPaths 目录下递归扫描，自动匹配本地仓库
3. 插件检测当前工作区是否为目标文件夹
   • 是 → 直接向 Chat 注入 prompt
   • 否 → 将 prompt 存入 globalState，切换工作区（窗口重载）
4. 窗口重载后插件重新激活，从 globalState 读取 pending prompt 并注入

配置

在 Cursor 设置中搜索 cursorWorkspacePrompt.searchPaths：

"cursorWorkspacePrompt.searchPaths": ["~"]

指定扫描本地 git 仓库的根目录列表（支持 ~ 路径）。当 folder 参数传入 git 远程地址时，插件会在这些目录下递归查找匹配的本地仓库。默认值 ["~"] 会扫描整个用户目录。

如果你的项目集中在某些目录下，可以缩小范围以加快匹配速度：

"cursorWorkspacePrompt.searchPaths": ["~/Projects", "~/work"]

安装

在 Cursor 扩展市场搜索 Workspace Prompt Deeplink 安装，或通过命令行：

cursor --install-extension gateai.cursor-workspace-prompt

参数说明

两个参数至少传一个。