{"meta":{"title":"GitHub Copilot CLI 命令参考","intro":"查找有助于有效使用的 Copilot 命令行界面（CLI） 命令和键盘快捷方式。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/zh/enterprise-cloud@latest/copilot/reference","title":"参考资料"},{"href":"/zh/enterprise-cloud@latest/copilot/reference/copilot-cli-reference","title":"Copilot 命令行界面（CLI） 参考"},{"href":"/zh/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference","title":"CLI 命令参考"}],"documentType":"article"},"body":"# GitHub Copilot CLI 命令参考\n\n查找有助于有效使用的 Copilot 命令行界面（CLI） 命令和键盘快捷方式。\n\n## 命令行命令\n\n| 命令 | Purpose |\n| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `copilot` | 启动交互式用户界面。 |\n| `copilot completion SHELL` | 生成一份适用于所选 Shell 的 shell 脚本，你可以利用该脚本来为 Copilot 命令行界面（CLI） 启用 Tab 键补全功能。 支持的 shell： `bash`、 `zsh`、 `fish`。 请参阅[使用 `copilot completion`](#using-copilot-completion)。 |\n| `copilot help [TOPIC]` | 显示帮助信息。 帮助主题包括：`billing`、、、`config`、`commands``environment``logging`、`monitoring`、 `permissions`和`providers`。 |\n| `copilot init` | 初始化 Copilot 此存储库的自定义说明。 |\n| `copilot login` | 使用 OAuth 设备流通过 Copilot进行身份验证。 接受 `--host HOST` 以指定 GitHub 主机 URL （默认值： `https://github.com`） 。 |\n| `copilot login` \\[选项] | 使用 OAuth 设备流通过 Copilot进行身份验证。 请参阅 [`copilot login` 选项](#copilot-login-options)。 |\n| `copilot mcp` | 从命令行管理 MCP 服务器配置。 |\n| `copilot plugin` | 管理插件和插件市场。 |\n| `copilot update` | 下载并安装最新版本。 |\n| `copilot version` | 显示版本信息并检查更新。 |\n\n### `copilot login` 选项\n\n| 选项 | Purpose |\n| ------------------------------------------------------------------------------------------------------------------------- | ------- |\n| `--host HOST` | |\n| GitHub 主机 URL （默认值： `https://github.com`） 。 使用此方法向使用数据驻留（例如 GitHub Enterprise Cloud）的 `https://example.ghe.com` 实例进行身份验证。 | |\n\n默认身份验证模式是基于 Web 的浏览器流。 完成后，身份验证令牌安全地存储在系统凭据存储中。 如果未找到凭据存储，则令牌存储在纯文本配置文件中`~/.copilot/`（如果已设置，则在指定的`COPILOT_HOME`目录中）。\n\n或者， Copilot 命令行界面（CLI） 将使用在环境变量中找到的身份验证令牌。 以下项按优先级顺序进行检查： `COPILOT_GITHUB_TOKEN`， `GH_TOKEN`。 `GITHUB_TOKEN` 此方法最适合无外设使用，例如自动化。\n\n支持的令牌类型包括具有“Copilot 请求”权限的 fine-grained personal access tokens (v2 PATs)，Copilot CLI 应用中的 OAuth 令牌，以及 GitHub CLI (`gh`) 应用中的 OAuth 令牌。 不支持经典 personal access tokens （`ghp_`）。\n\n**示例：**\n\n```shell\n# Authenticate with github.com\ncopilot login\n\n# Authenticate with GitHub Enterprise Cloud (data residency)\ncopilot login --host https://example.ghe.com\n\n# Use a fine-grained PAT via environment variable\nCOPILOT_GITHUB_TOKEN=github_pat_... copilot\n```\n\n### 使用 `copilot completion`\n\n该命令 `copilot completion SHELL` 输出指定 shell（bash、zsh 或 fish）的脚本。\n\n通过执行该脚本（或将其写入 shell 的补全目录），即可在终端中为 `copilot` 的子命令、命令选项以及命令选项的已知取值，启用 Tab 键自动补全功能。\n\n#### 用法示例\n\nBash （仅限当前会话）：\n\n```bash copy\nsource <(copilot completion bash)\n```\n\nBash （持久性，Linux）：\n\n```bash copy\ncopilot completion bash | sudo tee /etc/bash_completion.d/copilot\n```\n\nZsh — 将输出写入 $fpath 路径中的一个目录。 运行此命令后重启 shell：\n\n```shell copy\ncopilot completion zsh > \"${fpath[1]}/_copilot\"\n```\n\n鱼：\n\n```shell copy\ncopilot completion fish > ~/.config/fish/completions/copilot.fish\n```\n\n## 交互式界面中的全局快捷方式\n\n| Shortcut | Purpose |\n| ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |\n| `@ FILENAME` | 将文件内容包含在上下文中。 |\n| `# NUMBER` | 在上下文中包含 GitHub 问题或拉取请求。 |\n| `! COMMAND` | 在本地 shell 中执行命令，绕过 Copilot。 在空提示符下单独输入 `!` ，以按顺序输入运行多个 shell 命令的 shell 模式。 在空提示符上按 Esc 或 Ctrl+C 退出 shell 模式。 |\n| `?` | 打开快速帮助（在空白提示中）。 |\n| Esc | 取消当前操作。 |\n| Ctrl+C | 取消操作/清除输入。 按两次退出。 |\n| Ctrl+D | 关闭。 |\n| Ctrl+G | 在外部编辑器中编辑提示（`$EDITOR`）。 |\n| Ctrl+L | 清除屏幕。 |\n| Ctrl+Enter 或 Ctrl+Q | 将消息排队，以在智能体繁忙时发送。 |\n| Ctrl+R | 反向搜索命令历史记录。 |\n| Ctrl+V | 从剪贴板粘贴为附件。 |\n| Ctrl+然后 X`/` | 开始键入提示后，这样就可以运行斜杠命令，例如，如果要更改模型，而无需重新键入提示。 |\n| Ctrl+然后 X`e` | 在外部编辑器中编辑提示（`$EDITOR`）。 |\n| Ctrl+然后 X`b` | 将正在运行的任务或 shell 命令提升到后台。 |\n| Ctrl+然后 X`o` | 从时间线打开最新的链接。 |\n| Ctrl+Z | 将进程挂起到后台 (Unix)。 |\n| Shift+Enter 或 Option+Enter （Mac） / Alt+Enter （Windows/Linux） | 在输入中插入换行符。 |\n| Shift键+Tab键 | 在标准模式、计划和 Autopilot 模式之间循环。 |\n\n## 交互式界面中的时间线快捷方式\n\n| Shortcut | Purpose |\n| ------------------------------- | ------------------------------------------------- |\n| Ctrl+F | 打开时间线搜索。 |\n| Ctrl+O | 虽然提示输入中没有任何内容，但这会扩展 Copilot 回复时间线中的最近项目以显示更多详细信息。 |\n| Ctrl+E | 虽然提示输入中没有任何内容，但这会展开Copilot的响应时间轴中的所有项。 |\n| Ctrl+T | 在响应中展开/折叠推理显示。 |\n| 向上翻页/向下翻页 | 将当前时间线视图向上或向下翻动一页。 |\n\n## 会话选取器快捷方式\n\n会话选择器打开时（通过 `/resume` 或 `--continue` 打开）：\n\n| Shortcut | Purpose |\n| ------------------------- | ---------------------------- |\n| ↑/↓ | 向上或向下移动所选内容。 |\n| 输入 | 打开所选会话。 |\n| `s` | 在以下排序顺序中循环：相关性→创建时间→名称→上次使用。 |\n| Tab | 在本地选项卡和远程选项卡之间切换。 |\n| `d` | 删除所选会话。 |\n| Esc | 关闭选取器。 |\n\n会话按以下模式排序：\n\n| 模式 | 说明 |\n| ----------- | -------------------------- |\n| `relevance` | 根据与当前工作目录的匹配度对会话进行排序（默认）。 |\n| `last used` | 最近修改的会话优先。 |\n| `created` | 最近创建的会话优先。 |\n| `name` | 按会话名称按字母顺序排列;未命名的会话将排序到末尾。 |\n\n已在另一个窗口中打开的会话在所有非相关性排序模式下浮动到顶部。 当没有工作目录上下文可用时，将跳过 `relevance` 模式。\n\n## 差异模式快捷方式\n\n当打开差异模式时（通过 `/diff` 进入）：\n\n| Shortcut | Purpose |\n| --------------------------------------------- | ------------------ |\n| ↑ / `k` | 将所选内容向上移动一行。 |\n| ↓ / `j` | 将所选内容向下移动一行。 |\n| ← / `h` | 跳转到上一个文件。 |\n| → / `l` | 跳转到下一个文件。 |\n| 家 / `g` | 跳到第一行。 |\n| 结束 / `G` | 跳到最后一行。 |\n| 向上翻页 | 向上滚动一页。 |\n| 向下翻页 | 向下滚动一页。 |\n| Ctrl+U | 向上滚动半页。 |\n| Ctrl+D | 向下滚动半页。 |\n| `Click` | 选择所单击的差异行（需要鼠标支持）。 |\n| 鼠标滚动 | 向上或向下滚动。 |\n| `c` | 在所选行上添加或编辑批注。 |\n| `s` | 显示批注摘要（当存在批注时）。 |\n| `b` | 在未标记的更改和分支差异之间切换。 |\n| 输入 | 提交所有注释（如果存在批注）。 |\n| `r` | 刷新差异（仅限远程会话）。 |\n| Esc / Ctrl+C | 退出差异模式。 |\n\n在前 10 次快速按下之后，按住 ↑ 或 ↓ 会加快滚动速度。 鼠标支持需要启用 `--mouse`（在 alt-screen 模式下默认启用）。 使用 `--no-mouse` 禁用。\n\n## 交互式界面中的导航快捷方式\n\n| Shortcut | Purpose |\n| ------------------------------------------------------------ | ---------------------------- |\n| Ctrl+A | 移动到行首（输入时）。 |\n| Ctrl+B | 移到上一个字符。 |\n| Ctrl+E | 移动到行的末尾（键入时）。 |\n| Ctrl+F | 移动到下一个字符。 |\n| Ctrl+H | 删除上一个字符。 |\n| Ctrl+K | 从光标删除到行尾。 如果光标位于行的末尾，请删除换行符。 |\n| Ctrl+U | 从光标删除到行首。 |\n| Ctrl+W | 删除上一个单词。 |\n| 主页 | 跳转至当前可视化行首。 |\n| 结束 | 跳转至当前可视化行尾。 |\n| Ctrl+主页 | 移动到文本的开头。 |\n| Ctrl+结束 | 移动到文本的末尾。 |\n| Alt+←/→ （Windows/Linux）
| |\n| 选项+←/→ （Mac） | 按单词移动光标。 |\n| ↑/↓ | 浏览命令历史。 |\n| Tab键 / Ctrl+Y | 接受当前的内联补全建议。 |\n\n## 交互式接口中的斜杠命令\n\n| 命令 | Purpose |\n| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `/add-dir PATH` | 将目录添加到允许的文件访问列表。 |\n| `/agent` | 浏览并选择可用代理（如果有）。 请参阅“[关于自定义代理](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/about-custom-agents)”。 |\n| `/ask QUESTION` | 在不添加到对话历史记录的情况下提出一个快速的附带问题。 仅在实验模式下可用。 |\n| `/allow-all [on\\|off\\|show]`、`/yolo [on\\|off\\|show]` | 启用所有权限（工具、路径和 URL）。 |\n| `/changelog [summarize] [VERSION\\|last N\\|since VERSION]`、`/release-notes [summarize] [VERSION\\|last N\\|since VERSION]` | 显示 CLI 更改日志。 可选地指定一个版本、最近发布的版本数量或起始版本。 请为 AI 生成的摘要添加关键字 `summarize` 。 |\n| `/chronicle ` | 会话历史工具和分析。 请参阅“[关于 GitHub Copilot 命令行界面 (CLI) 会话数据](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/chronicle)”。 |\n| `/clear [PROMPT]`、`/new [PROMPT]`、`/reset [PROMPT]` | 启动新对话。 |\n| `/clikit [COMPONENT]` | 预览 CLI 业务组件（例如配额信息）。 |\n| `/collect-debug-logs [file\\|gist] [PATH]` | 将调试日志收集到归档文件或 GitHub gist 中。 |\n| `/diagnose [PROMPT]` | 分析当前会话日志，并选择性地提示代理询问诊断问题。 |\n| `/compact [FOCUS-INSTRUCTIONS]` | 汇总对话历史记录以减少上下文窗口使用情况。 （可选）提供焦点说明来引导摘要，例如 `/compact focus on the auth module`。 请参阅“[在 GitHub Copilot 命令行界面 (CLI) 中管理上下文](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/context-management#compaction)”。 |\n| `/context` | 显示上下文窗口令牌使用情况和可视化效果。 请参阅“[在 GitHub Copilot 命令行界面 (CLI) 中管理上下文](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/context-management#checking-your-context-usage)”。 |\n| `/copy` | 将最后一个响应复制到剪贴板。 |\n| `/cwd`、`/cd [PATH]` | 更改工作目录或显示当前目录。 |\n| `/delegate [PROMPT]` | 使用 AI 生成的拉取请求提交更改到远程存储库。 请参阅“[将任务委派给 Copilot](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/delegate-tasks-to-cca)”。 |\n| `/diff` | 查看当前目录中的更改;当工作树干净（实验性）时，自动切换到分支差异。 |\n| `/downgrade ` | 下载并重启到特定 CLI 版本。 可用于团队帐户。 |\n| `/env` | 显示加载的环境详细信息（说明、MCP 服务器、技能、代理、插件、LSP、挂钩、扩展）。 |\n| `/exit`、`/quit` | 退出 CLI。 |\n| `/extensions [manage\\|mode]`、`/extension` | 管理 CLI 扩展。 |\n| `/experimental [on\\|off\\|show]` | 切换、设置或显示实验性功能。 |\n| `/feedback`、`/bug` | 提供有关 CLI 的反馈。 |\n| `/fleet [PROMPT]` | 支持对任务的某些部分进行并行子代理执行。 请参阅“[使用 \\`/fleet\\` 命令并行运行任务](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/fleet)”。 |\n| `/help` | 显示交互式命令的帮助。 |\n| `/ide` | 连接到 IDE 工作区。 请参阅“[连接GitHub Copilot 命令行界面 (CLI)到VS Code](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/connecting-vs-code#managing-the-connection-with-the-ide-slash-command)”。 |\n| `/init` | 初始化此存储库的 Copilot 自定义说明和智能体功能。 请参阅 [项目初始化Copilot](#project-initialization-for-copilot)。 |\n| `/instructions` | 查看和切换自定义指令文件。 |\n| `/keep-alive [on\\|off\\|busy\\|DURATION]`、`/caffeinate [on\\|off\\|busy\\|DURATION]` | 防止计算机进入睡眠状态：当命令行界面（CLI）会话处于活动状态，或者软件代理繁忙，或者在设定的时间段内。 接受持续时间，例如`30`、`30m`、`2h`、`1d`（裸数默认为分钟）。 |\n| `/list-dirs` | 显示允许访问文件的所有目录。 |\n| `/login` | 登录到 Copilot。 |\n| `/logout` | 注销 Copilot。 |\n| `/lsp [show\\|test\\|reload\\|help] [SERVER-NAME]` | 管理语言服务器配置。 |\n| `/mcp [show\\|add\\|edit\\|delete\\|disable\\|enable\\|auth\\|reload] [SERVER-NAME]` | 管理 MCP 服务器配置。 请参阅“[为 GitHub Copilot 命令行界面 (CLI) 添加 MCP 服务器](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers#managing-mcp-servers)”。 |\n| `/model`、`/models [MODEL]` | 选择要使用的 AI 模型。 |\n| `/permissions [show\\|reset]` | 查看或清除当前会话中内存中的工具和路径授权。 |\n| `/plan [PROMPT]` | 在编码之前创建实现计划。 |\n| `/plugin [marketplace\\|install\\|uninstall\\|update\\|list] [ARGS...]` | 管理插件和插件市场。 请参阅“[关于 GitHub Copilot 命令行界面 (CLI) 的插件](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/about-cli-plugins)”。 |\n| `/pr [view\\|create\\|fix\\|auto]` | 管理当前分支的拉取请求。 请参阅“[使用 /pr 命令管理拉取请求](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/manage-pull-requests)”。 |\n| `/remote [on\\|off]` | 显示远程控制状态（如果未提供任何参数）、启用远程转向（`on`）或结束远程连接（`off`）。 请参阅“[通过其他设备控制 GitHub Copilot 命令行界面 (CLI) 会话](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/steer-remotely)”。 |\n| `/rename [NAME]` | 重命名当前会话（如果省略，将自动生成名称；这是`/session rename`的别名）。 |\n| `/research TOPIC` | 使用 GitHub 搜索和 Web 源进行深入调查。 请参阅“[使用GitHub Copilot 命令行界面 (CLI)进行研究](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/research)”。 |\n| `/reset-allowed-tools` | 重置允许的工具列表。 |\n| `/restart` | 重启 CLI，保留当前会话。 |\n| `/resume [SESSION-ID]`、`/continue [SESSION-ID]` | 通过从列表中选择（可选指定会话 ID）切换到其他会话。 |\n| `/review [PROMPT]` | 运行代码评审代理以分析更改。 请参阅“[使用 GitHub Copilot 命令行界面 (CLI) 请求代码评审](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/agentic-code-review)”。 |\n| `/rubber-duck [PROMPT]` | 有关计划、代码和测试的第二条意见，请咨询橡胶鸭代理。 请参阅“[关于橡皮鸭智能体](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/rubber-duck)”。 |\n| `/sandbox [enable\\|disable]` | 配置 shell 命令沙盒化。 |\n| `/search [QUERY]`、`/find [QUERY]` | 搜索对话时间线。 仅在实验模式下可用。 |\n| `/session [info\\|checkpoints [n]\\|files\\|plan\\|rename [NAME]\\|cleanup\\|prune\\|delete [ID]\\|delete-all]`、`/sessions [info\\|checkpoints [n]\\|files\\|plan\\|rename [NAME]\\|cleanup\\|prune\\|delete [ID]\\|delete-all]` | 显示会话信息和管理会话。 子 `info` 命令显示会话详细信息，包括会话链接（如果可用）。 子命令：`info`、、、`checkpoints`、`files``plan``rename``cleanup`、`prune`、。 `delete``delete-all` |\n| `/share [file\\|html\\|gist] [session\\|research] [PATH]`、`/export [file\\|html\\|gist] [session\\|research] [PATH]` | 将会话共享到 Markdown 文件、交互式 HTML 文件或 GitHub gist。 |\n| `/skills [list\\|info\\|add\\|remove\\|reload] [ARGS...]` | 管理技能以提升能力。 请参阅“[为 GitHub Copilot 命令行界面 (CLI) 添加代理技能](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/create-skills)”。 |\n| `/statusline`、`/footer` | 配置状态行中显示的项。 |\n| `/tasks` | 查看和管理任务（子代理和 shell 命令）。 |\n| `/terminal-setup` | 为多行输入支持配置终端（Shift+Enter 和 Ctrl+Enter）。 |\n| `/theme [default\\|dim\\|high-contrast\\|colorblind]` | 查看或设置颜色模式。 |\n| `/tuikit [colors\\|icons\\|select\\|tabbar]` | 预览 TUIkit 设计系统组件和颜色令牌。 |\n| `/undo`、`/rewind` | 倒退最后一轮并还原文件更改。 |\n| `/update`、`/upgrade` | 将 CLI 更新到最新版本。 |\n| `/usage` | 显示会话使用情况指标和统计信息。 |\n| `/user [show\\|list\\|switch]` | 管理当前 GitHub 用户。 |\n| `/version` | 显示版本信息并检查更新。 |\n| `/worktree [branch]`、`/move [branch]` | 创建新的 git 工作树并切换到它，移动任何未提交的更改。 如果省略分支名称，则会从会话中自动生成名称。 需要 git 存储库。 仅在实验模式下可用。 |\n\n要获取所有可用的斜杠命令的完整列表，请在 CLI 的交互式界面中输入 `/help`。\n\n## 命令行选项\n\n| 选项 | Purpose | |\n| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |\n| `--add-dir=PATH` | 将目录添加到允许的文件访问列表（可多次使用）。 | |\n| `--add-github-mcp-tool=TOOL` | 添加工具以启用 GitHub MCP 服务器，而不是默认 CLI 子集（可多次使用）。 将 `*` 用于所有工具。 | |\n| `--add-github-mcp-toolset=TOOLSET` | 添加工具集以启用 GitHub MCP 服务器，而不是默认 CLI 子集（可多次使用）。 对所有工具集使用 `all`。 | |\n| `--additional-mcp-config=JSON` | 仅为此会话添加 MCP 服务器。 服务器配置可以作为 JSON 字符串或文件路径（前缀） `@`提供。 从 `~/.copilot/mcp-config.json` 扩充配置。 覆盖任何已安装的同名 MCP 服务器配置。 请参阅“[为 GitHub Copilot 命令行界面 (CLI) 添加 MCP 服务器](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)”。 | |\n| `--agent=AGENT` | 指定要使用的值 自定义智能体 。 请参阅“[关于自定义代理](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/about-custom-agents)”。 | |\n| `--allow-all` | 启用所有权限（等效于 `--allow-all-tools --allow-all-paths --allow-all-urls`）。 | |\n| `--allow-all-paths` | 禁用文件路径验证并允许访问任何路径。 | |\n| `--allow-all-tools` | 允许所有工具在不确认的情况下自动运行。 以编程方式使用 CLI 时是必需的（env： `COPILOT_ALLOW_ALL`）。 | |\n| `--allow-all-urls` | 允许在没有确认的情况下访问所有 URL。 | |\n| `--allow-tool=TOOL ...` | CLI 有权使用的工具。 不会提示输入权限。 对于多个工具，请使用带引号的逗号分隔列表。 请参阅“[允许和拒绝工具使用](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/allowing-tools#allowing-or-denying-permission-for-specific-tools)”。 | |\n| `--allow-url=URL ...` | 允许访问特定的网址或域。 对于多个 URL，请使用带引号的逗号分隔列表。 | |\n| `--autopilot` | 在提示模式下启用 Autopilot 延续。 请参阅“[允许 GitHub Copilot CLI 自主工作](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/autopilot)”。 | |\n| `--available-tools=TOOL ...` | 只有这些工具可供模型使用。 对于多个工具，请使用带引号的逗号分隔列表。 请参阅“[允许和拒绝工具使用](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/allowing-tools)”。 | |\n| `--banner`、`--no-banner` | 显示或隐藏启动横幅。 | |\n| `--bash-env` | 启用 `BASH_ENV` 对 bash shell 的支持。 | |\n| `--connect[=SESSION-ID]` | 直接连接到远程会话（可选）指定会话 ID 或任务 ID。 与 `--resume` 和 `--continue`. | |\n| `--config-dir=DIRECTORY` | 用于设置配置目录的选项已弃用。 请改用 `COPILOT_HOME` 环境变量。 | |\n| `--continue` | 恢复当前工作目录中的最新会话，回退到全局最新会话。 | |\n| `--deny-tool=TOOL ...` | CLI 没有使用权限的工具。 不会提示输入权限。 对于多个工具，请使用带引号的逗号分隔列表。 | |\n| `--deny-url=URL ...` | 拒绝访问特定 URL 或域，优先于 `--allow-url`。 对于多个 URL，请使用带引号的逗号分隔列表。 | |\n| `--disable-builtin-mcps` | 禁用所有内置 MCP 服务器（当前： `github-mcp-server`）。 | |\n| `--disable-mcp-server=SERVER-NAME` | 禁用特定的 MCP 服务器（可以多次使用）。 | |\n| `--disallow-temp-dir` | 防止自动访问系统临时目录。 | |\n| `--effort=LEVEL`、`--reasoning-effort=LEVEL` | 设置推理工作量级别（`low`、、`medium``high`、`xhigh``max`）。 | |\n| `max`是Anthropic模型中深度最高的层级。 | | |\n| `--enable-all-github-mcp-tools` | 启用所有 GitHub MCP 服务器工具，而不是默认 CLI 子集。 | |\n| `--add-github-mcp-toolset`和`--add-github-mcp-tool`选项被覆盖。 | | |\n| `--enable-reasoning-summaries` | 请求对支持它的 OpenAI 模型进行推理摘要。 | |\n| `--excluded-tools=TOOL ...` | 这些工具将不适用于模型。 对于多个工具，请使用带引号的逗号分隔列表。 | |\n| `--experimental` | 启用实验性功能（使用 `--no-experimental` 进行禁用）。 | |\n| `-h`、`--help` | 显示帮助。 | |\n| `-i PROMPT`、`--interactive=PROMPT` | 启动交互式会话并自动执行此提示。 | |\n| `--log-dir=DIRECTORY` | 设置日志文件目录（默认值： `~/.copilot/logs/`）。 | |\n| `--log-level=LEVEL` | 设置日志级别（选项：`none`、、`error``warning`、`info`、`debug`、`all``default`）。 | |\n| `--max-autopilot-continues=COUNT` | Autopilot 模式下的最大延续消息数（默认值：无限制）。 请参阅“[允许 GitHub Copilot CLI 自主工作](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/autopilot)”。 | |\n| `--mode=MODE` | 设置初始代理模式（选项：`interactive`、、`plan``autopilot`）。 不能与 `--autopilot` 或 `--plan`. | |\n| `--model=MODEL` | 设置要使用的 AI 模型。 传递`auto`让Copilot自动选择最佳可用模型。 | |\n| `--mouse[=VALUE]` | 在备用屏幕模式下启用鼠标支持。 VALUE 可以是 `on` （默认值） 或 `off`。 启用后，CLI 在备用屏幕模式下捕获鼠标事件，包括滚轮、单击等。禁用后，将保留终端的默认鼠标行为。 设置完成后，该设置将保存到你的配置文件中。 | |\n| `-n NAME`、`--name=NAME` | 设置新会话的名称。 供 `--resume` 和 `/resume` 用于按名称查找会话。 | |\n| `--no-ask-user` | | |\n| `ask_user`禁用该工具（代理在不提出问题的情况下自主工作）。 | | |\n| `--no-auto-update` | 禁用自动下载 CLI 更新。 | |\n| `--no-bash-env` | 禁用 `BASH_ENV` 对 bash shell 的支持。 | |\n| `--no-color` | 禁用所有颜色输出。 | |\n| `--no-custom-instructions` | 禁止从 `AGENTS.md` 相关文件中加载自定义指令。 | |\n| `--no-experimental` | 禁用实验性功能。 | |\n| `--no-mouse` | 禁用鼠标支持。 | |\n| `--no-remote` | 禁用此会话的远程访问。 | |\n| `--output-format=FORMAT` | FORMAT 可以是 `text` （默认值）或 `json` （输出 JSONL：每行一个 JSON 对象）。 | |\n| `-p PROMPT`、`--prompt=PROMPT` | 以编程方式执行提示（完成后退出）。 请参阅“[以编程方式运行GitHub Copilot 命令行界面 (CLI)](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/automate-copilot-cli/run-cli-programmatically)”。 | |\n| `--plan` | 在计划模式下启动。 | |\n| `--mode plan` 的速记。 不能与 `--mode` 或 `--autopilot`. | | |\n| `--plain-diff` | 禁用富差异渲染（通过你的 git 配置指定的差异工具进行语法高亮显示）。 | |\n| `--plugin-dir=DIRECTORY` | 从本地目录加载插件（可以多次使用）。 | |\n| `--remote` | 启用从GitHub.com和GitHub Mobile远程访问此会话。 请参阅“[通过其他设备控制 GitHub Copilot 命令行界面 (CLI) 会话](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/steer-remotely)”。 | |\n| `-r`、`--resume[=VALUE]` | 通过从列表中选择来恢复以前的交互式会话。 （可选）指定会话 ID、ID 前缀或会话名称。 名称匹配精确且不区分大小写;当没有显式名称匹配时，回退到自动生成的摘要。 | |\n| `-s`、`--silent` | 仅输出代理响应（不使用使用情况统计信息），对于使用 `-p`脚本编写非常有用。 | |\n| `--screen-reader` | 启用屏幕阅读器优化。 | |\n| `--secret-env-vars=VAR ...` | 从 shell 和 MCP 服务器环境（可以多次使用）中修订环境变量。 对于多个变量，请使用带引号的逗号分隔列表。 默认情况下， `GITHUB_TOKEN` 和 `COPILOT_GITHUB_TOKEN` 环境变量中的值会从输出中隐藏。 | |\n| `--share=PATH` | 程序化会话结束后，将会话共享到 Markdown 文件（默认路径：`./copilot-session-.md`）。 | |\n| `--share-gist` | 在编程会话完成后，将会话共享给机密 GitHub gist。 | |\n| `--stream=MODE` | 启用或禁用流模式，该模式在生成时逐渐显示 Copilot其响应，而不是等待完整响应到达（模式选项： `on` 或 `off`，默认值： `on`） 。 | |\n| `-v`、`--version` | 显示版本信息。 | |\n| `--yolo` | 启用所有权限（等效于 `--allow-all`）。 | |\n\n有关命令和选项的完整列表，请运行 `copilot help`。\n\n> \\[!NOTE]\n> 选项`--remote`、`--no-remote`和`--connect`需要您的帐户具有远程会话功能。\n\n你可以将`--remote`与`--resume `配合使用，在本地恢复远程任务。 即使任务最初是在 Git 存储库外部创建的，也是如此。\n\n> \\[!NOTE]\n> 当在设置中将 `permissions.disableBypassPermissionsMode` 设为 `\"disable\"` 时，所有“全部允许”标志（`--allow-all-tools`、`--allow-all-paths`、`--allow-all-urls`、`--allow-all`、`--yolo`）都会在启动时被禁用，且不能用于授予更高权限。\n\n## 支持的模型\n\n使用 `--model=MODEL` 或 `COPILOT_MODEL` 环境变量选择 AI 模型。 传递`auto`让Copilot自动选择最佳可用模型。\n\n| 型号 | 最适用于 |\n| ------------------------ | ------------------- |\n| `claude-sonnet-4.6` | 常规用途编码（默认值） |\n| `gpt-5.4` | 复杂的推理任务 |\n| `claude-haiku-4.5` | 快速、轻量的操作 |\n| `gpt-5.3-codex` | 以代码为中心的任务 |\n| `gemini-3.1-pro-preview` | 谷歌双子座推理 |\n| `gemini-3.5-flash` | 快速 Google Gemini 响应 |\n\n还可以使用斜杠命令在 `/model` 交互式会话期间切换模型。\n\n## 工具可用性值\n\n和`--available-tools``--excluded-tools`选项支持以下值：\n\n### Shell 工具\n\n| 工具名称 | 说明 |\n| --------------------------------- | --------------- |\n| `bash` / `powershell` | 执行命令 |\n| `list_bash` / `list_powershell` | 列出活动 shell 会话 |\n| `read_bash` / `read_powershell` | 从 shell 会话中读取输出 |\n| `stop_bash` / `stop_powershell` | 终止 shell 会话 |\n| `write_bash` / `write_powershell` | 将输入发送到 shell 会话 |\n\n### 文件操作工具\n\n| 工具名称 | 说明 |\n| ------------- | -------------------------------------- |\n| `apply_patch` | 应用修补程序（某些模型使用修补程序，而不是 `edit`/`create`） |\n| `create` | 创建新文件 |\n| `edit` | 通过字符串替换编辑文件 |\n| `view` | 读取文件或目录 |\n\n### 代理和任务委派工具\n\n| 工具名称 | 说明 |\n| ------------- | -------- |\n| `list_agents` | 列出可用的代理 |\n| `read_agent` | 检查后台代理状态 |\n| `task` | 运行子代理 |\n\n### 其他工具\n\n| 工具名称 | 说明 |\n| -------------- | ------------ |\n| `ask_user` | 向用户提问 |\n| `glob` | 查找匹配模式的文件 |\n| `grep`（或 `rg`） | 搜索文件中的文本 |\n| `skill` | 调用自定义技能 |\n| `web_fetch` | 提取和分析 Web 内容 |\n\n## 工具权限模式\n\n`--allow-tool`和`--deny-tool`选项接受格式为`Kind(argument)`的权限模式。 该参数是可选的， 省略它与该类型的所有工具匹配。\n\n| 种类 | 说明 | 示例模式 |\n| ------------------------------------------ | ----------------------- | -------- |\n| `memory` | 将事实存储到代理内存 | `memory` |\n| `read` | 文件或目录读取 | |\n| `read`、`read(.env)` | | |\n| `shell` | Shell 命令执行 | |\n| `shell(git push)`、`shell(git:*)`、`shell` | | |\n| `url` | 通过 web 抓取或 shell 访问 URL | |\n| `url(github.com)`、`url(https://*.api.com)` | | |\n| `write` | 文件创建或修改 | |\n| `write`、`write(src/*.ts)` | | |\n| SERVER-NAME | MCP 服务器工具调用 | |\n| `MyMCP(create_issue)`、`MyMCP` | | |\n\n对于 `shell` 规则，`:*` 后缀与命令主干后跟一个空格匹配，以避免部分匹配。 例如， `shell(git:*)` 匹配 `git push` 和 `git pull` 不匹配 `gitea`。\n\n即使设置了拒绝规则， `--allow-all` 拒绝规则始终优先于允许规则。\n\n```shell\n# Allow all git commands except git push\ncopilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'\n\n# Allow a specific MCP server tool\ncopilot --allow-tool='MyMCP(create_issue)'\n\n# Allow all tools from a server\ncopilot --allow-tool='MyMCP'\n```\n\n## 环境变量\n\n| Variable | 说明 |\n| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `COLORFGBG` | 适用于深色/浅色终端背景检测的回退。 |\n| `COPILOT_ALLOW_ALL` | 将其设置为 `true` 以自动允许所有权限（相当于 `--allow-all`）。 |\n| `COPILOT_AUTO_UPDATE` | 设置为 `false` 禁用自动更新。 |\n| `COPILOT_CACHE_HOME` | 替代缓存目录（用于市场缓存、自动更新包和其他临时数据）。 有关平台默认值，请参阅 [GitHub Copilot CLI 配置目录](/zh/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference#changing-the-location-of-the-configuration-directory) 。 |\n| `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` | 自定义说明中额外目录的逗号分隔列表。 |\n| `COPILOT_EDITOR` | 用于交互式编辑的编辑器命令（在 `$VISUAL` 和 `$EDITOR` 后检查）。 如果未设置，则默认为`vi`。 |\n| `COPILOT_ENABLE_HTTP2` | 将其设置为 `1` 或 `true` 以启用 HTTP/2 传输。 HTTP/1.1 是默认值。 |\n| `COPILOT_GH_HOST` | |\n| GitHub 仅用于 Copilot 命令行界面（CLI） 的主机名，覆盖 `GH_HOST`。 适用于以下场景：`GH_HOST` 的目标是 GitHub Enterprise Server，但 Copilot 却需要针对 GitHub.com 或 GitHub Enterprise Cloud 主机名来进行身份验证。 | |\n| `COPILOT_GITHUB_TOKEN` | 身份验证令牌。 优先于 `GH_TOKEN` 和 `GITHUB_TOKEN`。 |\n| `COPILOT_HOME` | 覆盖配置和状态目录。 默认值：`$HOME/.copilot`。 |\n| `COPILOT_MODEL` | 设置 AI 模型。 |\n| `COPILOT_PROMPT_FRAME` | |\n| `1`设置为在输入提示周围启用装饰性 UI 框架，或`0`将其禁用。 替代当前会话的 `PROMPT_FRAME` 实验性功能标志。 | |\n| `COPILOT_SKILLS_DIRS` | 技能附加目录的逗号分隔列表。 |\n| `COPILOT_SUBAGENT_MAX_CONCURRENT` | 整个会话树中的最大并发子代理数。 默认值：`32`。 范围： `1`–`256`. |\n| `COPILOT_SUBAGENT_MAX_DEPTH` | 最大子代理嵌套深度。 默认值：`6`。 范围： `1`–`256`. |\n| `GH_HOST` | |\n| GitHub 和 GitHub CLI 的 Copilot 命令行界面（CLI） 主机名（默认值：`github.com`）。 将其设置为带有数据驻留主机名的 GitHub Enterprise Cloud。 仅替代为 `COPILOT_GH_HOST` 的 Copilot 命令行界面（CLI）。 | |\n| `GH_TOKEN` | 身份验证令牌。 优先于 `GITHUB_TOKEN`. |\n| `GITHUB_COPILOT_PROMPT_MODE_EXTENSIONS` | 设置为 `true` 加载项目扩展并允许在提示模式下使用扩展管理工具（`-p`）。 默认情况下禁用以防止运行存储库控制的扩展代码，而无需交互式信任。 |\n| `GITHUB_COPILOT_PROMPT_MODE_REPO_HOOKS` | 设置为 `true` 以在提示模式 (`-p`)下加载存储库挂钩。 如果该文件夹已受信任或已设置 `COPILOT_ALLOW_ALL`，仓库钩子也会自动加载。 |\n| `GITHUB_COPILOT_PROMPT_MODE_WORKSPACE_MCP` | 将其设置为 `true` 以在提示模式下加载工作区 MCP 源（`-p`）。 默认情况下禁用以防止启动存储库控制的 MCP 服务器，而无需交互式信任。 |\n| `GITHUB_TOKEN` | 身份验证令牌。 |\n| `PLAIN_DIFF` | 设置为 `true` 以禁用多差异呈现。 |\n| `USE_BUILTIN_RIPGREP` | 设置为 `false` 以使用系统 ripgrep，而不是捆绑的版本。 |\n\n## 配置文件设置\n\n有关配置文件设置的详细信息（包括用户设置、存储库设置、本地设置及其级联方式的完整列表），请参阅 [GitHub Copilot CLI 配置目录](/zh/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings)。\n\n> \\[!NOTE]\n> 用户设置以前存储在 `~/.copilot/config.json`. 该位置中的现有用户可编辑设置将在启动时自动迁移到 `~/.copilot/settings.json` 该位置。\n\n## Copilot 的项目初始化\n\n使用命令 `copilot init`或交互式会话中的斜杠命令 `/init` 时， Copilot 分析代码库并写入或更新 `.github/copilot-instructions.md` 存储库中的文件。 此自定义说明文件包含特定于项目的指南，可改进将来的 CLI 会话。\n\n当你启动新项目时，或者当你在现有存储库中开始使用 `copilot init` 时，你通常会使用`/init` 或 Copilot 命令行界面（CLI）。\n\n`copilot-instructions.md`创建或更新的文件通常记录信息：\n\n* 生成、测试和 Lint 命令。\n* 高级体系结构。\n* 特定于代码库的约定。\n\n如果文件已存在，Copilot 会提议可选择应用或拒绝的改进。\n\nCLI 在启动时查找 `copilot-instructions.md` 文件，如果缺少该文件，则会显示消息：\n\n> 💡 未找到副驾指令。 运行 /init 以为此项目生成 copilot-instructions.md 文件。\n\n如果不想创建此文件，可以使用斜杠命令永久隐藏当前存储库的 `/init suppress` 此启动消息。\n\n有关详细信息，请参阅“[为GitHub Copilot添加存储库自定义说明](/zh/enterprise-cloud@latest/copilot/how-tos/configure-custom-instructions/add-repository-instructions)”。\n\n## 挂钩引用\n\n有关挂钩的详细信息（包括挂钩配置格式、挂钩事件、输入有效负载和决策控制），请参阅 [GitHub Copilot 挂钩参考](/zh/enterprise-cloud@latest/copilot/reference/hooks-reference)。\n\n## MCP 服务器配置\n\nMCP 服务器向 CLI 代理提供其他工具。 在`~/.copilot/mcp-config.json`中配置持久性服务器。 使用 `--additional-mcp-config` 来为单个会话添加服务器。\n\n### `copilot mcp` 子命令\n\n用于 `copilot mcp` 从命令行管理 MCP 服务器配置，而无需启动交互式会话。\n\n| 子命令 | 说明 |\n| --------------------- | ---------------------------------------------- |\n| `list [--json]` | 列出按源分组的所有已配置的 MCP 服务器。 |\n| `get [--json]` | 显示特定服务器的配置和工具。 |\n| `add ` | 将服务器添加到用户配置。 写入到 `~/.copilot/mcp-config.json`。 |\n| `remove ` | 删除用户级服务器。 工作区服务器必须直接在其配置文件中进行编辑。 |\n\n\\*\\*\n`copilot mcp add` 选项：\\*\\*\n\n| 选项 | 说明 |\n| ------------------------ | ------------------------------------ |\n| `-- [args...]` | 本地 （stdio） 服务器的命令和参数。 |\n| `--url ` | 远程服务器的 URL。 |\n| `--type ` | 传输类型：`local`、、`stdio``http`或`sse`。 |\n| `--env KEY=VALUE` | 环境变量（可重复）。 |\n| `--header KEY=VALUE` | 远程服务器的 HTTP 标头（可重复）。 |\n| `--tools ` | 工具筛选器： `\"*\"` 表示全部，逗号分隔列表，或 `\"\"` 表示无。 |\n| `--timeout ` | 超时（以毫秒为单位）。 |\n| `--json` | 将添加的配置输出为 JSON 格式。 |\n| `--show-secrets` | 显示完整的环境变量和标头值。 |\n\n> \\[!CAUTION]\n> `--show-secrets` 可以将敏感的环境变量和标头值输出到终端或日志。 仅在受信任的环境中使用此选项，避免在共享日志或历史记录中复制、粘贴或其他捕获输出。\n\n### 传输类型\n\n| 类型 | 说明 | 必填字段 |\n| ----------------- | ---------------------------------------- | ----- |\n| `local` / `stdio` | 本地进程通过 stdin/stdout 进行通信。 | |\n| `command`、`args` | | |\n| `http` | 使用可流式 HTTP 传输的远程服务器。 | `url` |\n| `sse` | 使用服务器发送事件 (Server-Sent Events) 传输的远程服务器。 | `url` |\n\n### 本地服务器配置字段\n\n| 领域 | 必需 | 说明 |\n| ------------------------------------- | -- | ------------------------------------------- |\n| `command` | 是的 | 用于启动服务器的命令。 |\n| `args` | 是的 | 命令参数（数组）。 |\n| `tools` | 是的 | 要启用的工具：`[\"*\"]`，可以是所有工具或特定工具名称的列表。 |\n| `env` | 否 | 环境变量。 支持`$VAR`和`${VAR}``${VAR:-default}`扩展。 |\n| `cwd` | 否 | 服务器的工作目录。 |\n| `timeout` | 否 | 工具调用超时（以毫秒为单位）。 |\n| `type` | 否 | |\n| `\"local\"` 或 `\"stdio\"`。 默认值：`\"local\"`。 | | |\n\n### 专用 npm 注册表\n\n在 `--registry` 数组中使用 `args` 从专用 npm 注册表拉取包，例如 Artifactory 或 GitHub Packages 源：\n\n```json\n{\n \"mcpServers\": {\n \"my-internal-server\": {\n \"command\": \"npx\",\n \"args\": [\n \"--registry\", \"https://npm.pkg.github.com\",\n \"@my-org/internal-mcp-server\"\n ],\n \"tools\": [\"*\"]\n }\n }\n}\n```\n\n在计算服务器的身份指纹时，`--registry` 标志和其他 npm 配置标志（`--userconfig`、`--globalconfig`、`--prefix`、`--cache`、`--node-options`、`--workspace`、`-w`）会被视为取值参数。 这可确保当这些标志出现在包名称之前时，企业级允许列表检查和软件包注册表验证能够正常工作。\n\n### 远程服务器配置字段\n\n| 领域 | 必需 | 说明 |\n| ------------------- | -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `type` | 是的 | |\n| `\"http\"` 或 `\"sse\"`。 | | |\n| `url` | 是的 | 服务器 URL。 |\n| `tools` | 是的 | 要启用的工具。 |\n| `headers` | 否 | HTTP 标头。 支持变量扩展。 |\n| `oauthClientId` | 否 | 静态 OAuth 客户端 ID（跳过动态注册）。 |\n| `oauthPublicClient` | 否 | OAuth 客户端是否为公共客户端。 默认值：`true`。 将其设置为`false`，适用于具有存储机密的机密客户端。 |\n| `oauthGrantType` | 否 | OAuth 授权类型：`\"authorization_code\"`（默认，基于浏览器的流程）或 `\"client_credentials\"`（完全无外设，无需浏览器或回调）。 |\n| `oidc` | 否 | 启用 OIDC 令牌注入。 当`true`，CLI 会为服务器`GITHUB_COPILOT_OIDC_MCP_TOKEN`块（本地服务器）中引用的任何`GITHUB_COPILOT_OIDC_MCP_TOKEN_`或`env`变量注入 OIDC 令牌，或将令牌作为`Bearer``Authorization`标头（远程服务器）发送。 对于本地服务器，首选后缀变体（例如）， `${GITHUB_COPILOT_OIDC_MCP_TOKEN_MY_SVC}`为每个服务器分配唯一的变量名称。 |\n| `timeout` | 否 | 工具调用超时（以毫秒为单位）。 |\n\n### OAuth 重新身份验证\n\n使用 OAuth 的远程 MCP 服务器可能会在令牌过期或需要其他帐户时显示 `needs-auth` 状态。 使用 `/mcp auth ` 触发新的 OAuth 流。 这会打开浏览器身份验证提示，允许你登录或切换帐户。 完成流后，服务器会自动重新连接。\n\n### 无外设 OAuth（`client_credentials` 授权）\n\n对于没有可用的浏览器的 CI 或 cron 用例，请设置 `oauthGrantType: \"client_credentials\"`。 这需要：\n\n* `oauthClientId`— MCP 提供程序颁发的静态客户端 ID。\n* `oauthPublicClient: false`- 客户端是机密的。\n* 存储在系统钥匙串中的 `client_secret`（通过 `/mcp` UI 配置一次，或写入 OAuth 凭据存储）。\n\n配置后，CLI 将完全跳过浏览器、回调服务器、PKCE 和动态客户端注册。 每次遇到 401 错误时，会将 `grant_type=client_credentials` 直接发送至服务器检测到的令牌端点。\n\n```json\n{\n \"mcpServers\": {\n \"headless-api\": {\n \"type\": \"http\",\n \"url\": \"https://api.example.com/mcp\",\n \"tools\": [\"*\"],\n \"oauthClientId\": \"YOUR-CLIENT-ID\",\n \"oauthPublicClient\": false,\n \"oauthGrantType\": \"client_credentials\"\n }\n }\n}\n```\n\n### 筛选器映射\n\n控制如何使用服务器配置中的`filterMapping`字段来处理 MCP 工具输出。\n\n| 模式 | 说明 |\n| ------------------- | ----------------- |\n| `none` | 无筛选。 |\n| `markdown` | 将输出格式化为 Markdown。 |\n| `hidden_characters` | 删除隐藏或控制字符。 违约。 |\n\n### 内置 MCP 服务器\n\nCLI 包括内置 MCP 服务器，这些服务器在没有其他设置的情况下可用。\n\n| 服务器 | 说明 |\n| ------------------------------------------------- | -------------------------------------------- |\n| `github-mcp-server` | |\n| GitHub API 集成：问题、拉取请求、标签、提交、代码搜索和 GitHub Actions。 | |\n| `playwright` | 浏览器自动化：导航、单击、键入、屏幕截图和表单处理。 |\n| `fetch` | 通过 `fetch` 工具发送的 HTTP 请求。 |\n| `time` | 时间实用工具： `get_current_time` 和 `convert_time`。 |\n\n用于 `--disable-builtin-mcps` 禁用所有内置服务器，或 `--disable-mcp-server SERVER-NAME` 禁用特定服务器。\n\n#### GitHub MCP 服务器工具\n\n`github-mcp-server` 提供以下工具。\n\n| 工具 | 说明 |\n| ---------------------------------------------------------------- | -------- |\n| `get_file_contents`、`search_code` | 浏览存储库文件。 |\n| `list_issues`、`issue_read`、`search_issues` | 问题跟踪。 |\n| `get_pull_request`、`list_pull_requests`、`get_pull_request_files` | 拉取请求。 |\n| `list_commits`、`get_commit` | 提交历史记录。 |\n| `list_workflow_runs`、`get_workflow_run_logs` | |\n| GitHub Actions。 | |\n| `get_label`、`list_label`、`label_write` | 标签管理。 |\n\n### MCP 服务器命名\n\n服务器名称可以包含任何可打印字符，包括空格、Unicode 字符和标点符号。 不允许控制字符（U+0000–U+001F、U+007F）和右大括号（`}`）。 服务器名称用作工具名称的前缀，例如，名为 `my-server` 的服务器生成类似 `my-server-fetch` 的工具名称，而名为 `My Server` 的服务器生成类似 `My Server-fetch` 的工具名称。\n\n### MCP 工具名称清理\n\nMCP 服务器名称和工具名称在发送到模型之前进行过滤。 工具名称中无效的字符（除了 `a-z`、`A-Z`、`0-9`、`-`、`_` 之外的任何字符）都将被 `-` 替换。 Unicode 字符是 Punycode 编码的。 符号 `@` 也替换为 `-` ，以避免与 Punycode 编码冲突。\n\n组合名称 （`serverName-toolName`） 上限为 64 个字符。 截断将创建名称冲突时，将追加数字后缀（例如，`my-server-tool2``my-server-tool3`），以确保唯一性。\n\n### MCP 服务器信任级别\n\nMCP 服务器从多个源加载，每个源具有不同的信任级别。\n\n| 来源 | 信任级别 | 需评审 |\n| ---------------------------------- | ------------ | ---- |\n| 内置 | 高 | 否 |\n| 存储库 （`.github/mcp.json`） | 中等 | 推荐 |\n| 工作区 （`.mcp.json`） | 中等 | 推荐 |\n| 用户配置（`~/.copilot/mcp-config.json`） | User-defined | 用户责任 |\n| 远程服务器 | 低 | 始终 |\n\n所有 MCP 工具调用都需要显式权限。 这甚至适用于对外部服务的只读操作。\n\n### 企业 MCP 允许列表\n\nGitHub Enterprise 组织可以强制实施允许的 MCP 服务器白名单。 处于活动状态时，CLI 会根据企业策略评估每个非默认服务器，然后再连接。\n\n检测到 GitHub Enterprise 注册表策略（或启用 `MCP_ENTERPRISE_ALLOWLIST` 实验性功能标志）时，CLI：\n\n1. 根据每个配置的非默认服务器的命令、参数和远程 URL 计算指纹。\n2. 将指纹发送到企业白名单评估端点。\n3. 仅允许指纹已获批准的服务器；所有其他服务器都将被阻止，并收到一个包含企业名称的消息。\n\n此检查为“失效关闭”模式：如果评估终结点不可访问或返回错误，则会阻止非默认服务器，直至策略可以被验证。\n\n当企业允许列表阻止服务器时，CLI 会显示：\n\n```text\nMCP server \"SERVER-NAME\" was blocked by your enterprise \"ENTERPRISE-NAME\".\nContact your enterprise administrator to add this server to the allowlist.\n```\n\n内置默认服务器始终不受允许列表强制实施的约束。\n\n### 迁移自 `.vscode/mcp.json`\n\n如果项目使用 `.vscode/mcp.json`（VS Code 的 MCP 配置格式），请迁移到 `.mcp.json` 以便于 GitHub Copilot 命令行界面 (CLI)。 迁移会将密钥`servers`重新映射到 `mcpServers` 。\n\n**POSIX Shell（bash、zsh、fish 和其他）：**\n\n```shell\njq '{mcpServers: .servers}' .vscode/mcp.json > .mcp.json\n```\n\n需要 [`jq`](https://jqlang.github.io/jq/)。\n\nPowerShell：\n\n```powershell\npwsh -NoProfile -Command \"`$json = Get-Content '.vscode/mcp.json' -Raw | ConvertFrom-Json; `$content = ([pscustomobject]@{ mcpServers = `$json.servers } | ConvertTo-Json -Depth 100); [System.IO.File]::WriteAllText('.mcp.json', `$content, (New-Object System.Text.UTF8Encoding `$false))\"\n```\n\n在Windows，如果使用 Windows PowerShell 而不是 PowerShell Core，请将 `pwsh` 替换为 `powershell`。\n\n## 技能指南\n\n技能是可扩展 CLI 功能的 Markdown 文件。 每个技能都位于其自己的目录中，其中包含一个 `SKILL.md` 文件。 调用（通过 `/SKILL-NAME` 或自动由代理调用）时，技能的内容将注入到会话中。\n\n### 技能前页字段\n\n| 领域 | 类型 | 必需 | 说明 |\n| -------------------------- | ------------------ | -- | ------------------------------------------------- |\n| `name` | 字符串 | 是的 | 技能的唯一标识符。 仅字母、数字和连字符。 最多 64 个字符。 |\n| `description` | 字符串 | 是的 | 技能的作用以及何时使用它。 最多 1024 个字符。 |\n| `allowed-tools` | String 或 String\\[] | 否 | 技能处于活动状态时自动允许的工具的逗号分隔列表或 YAML 数组。 将 `\"*\"` 用于所有工具。 |\n| `user-invocable` | 布尔 | 否 | 用户是否可以使用 `/SKILL-NAME` 调用技能。 默认值：`true`。 |\n| `disable-model-invocation` | 布尔 | 否 | 阻止代理自动调用此技能。 默认值：`false`。 |\n\n### 技能位置\n\n系统将按照优先顺序从这些位置加载技能（对于重复名称，以首次找到项为准）。\n\n| 位置 | Scope | 说明 |\n| --------------------- | ----- | ------------------------------- |\n| `.github/skills/` | 项目 | 项目特定技能 |\n| `.agents/skills/` | 项目 | 替代项目位置。 |\n| `.claude/skills/` | 项目 | 与 Claude 兼容的位置。 |\n| 父 `.github/skills/` | 继承 | Monorepo 父目录支持。 |\n| `~/.copilot/skills/` | 个人 | 适用于所有项目的个人技能。 |\n| `~/.agents/skills/` | 个人 | 跨所有项目共享的代理技能。 |\n| 插件目录 | 插件 | 已安装插件中的技能。 |\n| `COPILOT_SKILLS_DIRS` | 自定义 | 其他目录（逗号分隔）。 |\n| （与 CLI 捆绑） | 内置 | CLI 附带的技能。 最低优先级 - 可以被任何其他来源替代。 |\n\n### 命令（可选技能格式）\n\n命令是 `.md` 中存储为单个 `.claude/commands/` 文件的技能的替代项。 命令名称派生自文件名。 命令文件使用简化的格式（不需要 `name` 字段）和支持 `description`， `allowed-tools`以及 `disable-model-invocation`。 命令的优先级低于具有相同名称的技能。\n\n## 自定义代理参考\n\n自定义代理是在 Markdown 文件中定义的专用 AI 代理。 文件名（减扩展名）将成为代理 ID。 使用 `.agent.md` 或 `.md` 用作文件扩展名。\n\n### 内置代理\n\n| 代理人 | 默认模型 | 说明 |\n| ----------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------- |\n| `code-review` | claude-sonnet-4.5 | 高信噪比代码审查。 分析代码差异中的缺陷、安全问题和逻辑错误。 |\n| `explore` | claude-haiku-4.5 | 快速代码库浏览。 搜索文件、读取代码和回答问题。 提供不超过300字的简明答案。 可以安全地并行运行。 |\n| `general-purpose` | claude-sonnet-4.5 | 支持复杂多步骤任务的全功能代理。 在单独的上下文窗口中运行。 |\n| `research` | claude-sonnet-4.6 | 深度研究代理。 基于代码库、相关存储库和 Web 中的信息生成报表。 |\n| `rubber-duck` | 互补模型 | 使用互补模型来对提案、设计、实现或测试进行建设性的批评。 标识薄弱点并建议改进。 请参阅“[关于橡皮鸭智能体](/zh/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/rubber-duck)”。 |\n| `task` | claude-haiku-4.5 | 命令执行（测试、构建、代码检查）。 成功时返回简要摘要，失败时返回全部输出。 |\n\n### 自定义代理程序前端字段\n\n| 领域 | 类型 | 必需 | 说明 |\n| ------------- | ------ | -- | ---------------------------------------------------------------------------- |\n| `description` | 字符串 | 是的 | 说明显示在代理列表和`task` 工具中。 |\n| `infer` | 布尔 | 否 | 允许主代理自动委派。 默认值：`true`。 |\n| `mcp-servers` | 对象 | 否 | 要连接的 MCP 服务器。 使用与`~/.copilot/mcp-config.json`相同的模式。 |\n| `model` | 字符串 | 否 | 此代理的 AI 模型。 未设置时，继承外部代理的模型。 当会话模型设置为 `Auto` （服务器选择）时，子代理始终继承解析的会话模型，而不考虑此字段。 |\n| `name` | 字符串 | 否 | 显示名称。 默认为文件名。 |\n| `tools` | 字符串\\[] | 否 | 代理可用的工具。 默认值： `[\"*\"]` （所有工具）。 |\n\n### 自定义代理位置\n\n| Scope | 位置 |\n| ------------------------------------- | -------------------- |\n| 项目 | |\n| `.github/agents/` 或 `.claude/agents/` | |\n| 用户 | `~/.copilot/agents/` |\n| 插件 | `/agents/` |\n\nProject级代理优先于用户级代理。 插件代理的优先级最低。\n\n### 子代理限制\n\nCLI 强制实施深度和并发限制以防止生成失控代理。\n\n| Limit | 默认 | 环境变量 |\n| ----- | ---- | --------------------------------- |\n| 最大深度 | `6` | `COPILOT_SUBAGENT_MAX_DEPTH` |\n| 最大并发数 | `32` | `COPILOT_SUBAGENT_MAX_CONCURRENT` |\n\n**深度** 计数彼此嵌套的代理数。 达到深度限制时，最内部的代理无法生成进一步的子代理。\n**并发** 计数在整个会话树中同时运行的子代理数。 达到限制后，将拒绝新的子代理请求，直到活动代理完成。 值被限制在`1`和`256`之间。\n\n## 权限审批结果\n\n当 CLI 提示执行作的权限时，可以使用以下键进行响应。\n\n| 密钥 | Effect |\n| --- | ----------------- |\n| `y` | 允许此特定请求一次。 |\n| `n` | 拒绝此特定请求一次。 |\n| `!` | 在会话剩余时段允许所有类似的请求。 |\n| `#` | 在会话剩余时段拒绝所有类似的请求。 |\n| `?` | 显示有关请求的详细信息。 |\n\n显示完整对话框后，还可以从以下选项中进行选择：\n\n| 选项 | Scope | 持久性 |\n| --- | ------- | -------- |\n| 一旦 | 单一使用 | 没有 |\n| 此位置 | 在手动清除之前 | 按位置保存到磁盘 |\n| 始终 | 永久 | 配置文件 |\n\n当 CLI 可以确定位置密钥（git 根目录或当前目录）时，将显示 **“此位置** ”选项。 它将审批保存到磁盘，以便在下次在该目录中工作时自动授予相同的权限，而无需再次提示。\n\n使用 `/permissions reset` 清除当前会话的内存中授权。\n\n## 安全性\n\n### 命令安全分析\n\n在执行之前会分析 Shell 命令，以确定潜在的危险模式：\n\n* 文件删除 （`rm -rf`）\n* 系统修改 （`sudo`， `chmod 777`）\n* 网络外泄（`curl` 具有敏感路径）\n* 凭据访问（读取 `.env`、SSH 密钥）\n* 用于覆盖危险变量的内联环境变量赋值（例如，`PATH=...`、`LD_PRELOAD=...`）\n\n高风险命令显示其他警告，并需要显式确认。\n\n#### 环境变量拒绝列表\n\nCLI 会阻止内联分配环境变量，这些环境变量可以被利用以执行任意代码，即使在其他只读命令中也是如此。 阻止的类别包括：\n\n| 类别 | 示例 |\n| ------------------------------------------------------------------------------------------------------------------- | -- |\n| 动态链接器注入 | |\n| `LD_*`、 `DYLD_*` （所有前缀） | |\n| Git 索引配置替代 | |\n| `GIT_CONFIG_COUNT`、`GIT_CONFIG_KEY_*`、`GIT_CONFIG_VALUE_*`（所有`GIT_CONFIG_`前缀） | |\n| Git 外部程序钩子 | |\n| `GIT_EXTERNAL_DIFF`、`GIT_PROXY_COMMAND` | |\n| Git 配置文件覆盖 | |\n| `GIT_CONFIG`、`GIT_CONFIG_GLOBAL`、`GIT_CONFIG_SYSTEM` | |\n| Shell PATH 和启动文件 | |\n| `PATH`、`BASH_ENV`、`ENV` | |\n| 现有被阻止的变量 | |\n| `PAGER`、`GIT_PAGER`、`GIT_EDITOR`、`VISUAL`、`EDITOR`、`GIT_SSH`、`GIT_SSH_COMMAND`、`GIT_ASKPASS`、`BROWSER`、`GH_BROWSER` | |\n\n### `web_fetch` SSRF 防护\n\n该工具 `web_fetch` 在发出任何 HTTP 请求之前强制实施服务器端请求伪造（SSRF）保护：\n\n* **协议白名单**：仅允许 `http://` 和 `https://` URL。\n `file://` 和其他方案均被拒绝。\n* **IP 阻止列表**：IP 文本检查和 DNS 预解析阻止了对环回地址`127.x.x.x`（、 `::1`）、RFC-1918 专用范围（`10.x`、 `172.16–31.x`、 `192.168.x`）和云元数据终结点（例如） `169.254.169.254`的请求。\n* **无自动重定向**： `3xx` 不会自动遵循重定向。 在继续跟随该重定向之前，系统会根据同一 IP 黑名单再次验证重定向目标 URL。\n\n若要允许 `web_fetch` 在开发期间访问 `localhost` （例如，对于本地文档服务器），请设置以下环境变量：\n\n```bash\nexport COPILOT_WEB_FETCH_ALLOW_LOCALHOST=1\n```\n\n## OpenTelemetry 监视\n\nCopilot 命令行界面（CLI） 可以通过 [OpenTelemetry（OTel](https://opentelemetry.io/) ）导出跟踪和指标，从而了解代理交互、LLM 调用、工具执行和令牌使用情况。 所有信号名称和属性都遵循 [OTel GenAI 语义约定](https://github.com/open-telemetry/semantic-conventions-genai/tree/main/docs/gen-ai/)。\n\n默认情况下，OTel 处于关闭状态，开销为零。 当满足以下任一条件时，它将激活：\n\n* `COPILOT_OTEL_ENABLED=true`\n* `OTEL_EXPORTER_OTLP_ENDPOINT` 已设置\n* `COPILOT_OTEL_FILE_EXPORTER_PATH` 已设置\n\n### OTel 环境变量\n\n| Variable | 默认 | 说明 |\n| ---------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------ |\n| `COPILOT_OTEL_ENABLED` | `false` | 显式启用 OTel。 如果 `OTEL_EXPORTER_OTLP_ENDPOINT` 已设置，则不是必需的。 |\n| `OTEL_EXPORTER_OTLP_ENDPOINT` | — | OTLP 终结点 URL。 设置此项会自动启用 OTel。 |\n| `COPILOT_OTEL_EXPORTER_TYPE` | `otlp-http` | 导出程序类型： `otlp-http` 或 `file`。 当设置`file`时自动选择`COPILOT_OTEL_FILE_EXPORTER_PATH`。 |\n| `OTEL_EXPORTER_OTLP_PROTOCOL` | `http/json` | OTLP HTTP 线路协议： `http/json` 或 `http/protobuf`。 仅适用于 `otlp-http` 导出器。 |\n| `OTEL_EXPORTER_OTLP_TRACES_PROTOCOL` | — | 仅针对跟踪覆盖 `OTEL_EXPORTER_OTLP_PROTOCOL`。 |\n| `OTEL_EXPORTER_OTLP_METRICS_PROTOCOL` | — | 仅对指标进行替代 `OTEL_EXPORTER_OTLP_PROTOCOL` 。 |\n| `OTEL_SERVICE_NAME` | `github-copilot` | 资源属性中的服务名称。 |\n| `OTEL_RESOURCE_ATTRIBUTES` | — | 逗号分隔的 `key=value` 对的额外资源属性。 对特殊字符使用百分比编码。 |\n| `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` | `false` | 捕获完整的提示和响应内容。 请参阅 [内容捕获](#content-capture)。 |\n| `OTEL_LOG_LEVEL` | — | OTel 诊断日志级别：`NONE`、、`ERROR``WARN`、`INFO``DEBUG`、`VERBOSE`。 `ALL` |\n| `COPILOT_OTEL_FILE_EXPORTER_PATH` | — | 将所有信号作为 JSON 行写入此文件。 设置此项会自动启用 OTel。 |\n| `COPILOT_OTEL_SOURCE_NAME` | `github.copilot` | 用于跟踪程序和计量的检测范围名称。 |\n| `OTEL_EXPORTER_OTLP_HEADERS` | — | OTLP 导出器（例如 `Authorization=Bearer token`）的身份验证头。 |\n\n### Traces\n\n运行时为每个智能体交互发出分层跨度树。 每个树都包含根`invoke_agent`范围，以及`chat``execute_tool`子范围。\n\n#### `invoke_agent` span 属性\n\n包装整个智能体调用：一个用户消息的所有 LLM 调用和工具执行。\n\n* **顶级会话**会将跨度类型 `CLIENT`（远程服务调用）与 `server.address` 和 `server.port` 一起使用。\n* **子代理调用** （例如，浏览、任务）在没有服务器属性的情况下使用范围类型 `INTERNAL` （进程内）。\n\n| Attribute | 说明 | Span 类型 |\n| ------------------------------------------ | ------------------------------------------------ | ---------- |\n| `gen_ai.operation.name` | `invoke_agent` | 两者都有 |\n| `gen_ai.provider.name` | 提供者（例如`github`、`anthropic`） | 两者都有 |\n| `gen_ai.agent.id` | 已知时稳定的代理定义标识符;顶级默认使用 `github.copilot.default` | 两者都有 |\n| `gen_ai.agent.name` | 代理名称（可用时） | 两者都有 |\n| `gen_ai.agent.description` | 代理说明（可用时） | 两者都有 |\n| `gen_ai.agent.version` | 已知时代理定义版本;否则为运行时版本 | 两者都有 |\n| `gen_ai.conversation.id` | 会话标识符 | 两者都有 |\n| `enduser.pseudo.id` | 若可用，从 `analytics_tracking_id` 获取假名 Copilot 用户标识符 | 两者都有 |\n| `gen_ai.request.model` | 请求的模型 | 两者都有 |\n| `gen_ai.response.finish_reasons` | | |\n| `[\"stop\"]` 或 `[\"error\"]` | 两者都有 | |\n| `gen_ai.usage.input_tokens` | 总输入令牌数（所有轮次） | 两者都有 |\n| `gen_ai.usage.output_tokens` | 总输出标记（所有轮次） | 两者都有 |\n| `gen_ai.usage.cache_read.input_tokens` | 读取缓存的输入令牌 | 两者都有 |\n| `gen_ai.usage.cache_creation.input_tokens` | 创建的缓存输入令牌 | 两者都有 |\n| `github.copilot.turn_count` | LLM 往返次数 | 两者都有 |\n| `github.copilot.cost` | 货币成本 | 两者都有 |\n| `github.copilot.aiu` | AI 单元消耗 | 两者都有 |\n| `server.address` | 服务器主机名 | 仅 `CLIENT` |\n| `server.port` | 服务器端口 | 仅 `CLIENT` |\n| `error.type` | 错误类名称（出错时） | 两者都有 |\n| `gen_ai.input.messages` | 完整输入消息作为 JSON 格式（仅限内容捕获） | 两者都有 |\n| `gen_ai.output.messages` | JSON格式的完整输出消息（仅用于捕获内容） | 两者都有 |\n| `gen_ai.system_instructions` | JSON 格式的系统提示内容（仅限内容捕获） | 两者都有 |\n| `gen_ai.tool.definitions` | 工具模式为 JSON（仅内容捕获） | 两者都有 |\n\n#### `chat` span 属性\n\n每个 LLM 请求一个跨度。 范围类型： `CLIENT`.\n\n| Attribute | 说明 |\n| ------------------------------------------ | ------------------------- |\n| `gen_ai.operation.name` | `chat` |\n| `gen_ai.provider.name` | 提供者名称 |\n| `gen_ai.request.model` | 请求的模型 |\n| `gen_ai.request.stream` | 是否使用了流式处理模式（仅流式处理） |\n| `gen_ai.conversation.id` | 会话标识符 |\n| `gen_ai.response.finish_reasons` | 停止原因 |\n| `gen_ai.response.id` | 响应 ID |\n| `gen_ai.response.model` | 已解析的模型 |\n| `gen_ai.response.time_to_first_chunk` | 首次流式处理区块的时间（以秒为单位）（仅流式处理） |\n| `gen_ai.usage.cache_creation.input_tokens` | 创建的缓存令牌 |\n| `gen_ai.usage.cache_read.input_tokens` | 读取缓存令牌 |\n| `gen_ai.usage.input_tokens` | 此轮次输入令牌 |\n| `gen_ai.usage.output_tokens` | 此轮次输出令牌 |\n| `github.copilot.cost` | 轮次成本 |\n| `github.copilot.aiu` | AI 单元消耗当前回合 |\n| `github.copilot.server_duration` | 服务器端持续时间 |\n| `github.copilot.initiator` | 请求发起者 |\n| `github.copilot.turn_id` | 轮次标识符 |\n| `github.copilot.interaction_id` | 交互标识符 |\n| `server.address` | 服务器主机名 |\n| `server.port` | 服务器端口 |\n| `error.type` | 错误类名称（出错时） |\n| `gen_ai.input.messages` | JSON 格式的完整提示消息（仅限内容捕获） |\n| `gen_ai.output.messages` | JSON 形式的完整响应消息（仅内容捕获） |\n| `gen_ai.system_instructions` | JSON 格式的系统提示内容（仅限内容捕获） |\n\n#### `execute_tool` span 属性\n\n为每个工具调用指定一个跨度。 范围类型： `INTERNAL`.\n\n| Attribute | 说明 |\n| ---------------------------- | ---------------------- |\n| `gen_ai.operation.name` | `execute_tool` |\n| `gen_ai.provider.name` | 提供程序名称（如果可用） |\n| `gen_ai.tool.name` | 工具名称（例如， `readFile`） |\n| `gen_ai.tool.type` | `function` |\n| `gen_ai.tool.call.id` | 工具调用标识符 |\n| `gen_ai.tool.description` | 工具说明 |\n| `error.type` | 错误类名称（出错时） |\n| `gen_ai.tool.call.arguments` | 工具输入参数以 JSON 格式（仅内容捕获） |\n| `gen_ai.tool.call.result` | 工具输出为 JSON（仅限内容捕获） |\n\n### Metrics\n\n#### GenAI 约定指标\n\n| Metric | 类型 | 单位 | 说明 |\n| ----------------------------------------------- | --- | ------ | ----------------------------- |\n| `gen_ai.client.operation.duration` | 直方图 | s | LLM API 调用和代理调用持续时间 |\n| `gen_ai.client.token.usage` | 直方图 | tokens | 按类型排序的令牌计数 （`input`/`output`） |\n| `gen_ai.client.operation.time_to_first_chunk` | 直方图 | s | 接收第一个流媒体数据块的时间 |\n| `gen_ai.client.operation.time_per_output_chunk` | 直方图 | s | 第一个区块后的区块间延迟 |\n\n#### 特定于供应商的指标\n\n| Metric | 类型 | 单位 | 说明 |\n| ----------------------------------- | ------- | ----- | -------------------------------------- |\n| `github.copilot.tool.call.count` | Counter | calls | 通过 `gen_ai.tool.name` 和 `success` 调用工具 |\n| `github.copilot.tool.call.duration` | 直方图 | s | 工具执行由 `gen_ai.tool.name` 产生的延迟 |\n| `github.copilot.agent.turn.count` | 直方图 | 轮次 | 每个代理调用的 LLM 往返次数 |\n\n### 跨度事件\n\n在活动 `chat` 或 `invoke_agent` 跨度上记录的生命周期事件。\n\n| 事件 | 说明 | 密钥属性 |\n| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------------------------- |\n| `github.copilot.hook.start` | 挂钩开始执行 | |\n| `github.copilot.hook.type`、`github.copilot.hook.invocation_id` | | |\n| `github.copilot.hook.end` | 挂钩成功完成 | |\n| `github.copilot.hook.type`、`github.copilot.hook.invocation_id` | | |\n| `github.copilot.hook.error` | 挂钩失败 | |\n| `github.copilot.hook.type`、`github.copilot.hook.invocation_id`、`github.copilot.hook.error_message` | | |\n| `github.copilot.session.truncation` | 对话历史记录被截断 | |\n| `github.copilot.token_limit`、`github.copilot.pre_tokens`、`github.copilot.post_tokens`、`github.copilot.pre_messages`、`github.copilot.post_messages`、`github.copilot.tokens_removed`、`github.copilot.messages_removed`、`github.copilot.performed_by` | | |\n| `github.copilot.session.compaction_start` | 历史压缩开始 | 没有 |\n| `github.copilot.session.compaction_complete` | 已完成历史记录压缩 | |\n| `github.copilot.success`、`github.copilot.pre_tokens`、`github.copilot.post_tokens`、`github.copilot.tokens_removed`、`github.copilot.messages_removed`、`github.copilot.message`（仅内容捕获） | | |\n| `github.copilot.skill.invoked` | 调用了技能 | |\n| `github.copilot.skill.name`、`github.copilot.skill.path`、`github.copilot.skill.plugin_name`、`github.copilot.skill.plugin_version` | | |\n| `github.copilot.session.shutdown` | 会话正在关闭 | |\n| `github.copilot.shutdown_type`、`github.copilot.total_premium_requests`、`github.copilot.lines_added`、`github.copilot.lines_removed`、`github.copilot.files_modified_count` | | |\n| `github.copilot.session.abort` | 用户取消了当前操作 | `github.copilot.abort_reason` |\n| `exception` | 会话错误 | |\n| `github.copilot.error_type`、`github.copilot.error_status_code`、`github.copilot.error_provider_call_id` | | |\n\n### 资源属性\n\n所有信号都携带这些资源属性。\n\n| Attribute | 价值 |\n| ------------------------------------------ | ----- |\n| `service.name` | |\n| `github-copilot` （可通过 `OTEL_SERVICE_NAME`） | |\n| `service.version` | 运行时版本 |\n\n### 内容捕获\n\n默认情况下，不会捕获提示内容、响应或工具参数，仅捕获模型名称、令牌计数和持续时间等元数据。 若要捕获完整内容，请设置 `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true`。\n\n> \\[!WARNING]\n> 内容捕获可能包括敏感信息，例如代码、文件内容和用户提示。 仅在受信任的环境中启用此功能。\n\n启用内容捕获后，将填充以下属性。\n\n| Attribute | Content |\n| ---------------------------- | ------------- |\n| `gen_ai.input.messages` | 完整提示消息 （JSON） |\n| `gen_ai.output.messages` | 完整响应消息 （JSON） |\n| `gen_ai.system_instructions` | 系统提示内容 （JSON） |\n| `gen_ai.tool.definitions` | 工具架构 （JSON） |\n| `gen_ai.tool.call.arguments` | 工具输入参数 |\n| `gen_ai.tool.call.result` | 工具输出结果 |\n\n## 延伸阅读\n\n* [GitHub Copilot 命令行界面 (CLI)](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli)\n* [GitHub Copilot 挂钩参考](/zh/enterprise-cloud@latest/copilot/reference/hooks-reference)\n* [GitHub Copilot CLI 插件参考](/zh/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-plugin-reference)\n* [GitHub Copilot 命令行界面编程参考](/zh/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-programmatic-reference)\n* [GitHub Copilot CLI 配置目录](/zh/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference)"}