chatgpt-app-builder

为 LLM 创建插件

ChatGPT 插件是一种对话体验，通过工具和自定义 UI 视图扩展 ChatGPT。它们以 MCP 服务的形式构建，并在对话过程中调用。

⚠️ 插件同时面向两类用户：人类和 ChatGPT LLM。他们通过视图协作——人类与视图交互，LLM 则能看到视图状态。编写代码前，请牢记这一点：视图是双方共享的界面。

SPEC.md 用于记录插件的需求和设计决策。开发插件时，请及时更新。

正在构建电商插件？ → 请先阅读 ecommerce.md。

没有 SPEC.md？ → 请先阅读 discover.md。在 SPEC.md 创建之前，请勿进行其他操作。

已有 SPEC.md？ → 请先阅读 SPEC.md，然后按照 architecture.md 设计更改。更新 SPEC.md 后，再阅读下方相关的实现参考文档，然后编写代码。

正在从 Skybridge < 0.36.x 迁移？ → 请先阅读 migrate-to-v1.md。用户可能会将 skybridge >= 0.36.x 称为 v1。

正在从 Skybridge 1.x 迁移到 2.x？ → 请先获取 v2.0.0 发布说明，并按说明操作。

设置

1. 复制模板 → copy-template.md：使用现成的 SPEC.md 启动新项目时
2. 本地运行 → run-locally.md：准备测试、需要开发服务器或连接 ChatGPT 时
3. 评估 → evals.md：在测试中检查真实模型是否能根据自然语言提示调用正确的工具

架构

设计或演进 UX 流程和 API 形态 → architecture.md

实现

• 获取并呈现数据 → fetch-and-render-data.md：实现服务端处理程序和视图数据获取时
• 状态和上下文 → state-and-context.md：持久化视图 UI 状态并更新 LLM 上下文时
• 提示 LLM → prompt-llm.md：视图需要触发 LLM 响应时
• UI 指南 → ui-guidelines.md：显示模式、布局限制、主题、设备和区域设置
• 外部链接 → open-external-links.md：重定向到外部 URL 或设置“在应用中打开”目标时
• OAuth → oauth.md：工具需要用户身份验证才能访问用户专属数据时
• 资源和样式 → assets-and-styling.md：向视图添加图像、字体或 CSS 时
• CSP → csp.md：声明允许用于 fetch、资源、重定向或 iframe 的域名时
• 事件 → events.md：ChatGPT 需要在用户未参与的情况下响应应用中的活动时，例如新评论或事件
• OpenAI MCP 扩展 → openai-extensions.md：视图需要从 ChatGPT 侧边栏、对话侧面板、文件或深层链接中打开，或需要使用 ChatGPT 的 @ 提及、带标题的消息或本地文件时

部署

• 发布到生产环境 → deploy.md：准备通过 Alpic 部署时
• 发布到 ChatGPT Directory → publish.md：准备提交审核时

完整 API 文档：https://docs.skybridge.tech/api-reference.md

发布说明和变更日志：https://skybridge.tech/changelog.md