Code OSS 开发日志查看器
快速定位并读取 Code OSS 开发运行日志。
技能主要执行本地日志定位与读取,未要求网络、凭据或破坏性操作,并明确临时探针应恢复、不得提交;但日志可能包含遥测、认证或代理信息,文档未要求脱敏、用户确认、访问范围隔离或备份恢复,因此扣分。
路径、日志层级、按修改时间选择最新运行和按场景筛选文件的流程较清晰;但未覆盖目录不存在、权限不足、无日志或多窗口歧义时的诊断反馈,命令可移植性和关键路径复现也未由本技能测试,因此按静态上限保守扣分。
明确面向 Code OSS 与 Agents app 开发运行日志,并按故障类型映射文件;但触发条件、非适用范围、发行版差异、中文使用场景及中国大陆网络环境适配未说明,且对非开发构建用户数据目录的支持有限,因此扣分。
具备 front matter、分层标题、表格、目录示例、命令示例和限制提示,仓库还提供 MIT 许可及 Microsoft 归属;但技能没有版本、变更记录、独立维护责任或更新路径,安装依赖和故障排查说明也不完整,因此扣分。
对启动、扩展、代理、MCP、终端和网络问题提供了可直接执行的日志选择与读取方法,核心任务通常可完成;但没有静态可验证的代表性输出、结果正确性证据或与手工搜索的比较,且临时探针流程成本较高,因此未接近满分。
技能文本本身可审计,日志文件名和目录结构给出了一定可追溯依据;但没有针对该技能的测试、固定样例日志、CI 覆盖或第三方复现证据,提供的仓库 CI 与此技能关键路径无直接覆盖,因此仅给有限分数。
- 读取日志前应明确日志可能包含敏感信息,并对分享、粘贴或上传内容进行脱敏。
- 临时启用日志转发和探针会修改源码并扩大日志暴露面;应在操作前确认范围,并确保异常中断后也能恢复默认状态。
- 文档假设存在标准用户数据目录和 Unix 风格命令;Windows、权限受限、空日志或自定义启动方式可能需要额外处理。
它能做什么 & 适用场景
此技能用于查找和读取最近一次 Code OSS 或 Agents app 开发运行生成的时间戳日志。它覆盖主进程、渲染器、扩展主机、Agent host、MCP、终端和网络等日志文件。技能会根据用户数据目录定位最近的日志运行目录,并按调查目标选择相关文件。它适合已经拥有本地开发构建日志、需要排查启动、扩展、代理、MCP、终端或网络问题的开发者。
识别用户要排查的是 Code OSS 还是 Agents app;在默认或指定的用户数据目录下查找 logs 文件夹;使用 ls -lt 按修改时间定位最近的时间戳运行目录;列出目录内容;根据问题读取 main.log、window1/renderer.log、agenthost.log、扩展主机日志、MCP 日志、终端日志或网络日志;使用 tail 查看最近记录,使用 rg 搜索错误或探针标记,使用 find 查找非空日志。对于临时 console.log 探针,它还说明如何临时启用开发控制台转发、复现问题并恢复默认关闭状态。
- Code OSS 开发者遇到应用启动失败或崩溃,需要检查 main.log 和渲染器日志。
- 扩展开发者发现扩展激活或运行异常,需要查看扩展主机及具体扩展日志。
- Agents app 用户排查 Copilot、Agent session 或 Agent host 通信问题,需要定位 agenthost.log 及相关输出日志。
- 开发者调试 MCP、终端、网络认证或设置同步问题,需要按用途读取对应的进程日志。
- 进行源代码临时探针调试的贡献者,需要将 console 输出转发到正常日志并在结束后清理改动。
优缺点一览
- 覆盖 Code OSS 和 Agents app 的多类开发进程日志。
- 明确处理默认用户数据目录、自定义 --user-data-dir 和 .build 临时目录。
- 按启动、扩展、Agent、MCP、终端和网络等场景提供具体文件定位。
- 支持 tail、rg 和 find 等直接可执行的日志检查方式。
- 只面向 Code OSS 或 Agents app 开发运行日志,不是通用日志分析器。
- 要求本地存在日志目录,并需要 shell 与文件系统访问权限。
- 源材料没有提供独立安装命令、测试套件或跨平台验证信息。
- 临时 console.log 转发流程需要修改源代码并在结束后手动恢复。
如何安装
该仓库包含 61 个技能;本技能位于 .github/skills/code-oss-logs/SKILL.md。README 没有提供单独的安装命令或安装器,因此具体安装方式未在源材料中说明。若客户端支持 Agent Skills 目录,将该文件所在的技能目录按客户端要求放入技能目录;客户端目录约定未被文档化。
如何使用
在已安装并可访问该技能的客户端中提出具体请求,例如:“查找最近一次 Code OSS 开发运行的启动错误日志”或“检查 Agents app 最近一次运行中的 MCP 错误”。如果使用自定义用户数据目录,请在请求中提供启动命令中的 --user-data-dir=<dir>;技能会使用 <dir>/logs/。若未提供目录,默认检查 $HOME/.vscode-oss-dev/logs/。日志读取依赖本地 shell 和文件系统;源材料未规定特定客户端的触发命令。