工程开发
vscode-playwright avatar

vscode-playwright

使用 Playwright 和 serve-web 自动截取高质量 VS Code 屏幕截图,适用于文档、演示文稿及技术视觉内容。

简介

vscode-playwright 技能提供了一套自动化流程,用于生成专业级的 VS Code 编辑器屏幕截图。此工具专为开发人员、技术作者与产品团队设计,简化了将实时编辑器视图嵌入演示文稿、项目文档与营销素材的过程。通过利用 Playwright MCP (模型上下文协议) 工具与 serve-web 代理服务器,它建立了一个临时且隔离的环境,确保每次产出的视觉资产皆保持一致、整洁且无干扰。此工具处理完整生命周期,从启动具有特定工作区设置的 VS Code 服务器,到微调编辑器 UI 外观以实现最佳可读性。

  • 自动化 VS Code 服务器实例的生命周期管理,包括创建临时数据目录以防止状态污染。

  • 程序化 UI 清理功能,通过命令面板集成关闭标签页、通知、侧边栏与面板。

  • 精确的视口配置,以符合演示文稿模板与文档排版所需的特定长宽比与分辨率。

  • 增强的可读性设置,例如应用全局缩放 (1.5x–1.75x),以在缩小图像时保持字体清晰度。

  • 支持标准 VS Code CLI 变体,包括核心 VS Code 与 VS Code Insiders,并具备自动环境检测功能。

  • 使用无头浏览器自动化进行灵活的文件导航与编辑器交互。

  • 在启动流程前,请确保已设置并可访问 Playwright MCP 工具 (mcp_microsoft_pla_browser_*)。

  • 使用提供的 Bash 检测逻辑,根据环境选择正确的 code 或 code-insiders CLI。

  • 务必设置特定的宽度与高度像素值以符合目标演示文稿占位符,而非预设为通用屏幕分辨率。

  • 通过 page.keyboard.press 命令利用命令面板模式,与 VS Code 内部功能 (如“转到文件”或“切换勿扰模式”) 进行交互。

  • 本工具需要使用 curl 进行服务器就绪检查;在发送浏览器指令前,请确认 serve-web 服务已在 localhost:8765 上响应。

  • 为达最佳效果,请使用设置预加载功能来强制执行一致的主题 (如 Default Dark Modern),并禁用可能会产生视觉杂讯的遥测或自动还原功能。

仓库统计

Star 数
1,033
Fork 数
172
Open Issue 数
159
主要语言
PowerShell
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 04:34
在 GitHub 查看