这个项目能做什么

Design Oracle 是一款基于 MIT 许可的工具，用于分析网站并提取其完整的设计系统。它结合了 Next.js 前端、FastAPI 后端、ARQ worker、Redis、SQLite 以及 Playwright/Chromium 分析流水线。 核心功能包括：使用 Playwright 进行全页捕捉；通过视觉评分和启发式算法进行设计 DNA 分类；检测 Hero、定价、导航和 FAQ 等组件并提供边界框；通过 SSE 结合 Redis pub/sub 实现实时进度显示；以及导出为 Tailwind v4 配置、React JSX 组件、JSON 设计令牌和 Markdown 格式的 DESIGN.md 报告。此外，它还通过 MCP 为 AI 工作流提供分析工具。 在安装方面，推荐使用 Docker Compose：将 .env.example 复制为 .env，运行 docker compose up --build -d，然后访问 http://localhost:3000。本地 start.sh 启动选项要求 Python 3.12+、Node.js 20+ 和 Redis 7+，将启动虚拟环境、Playwright Chromium、Redis、ARQ worker、运行在 3000 端口的 Next.js 以及运行在 5000 端口的 FastAPI。 API 包含健康检查、分析、状态、结果、SSE 事件、截图、删除、设计列表，以及用于 Tailwind、组件、design.md 和令牌的导出端点。每次分析结果将写入 analyses/{id}/ 目录，包含 screenshot.png、screenshot-overlay.png、result.json、DESIGN.md、tailwind.config.js、components.jsx 和 design-tokens.json。 MCP 服务器可通过 http://localhost:5000/mcp 的 HTTP SSE 访问，或在 stdio 模式下独立运行。轻量级的 uvx CLI (design-oracle-mcp) 通过 HTTP 调用后端，无需安装 Playwright/Chromium。文档中提供了适用于 opencode、Cursor 和 Claude Code 的工具代码片段。start-public.sh 脚本可通过 Cloudflare Tunnel 将应用暴露在临时公共 HTTPS URL 下。 已知限制：分析目前使用单一的 1440x900 视口；受机器人保护的网站可能会拦截 Playwright，虽然提供了 STEALTH_MODE 以应对基础和中级保护，但企业级保护可能仍需要验证码或付费代理；组件检测基于启发式算法而非机器学习/视觉识别；SQLite 存储适用于本地或单用户使用，不适用于多租户部署。