在介绍了 Jump Desktop 的一键配置后，今天，我们将介绍如何通过 Protocol Launcher 与 Trae China 联动，让 AI 辅助编程变得更加高效。

作为开发者，你可能经常遇到这些场景：

• 在文档中提供一个"在 Trae China 中打开"的按钮，方便用户快速体验项目。
• 在内部平台点击链接，直接在 Trae China 中打开特定文件或文件夹。
• 一键安装 MCP 服务，快速扩展 AI 能力。
• 引导用户快速连接到远程开发环境或 SSH 服务器。

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

---

Trae China 与深度链接

Trae China 是字节跳动推出的一款 AI 原生代码编辑器，提供 SOLO Coder、SOLO Builder 等智能编程模式，支持 MCP Server 扩展、自定义 Agent、多任务处理等功能。

::: tip 重要提示
trae-cn 模块专为中国大陆用户设计，内置的是国内大模型（如豆包、文心一言等），访问速度更快，符合国内网络环境。国际用户请使用 Trae 国际版 模块。
:::

然而，手动拼接这些深度链接通常需要处理复杂的参数编码，且缺乏类型提示，极易出错。

---

核心能力：AI 驱动的开发体验

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

1. 快速打开编辑器：一键唤起 Trae China，打开文件或文件夹。
2. MCP 服务安装：支持 STDIO、Streamable HTTP、SSE 三种类型的 MCP 服务一键安装。
3. 远程开发：快速连接 SSH 远程服务器、WSL 或开发容器。
4. 扩展与智能体：直接打开扩展详情页或导入自定义 Agent。
5. 设置跳转：精准定位到特定设置项。

---

快速上手

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

npm install protocol-launcher

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

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

// ✅ 推荐：按需加载 Trae China 模块
import { open, openFile, openFolder, installMCP, openRemote } from 'protocol-launcher/trae-cn'

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

场景一：一键打开编辑器 (open)

最简单的用法，直接唤起 Trae China：

import { open } from 'protocol-launcher/trae-cn'

const url = open()

场景二：打开文件或文件夹 (openFile, openFolder)

引导用户在 Trae China 中快速查看特定文件或文件夹：

import { openFile, openFolder } from 'protocol-launcher/trae-cn'

// 打开文件，可指定行号和列号
const fileUrl = openFile({
  path: '/etc/hosts',
  line: 10,
  column: 5,
  openInNewWindow: true, // 在新窗口打开
})

// 打开文件夹
const folderUrl = openFolder({
  path: '/code/my-project',
  openInNewWindow: true,
})

场景三：安装 MCP 服务 (installMCP)

这是 Trae China 的核心功能之一。Protocol Launcher 支持三种类型的 MCP 服务安装：

import { installMCP } from 'protocol-launcher/trae-cn'

// STDIO 类型的 MCP 服务
const stdioUrl = installMCP({
  name: 'server-everything',
  type: 'stdio',
  command: 'npx',
  args: ['-y', '@modelcontextprotocol/server-everything'],
})

// Streamable HTTP 类型的 MCP 服务
const httpUrl = installMCP({
  name: '企查查企业信息 MCP',
  type: 'http',
  url: 'https://mcp.qcc.com/basic/stream',
  headers: {
    Authorization: 'REPLACE_WITH_YOUR_TOKEN',
  },
})

// SSE 类型的 MCP 服务
const sseUrl = installMCP({
  name: '企查查风险信息 MCP',
  type: 'http',
  url: 'https://mcp.qcc.com/basic/sse',
  headers: {
    Authorization: 'REPLACE_WITH_YOUR_TOKEN',
  },
})

场景四：远程开发 (openRemote)

快速连接到远程开发环境：

import { openRemote } from 'protocol-launcher/trae-cn'

// 连接 SSH 远程服务器
const sshUrl = openRemote({
  type: 'ssh-remote',
  host: 'root@172.18.105.209:22',
  path: '/code/my-project',
})

// 连接 WSL
const wslUrl = openRemote({
  type: 'wsl',
  host: 'Ubuntu-22.04',
  path: '/home/user/project',
})

// 连接开发容器
const devContainerUrl = openRemote({
  type: 'dev-container',
  host: 'my-project-container',
  path: '/workspace',
})

场景五：打开扩展或自定义智能体 (openExtension, openAgent)

import { openExtension, openAgent } from 'protocol-launcher/trae-cn'

// 打开扩展详情页
const extensionUrl = openExtension({
  id: 'esbenp.prettier-vscode',
})

// 打开自定义智能体
const agentUrl = openAgent({
  agentId: '878f64',
})

场景六：打开设置页 (openSettings)

精准定位到特定设置项：

import { openSettings } from 'protocol-launcher/trae-cn'

// 打开设置页，可指定具体设置项
const settingsUrl = openSettings({
  path: 'terminal.integrated.suggest.enabled',
  openInNewWindow: true,
})

---

为什么选择 Protocol Launcher？

1. 类型安全与智能提示：TypeScript 的类型定义确保你提供正确的参数，IDE 会自动提示所有可用选项。
2. 自动编码处理：库内部自动处理 URL 编码和参数拼接，确保生成的链接 100% 可用。
3. 一致的 API 设计：与 VS Code、Cursor 等其他编辑器保持一致的 API 风格，学习成本低。
4. 按需加载 (Tree Shaking)：采用模块化设计，支持按需加载以最小化包体积：
   • 推荐方式：使用子路径导入（如 import { openFile } from 'protocol-launcher/trae-cn'），这样构建工具只会打包相关的代码。
   • 全量方式：也可以从根包导入（如 import { traeCn } from 'protocol-launcher'），建议生产环境始终使用按需加载。
5. AI 原生支持：专门为 Trae China 的 AI 特性设计，包括 MCP 服务和自定义 Agent 的快速导入。

---

结语

通过 Protocol Launcher，你可以极大降低用户使用 Trae China 的门槛。无论是在开源项目的文档中，还是企业内部的开发平台，它都是连接 Web 与本地 AI 编辑器最优雅的桥梁。

特别是对于需要快速集成 MCP 服务的场景，Protocol Launcher 提供了简洁而强大的 API，让 AI 能力的扩展变得前所未有的简单。

---

🔗 相关链接

• Protocol Launcher 官网：https://protocol-launcher.huayi-data.com/
• Trae China 文档：Trae China | Protocol Launcher