用途：面向由“Developer: Export Agent Host Debug Logs”生成的日志包，帮助理解各文件含义并按症状定位问题。这些包不同于普通带时间戳的 Code OSS 日志目录，且可能包含令牌、提示词、文件内容、终端输出、路径与设置，应视为敏感数据，仅在本地分析，避免引用密钥或无关用户内容。
主要文件与含义：events.jsonl 为持久化的 Copilot SDK 事件，覆盖轮次、消息、工具、权限、钩子、技能与子代理；usage.jsonl 为客户端捕获的每次模型调用的令牌/额度用量；customizations.json 为会话加载的技能/钩子/代理/MCP 服务器快照；ahp/.jsonl 为客户端连接的 AHP 流量；ahp/mission-control/.jsonl 为主机侧 Mission Control 流量；agenthost*.log 为 Agent Host 进程行为；copilot-logs/*.log 为提及所选会话 ID 的 SDK 日志；vscode-logs/Window 与 Shared 为窗口/共享日志；另有远程 Agent Host 日志。基本链路为：Window/客户端 <-> AHP <-> Agent Host 进程 <-> Copilot SDK。
使用方式：先列出文件并记录大小，确认症状、大致时间、本地或远程主机，以及已知的会话、聊天、轮次、请求或工具 ID；再从最接近症状的文件入手，按已知时间或 ID 搜索，并沿相邻层追踪同一操作。压缩包可用内置脚本解压：python3 .github/skills/agent-host-logs/scripts/extract.py "<archive>.zip"，以最终输出的临时路径为工作目录，结束后只删除该目录。桌面 ZIP 导出中主机日志常压缩在 host-logs.zip 内，需再次解压并同时查看两个目录。
限制与注意：文件为尽力收集，缺失属正常；events.jsonl、SDK 日志与 AHP 时间戳通常为 UTC，普通 .log 可能为本地时间；AHP 与 SDK 进程日志可能包含多个会话；订阅结果可能是完整快照；_ahpLog.truncated: true 表示大值被省略；仅有警告或错误级别不足以证明因果。Mission Control 日志独立记录，认证请求令牌会被脱敏，但其余会话内容仍敏感。部分文件仅在开启 agent-host 调试日志时存在。