在介绍了 Kiro 的一键唤起后，今天，我们来看看另一款强大的开源 AI 编程工具 —— OpenCode。

通过 Protocol Launcher，你可以为 OpenCode 生成深度链接，让用户从网页、控制台或自动化脚本中，一键打开 OpenCode 应用或直接加载指定的项目文件夹。

---

OpenCode 与深度链接

OpenCode 是一个开源的智能体，旨在帮助开发者在终端、IDE 或桌面端更高效地编写代码。它支持自定义的 URL 协议（opencode://），允许外部应用直接唤起并执行特定操作。

如果你希望在项目管理面板、CI/CD 报告或本地开发工具中引导用户：

• 快速启动 OpenCode 编辑器
• 直接打开并加载特定的项目代码库

Protocol Launcher 将这些 URL 协议封装成了类型安全的 TypeScript 函数，让你无需手动拼接字符串即可轻松实现唤起功能。

---

核心能力：快速启动与项目加载

Protocol Launcher 为 OpenCode 专门提供了 protocol-launcher/opencode 子模块，支持以下核心能力：

1. 启动应用：通过 open 方法，直接唤起 OpenCode 应用程序。
2. 打开项目：通过 openProject 方法，在 OpenCode 中直接打开指定的项目目录。

---

快速上手

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

npm install protocol-launcher

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

• 按需加载（通过子路径导入）：支持 Tree Shaking，体积更小，推荐在生产环境使用。
• 全量导入（从根包导入）：写法更简单，适合快速原型开发或脚本。

// ✅ 推荐：按需加载 OpenCode 模块
import { open, openProject } from 'protocol-launcher/opencode'

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

场景一：启动 OpenCode (open)

当你仅仅需要唤起 OpenCode 主程序，让用户自行选择操作时，可以使用 open 方法：

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

// 生成链接: opencode://
const url = open()

场景二：在 OpenCode 中打开项目 (openProject)

当你需要让用户直接进入某个项目的开发环境时，可以使用 openProject：

import { openProject } from 'protocol-launcher/opencode'

// 生成链接: opencode://open-project?directory=/Users/dev/project
const url = openProject({
  path: '/Users/dev/project', // 项目文件夹的绝对路径
})

这个功能特别适合用于内部开发者平台的“打开项目”按钮，或者在克隆完代码后自动打开编辑器。

---

为什么选择 Protocol Launcher？

1. 类型安全：TypeScript 支持为 openProject 提供完整的类型定义，防止参数拼写错误。
2. 简化调用：无需记忆复杂的 URL 协议格式（如 opencode://open-project?directory=...），直接调用函数即可。
3. 极致的按需加载 (Tree Shaking)：
   • 推荐方式：使用子路径导入（如 import { openProject } from 'protocol-launcher/opencode'）。
   • 全量方式：也可以从根包导入统一入口（如 import { opencode } from 'protocol-launcher'）。
4. 统一体验：无论是 VS Code、TextMate 还是 OpenCode，Protocol Launcher 都提供了风格一致的 API，降低学习成本。

---

结语

通过 Protocol Launcher，集成 OpenCode 的唤起功能变得异常简单。无论是构建开发者工具链，还是优化团队内部的工作流，都可以通过它实现流畅的“一键编码”体验。

---

🔗 相关链接

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