诊断、日志与问题报告
查看有效环境,分析当前会话日志,区分本地归档、gist 和受限上传。
This page has not been translated into English yet. The original Chinese version is shown below.
先把问题定位到登录、配置加载、模型请求、工具执行或界面,再收集对应证据。完整日志可能含代码、路径和提示,不必一开始就上传全部内容。
确认环境
| 入口 | 用途 |
|---|---|
| copilot version 或 /version | 当前版本与更新 |
| /env | 实际加载的配置和扩展 |
| /settings 的 Problems | 无效、未知设置与跨作用域问题 |
| /mcp list | 服务器状态 |
| /lsp logs | 语言服务器日志 |
| /extensions manage | 扩展状态与日志位置 |
启动可用 --log-dir DIRECTORY 指定目录,默认 ~/.copilot/logs/;--log-level 接受 none、error、warning、info、debug、all、default。需要具体日志规则时运行 copilot help logging。
分析当前会话
/diagnose Explain why the last tool call failed./diagnose 使用当前会话日志分析异常,可附提示缩小范围。回答仍需与实际错误核对,尤其是组织策略和外部服务故障,不能只凭模型推测认定原因。
异常崩溃后的恢复目前需 COPILOT_ENABLE_INTERRUPTED_SESSION_RESTORE=1 临时 opt-in。恢复时原本执行到中途的任务会自动继续;启动时先确认选中的会话与操作范围。
收集资料
/collect-debug-logs filefile 保存本地归档,可附 PATH。gist 上传到 secret GitHub gist;share 先保存本地归档,再询问本次上传同意,默认 No。
share 上传 GitHub 当前仅向 GitHub staff / internal 用户开放,并非所有用户都可用;其他用户使用本地归档、gist 或普通公开反馈入口。secret gist 仍是外部托管资料,不等于只存在本地。
提交问题
/feedback / /bug 提供反馈入口,可能包含附日志流程。先整理最小复现、当前版本、期望和实际行为,并检查归档中是否含不应分享的凭据或仓库内容。
/changelog / /release-notes 可查看特定版本、last N 或 since VERSION,summarize 会请求 AI 摘要。排查升级回归时先比较官方变更;/downgrade VERSION 在参考中列为 team accounts 能力,不应假定所有账号都能用。