Agent Host 日志分析
定位 Agent Host 导出日志中的会话、传输与主机问题。
技能明确将日志视为敏感数据，要求本地分析、不引用秘密或无关内容；提取脚本限制条目、大小、路径、符号链接、加密条目和特殊文件，降低路径穿越与资源耗尽风险。扣分在于会运行本地脚本并删除临时目录，缺少显式用户确认、权限边界、结果脱敏细则和可恢复机制。
文档、日志类型、关联字段和故障定位顺序基本一致；提取脚本包含较完整的 ZIP 预检和失败清理逻辑。静态证据未提供该技能专用测试、跨平台验证或异常分析示例，因此不能确认关键路径实际可运行，按静态上限保守扣分。
触发条件明确，覆盖多种 Agent Host 导出格式，并说明不同日志的适用场景。扣分在于未明确输入缺失时的输出格式、非适用范围、分析结论边界，也未提供中文使用说明或大陆网络环境适配证据；核心分析本身不必然依赖海外服务。
文档结构清晰，包含简介、文件说明、启动步骤和提示；仓库 README、LICENSE 和 SECURITY.md 提供了 MIT 许可、Microsoft 归属及安全联系路径。扣分在于技能没有独立版本、变更记录、维护责任人、安装依赖说明或 FAQ，且未说明 Python 版本和跨平台 shell 假设。
技能提供了从症状、时间和 ID 到相邻日志层的具体排查流程，并给出时间戳、会话和请求关联方法，能够直接支持人工诊断。扣分在于没有固定输出模板、代表性结论示例或验证后的结果格式，最终分析仍依赖用户自行判断。
SKILL.md 和提取脚本均为可审计的一手材料，脚本中的安全约束可静态核查。扣分在于没有该技能的提交测试、样例 bundle、CI 覆盖或第三方执行证据；仅凭静态阅读无法独立复现诊断效果。
- 日志可能包含令牌、提示词、文件内容、终端输出、路径和设置；在共享环境或发送分析结果前必须自行脱敏。
- 删除临时提取目录是不可逆操作，且技能未定义分析结果的保存、回滚或审计方式。
- 文档假定可用 python3 和类 Unix shell 命令；Windows 原生环境的执行兼容性未在所给材料中证明。
- 缺少固定输出格式和专用测试，结论需要人工复核。
它能做什么 & 适用场景
该技能用于分析由“Developer: Export Agent Host Debug Logs...”生成的 Agent Host 调试日志包。它面向以 ah-logs 或 ahp-logs 开头的 ZIP 压缩包或已解压文件夹，并关联 Copilot SDK 事件、AHP 通信、Agent Host、客户端和远程主机日志。分析时应将日志视为敏感数据，因为其中可能包含令牌、提示词、文件内容、终端输出、路径和设置。它适合需要依据时间戳、会话 ID、请求 ID 或工具 ID 调查 Agent Host 行为的开发者。
读取导出包中的 events.jsonl、ahp/*.jsonl、Agent Host.log、copilot-logs/*.log、Window.log、Shared.log 以及远程主机日志等文件；对 ZIP 包运行仓库内的 scripts/extract.py 进行解压；根据症状、时间、主机类型和已知 ID 选择最相关的日志层；使用 session ID、turnId、interactionId、工具或请求 ID、JSON-RPC id、serverSeq 及 event id/parentId 进行跨日志关联；结合时间戳重建轮转 AHP 日志的顺序，并据此定位失败响应、缺失完成事件或用户可见后果。
- 开发者导出 Agent Host 调试日志后，需要调查某个会话中的轮次、消息、工具或权限行为。
- 排查客户端与服务端状态不同步，或需要依据 AHP 请求、响应、订阅和通知重建事件顺序。
- 调查 Agent Host 启动、认证、会话、提供商、工具、Git/worktree 或主机侧错误。
- 分析 Copilot SDK 进程日志，或核对本地与远程 Agent Host 在不同时区中的行为。
- 处理只收集到部分日志文件的有效导出包，并区分真正的失败证据与单纯的警告或错误级别。
优缺点一览
- 覆盖 SDK 事件、AHP 传输、Agent Host、客户端、共享进程和远程主机多个关联层。
- 明确提供按症状选择日志、按 ID 关联以及重建轮转日志顺序的方法。
- 支持只包含部分文件的有效导出包，并提醒不要把单独的警告或错误级别当作因果证据。
- 包含令牌、提示词、文件内容和终端输出等敏感数据处理要求。
- 范围仅限 Agent Host 调试日志导出包，不是针对普通带时间戳的 Code OSS 日志目录的通用分析流程。
- 日志收集采用尽力而为方式，缺失文件是正常情况，可能限制调查范围。
- 不同日志的时区和时间精度可能不同：events.jsonl、Copilot SDK 和 AHP 通常使用 UTC，而普通 .log 文件可能使用本地时间。
- 源材料没有提供独立安装步骤、测试套件或结构化报告输出格式。
如何安装
该源材料没有说明此技能的独立安装流程。技能位于仓库的 .github/skills/agent-host-logs/ 目录；使用时需要让兼容 Agent Skills 的客户端加载该目录及其 SKILL.md。README 只说明整个 VS Code 仓库的 MIT 许可和维护背景，未提供此技能的单独安装命令。
如何使用
将 ah-logs 或 ahp-logs ZIP 文件或已解压文件夹提供给技能，并说明症状、约略时间、本地或远程主机，以及已知的 session、chat、turn、request 或 tool ID。例如："分析这个 ah-logs.zip，调查 2025-01-01 期间某个会话为何没有完成；优先关联 turnId 和 request ID。" 如需解压 ZIP，在仓库可用时运行：python3 .github/skills/agent-host-logs/scripts/extract.py "<archive>.zip"。从命令最后给出的临时目录开始分析；完成后只删除该命令指定的确切临时目录。
对比同类
与普通的带时间戳 Code OSS 日志目录相比，该技能专门面向“Export Agent Host Debug Logs...”生成的导出包，并额外解释 events.jsonl、AHP JSONL、Copilot SDK 和远程 Agent Host 日志之间的关联。