---
title: "Deep Links"
description: "基于 Cursor 官方 Deeplinks 文档解释 prompt、command、rule 链接、web/app 格式、确认机制、URL 长度和敏感信息边界。"
verifiedAt: "2026-05-09"
---

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

> [!NOTE]
> **阅读目标**：读完本章，你应该能生成和审查 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、版本控制和撤回。

## 本章自检

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

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

## 官方来源

- [Cursor Deeplinks](https://cursor.com/docs/reference/deeplinks.md) —— 官方 prompt、command、rule deeplink、URL 形态、确认机制和 FAQ。
- [Cursor Slash Commands](https://cursor.com/docs/cli/reference/slash-commands.md) —— commands 背景。
- [Cursor Rules](https://cursor.com/docs/rules.md) —— custom rules 背景。

## 接下来去哪

<Cards>
  <Card title="Cursor 官方教程目录" description="返回 Cursor 官方资料总目录。" href="/docs/cursor/official" />
  <Card title="TypeScript SDK" description="回看用 SDK 以代码方式启动 Cursor agent。" href="/docs/cursor/official/05-integrations-sdk/76-typescript-sdk" />
</Cards>
