技能介绍

要解决什么问题

如果你要在自有应用里调用 GitHub Copilot（而不是只在终端里敲 copilot），需要一套稳定的进程间协议、会话状态和多语言 API。Copilot SDK 通过 JSON-RPC 封装 Copilot CLI：CLI 仍负责模型调用、工具执行与 MCP 生命周期，你的代码只关心「客户端 → 会话 → 消息」这条主路径。

核心能力与用法

多运行时：Node.js、Python、Go、.NET 包名与 API 形态一致，典型流程是创建 CopilotClient、 createSession / resumeSession，再 sendAndWait 或开启 streaming 订阅增量事件。
传输：默认 stdio（CLI 子进程管道，适合本地单进程）；TCP 适合把 CLI 当无头服务、多客户端共享同一 CLI 实例。
扩展 Copilot 能力：用 JSON Schema 定义自定义工具；在 onPreToolUse / onPostToolUse 等钩子里做权限（allow / deny / ask）、改参数、脱敏或注入上下文。
MCP：可挂本地 stdio 或远程 HTTP MCP 服务器；集成前应用 MCP Inspector 单独测 tools/list，避免 stdout 被调试日志污染。
认证与 BYOK：凭据优先级从显式 githubToken、HMAC、环境变量到 CLI 已登录 OAuth；BYOK 可接 OpenAI、Azure、Anthropic、Ollama 等，但密钥不持久化，恢复会话须重配 provider，且无自动刷新 bearer。
会话持久化：自定义 sessionId 后状态落在 ~/.copilot/session-state/{sessionId}/（对话、工具结果、plan 等）；API 密钥与内存工具状态不会跟着恢复。长对话可用 infiniteSessions 做自动压缩，替代 CLI 的 /compact。

边界与注意点

SDK 不能替代 CLI 的交互 UI、斜杠命令、--share 导出、YOLO 等；导出与用量可改用 session.on() + getMessages() 或用量事件。权限模型默认拒绝，需实现 onPermissionRequest 等处理器。生产部署要规划会话清理、CLI 健康检查、密钥托管，以及多租户下「每用户单独 CLI」与「共享 CLI + sessionId」的隔离取舍。