在介绍了 CodeRunner 的一键配置后，今天，我们将介绍如何通过 Protocol Launcher 与 SourceTree 联动，让 Git 协作变得更加顺滑。

作为开发者或项目维护者，你可能经常遇到这些场景：

• 在项目文档中提供一个“在 SourceTree 中打开”的按钮，方便用户快速克隆仓库。
• 在内部平台点击链接，直接在本地客户端打开某个特定仓库进行代码审查。
• 引导用户快速在 SourceTree 中克隆并开始开发项目。

现在，通过 Protocol Launcher，你可以摆脱手动拼接复杂的 sourcetree:// 协议链接，以类型安全的方式提升协作效率。

---

SourceTree 与深度链接

SourceTree 是 Atlassian 推出的免费 Git 客户端，支持 Windows 和 macOS 平台。它提供了强大的深度链接支持，允许从网页或第三方应用直接触发打开应用、克隆仓库等操作。

然而，手动拼接这些链接通常需要了解 SourceTree 协议的具体参数格式，且缺乏类型提示，极易出错。

---

核心能力：自动化操作与精准克隆

Protocol Launcher 为 SourceTree 专门提供了 protocol-launcher/sourcetree 模块，支持以下核心功能：

1. 一键打开 SourceTree：快速唤起本地 SourceTree 客户端。
2. 快速克隆仓库：支持指定 Git 仓库地址，自动打开 SourceTree 的克隆界面。
3. 自动处理协议逻辑：内部自动处理 SourceTree 特有的参数格式，确保链接 100% 可用。

---

快速上手

首先，确保你的项目中已安装：

npm install protocol-launcher

在代码中你可以根据场景选择两种导入方式：

• 按需加载（通过子路径导入），支持 Tree Shaking，体积更小；
• 全量导入（从根包导入），写法更简单，但会引入所有已支持应用的逻辑。

// ✅ 推荐：按需加载 SourceTree 模块
import { open, cloneProject } from 'protocol-launcher/sourcetree'

// 也可以从根包导入，但会包含所有应用模块
// import { sourcetree } from 'protocol-launcher'

场景一：一键打开 SourceTree 客户端 (open)

这是最常用的功能。你可以引导用户直接打开本地的 SourceTree 客户端：

import { open } from 'protocol-launcher/sourcetree'

const url = open()

场景二：快速克隆项目 (cloneProject)

如果你想让用户快速在 SourceTree 中克隆某个 Git 仓库：

import { cloneProject } from 'protocol-launcher/sourcetree'

const url = cloneProject({
  repo: 'https://github.com/zhensherlock/protocol-launcher',
})

---

为什么选择 Protocol Launcher？

1. 自动处理协议格式：SourceTree 的协议格式相对简单，但库内部仍然会自动处理所有的转义逻辑，确保生成的 URL 在唤起应用时绝不乱码。
2. 类型安全与参数提示：TypeScript 的智能补全会确保你提供了必要的 repo 参数，并提醒你参数的正确格式。
3. 一致的用户体验：通过封装复杂的协议逻辑，你可以专注于业务功能的实现，而不用担心不同操作系统下协议触发的细微差异。
4. 极致的按需加载 (Tree Shaking)：采用了模块化设计，支持按需加载以最小化包体积：
   • 推荐方式：使用子路径导入（如 import { open, cloneProject } from 'protocol-launcher/sourcetree'），这样构建工具只会打包相关的代码。
   • 全量方式：也可以从根包导入（如 import { sourcetree } from 'protocol-launcher'），建议生产环境始终使用按需加载。

---

结语

通过 Protocol Launcher，你可以极大降低用户参与 Git 协作的门槛。无论是在开源项目的文档中，还是企业内部的代码管理平台，它都是连接 Web 与本地 Git 客户端最优雅的桥梁。

---

🔗 相关链接

• Protocol Launcher 官网: https://protocol-launcher.huayi-data.com/
• SourceTree 模块文档: SourceTree | Protocol Launcher