[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-lackeyjb--playwright-skill":3,"tool-lackeyjb--playwright-skill":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",148568,2,"2026-04-09T23:34:24",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":75,"owner_email":75,"owner_twitter":75,"owner_website":75,"owner_url":77,"languages":78,"stars":83,"forks":84,"last_commit_at":85,"license":86,"difficulty_score":32,"env_os":87,"env_gpu":87,"env_ram":87,"env_deps":88,"category_tags":95,"github_topics":96,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":110,"updated_at":111,"faqs":112,"releases":143},6017,"lackeyjb\u002Fplaywright-skill","playwright-skill","Claude Code Skill for browser automation with Playwright. Model-invoked - Claude autonomously writes and executes custom automation for testing and validation.","playwright-skill 是一款专为 Claude Code 设计的浏览器自动化技能，它能让 AI 自主编写并执行基于 Playwright 的测试脚本。无论是简单的页面验证还是复杂的多步骤业务流程，用户只需提出需求，Claude 即可动态生成定制代码并实时运行，无需依赖预设脚本。\n\n这一工具主要解决了传统自动化测试中脚本编写门槛高、维护成本大以及灵活性不足的痛点。它将自然语言指令直接转化为可执行的浏览器操作，大幅提升了测试与验证的效率。\n\nplaywright-skill 特别适合开发者、测试工程师以及需要频繁进行网页交互验证的技术人员使用。对于希望利用 AI 辅助自动化工作流的研究人员而言，它也是一个强大的助力。\n\n其技术亮点在于“按需加载”机制：Claude 会根据任务自动判断何时调用该技能，仅加载必要的信息以保持上下文简洁。默认开启可见浏览器模式，让用户能直观看到自动化操作过程。此外，内置的智能临时文件管理和通用执行器有效避免了模块解析错误和竞争条件，确保了运行的稳定性与安全性。作为 Claude Code 插件，它还支持便捷的团队分发与自动更新，让协作更加顺畅。","# Playwright Skill for Claude Code\n\n**General-purpose browser automation as a Claude Skill**\n\nA [Claude Skill](https:\u002F\u002Fwww.anthropic.com\u002Fblog\u002Fskills) that enables Claude to write and execute any Playwright automation on-the-fly - from simple page tests to complex multi-step flows. Packaged as a [Claude Code Plugin](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fplugins) for easy installation and distribution.\n\nClaude autonomously decides when to use this skill based on your browser automation needs, loading only the minimal information required for your specific task.\n\nMade using Claude Code.\n\n## Features\n\n- **Any Automation Task** - Claude writes custom code for your specific request, not limited to pre-built scripts\n- **Visible Browser by Default** - See automation in real-time with `headless: false`\n- **Zero Module Resolution Errors** - Universal executor ensures proper module access\n- **Progressive Disclosure** - Concise SKILL.md with full API reference loaded only when needed\n- **Safe Cleanup** - Smart temp file management without race conditions\n- **Comprehensive Helpers** - Optional utility functions for common tasks\n\n## Installation\n\nThis repository is structured as a [Claude Code Plugin](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fplugins) containing a skill. You can install it as either a **plugin** (recommended) or extract it as a **standalone skill**.\n\n### Understanding the Structure\n\nThis repository uses the plugin format with a nested structure:\n\n```\nplaywright-skill\u002F              # Plugin root\n├── .claude-plugin\u002F           # Plugin metadata\n└── skills\u002F\n    └── playwright-skill\u002F     # The actual skill\n        └── SKILL.md\n```\n\nClaude Code expects skills to be directly in folders under `.claude\u002Fskills\u002F`, so manual installation requires extracting the nested skill folder.\n\n---\n\n### Option 1: Plugin Installation (Recommended)\n\nInstall via Claude Code's plugin system for automatic updates and team distribution:\n\n```bash\n# Add this repository as a marketplace\n\u002Fplugin marketplace add lackeyjb\u002Fplaywright-skill\n\n# Install the plugin\n\u002Fplugin install playwright-skill@playwright-skill\n\n# Navigate to the skill directory and run setup\ncd ~\u002F.claude\u002Fplugins\u002Fmarketplaces\u002Fplaywright-skill\u002Fskills\u002Fplaywright-skill\nnpm run setup\n```\n\nVerify installation by running `\u002Fhelp` to confirm the skill is available.\n\n---\n\n### Option 2: Standalone Skill Installation\n\nTo install as a standalone skill (without the plugin system), extract only the skill folder:\n\n**Global Installation (Available Everywhere):**\n\n```bash\n# Clone to a temporary location\ngit clone https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill.git \u002Ftmp\u002Fplaywright-skill-temp\n\n# Copy only the skill folder to your global skills directory\nmkdir -p ~\u002F.claude\u002Fskills\ncp -r \u002Ftmp\u002Fplaywright-skill-temp\u002Fskills\u002Fplaywright-skill ~\u002F.claude\u002Fskills\u002F\n\n# Navigate to the skill and run setup\ncd ~\u002F.claude\u002Fskills\u002Fplaywright-skill\nnpm run setup\n\n# Clean up temporary files\nrm -rf \u002Ftmp\u002Fplaywright-skill-temp\n```\n\n**Project-Specific Installation:**\n\n```bash\n# Clone to a temporary location\ngit clone https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill.git \u002Ftmp\u002Fplaywright-skill-temp\n\n# Copy only the skill folder to your project\nmkdir -p .claude\u002Fskills\ncp -r \u002Ftmp\u002Fplaywright-skill-temp\u002Fskills\u002Fplaywright-skill .claude\u002Fskills\u002F\n\n# Navigate to the skill and run setup\ncd .claude\u002Fskills\u002Fplaywright-skill\nnpm run setup\n\n# Clean up temporary files\nrm -rf \u002Ftmp\u002Fplaywright-skill-temp\n```\n\n**Why this structure?** The plugin format requires the `skills\u002F` directory for organizing multiple skills within a plugin. When installing as a standalone skill, you only need the inner `skills\u002Fplaywright-skill\u002F` folder contents.\n\n---\n\n### Option 3: Download Release\n\n1. Download and extract the latest release from [GitHub Releases](https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Freleases)\n2. Copy only the `skills\u002Fplaywright-skill\u002F` folder to:\n   - Global: `~\u002F.claude\u002Fskills\u002Fplaywright-skill`\n   - Project: `\u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.claude\u002Fskills\u002Fplaywright-skill`\n3. Navigate to the skill directory and run setup:\n   ```bash\n   cd ~\u002F.claude\u002Fskills\u002Fplaywright-skill  # or your project path\n   npm run setup\n   ```\n\n---\n\n### Verify Installation\n\nRun `\u002Fhelp` to confirm the skill is loaded, then ask Claude to perform a simple browser task like \"Test if google.com loads\".\n\n## Quick Start\n\nAfter installation, simply ask Claude to test or automate any browser task. Claude will write custom Playwright code, execute it, and return results with screenshots and console output.\n\n## Usage Examples\n\n### Test Any Page\n\n```\n\"Test the homepage\"\n\"Check if the contact form works\"\n\"Verify the signup flow\"\n```\n\n### Visual Testing\n\n```\n\"Take screenshots of the dashboard in mobile and desktop\"\n\"Test responsive design across different viewports\"\n```\n\n### Interaction Testing\n\n```\n\"Fill out the registration form and submit it\"\n\"Click through the main navigation\"\n\"Test the search functionality\"\n```\n\n### Validation\n\n```\n\"Check for broken links\"\n\"Verify all images load\"\n\"Test form validation\"\n```\n\n## How It Works\n\n1. Describe what you want to test or automate\n2. Claude writes custom Playwright code for the task\n3. The universal executor (run.js) runs it with proper module resolution\n4. Browser opens (visible by default) and automation executes\n5. Results are displayed with console output and screenshots\n\n## Configuration\n\nDefault settings:\n\n- **Headless:** `false` (browser visible unless explicitly requested otherwise)\n- **Slow Motion:** `100ms` for visibility\n- **Timeout:** `30s`\n- **Screenshots:** Saved to `\u002Ftmp\u002F`\n\n## Project Structure\n\n```\nplaywright-skill\u002F\n├── .claude-plugin\u002F\n│   ├── plugin.json          # Plugin metadata for distribution\n│   └── marketplace.json     # Marketplace configuration\n├── skills\u002F\n│   └── playwright-skill\u002F    # The actual skill (Claude discovers this)\n│       ├── SKILL.md         # What Claude reads\n│       ├── run.js           # Universal executor (proper module resolution)\n│       ├── package.json     # Dependencies & setup scripts\n│       └── lib\u002F\n│           └── helpers.js   # Optional utility functions\n│       └── API_REFERENCE.md # Full Playwright API reference\n├── README.md                # This file - user documentation\n├── CONTRIBUTING.md          # Contribution guidelines\n└── LICENSE                  # MIT License\n```\n\n## Advanced Usage\n\nClaude will automatically load `API_REFERENCE.md` when needed for comprehensive documentation on selectors, network interception, authentication, visual regression testing, mobile emulation, performance testing, and debugging.\n\n## Dependencies\n\n- Node.js\n- Playwright (installed via `npm run setup`)\n- Chromium (installed via `npm run setup`)\n\n## Troubleshooting\n\n**Playwright not installed?**\nNavigate to the skill directory and run `npm run setup`.\n\n**Module not found errors?**\nEnsure automation runs via `run.js`, which handles module resolution.\n\n**Browser doesn't open?**\nVerify `headless: false` is set. The skill defaults to visible browser unless headless mode is requested.\n\n**Install all browsers?**\nRun `npm run install-all-browsers` from the skill directory.\n\n## What is a Skill?\n\n[Agent Skills](https:\u002F\u002Fagentskills.io) are folders of instructions, scripts, and resources that agents can discover and use to do things more accurately and efficiently. When you ask Claude to test a webpage or automate browser interactions, Claude discovers this skill, loads the necessary instructions, executes custom Playwright code, and returns results with screenshots and console output.\n\nThis Playwright skill implements the [open Agent Skills specification](https:\u002F\u002Fagentskills.io), making it compatible across agent platforms.\n\n## Contributing\n\nContributions are welcome. Fork the repository, create a feature branch, make your changes, and submit a pull request. See [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n## Learn More\n\n- [Agent Skills Specification](https:\u002F\u002Fagentskills.io) - Open specification for agent skills\n- [Claude Code Skills Documentation](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fskills)\n- [Claude Code Plugins Documentation](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fplugins)\n- [Plugin Marketplaces](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fplugin-marketplaces)\n- [API_REFERENCE.md](skills\u002Fplaywright-skill\u002FAPI_REFERENCE.md) - Full Playwright documentation\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fissues)\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n","# Playwright 技能，适用于 Claude Code\n\n**作为 Claude 技能的通用浏览器自动化**\n\n这是一个 [Claude 技能](https:\u002F\u002Fwww.anthropic.com\u002Fblog\u002Fskills)，使 Claude 能够即时编写并执行任何 Playwright 自动化任务——从简单的页面测试到复杂的多步骤流程。该技能以 [Claude Code 插件](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fplugins) 的形式打包，便于安装和分发。\n\nClaude 会根据您的浏览器自动化需求自主决定何时使用此技能，仅加载完成特定任务所需的最少信息。\n\n由 Claude Code 构建。\n\n## 功能特性\n\n- **任意自动化任务**：Claude 会根据您的具体请求编写自定义代码，不限于预构建的脚本。\n- **默认可见浏览器**：通过 `headless: false` 实时查看自动化过程。\n- **零模块解析错误**：通用执行器确保正确访问所有模块。\n- **渐进式披露**：简洁的 SKILL.md 文件包含完整的 API 参考文档，仅在需要时加载。\n- **安全清理**：智能临时文件管理，避免竞态条件。\n- **全面辅助工具**：可选的常用任务实用函数。\n\n## 安装\n\n本仓库采用 [Claude Code 插件](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fplugins) 结构，包含一个技能。您可以将其作为 **插件**（推荐）安装，或提取为 **独立技能**。\n\n### 结构说明\n\n本仓库使用插件格式，具有嵌套结构：\n\n```\nplaywright-skill\u002F              # 插件根目录\n├── .claude-plugin\u002F           # 插件元数据\n└── skills\u002F\n    └── playwright-skill\u002F     # 实际技能\n        └── SKILL.md\n```\n\nClaude Code 要求技能直接位于 `.claude\u002Fskills\u002F` 目录下，因此手动安装时需提取嵌套的技能文件夹。\n\n---\n\n### 选项 1：插件安装（推荐）\n\n通过 Claude Code 的插件系统安装，可实现自动更新和团队分发：\n\n```bash\n# 将本仓库添加到市场\n\u002Fplugin marketplace add lackeyjb\u002Fplaywright-skill\n\n# 安装插件\n\u002Fplugin install playwright-skill@playwright-skill\n\n# 进入技能目录并运行设置\ncd ~\u002F.claude\u002Fplugins\u002Fmarketplaces\u002Fplaywright-skill\u002Fskills\u002Fplaywright-skill\nnpm run setup\n```\n\n运行 `\u002Fhelp` 验证安装，确认技能已可用。\n\n---\n\n### 选项 2：独立技能安装\n\n若要作为独立技能安装（不使用插件系统），只需提取技能文件夹：\n\n**全局安装（随处可用）：**\n\n```bash\n# 克隆到临时位置\ngit clone https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill.git \u002Ftmp\u002Fplaywright-skill-temp\n\n# 仅将技能文件夹复制到全局技能目录\nmkdir -p ~\u002F.claude\u002Fskills\ncp -r \u002Ftmp\u002Fplaywright-skill-temp\u002Fskills\u002Fplaywright-skill ~\u002F.claude\u002Fskills\u002F\n\n# 进入技能目录并运行设置\ncd ~\u002F.claude\u002Fskills\u002Fplaywright-skill\nnpm run setup\n\n# 清理临时文件\nrm -rf \u002Ftmp\u002Fplaywright-skill-temp\n```\n\n**项目专用安装：**\n\n```bash\n# 克隆到临时位置\ngit clone https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill.git \u002Ftmp\u002Fplaywright-skill-temp\n\n# 仅将技能文件夹复制到项目目录\nmkdir -p .claude\u002Fskills\ncp -r \u002Ftmp\u002Fplaywright-skill-temp\u002Fskills\u002Fplaywright-skill .claude\u002Fskills\u002F\n\n# 进入技能目录并运行设置\ncd .claude\u002Fskills\u002Fplaywright-skill\nnpm run setup\n\n# 清理临时文件\nrm -rf \u002Ftmp\u002Fplaywright-skill-temp\n```\n\n**为何采用这种结构？** 插件格式要求使用 `skills\u002F` 目录来组织插件内的多个技能。当作为独立技能安装时，您只需内层的 `skills\u002Fplaywright-skill\u002F` 文件夹内容即可。\n\n---\n\n### 选项 3：下载发布版本\n\n1. 从 [GitHub Releases](https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Freleases) 下载并解压最新发布版本。\n2. 仅复制 `skills\u002Fplaywright-skill\u002F` 文件夹至：\n   - 全局：`~\u002F.claude\u002Fskills\u002Fplaywright-skill`\n   - 项目：`\u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.claude\u002Fskills\u002Fplaywright-skill`\n3. 进入技能目录并运行设置：\n   ```bash\n   cd ~\u002F.claude\u002Fskills\u002Fplaywright-skill  # 或项目路径\n   npm run setup\n   ```\n\n---\n\n### 验证安装\n\n运行 `\u002Fhelp` 确认技能已加载，然后让 Claude 执行一个简单的浏览器任务，例如“测试 google.com 是否加载”。\n\n## 快速入门\n\n安装完成后，只需让 Claude 测试或自动化任何浏览器任务。Claude 会编写自定义 Playwright 代码，执行并返回结果，附带截图和控制台输出。\n\n## 使用示例\n\n### 测试任意页面\n\n```\n“测试首页”\n“检查联系表单是否正常工作”\n“验证注册流程”\n```\n\n### 视觉测试\n\n```\n“分别截取移动端和桌面端的仪表盘截图”\n“测试不同视口下的响应式设计”\n```\n\n### 交互测试\n\n```\n“填写注册表单并提交”\n“点击浏览主导航”\n“测试搜索功能”\n```\n\n### 验证测试\n\n```\n“检查是否有损坏的链接”\n“验证所有图片是否加载”\n“测试表单验证”\n```\n\n## 工作原理\n\n1. 描述您想要测试或自动化的内容。\n2. Claude 为该任务编写自定义 Playwright 代码。\n3. 通用执行器（run.js）负责运行代码，并确保正确解析所有模块。\n4. 浏览器打开（默认可见），自动化任务开始执行。\n5. 最终结果显示控制台输出和截图。\n\n## 配置\n\n默认设置：\n\n- **无头模式**：`false`（浏览器默认可见，除非明确指定）\n- **慢动作**：`100ms` 以提高可见性。\n- **超时时间**：`30秒`。\n- **截图**：保存至 `\u002Ftmp\u002F`。\n\n## 项目结构\n\n```\nplaywright-skill\u002F\n├── .claude-plugin\u002F\n│   ├── plugin.json          # 插件元数据，用于分发\n│   └── marketplace.json     # 市场配置\n├── skills\u002F\n│   └── playwright-skill\u002F    # 实际技能（Claude 会发现它）\n│       ├── SKILL.md         # Claude 读取的内容\n│       ├── run.js           # 通用执行器（确保模块正确解析）\n│       ├── package.json     # 依赖项及设置脚本\n│       └── lib\u002F\n│           └── helpers.js   # 可选的实用函数\n│       └── API_REFERENCE.md # 完整的 Playwright API 参考\n├── README.md                # 当前文件——用户文档\n├── CONTRIBUTING.md          # 贡献指南\n└── LICENSE                  # MIT 许可证\n```\n\n## 高级用法\n\nClaude 会在需要时自动加载 `API_REFERENCE.md`，提供关于选择器、网络拦截、身份验证、视觉回归测试、移动设备模拟、性能测试和调试等方面的全面文档。\n\n## 依赖项\n\n- Node.js\n- Playwright（通过 `npm run setup` 安装）\n- Chromium（通过 `npm run setup` 安装）\n\n## 故障排除\n\n**Playwright 未安装？**\n导航到技能目录并运行 `npm run setup`。\n\n**出现“模块未找到”错误？**\n确保自动化通过 `run.js` 运行，该文件负责处理模块解析。\n\n**浏览器未打开？**\n请确认已设置 `headless: false`。默认情况下，技能会以可见模式运行浏览器，除非明确请求无头模式。\n\n**安装所有浏览器？**\n在技能目录下运行 `npm run install-all-browsers`。\n\n## 什么是技能？\n\n[Agent Skills](https:\u002F\u002Fagentskills.io) 是包含指令、脚本和资源的文件夹，智能体可以发现并使用它们来更准确、更高效地完成任务。当您让 Claude 测试网页或自动化浏览器交互时，Claude 会发现此技能，加载必要的指令，执行自定义的 Playwright 代码，并返回带有截图和控制台输出的结果。\n\n此 Playwright 技能实现了 [开放的 Agent Skills 规范](https:\u002F\u002Fagentskills.io)，使其能够在不同的智能体平台上兼容。\n\n## 贡献\n我们欢迎您的贡献。请 fork 仓库，创建功能分支，进行更改，并提交 pull request。详情请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。\n\n## 了解更多\n\n- [Agent Skills 规范](https:\u002F\u002Fagentskills.io) - 开放的智能体技能规范\n- [Claude Code 技能文档](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fskills)\n- [Claude Code 插件文档](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fplugins)\n- [插件市场](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fplugin-marketplaces)\n- [API_REFERENCE.md](skills\u002Fplaywright-skill\u002FAPI_REFERENCE.md) - 完整的 Playwright 文档\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fissues)\n\n## 许可证\n\nMIT 许可证 - 详情请参阅 [LICENSE](LICENSE) 文件。","# Playwright Skill 快速上手指南\n\nPlaywright Skill 是一个专为 Claude Code 设计的浏览器自动化技能。它允许 Claude 根据您的需求动态编写并执行 Playwright 代码，从简单的页面测试到复杂的多步骤流程均可胜任。默认情况下，浏览器将以可见模式运行，方便实时观察自动化过程。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：Linux, macOS 或 Windows\n*   **Node.js**：已安装 Node.js (推荐 LTS 版本)\n*   **Claude Code**：已安装并配置好 Claude Code 客户端\n*   **网络环境**：能够访问 GitHub 和 npm 仓库（如遇网络问题，建议配置国内镜像源）\n\n> **提示**：该工具在安装过程中会自动下载 Playwright 依赖及 Chromium 浏览器内核，首次运行可能需要少量时间。\n\n## 安装步骤\n\n您可以选择通过 **插件系统**（推荐，支持自动更新）或 **独立技能** 方式安装。\n\n### 方式一：插件安装（推荐）\n\n这是最简便的方式，适合大多数用户。\n\n1.  **添加市场源并安装插件**\n    在 Claude Code 终端中依次执行以下命令：\n    ```bash\n    \u002Fplugin marketplace add lackeyjb\u002Fplaywright-skill\n    \u002Fplugin install playwright-skill@playwright-skill\n    ```\n\n2.  **初始化环境**\n    进入插件目录并运行设置脚本以安装 Playwright 依赖：\n    ```bash\n    cd ~\u002F.claude\u002Fplugins\u002Fmarketplaces\u002Fplaywright-skill\u002Fskills\u002Fplaywright-skill\n    npm run setup\n    ```\n\n3.  **验证安装**\n    返回 Claude Code 主界面，输入 `\u002Fhelp` 确认技能已加载。\n\n### 方式二：独立技能安装\n\n如果您希望将技能全局部署或仅在特定项目中使用，可手动提取技能文件夹。\n\n#### 全局安装（对所有项目可用）\n\n```bash\n# 1. 克隆仓库到临时目录\ngit clone https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill.git \u002Ftmp\u002Fplaywright-skill-temp\n\n# 2. 创建技能目录并复制核心文件\nmkdir -p ~\u002F.claude\u002Fskills\ncp -r \u002Ftmp\u002Fplaywright-skill-temp\u002Fskills\u002Fplaywright-skill ~\u002F.claude\u002Fskills\u002F\n\n# 3. 进入目录并初始化\ncd ~\u002F.claude\u002Fskills\u002Fplaywright-skill\nnpm run setup\n\n# 4. 清理临时文件\nrm -rf \u002Ftmp\u002Fplaywright-skill-temp\n```\n\n#### 项目级安装（仅对当前项目可用）\n\n```bash\n# 1. 克隆仓库到临时目录\ngit clone https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill.git \u002Ftmp\u002Fplaywright-skill-temp\n\n# 2. 在当前项目下创建技能目录并复制\nmkdir -p .claude\u002Fskills\ncp -r \u002Ftmp\u002Fplaywright-skill-temp\u002Fskills\u002Fplaywright-skill .claude\u002Fskills\u002F\n\n# 3. 进入目录并初始化\ncd .claude\u002Fskills\u002Fplaywright-skill\nnpm run setup\n\n# 4. 清理临时文件\nrm -rf \u002Ftmp\u002Fplaywright-skill-temp\n```\n\n## 基本使用\n\n安装完成后，无需编写任何代码，直接用自然语言向 Claude 描述您的浏览器自动化需求即可。Claude 会自动调用该技能，生成 Playwright 代码，启动可见浏览器执行任务，并返回结果（包含截图和控制台输出）。\n\n### 简单示例\n\n**示例 1：测试页面加载**\n```text\n测试 google.com 是否能正常加载\n```\n\n**示例 2：表单交互测试**\n```text\n打开注册页面，填写用户名和密码，然后点击提交按钮，验证是否成功\n```\n\n**示例 3：视觉测试**\n```text\n截取当前仪表盘页面在移动端和桌面端视图下的截图\n```\n\n**示例 4：功能验证**\n```text\n检查首页是否存在失效链接，并验证所有图片是否都能正常加载\n```\n\n### 工作原理简述\n\n1.  您描述任务（如“测试登录流程”）。\n2.  Claude 读取技能文档，动态编写定制的 Playwright 脚本。\n3.  通过内置的执行器 (`run.js`) 运行脚本，确保模块解析无误。\n4.  浏览器自动打开（默认非无头模式），执行操作。\n5.  执行结果、日志及截图直接反馈给您。\n\n> **注意**：默认配置下浏览器会以可见模式运行（`headless: false`），并带有 100ms 的慢动作延迟以便观察。如需无头模式，可在指令中明确告知 Claude。","某电商团队的前端工程师需要在每次发布前，快速验证新上线的“限时秒杀”活动页在复杂交互下的稳定性，包括倒计时同步、库存实时扣减及多步骤下单流程。\n\n### 没有 playwright-skill 时\n- **脚本维护成本高**：必须手动编写和维护固定的 Playwright 测试脚本，一旦页面元素微调或活动规则变更，就需要人工重构代码。\n- **反馈周期长**：从发现需求到写出可执行的自动化脚本通常需要数小时，无法在代码提交后的几分钟内立即获得验证结果。\n- **调试过程黑盒**：默认无头模式运行难以直观定位失败原因，复现偶发的时序问题（如库存竞争）需要额外配置截图或视频录制。\n- **场景覆盖受限**：受限于预写脚本的固定逻辑，难以临时发起针对特定边缘案例（如特定用户状态下的异常流）的即时探索性测试。\n\n### 使用 playwright-skill 后\n- **动态生成代码**：只需向 Claude 描述“验证秒杀倒计时结束后的按钮状态”，playwright-skill 即可自主编写并执行量身定制的自动化代码，无需人工介入编码。\n- **即时验证反馈**：在对话中直接触发测试，几分钟内即可完成从代码生成、执行到结果返回的全流程，大幅缩短发布前的验证窗口。\n- **可视化实时调试**：默认以有头模式（`headless: false`）运行，工程师可亲眼看到浏览器自动操作的全过程，快速定位交互卡顿或逻辑错误。\n- **灵活应对变化**：面对临时的验证需求，可直接用自然语言指令让 playwright-skill 构建复杂的多步流程（如模拟高并发下的库存扣减），无需预先准备脚本库。\n\nplaywright-skill 将繁琐的浏览器自动化编码工作转化为自然的语言交互，让前端验证从“耗时的人工脚本工程”变成了“即问即得的智能服务”。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flackeyjb_playwright-skill_ed3cd04c.png","lackeyjb","Bryan Lackey","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Flackeyjb_052a9ac1.jpg",null,"@hashicorp","https:\u002F\u002Fgithub.com\u002Flackeyjb",[79],{"name":80,"color":81,"percentage":82},"JavaScript","#f1e05a",100,2359,156,"2026-04-09T15:24:45","MIT","未说明",{"notes":89,"python":90,"dependencies":91},"该工具基于 Node.js 运行，非 Python 项目。安装后需执行 'npm run setup' 以自动安装 Playwright 及其依赖的浏览器（默认为 Chromium）。默认配置为有头模式（可见浏览器），若需无头模式需显式指定。","不适用",[92,93,94],"Node.js","Playwright","Chromium",[52,13],[97,98,99,100,101,102,103,104,105,106,107,108,109],"ai-tools","automation","browser-automation","claude","claude-code","claude-skills","developer-tools","e2e-testing","nodejs","playwright","web-testing","claude-plugin","model-invoked","2026-03-27T02:49:30.150509","2026-04-10T07:44:34.311772",[113,118,123,128,133,138],{"id":114,"question_zh":115,"answer_zh":116,"source_url":117},27265,"这个项目是由 Claude 或其他 AI 编写的吗？","是的，该项目是使用 Claude 编写的。提交记录中已将 Claude Code 列为贡献者，且 README 文件中已添加了相关说明以明确其作者身份。","https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fissues\u002F16",{"id":119,"question_zh":120,"answer_zh":121,"source_url":122},27266,"为什么按照项目特定手动安装步骤操作后，Claude Code 无法检测到技能？","这是因为安装指令生成的目录结构存在嵌套（例如 `.claude\u002Fskills\u002Fplaywright-skill\u002Fskills\u002Fplaywright-skill\u002FSKILL.md`），而 Claude Code 期望的结构是 `.claude\u002Fskills\u002Fplaywright-skill\u002FSKILL.md`。目前的目录结构是为作为“插件”使用而设计的。解决方法是调整目录结构，将 `SKILL.md` 直接放置在 `.claude\u002Fskills\u002Fplaywright-skill\u002F` 下，或者等待文档更新以区分插件模式和普通技能模式的安装路径。","https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fissues\u002F10",{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},27267,"通过插件系统安装时，为什么代理会找不到正确的路径？","通过插件系统安装时，实际路径为 `~\u002F.claude\u002Fplugins\u002Fmarketplaces\u002Fplaywright-skill\u002Fskills\u002Fplaywright-skill`，但技能文件内部可能硬编码了查找 `~\u002F.claude\u002Fskills\u002Fplaywright-skill` 的逻辑，导致代理需要反复试错。维护者已通过实施动态路径解析（dynamic path resolution）修复了此问题，以适配所有安装方法。","https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fissues\u002F1",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},27268,"如何为 Playwright 发出的所有 HTTP(s) 请求添加自定义请求头？","这是一个功能增强请求。用户希望配置 Playwright 在每次请求时自动传递自定义头部（例如用于标识流量来源或获取针对 LLM 优化的错误信息）。目前该 Issue 处于讨论阶段，尚未提供具体的内置配置命令，通常需要在 Playwright 初始化配置中设置 `extraHTTPHeaders` 或通过中间件实现。","https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fissues\u002F7",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},27269,"技能内部的 API 参考文档链接失效怎么办？","API 参考文档应当包含在技能包内部，而不是链接到外部或错误的路径。如果技能文件中的链接无法找到文档，说明文档未被正确打包或路径引用错误。需要确保文档文件存在于技能目录中，并修正 `SKILL.md` 中的相对路径链接。","https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fissues\u002F19",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},27270,"是否应该移除仓库中的 skills 目录层级以便直接检出？","有用户建议移除嵌套的 `skills` 目录层，以便直接将代码检出到本地的 skills 目录中，方便升级时同步代码仓库。不过维护者认为当前的嵌套结构是为了支持插件系统，因此该建议未被直接采纳作为通用标准，用户可根据自身需求手动调整目录结构。","https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fissues\u002F6",[144,149,154,159,164,169,174,179],{"id":145,"version":146,"summary_zh":147,"released_at":148},180395,"v4.1.0","## 新增功能\n\n- **自定义 HTTP 头支持** - 增加了为浏览器请求配置自定义 HTTP 头的功能 (#17)\n\n## 安装\n\n```bash\nclaude mcp add playwright-skill -- npx --yes @anthropic-ai\u002Fclaude-code-mcp-server skill https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Freleases\u002Fdownload\u002Fv4.1.0\u002Fplaywright-skill.tar.gz\n```","2025-12-02T12:46:30",{"id":150,"version":151,"summary_zh":152,"released_at":153},180396,"v4.0.2","## 修复\n\n- **修复了所有安装方式的动态路径解析** ([#2](https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fpull\u002F2))\n  - 解决了插件安装路径与硬编码路径不匹配的问题\n  - 消除了 Claude 在发现技能目录时需要反复试错的情况\n  - 支持插件系统、手动全局安装以及项目特定安装\n  - 将 9 处硬编码的路径引用替换为动态的 `$SKILL_DIR` 占位符\n\n## 变更内容\n\n此补丁版本修复了一个关键 bug：技能文档中引用了与实际插件安装位置不符的硬编码路径，导致 Claude 必须通过不断试错才能找到正确的目录。","2025-10-21T15:19:17",{"id":155,"version":156,"summary_zh":157,"released_at":158},180397,"v4.0.1","## 文档改进\n\n本次发布重点在于优化 README 文件，以提升清晰度和专业性：\n\n### 变更\n- 移除了花哨的元素（复选标记、标语页脚）\n- 简化了安装和验证说明\n- 整合并压缩了所有章节，提高可读性\n- 从 README 中移除了变更日志部分\n- 重新组织了内容结构——将“什么是 Claude Skill？”移至文末，以更好地体现信息层级\n\n### 安装\n\n**通过插件系统（推荐）：**\n```bash\n\u002Fplugin marketplace add lackeyjb\u002Fplaywright-skill\n\u002Fplugin install playwright-skill@playwright-skill\ncd ~\u002F.claude\u002Fplugins\u002Fmarketplaces\u002Fplaywright-skill\u002Fskills\u002Fplaywright-skill\nnpm run setup\n```\n\n**手动安装：**\n```bash\ncd ~\u002F.claude\u002Fskills\ngit clone https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill.git\ncd playwright-skill\u002Fskills\u002Fplaywright-skill\nnpm run setup\n```\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fcompare\u002Fv4.0.0...v4.0.1","2025-10-20T00:31:25",{"id":160,"version":161,"summary_zh":162,"released_at":163},180398,"v4.0.0","# 🎉 重大发布：自动检测与智能测试管理\n\n版本 4.0.0 带来了显著的工作流改进，消除了使用 Playwright 进行测试时常见的痛点。\n\n## ✨ 新功能\n\n### 🔍 **自动检测开发服务器**\n- 自动扫描常见端口（3000、3001、3002、5173、8080、8000、4200、5000、9000、1234）\n- 智能工作流：\n  - **找到 1 个服务器** → 自动使用\n  - **多个服务器** → 询问要测试哪一个\n  - **未找到服务器** → 请求输入 URL 或提示帮助启动一个\n- **再也不需要硬编码 URL 或手动修改了！**\n\n### 🧹 **整洁的测试管理**\n- 所有测试脚本现在都写入 `\u002Ftmp\u002Fplaywright-test-*.js`\n- 操作系统会自动清理（项目目录不再杂乱）\n- 再也不会有测试文件污染你的技能目录了\n\n### 🔗 **URL 参数化**\n- 每个示例都在顶部包含 `TARGET_URL` 常量\n- 如果自动检测选择了错误的服务器，可以轻松修改\n- 所有代码示例都采用一致的模式\n\n### 📚 **内联执行支持**\n- 可以快速执行一次性任务\n- 对于简单的截图或检查，无需创建文件\n- 文档说明了何时使用内联方式，何时使用文件\n\n## 🔧 技术变更\n\n**新增函数：**\n- `detectDevServers()` 在 `lib\u002Fhelpers.js` 中 - 用于扫描正在运行的服务器\n\n**文档更新：**\n- 完全重写了 `SKILL.md`，增加了关键的工作流章节\n- 更新所有示例，使用 `\u002Ftmp` 目录和参数化的 URL\n- 新增展示了服务器检测流程的执行模式\n- 优化了提示部分，加入了最佳实践\n\n## 📊 影响\n\n**v4.0.0 之前**（来自真实用户记录）：\n- ❌ 硬编码 `localhost:3000`\n- ❌ 服务器实际在 3001 端口 → 需要手动修改 3 处\n- ❌ 没有服务器检测功能\n- ❌ 测试文件让技能目录变得杂乱\n- ❌ 因写入错误位置而引发钩子错误\n\n**v4.0.0 之后：**\n- ✅ 自动检测到 3001 端口\n- ✅ 无需任何手动编辑\n- ✅ 主动进行服务器检测\n- ✅ 所有文件都存放在 `\u002Ftmp` 目录中（保持整洁）\n- ✅ 不再出现钩子错误\n\n## 🚀 升级说明\n\n由于工作流的重大变化，此次为**主版本升级**：\n\n**破坏性变更：**\n- 技能现在要求先执行服务器检测，再进行本地主机测试\n- 测试文件将被写入 `\u002Ftmp` 目录，而非技能目录\n\n**迁移：**\n- 无需任何操作 - 技能会自动处理一切\n- 技能目录中的旧测试文件可以安全删除\n\n## 📖 文档\n\n更新后的示例展示了新的工作流：\n1. 自动检测服务器\n2. 将测试脚本写入 `\u002Ftmp` 目录，并使用参数化的 URL\n3. 执行并享受干净的结果\n\n完整详情和示例请参阅 `SKILL.md`。\n\n---\n\n**完整变更日志：** https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fcompare\u002Fv3.2.0...v4.0.0","2025-10-19T22:56:43",{"id":165,"version":166,"summary_zh":167,"released_at":168},180399,"v3.2.0","## 变更内容\n\n此版本修复了插件结构，使其完全符合 Claude Code 插件模式的要求。\n\n### 结构性变更\n\n- **修复 `plugin.json` 模式**：移除了无效的 `skills` 字段，并修正了 `author` 和 `repository` 的格式，以符合 Claude Code 的验证要求。\n- **重新组织目录结构**：按照 Claude Code 插件的标准规范，将技能文件移动到 `skills\u002Fplaywright-skill\u002F` 子目录中。\n- **更新文档**：README 现在反映了新的嵌套目录结构，适用于手动安装和通过插件系统安装。\n\n### 安装方法\n\n**通过插件系统（推荐）：**\n```bash\n\u002Fplugin marketplace add lackeyjb\u002Fplaywright-skill\n\u002Fplugin install playwright-skill@playwright-skill\ncd ~\u002F.claude\u002Fplugins\u002Fmarketplaces\u002Fplaywright-skill\u002Fskills\u002Fplaywright-skill\nnpm run setup\n```\n\n**手动安装：**\n```bash\ncd ~\u002F.claude\u002Fskills\ngit clone https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill.git\ncd playwright-skill\u002Fskills\u002Fplaywright-skill\nnpm run setup\n```\n\n### 破坏性变更\n\n- 目录结构已更改——手动安装用户应重新安装或调整路径。\n- 技能文件现在位于 `skills\u002Fplaywright-skill\u002F` 子目录中。\n\n### 错误修复\n\n- 修复了阻止通过 Claude Code 插件系统安装的 `plugin.json` 验证错误。\n- 修正了插件结构，使其与官方 Claude Code 模式一致。\n\n---\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fcompare\u002Fv3.1.0...v3.2.0","2025-10-19T22:34:14",{"id":170,"version":171,"summary_zh":172,"released_at":173},180400,"v3.1.0","## 🎉 市场安装现已可用！\n\n您现在可以使用 Claude Code 的插件市场系统，直接从 GitHub 安装 Playwright Skill！\n\n### 安装\n\n**新增：通过插件市场（推荐）**\n```bash\n\u002Fplugin marketplace add lackeyjb\u002Fplaywright-skill\n\u002Fplugin install playwright-skill@playwright-skill\n```\n\n**替代方案：手动 Git 克隆**\n```bash\ncd ~\u002F.claude\u002Fskills\ngit clone https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill.git\ncd playwright-skill\nnpm run setup\n```\n\n### 新增内容\n\n- ✅ **市场支持** - 添加了 `.claude-plugin\u002Fmarketplace.json`，支持直接从 GitHub 安装\n- ✅ **简化安装** - 无需再手动进行 Git 克隆\n- ✅ **更新文档** - 提供清晰的市场安装说明\n- ✅ **更简洁的 README** - 移除了关于插件管理命令的部分\n\n### 功能特性\n\n- 🎭 **任意自动化任务** - Claude 会根据您的具体需求编写自定义代码\n- 👁️ **默认显示浏览器** - 实时查看操作过程\n- 🔧 **零模块解析错误** - 通用执行器确保正确访问所有模块\n- 📦 **渐进式披露** - 简洁的 SKILL.md 文件，完整的 API 参考仅在需要时加载\n\n### 注意事项\n\n- **小版本升级** - 新增市场安装功能\n- **无破坏性变更** - 所有 v3.0.x 版本的功能保持不变\n- **向后兼容** - 手动安装方式仍完全支持\n\n---\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fcompare\u002Fv3.0.1...v3.1.0","2025-10-19T22:08:37",{"id":175,"version":176,"summary_zh":177,"released_at":178},180401,"v3.0.1","## 文档更新\n\n此版本包含重要的文档改进，旨在帮助用户安装和理解 Playwright Skill。\n\n### 更改内容\n\n- ✅ **插件安装说明** - 新增通过 `\u002Fplugin` 命令进行安装的完整指南\n- ✅ **术语更新** - 正确解释了 Claude Skills 与 Plugins 的区别，并附上官方文档链接\n- ✅ **安装选项** - 阐明了使用插件系统安装与手动 Git 克隆的区别\n- ✅ **插件管理** - 新增启用、禁用和卸载插件的相关命令\n- ✅ **验证步骤** - 新增安装后的验证指南\n- ✅ **官方文档链接** - 提供 Anthropic 的 Skills、Plugins 和 Marketplace 相关文档链接\n\n### 安装方法\n\n**通过插件系统（当已添加到市场时）：**\n```bash\n\u002Fplugin install playwright-skill@marketplace-name\n```\n\n**通过 Git 克隆（当前方法）：**\n```bash\ncd ~\u002F.claude\u002Fskills\ngit clone https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill.git\ncd playwright-skill\nnpm run setup\n```\n\n### 注意事项\n\n- **无代码变更** - v3.0.0 的所有功能均保持不变\n- **仅更新文档** - 可安全更新，不会引入破坏性更改\n\n---\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill\u002Fcompare\u002Fv3.0.0...v3.0.1","2025-10-19T21:56:36",{"id":180,"version":181,"summary_zh":182,"released_at":183},180402,"v3.0.0","# Claude 代码的 Playwright 技能\n\n使用 Playwright 实现通用浏览器自动化。测试页面、自动化交互、验证用户体验——任何浏览器任务均可即时完成，默认显示浏览器窗口，便于调试。\n\n## 功能特性\n- ✅ 支持任意自动化任务，不限于预构建脚本\n- ✅ 默认显示浏览器窗口，方便调试\n- ✅ 无模块解析错误\n- ✅ 渐进式披露模式\n- ✅ 安全清理与全面辅助工具\n\n## 安装步骤\n\n```bash\ncd ~\u002F.claude\u002Fskills\ngit clone https:\u002F\u002Fgithub.com\u002Flackeyjb\u002Fplaywright-skill.git\ncd playwright-skill\nnpm run setup\n```","2025-10-19T21:37:53"]