SuperAPI AI 工具集

code-oss-logs

编程与开发

查看项目

更新于 10-16 07:09

技能介绍

Code OSS Logs 技能用于查找并显示最近一次 Code OSS 或 Agents 应用开发运行产生的日志。

用途 该技能帮助用户在调试 Code OSS 开发构建时定位并阅读日志,适用场景包括:查找日志、读取日志文件、调试 Code OSS、检查渲染进程日志、扩展宿主日志、智能体相关日志等。

日志根目录

  • Code OSS 与 Agents 应用的默认用户数据目录均为 $HOME/.vscode-oss-dev,日志路径为 $HOME/.vscode-oss-dev/logs/。
  • 如果 Code OSS 启动时使用了 --user-data-dir=<dir>,则应使用 <dir>/logs/,而非上述默认路径。启动和调试辅助工具常在 .build/ 下创建临时用户数据目录;在已知启动命令的确切用户数据目录时,应优先使用该目录。

每次运行会创建一个带时间戳的文件夹,例如 20260330T163430。按修改时间排序后最新的文件夹通常就是用户关心的那一次运行。

操作步骤

  1. 确认用户询问的是 Code OSS 还是 Agents 应用;若不明确,则两者都检查。
  2. 查找最近的日志文件夹: ls -lt "$HOME/.vscode-oss-dev/logs" | head -5

    或是自定义用户数据目录:

    ls -lt "<user-data-dir>/logs" | head -5
  3. 进入最近的文件夹并列出内容。
  4. 根据用户调查的问题读取相关日志文件。可使用 tail 查看最近条目,或用 rg 过滤。

目录结构 每个带时间戳的日志文件夹结构如下: <timestamp>/ ├── main.log # Electron 主进程(应用生命周期、窗口管理) ├── agenthost.log # 智能体宿主进程(Copilot 智能体、模型列表、智能体会话) ├── mcpGateway.log # MCP 网关/服务器协调 ├── sharedprocess.log # 共享进程(扩展画廊、全局服务) ├── telemetry.log # 遥测事件 ├── terminal.log # 终端/pty 活动 ├── ptyhost.log # Pty 宿主进程 ├── network-shared.log # 共享网络活动 ├── editSessions.log # 编辑会话/云端更改 ├── userDataSync.log # 设置同步 ├── remoteTunnelService.log # 远程隧道服务 │ └── window1/ # 各窗口日志(window1、window2 等) ├── renderer.log # 渲染进程(工作台 UI、服务、启动) ├── network.log # 各窗口网络活动 ├── views.log # 视图/面板活动 ├── notebook.rendering.log # 笔记本渲染 ├── customizationsDebug.log # 智能体自定义调试信息(Agents 应用) ├── mcpServer.*.log # 各 MCP 服务器日志(每个已配置服务器一个文件) │ ├── exthost/ # 扩展宿主日志 │ ├── exthost.log # 扩展宿主主日志(激活、错误) │ ├── extHostTelemetry.log │ ├── <publisher.extension>/ # 各扩展日志文件夹 │ │ └── <extension>.log │ └── output_logging_<timestamp>/ # 扩展输出通道 │ └── output_<timestamp>/ # 输出通道日志(工作台侧) ├── tasks.log # 任务输出 ├── agentSessionsOutput.log # 智能体会话输出(Agents 应用) └── agenthost.<clientId>.log # 启用跟踪时的智能体宿主 IPC 流量

多个 output_ 文件夹 在同一会话中,每次窗口重新加载都会新建一个 output_<timestamp>/ 文件夹,并在 exthost/ 内创建对应的 output_logging_<timestamp>/。会话级带时间戳文件夹(如 20260330T163430/)保持不变,但每次重载会获得新的输出通道目录。时间戳最新的 output_* 文件夹对应当前或最近一次重载的日志,较早的文件夹包含该会话先前重载的日志。

按使用场景划分的关键文件

  • 应用启动/崩溃:main.log、window1/renderer.log
  • 扩展问题:window1/exthost/exthost.log、window1/exthost/<publisher.ext>/
  • Copilot/智能体问题:agenthost.log、window1/exthost/GitHub.copilot-chat/
  • 智能体宿主 IPC(Agents 应用):window1/output_<timestamp>/agenthost.*.log
  • MCP 服务器问题:mcpGateway.log、window1/mcpServer.*.log
  • 终端问题:terminal.log、ptyhost.log
  • 网络/认证问题:network-shared.log、window1/network.log
  • 设置同步:userDataSync.log
  • 智能体自定义:window1/customizationsDebug.log(Agents 应用)

常用命令

查看日志文件的最近条目

tail -50 "<timestamp>/window1/renderer.log"

在某次运行的所有日志中搜索探针标记或错误

rg -n "MY_PROBE|error" "<timestamp>"

显示某次运行中非空的日志

find "<timestamp>" -type f -size +0 -print

临时控制台转发工作流 当使用临时 console.log 探针并希望这些探针保留在常规日志文件中时,可在启动 Code OSS 前本地启用开发控制台转发:

  1. 在 src/vs/platform/log/common/log.ts 中找到 isDevConsoleLogForwardingEnabled。
  2. 临时启用被注释的 Boolean("true") 一行: export const isDevConsoleLogForwardingEnabled = false || Boolean("true") // done "weirdly" so that a lint warning prevents you from pushing this ;
  3. 构建或让 watch 任务拾取该更改。
  4. 启动 Code OSS 或 Agents 应用并复现问题。
  5. 读取相关日志。
  6. 完成前,将该标志恢复为默认关闭状态,并移除所有临时 console.log 探针。

Boolean("true") 这种写法刻意对 lint 不友好,以便意外启用的标志在提交前被捕获。不要将该标志以启用状态提交。

提示

  • 在源码构建中使用临时开发探针时,console.log 或 ILogService 均可,选在正在修改的代码中最方便的一种即可。
  • console.log 探针绝不能提交。如果日志代码打算长期保留在产品中,应改用 ILogService。
  • 如果源码构建中启用了开发控制台转发,则 console.debug、console.error、console.info、console.log 和 console.warn 会通过进程日志服务写入常规日志文件。
  • 控制台探针会落到发出它们的进程对应日志中:主进程写入 main.log,渲染/工作台写入 window1/renderer.log,共享进程写入 sharedprocess.log,pty 宿主写入 ptyhost.log,智能体宿主写入 agenthost.log。启用转发所有扩展宿主控制台输出时,扩展宿主控制台输出会从渲染侧被观察到并出现在 window1/renderer.log 中。
  • 若未启用控制台转发,必须保留在日志文件中的探针应使用 ILogService;原生 console.log 可能只出现在 DevTools 或 stdout 中。
  • 并非所有日志文件都有内容,许多文件被创建为空,仅当对应子系统产生输出时才会填充。
  • window1/ 是第一个窗口;多窗口会话还会有 window2/ 等。
  • 日志行格式为:YYYY-MM-DD HH:MM:SS.mmm [level] message。

关于该技能的收费、价格、支持平台与其他使用限制,暂未提供。