GitHub Copilot SDK HOT

GitHub Copilot SDK是什么？

GitHub Copilot SDK 是 GitHub 官方的开源项目（仓库 github/copilot-sdk，MIT 许可，建库于 2026 年 1 月 14 日，目前约 1.04 万星），一句话概括就是：把 Copilot 的 Agent 能力做成可以嵌进你自己应用里的 SDK。它暴露的不是一个新模型接口，而是 Copilot CLI 背后那套已经在生产里跑过的 Agent 运行时——规划、工具调用、文件编辑、流式输出、多轮会话都由 Copilot 负责，你只负责定义 Agent 的行为，不用再自己搭一层编排。

架构上它做得挺克制：你的应用调 SDK，SDK 自动拉起并管理 Copilot CLI 的 server 模式进程，两者之间走 JSON-RPC（stdio 或 TCP），CLI 再对接 GitHub 的模型与认证。也就是说进程管理这类脏活官方帮你兜了。时间线上，2026 年 4 月 2 日进入公开预览，6 月 2 日宣布正式 GA，API 面在 GA 时做过一轮基于预览反馈的清理，官方口径已是「稳定、可用于生产」。

核心功能

• 自定义工具与 MCP：注册你自己的工具让 Agent 自主决定何时调用，接入 MCP server，甚至覆盖 grep、edit_file 这些内置工具。
• 系统提示词分段定制：按身份、语气、工具说明、安全规则等分区做 replace / append / prepend，或用动态 transform 回调改写，不必重写整段 prompt。
• 认证方式灵活：GitHub OAuth、GitHub Apps、环境变量 token，以及面向 OpenAI、Microsoft Foundry、Anthropic 等的 BYOK。
• 云端与远程会话：可创建带仓库元数据的云端会话，或按需开启远程会话 URL，适合把 Agent 放进 CI/CD 与内部平台。
• 可观测与可拦截：内置 OpenTelemetry 分布式追踪（W3C trace context 贯穿 CLI 启动、JSON-RPC 调用、会话操作与工具执行），配合 hook 体系可在工具调用前后、会话启动、权限请求处插手。

版本/套餐对比

SDK 代码本身是 MIT 开源、免费取用，真正决定成本的是背后的调用额度。官方在 GA 公告里写得很清楚：SDK 对所有 GitHub Copilot 订阅者开放，包括个人可用的 Copilot Free；不是 Copilot 用户也能通过 BYOK 用自己的模型密钥。同时有一句必须留意——对 Copilot 订阅者而言，每一次 prompt 都会计入你的高级请求（premium request）配额。所以选档逻辑其实是：轻量试水用 Copilot Free 或 BYOK，要把 Agent 放进日常研发流水线，就得按预计 prompt 量去反推该上哪档 Copilot 订阅。

从预览到 GA 的增量也值得一提：新增了默认打包 Copilot CLI 二进制的 Rust SDK、Java 正式加入，多客户端协作（不同客户端向同一会话贡献工具与权限）更完善，斜杠命令与交互式输入提示在所有语言 SDK 上齐平。此后仍保持高频小步迭代：v1.0.15（2026-09-28）给全部六个 SDK 加上类型化结构化输出——传 JSON Schema 或语言惯用的 typed helper，模型返回经校验的结构化结果而非自由文本（如 session.sendAndWait(prompt, Answer)）；JSON-RPC 错误的 data 载荷在各 SDK 可直接读取；新增实验性连接级安装确认 handler，MCP/Skill 安装前可弹人工审批；Java 补上 darwin-x64 与 Alpine 原生运行时；Rust 运行时安装内存占用降约 99%；其后的 v1.0.17（2026-10-07）带来三项新能力——活动会话可中途替换客户端工具（无需重建会话）、子代理生命周期钩子 OnSubagentStart/OnSubagentStop、二进制会话文件系统提供者（view 工具可读 provider 提供的图片），并把捆绑的 Copilot CLI 升到 1.0.93-4；v1.0.16（2026-09-30）、v1.0.18（2026-10-08）与 v1.0.19（2026-10-09）均为内部依赖刷新（SDK 快照分别对齐 Copilot CLI 1.0.90、1.0.94 与最新快照），无用户可见变化；v1.0.21（2026-10-13，中间没有 v1.0.20 正式版）按 Copilot CLI 1.0.97 重新生成各 SDK 的 RPC 与会话事件类型（新增 catalog agent 插件/媒体类型字段并更新会话事件 schema），Rust 侧细化 JSON-RPC 与会话文件系统分发处理，C# 微调内置 PermissionHandlers。前一版 v1.0.14（2026-09-16）把消息来源做成类型化标注——人类用户的 user、系统注入的 system 与已识别的 agent- 发送方各有来源标识，接收方据此能分辨「agent 的输入」与「人类授权」；auto 模型路由补上延迟优先的 Fast 档。

值不值得用？

如果你本来就在 GitHub 生态里，这几乎是最省事的一条路。最大的价值不是「能调模型」，而是省掉了自建 Agent 编排的那几千行——权限、hook、追踪、多轮会话、文件编辑这些细节，自己写一遍就知道有多耗人。六语言覆盖也不是凑数，.NET 和 Java 有官方 SDK 这件事，对企业内部平台团队来说分量很足。

短板同样明确。SDK 开源不等于底座开源：Copilot 引擎仍是闭源云服务，你无法自托管，也就意味着数据边界与可用性都得接受 GitHub 的条款。计费上和高级请求配额挂钩，Agent 一旦跑成高频任务，账单模型要提前算。另外它迭代得非常猛——v1.0.13 到 v1.0.14、再到 v1.0.15 都是 12 天一版，v1.0.16 只隔 2 天、v1.0.17 又在一周后跟进、v1.0.18 与 v1.0.19 接连隔天就到、v1.0.21 在 10-13 跟进、v1.0.22 于 10-14 跟进、v1.0.23 于 10-19 跟进，仓库里长期天天在更——好处是问题修得快，代价是你得跟版本。

使用建议

• 先跑官方 Getting Started 起一个最小 Agent，把 SDK 拉起 CLI、走通 JSON-RPC 这条链路确认环境没问题。
• 从 cookbook 里挑最接近你场景的配方改，比从零写省事得多。
• 上生产前先把权限框架配好：敏感操作走审批 handler，只读工具标记成免授权，能少一半误操作风险。
• 打开 OpenTelemetry 追踪再上量，慢在哪、卡在哪一目了然，别等出问题才补观测。
• 用 BYOK 还是 Copilot 配额，最好在设计阶段就定，两者的成本曲线完全不同。

适合谁用？

推荐：想在自家应用、内部平台或 IDE 扩展里嵌入 Agent 能力的开发团队，尤其是已经买了 Copilot、技术栈在 .NET / Java / Node 上的企业。 可考虑：做 CI/CD 助手、代码审查机器人、面向客户的 AI 功能的团队，先用 Copilot Free 或 BYOK 验证可行性。 不推荐：要求模型与运行时完全自托管、数据不出内网的场景，以及不接受按 prompt 计入配额这种计费方式的团队。

版本记录

以下按时间倒序收录历次版本更新的完整说明（页面顶部简介只保留最新一版要点）。

最新稳定版 v1.0.26（2026-10-22 发布；npm @github/copilot-sdk 的 latest 与 GitHub releases/latest 均已指向 1.0.26）：官方 release 正文仅一条「Updated the bundled Copilot CLI snapshot to 1.0.103」——本版为内部依赖更新（捆绑 Copilot CLI 快照升到 1.0.103），无 SDK API 层面的用户可见变更。

前一版 v1.0.25（2026-10-21 发布；npm @github/copilot-sdk 的 latest 与 GitHub releases/latest 均已指向 1.0.25）：官方 release 正文只有 Full Changelog（v1.0.24...v1.0.25），没有变更说明；该 tag 与上一版之间只有三个提交，全部是「Update SDK snapshot for Copilot CLI 1.0.102」的 SDK 快照刷新（同仓库另有 sdk-snapshot/cli-1.0.102 提交），因此本版属捆绑依赖快照跟进，官方未列出用户可见的 SDK API 变更。

前一版 v1.0.24（2026-10-20 发布；npm @github/copilot-sdk 的 latest 与 GitHub releases/latest 均已指向 1.0.24）：官方 release 正文写明本版仍为内部依赖更新——SDK 快照随较新的 Copilot CLI 构建刷新，自 v1.0.22 起无用户可见的 SDK API 变更；Full Changelog 为 v1.0.22...v1.0.24，中间没有 v1.0.23 的正式release 页（当时 npm 已先行发版，GitHub 侧只有 v1.0.23-preview.0~5 预发布）。

前一版 v1.0.23（2026-10-19 发布；npm @github/copilot-sdk 的 latest 通道已指向 1.0.23，GitHub 尚未建立 v1.0.23 正式 release 页，仅有 v1.0.23-preview.0~5 预发布）：按 v1.0.23-preview.5 的发布说明，本版仍为内部依赖更新——六个 SDK 把捆绑的 Copilot CLI 依赖升级到 1.0.100-1，官方明确无用户可见的 SDK 变更；v1.0.24-preview.0 亦注明「自 v1.0.23-preview.5 起无其他用户可见变更」。

前一版 v1.0.22（2026-10-14 发布）：本版仅内部依赖更新——六个 SDK 全部把捆绑的 Copilot CLI 依赖升级到 1.0.98-2，官方明确无 SDK API 变更（Full Changelog 为 v1.0.21...v1.0.22）。

前一版 v1.0.21（2026-10-13；中间没有 v1.0.20 正式版，官方 Full Changelog 为 v1.0.19...v1.0.21）：六个 SDK 按 Copilot CLI 1.0.97 重新生成 RPC 与会话事件类型（新增 catalog agent 插件/媒体类型字段并更新会话事件 schema），Rust 侧细化 JSON-RPC 与会话文件系统分发处理，C# 微调内置 PermissionHandlers。v1.0.17（2026-10-07）带来的能力：新增会话中途替换客户端工具——活动会话的客户端自定义工具与 handler 可在一次调用内替换而无需重建会话（内置/MCP/插件工具不受影响，传空列表可移除全部客户端工具，六语言 SDK 均有对应 API，如 TS session.setTools([tool])、Python session.set_tools([tool])）；新增子代理生命周期钩子 OnSubagentStart / OnSubagentStop（启动钩子可为子代理首轮提示预置上下文，停止钩子可检视或替换响应、或用后续指令阻止停止）；新增二进制会话文件系统提供者——会话 FS provider 可直接提供精确文件字节，使 view 工具能读取仅由 provider 提供的图片（读写上限约 48 MiB）；新增会话事件 tool.shell_output 与 human_response.recorded、tool.execution_complete 增加文件编辑明细；捆绑的 Copilot CLI 更新到 1.0.93-4 并重生成全部 SDK 的 RPC 与会话事件类型，C# 新增自定义会话事件 JSON 转换器。

前一版 v1.0.16（2026-09-30 发布；下述新增能力为 v1.0.15 引入）：六个语言 SDK 全量支持类型化结构化输出（传 JSON Schema 或语言惯用的 typed helper，模型返回经校验的结构化结果而非自由文本）、JSON-RPC 错误响应的 data 载荷在各 SDK 中可直接读取（可按机器可读错误细节分支处理）、实验性连接级安装确认 handler（MCP/Skill 安装前可弹人工审批，须显式 confirm/decline/cancel）；Java 新增 darwin-x64 与 Alpine（linuxmusl-x64）原生运行时支持；Rust 运行时安装内存占用降约 99%，多 SDK 合并拦截的 HTTP 响应分片以提升工具调用流式吞吐。v1.0.16 为内部依赖刷新（SDK 快照对齐 Copilot CLI 1.0.90），无用户可见变化。

上一版 v1.0.14（2026-09-16）带来消息来源类型化标注、auto 路由 Fast 延迟优先档、managedSettings.clearCache 企业策略缓存一键刷新与 Rust 会话级模型白名单。