Deep Links

Deep links（深度链接，能直接跳转到应用内特定位置 / 状态的链接，如 cursor://...）用来分享 Cursor prompt、command 和 rule，让团队可以复用工作流、命令和规则。

阅读目标：读完本章，你应该能生成和审查 Cursor deeplink，并知道它为什么不能自动执行、为什么要做敏感信息检查。

1. 先判断

Deep links 适合分享“入口”，不适合分享秘密。

类型	用途
Prompt link	打开 Cursor，并把 prompt 预填到 chat
Command link	创建 `.cursor/commands` 风格的 custom command
Rule link	创建 `.cursor/rules` 风格的 custom rule

关键安全点：deeplink 不会自动执行。用户点击后仍要 review 和 confirm。

2. 两种 URL 形态

Cursor 支持 app protocol 和 web link。

形态	示例
App protocol	`cursor://anysphere.cursor-deeplink/prompt?text=Hello%20world`
Web link	`https://cursor.com/link/prompt?text=Hello%20world`

Web link 会打开 cursor.com，再让用户在浏览器里打开 deeplink 或复制到 Cursor。分享给不确定是否安装 Cursor 的人时，web link 更稳。

3. Prompt deeplink

Prompt link 只需要 text。

适合：

分享某个 repo 的 review prompt。
分享调研、排障、重构、测试生成的起手式。
在教程、issue template、内部文档中放统一任务入口。

不适合：

把 API key、password、customer data 写进 prompt。
把内部 proprietary code 直接塞进 URL。
让用户误以为点击后会自动执行。

4. Command deeplink

Command link 用来分享 custom command。参数通常包括：

参数	用途
`name`	command 名称
`text`	command 内容

用户点击后，Cursor 会创建一个新 command。用户仍要 review 和 confirm，command 不会自动运行。

适合分享团队固定动作，例如 debug API、生成测试、做 release note、检查 migrations。

5. Rule deeplink

Rule link 用来分享 custom rule。参数通常包括：

参数	用途
`name`	rule 名称
`text`	rule 内容

适合分享代码风格、项目约束、安全红线、review 标准。

rule 的风险比 prompt 更长期：用户确认后，rule 会影响后续 Cursor 行为。分享前要确认内容不包含临时偏好、过期约束或不该推广到其他项目的内部规则。

6. URL encode 和长度限制

生成 deeplink 时要 URL-encode 参数。空格、中文、换行、符号都应该通过标准 URL APIs 处理，不要手工拼接。

官方说明 deeplink URL 最大长度是 8,000 characters。注意这是 URL-encoded 之后的长度，不是原文长度。

超长内容建议：

改成链接到内部文档。
拆成多个更小 prompt / command / rule。
用 repo 中的 .cursor/commands 或 .cursor/rules 直接管理。

7. 分享前检查

每条 deeplink 发出去前至少检查：

是否包含 API key、token、password、private URL。
是否包含客户数据、日志、截图文字或内部 repo 细节。
prompt / command / rule 是否已经 URL-encoded。
link 是否低于 8,000 characters。
用户点击后是否需要明确 review。
command / rule 是否适合长期保存。

8. 商业级用法

更稳的落地方式：

场景	推荐
教程站	放 web link，配清晰标题和适用场景
团队 SOP	prompt link 只放非敏感指令，具体上下文让用户本地选择
Command 分发	小范围试用后再公开
Rule 分发	版本化管理，避免链接散落后不可追踪
对外分享	默认只分享 prompt，不分享包含组织规则的 command / rule

Deep links 的价值是降低启动成本。真正的规则和命令，长期仍应进 repo 或团队配置，便于 review、版本控制和撤回。

本章自检

这个链接是 prompt、command 还是 rule？
用户点击后是否需要 review 和 confirm？
URL-encoded 后是否超过 8,000 characters？
是否包含任何敏感或 proprietary 内容？
command / rule 是否应该改为 repo 文件，而不是链接传播？

通过标准：你能生成一条 web deeplink 和一条 app protocol deeplink，并能解释为什么它不会自动执行。

官方来源

Cursor Deeplinks —— 官方 prompt、command、rule deeplink、URL 形态、确认机制和 FAQ。
Cursor Slash Commands —— commands 背景。
Cursor Rules —— custom rules 背景。