{"meta":{"title":"关于 GitHub Copilot CLI 的扩展","intro":"扩展允许你将自己的工具和斜杠命令添加到 GitHub Copilot CLI其中，仅使用 CLI 附带的 SDK。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/copilot","title":"GitHub Copilot"},{"href":"/zh/copilot/concepts","title":"概念"},{"href":"/zh/copilot/concepts/agents","title":"智能体"},{"href":"/zh/copilot/concepts/agents/copilot-cli","title":"Copilot CLI"},{"href":"/zh/copilot/concepts/agents/copilot-cli/about-cli-extensions","title":"CLI 扩展"}],"documentType":"article"},"body":"# 关于 GitHub Copilot CLI 的扩展\n\n扩展允许你将自己的工具和斜杠命令添加到 GitHub Copilot CLI其中，仅使用 CLI 附带的 SDK。\n\n> \\[!NOTE]\n> GitHub Copilot CLI 扩展目前是实验性功能，可能会更改。\n\n扩展使你能够将自己的功能添加到 Copilot CLI。 每个扩展都是一个小型 Node.js 模块，作为独立进程与交互式会话并行运行，并回连到该会话。 通过该连接，扩展可以添加：\n\n* **工具**，即 Copilot 在为你工作时可以调用的工具。\n* ```\n            由你自己运行的**斜杠命令**。\n  ```\n\n由于扩展在计算机上运行实际代码，因此可以添加内置工具没有的功能。 例如，扩展可以观察会话中发生的情况，并在多次工具调用之间持续累计总数，而一次性的 shell 命令则做不到这一点。\n\n本文介绍扩展的工作原理，以及 Copilot CLI 如何处理它们。 有关生成自己的扩展的实践指南，请参阅 [为 GitHub Copilot CLI 创建扩展](/zh/copilot/tutorials/create-an-extension)。\n\n> \\[!WARNING]\n> 扩展程序会在你的计算机上运行，并使用你的权限。 仅加载信任的扩展代码，就像只运行未自行编写的任何其他脚本一样。\n\n## 如何发现扩展\n\nCopilot CLI 启动时，会在多个位置查找扩展。 每个扩展都位于各自的子目录中，并且该子目录必须包含一个名为 `extension.mjs`、`extension.cjs` 或 `extension.js` 的入口文件。 这些都是 JavaScript 文件：Copilot CLI 会通过 Node.js 直接运行入口文件，因此扩展必须使用 JavaScript 编写——目前不支持 TypeScript 和其他语言。\n\n子目录的名称将成为扩展的名称。\n\n| 来源                                 | 位置                            | Availability          |\n| ---------------------------------- | ----------------------------- | --------------------- |\n| **项目**                             |                               |                       |\n| `.github/extensions/NAME/` 在当前存储库中 | 可供在该存储库中工作的任何人使用。             |                       |\n| **用户**                             | `~/.copilot/extensions/NAME/` | 在所有 CLI 会话中，每个目录中都可用。 |\n| \\*\\*\\*\\*插件                         | 已安装的插件                        | 凡是启用了该插件的地方，均可使用。     |\n\n## 选择扩展程序的安装位置\n\n将扩展目录放在何处可确定谁可以使用它：\n\n* \\*\\*`.github/extensions/`\\*\\*当扩展特定于该项目时，将其放入存储库中，并且你想要与在那里工作的每个人共享它。\n* 如果你希望该扩展在你自己的所有会话中都可用，而不管你从哪个目录启动 CLI，就把它放在 **`~/.copilot/extensions/`** 中。\n\n这两个位置遵循完全相同的结构（包含文件的 `extension.mjs` 命名子目录），因此只需重新定位其文件夹即可将扩展从一个位置移动到另一个位置。\n\n## 启用扩展\n\n扩展当前是一项实验性功能，因此需要启用实验性功能。 可以通过执行以下操作之一来执行此操作：\n\n* 使用 `‑‑experimental` 标志启动 CLI。\n* 在 `/experimental on` 交互式会话中运行斜杠命令。\n\n## 更改 CLI 处理扩展的方式\n\n你可以使用 Copilot 命令来限制 `/extensions mode` 对扩展的访问权限，或将这些扩展完全禁用。 使用此命令时，会获得三个选项：\n\n* **加载和扩充** （默认值）- CLI 运行扩展， \\_并\\_Copilot 可以管理它们。\n* **仅加载** — CLI 运行扩展，但 Copilot 无法管理它们。\n* **已禁用** — 扩展在当前会话中完全关闭，在将来的会话中将保持禁用状态，直到切换到其他两个设置之一。 其他当前会话不受影响。\n\n所做的任何更改都会立即在当前会话中生效：\n\n* **切换到“已禁用**”会停止当前正在运行的任何扩展。 其进程已关闭，并且其工具不再可用。\n* **从“已禁用”** 切换到其他任一设置将启动扩展。\n* 在 **“仅加载”** 和 **“加载并增强”** 之间切换只会改变Copilot是否能够管理你的扩展程序。\n\n### “管理扩展”的含义\n\n在 **“加载和增强** ”模式下， Copilot 提供一组额外的工具，用于在扩展系统上直接工作，作为执行请求的一部分。 借助这些工具，Copilot 可以：\n\n* **列出** 它发现的扩展，并查看其状态。\n* **检查**扩展（包括其日志文件的末尾内容），以帮助诊断失败或行为异常的扩展。\n* **搭建**新扩展：为你生成一个基础的 `extension.mjs` 文件，以供后续开发使用。\n* **重新加载** 扩展，以便它（或你）刚刚编写的代码生效，而无需重启会话。\n\n这就是为什么你可以让 Copilot 为你构建一个扩展。\nCopilot 可以创建文件、编写代码并重新加载它，而无需离开会话。\n\n如果您希望保留一组已知且受信任的扩展继续运行，但又不想让 \\*\\*\\*\\* 在其工作过程中附带创建、重新加载或以其他方式更改在您的计算机上运行的扩展代码，请选择 Copilot。 现有扩展仍在运行，并且 Copilot 仍可调用它们提供的工具;它根本无法自行管理扩展。\n\n## 扩展与插件的比较\n\n扩展和插件都添加了 Copilot CLI功能，但它们服务于不同的目的：\n\n* **扩展**是一个 JavaScript 模块，你编写该模块以添加工具和斜杠命令，由会话中运行的代码提供支持。\n* **插件**是一个可安装包，可将可重用组件（如代理、技能、挂钩和集成）捆绑在一起，并且可以通过市场分发。\n\n有关插件的详细信息，请参阅 [关于 GitHub Copilot 插件](/zh/copilot/concepts/agents/about-plugins)。\n\n## 延伸阅读\n\n* [为 GitHub Copilot CLI 创建扩展](/zh/copilot/tutorials/create-an-extension)\n* [GitHub Copilot CLI 命令参考](/zh/copilot/reference/copilot-cli-reference/cli-command-reference#slash-commands-in-the-interactive-interface)\n* [GitHub Copilot CLI](/zh/copilot/how-tos/copilot-cli)"}