[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-e2b-dev--surf":3,"tool-e2b-dev--surf":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 真正成长为懂上",149489,2,"2026-04-10T11:32:46",[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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[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},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"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":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":76,"owner_email":77,"owner_twitter":78,"owner_website":79,"owner_url":80,"languages":81,"stars":94,"forks":95,"last_commit_at":96,"license":97,"difficulty_score":32,"env_os":98,"env_gpu":98,"env_ram":98,"env_deps":99,"category_tags":107,"github_topics":108,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":115,"updated_at":116,"faqs":117,"releases":145},6268,"e2b-dev\u002Fsurf","surf","Surf is a computer use AI agent powered by OpenAI that interacts with a E2B's virtual desktop environment through natural language instructions","Surf 是一款由 E2B 与 OpenAI 联手打造的开源 AI 智能体，它能让大模型像人类一样直接操作云端虚拟电脑。用户只需通过自然语言下达指令（例如“打开浏览器并搜索资讯”），Surf 即可在隔离的 Linux 桌面环境中自动执行点击、输入等复杂操作，并实时将屏幕变化反馈给用户。\n\n这一工具主要解决了传统 AI 仅能生成文本或代码、难以直接操控图形界面软件的痛点，实现了从“对话建议”到“实际执行”的跨越。其核心技术亮点在于深度集成了 E2B 的云原生沙箱技术与 OpenAI 的计算机使用（Computer Use）能力，利用 Server-Sent Events 技术实现低延迟的动作流式传输，确保交互过程流畅且安全隔离。\n\nSurf 特别适合开发者用于测试自动化工作流、研究人员探索具身智能在数字环境中的应用，以及需要构建自主任务代理的技术团队。虽然普通用户也能从中体验未来的人机交互模式，但目前仍需一定的技术背景来部署和配置 API 密钥。作为一个基于 Next.js 的开放项目，Surf 为构建能够真正“动手”做事的 AI 助手提供了坚实的基础设施参考。","![E2B Surf Preview Light](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fe2b-dev_surf_readme_a75ae3ff8add.png)\n![E2B Surf Preview Dark](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fe2b-dev_surf_readme_2bbaa7a55bad.png)\n\n# 🏄 Surf - OpenAI's Computer Use Agent + E2B Desktop\n\nA Next.js application that allows AI to interact with a virtual desktop environment. This project integrates [E2B's desktop sandbox](https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fdesktop) with OpenAI's API to create an AI agent that can perform tasks on a virtual computer through natural language instructions.\n\n[E2B](https:\u002F\u002Fe2b.dev) is an open source isolated virtual computer in the cloud made for AI use cases.\n\n## Overview\n\nThe Computer Use App provides a web interface where users can:\n\n1. Start a virtual desktop sandbox environment\n2. Send natural language instructions to an AI agent\n3. Watch as the AI agent performs actions on the virtual desktop\n4. Interact with the AI through a chat interface\n\nThe application uses Server-Sent Events (SSE) to stream AI responses and actions in real-time, providing a seamless experience.\n\n## How It Works\n\n### Architecture\n\nThe application consists of several key components:\n\n1. **Frontend UI (Next.js)**: Provides the user interface with a virtual desktop view and chat interface\n2. [**E2B Desktop Sandbox**](https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fdesktop): Creates and manages virtual desktop environments\n3. [**OpenAI Computer Use**](https:\u002F\u002Fplatform.openai.com\u002Fdocs\u002Fguides\u002Ftools-computer-use): Processes user instructions and generates actions for the AI agent\n4. **Streaming API**: Handles real-time communication between the frontend and backend\n\n### Core Flow\n\n1. User starts a new sandbox instance\n2. E2B creates a virtual desktop and provides a URL for streaming\n3. User sends instructions via the chat interface\n4. Backend processes the instructions using OpenAI's API\n5. AI generates actions (clicks, typing, etc.) to perform on the virtual desktop\n6. Actions are executed on the sandbox and streamed back to the frontend\n7. The process repeats as the user continues to provide instructions\n\n## Prerequisites\n\nBefore starting, you'll need:\n\n1. [Node.js](https:\u002F\u002Fnodejs.org\u002F) (version specified in package.json)\n2. [npm](https:\u002F\u002Fwww.npmjs.com\u002F) (comes with Node.js)\n3. An [E2B API key](https:\u002F\u002Fe2b.dev\u002Fdocs\u002Fgetting-started\u002Fapi-key)\n4. An [OpenAI API key](https:\u002F\u002Fplatform.openai.com\u002Fapi-keys)\n\n## Setup Instructions\n\n1. **Clone the repository**\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fsurf\ncd surf\n```\n\n2. **Install dependencies**\n```bash\nnpm install\n```\n\n3. **Set up environment variables**\n\nCreate a `.env.local` file in the root directory based on the provided `.env.example`:\n\n```env\nE2B_API_KEY=your_e2b_api_key\nOPENAI_API_KEY=your_openai_api_key\n```\n\n4. **Start the development server**\n```bash\nnpm run dev\n```\n\n5. **Open the application**\n\nNavigate to [http:\u002F\u002Flocalhost:3000](http:\u002F\u002Flocalhost:3000) in your browser.\n\n## Usage\n\n1. **Start a Sandbox Instance**\n   - Click the \"Start new Sandbox\" button to initialize a virtual desktop environment\n   - Wait for the sandbox to start (this may take a few seconds)\n\n2. **Send Instructions**\n   - Type your instructions in the chat input (e.g., \"Open Firefox and go to google.com\")\n   - Press Enter or click the send button\n   - You can also select from example prompts if available\n\n3. **Watch AI Actions**\n   - The AI will process your instructions and perform actions on the virtual desktop\n   - You can see the AI's reasoning and actions in the chat interface\n   - The virtual desktop will update in real-time as actions are performed\n\n4. **Manage the Sandbox**\n   - The timer shows the remaining time for your sandbox instance\n   - You can stop the sandbox at any time by clicking the \"Stop\" button\n   - The sandbox will automatically extend its time when it's about to expire\n\n## Features\n\n- **Virtual Desktop Environment**: Runs a Linux-based desktop in a sandbox\n- **AI-Powered Interaction**: Uses OpenAI's API to understand and execute user instructions\n- **Real-Time Streaming**: Shows AI actions and responses as they happen\n- **Chat Interface**: Provides a conversational interface for interacting with the AI\n- **Example Prompts**: Offers pre-defined instructions to help users get started\n- **Dark\u002FLight Mode**: Supports both dark and light themes\n\n## Technical Details\n\n### Dependencies\n\nThe application uses several key dependencies:\n\n- **Next.js**: React framework for the frontend\n- **@e2b\u002Fdesktop**: SDK for creating and managing desktop sandbox environments\n- **OpenAI**: SDK for interacting with OpenAI's API\n- **Tailwind CSS**: Utility-first CSS framework for styling\n- **Framer Motion**: Library for animations\n\nSee `package.json` for a complete list of dependencies.\n\n### API Endpoints\n\n- **\u002Fapi\u002Fchat**: Handles chat messages and streams AI responses and actions\n\n### Server Actions\n\n- **createSandbox**: Creates a new sandbox instance\n- **increaseTimeout**: Extends the sandbox timeout\n- **stopSandboxAction**: Stops a running sandbox instance\n\n## Troubleshooting\n\n- **Sandbox not starting**: Verify your E2B API key is correct in `.env.local`\n- **AI not responding**: Check that your OpenAI API key is valid and has access to the required models\n- **Actions not working**: Ensure the sandbox is running and the AI has proper instructions\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n\n## Support\n\nIf you encounter any issues or have questions:\n- Check the [E2B Documentation](https:\u002F\u002Fe2b.dev\u002Fdocs)\n- Join the [E2B Discord](https:\u002F\u002Fdiscord.gg\u002FU7KEcGErtQ)\n- Open an [issue](https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fcomputer-use-app\u002Fissues)\n","![E2B Surf 预览 - 浅色模式](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fe2b-dev_surf_readme_a75ae3ff8add.png)\n![E2B Surf 预览 - 深色模式](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fe2b-dev_surf_readme_2bbaa7a55bad.png)\n\n# 🏄 Surf - OpenAI 的计算机使用代理 + E2B 桌面\n\n一个基于 Next.js 的应用程序，允许 AI 与虚拟桌面环境进行交互。该项目将 [E2B 的桌面沙盒](https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fdesktop) 与 OpenAI 的 API 集成，创建了一个可以通过自然语言指令在虚拟计算机上执行任务的 AI 代理。\n\n[E2B](https:\u002F\u002Fe2b.dev) 是一个开源的云端隔离虚拟计算机，专为 AI 应用场景打造。\n\n## 概述\n\n“计算机使用应用”提供了一个网页界面，用户可以在其中：\n\n1. 启动一个虚拟桌面沙盒环境\n2. 向 AI 代理发送自然语言指令\n3. 观看 AI 代理在虚拟桌面上执行操作\n4. 通过聊天界面与 AI 互动\n\n该应用使用服务器发送事件 (SSE) 实时流式传输 AI 的响应和操作，从而提供无缝的体验。\n\n## 工作原理\n\n### 架构\n\n该应用由几个关键组件组成：\n\n1. **前端 UI (Next.js)**：提供带有虚拟桌面视图和聊天界面的用户界面\n2. [**E2B 桌面沙盒**](https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fdesktop)：创建并管理虚拟桌面环境\n3. [**OpenAI 计算机使用功能**](https:\u002F\u002Fplatform.openai.com\u002Fdocs\u002Fguides\u002Ftools-computer-use)：处理用户指令并生成 AI 代理要执行的操作\n4. **流式 API**：负责前端和后端之间的实时通信\n\n### 核心流程\n\n1. 用户启动一个新的沙盒实例\n2. E2B 创建一个虚拟桌面，并提供用于流式传输的 URL\n3. 用户通过聊天界面发送指令\n4. 后端使用 OpenAI 的 API 处理指令\n5. AI 生成要在虚拟桌面上执行的操作（点击、输入等）\n6. 这些操作在沙盒中执行，并流式传输回前端\n7. 当用户继续提供指令时，此过程会重复进行。\n\n## 先决条件\n\n在开始之前，您需要：\n\n1. [Node.js](https:\u002F\u002Fnodejs.org\u002F)（版本需符合 package.json 中的指定）\n2. [npm](https:\u002F\u002Fwww.npmjs.com\u002F)（随 Node.js 一起安装）\n3. 一个 [E2B API 密钥](https:\u002F\u002Fe2b.dev\u002Fdocs\u002Fgetting-started\u002Fapi-key)\n4. 一个 [OpenAI API 密钥](https:\u002F\u002Fplatform.openai.com\u002Fapi-keys)\n\n## 设置说明\n\n1. **克隆仓库**\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fsurf\ncd surf\n```\n\n2. **安装依赖项**\n```bash\nnpm install\n```\n\n3. **设置环境变量**\n\n根据提供的 `.env.example` 文件，在根目录下创建一个 `.env.local` 文件：\n\n```env\nE2B_API_KEY=your_e2b_api_key\nOPENAI_API_KEY=your_openai_api_key\n```\n\n4. **启动开发服务器**\n```bash\nnpm run dev\n```\n\n5. **打开应用程序**\n\n在浏览器中访问 [http:\u002F\u002Flocalhost:3000](http:\u002F\u002Flocalhost:3000)。\n\n## 使用方法\n\n1. **启动沙盒实例**\n   - 点击“启动新沙盒”按钮以初始化虚拟桌面环境\n   - 等待沙盒启动（可能需要几秒钟）\n\n2. **发送指令**\n   - 在聊天输入框中键入您的指令（例如：“打开 Firefox 并访问 google.com”）\n   - 按下 Enter 键或点击发送按钮\n   - 如果有示例提示，您也可以从中选择\n\n3. **观看 AI 操作**\n   - AI 将处理您的指令并在虚拟桌面上执行操作\n   - 您可以在聊天界面中看到 AI 的推理过程和执行动作\n   - 虚拟桌面会随着操作的执行而实时更新\n\n4. **管理沙盒**\n   - 计时器显示沙盒实例剩余的时间\n   - 您可以随时点击“停止”按钮来终止沙盒\n   - 沙盒将在即将到期时自动延长使用时间\n\n## 功能特性\n\n- **虚拟桌面环境**：在沙盒中运行基于 Linux 的桌面\n- **AI 驱动的交互**：使用 OpenAI 的 API 理解并执行用户指令\n- **实时流式传输**：实时展示 AI 的操作和响应\n- **聊天界面**：提供与 AI 交互的对话式界面\n- **示例提示**：提供预定义的指令帮助用户快速上手\n- **深\u002F浅色模式**：支持深色和浅色主题\n\n## 技术细节\n\n### 依赖项\n\n该应用使用了几个关键依赖项：\n\n- **Next.js**：用于前端的 React 框架\n- **@e2b\u002Fdesktop**：用于创建和管理桌面沙盒环境的 SDK\n- **OpenAI**：用于与 OpenAI API 交互的 SDK\n- **Tailwind CSS**：用于样式的实用优先 CSS 框架\n- **Framer Motion**：用于动画的库\n\n完整的依赖列表请参阅 `package.json`。\n\n### API 端点\n\n- **\u002Fapi\u002Fchat**：处理聊天消息并流式传输 AI 的响应和操作\n\n### 服务器端操作\n\n- **createSandbox**：创建新的沙盒实例\n- **increaseTimeout**：延长沙盒超时时间\n- **stopSandboxAction**：停止正在运行的沙盒实例\n\n## 故障排除\n\n- **沙盒无法启动**：请检查 `.env.local` 文件中的 E2B API 密钥是否正确\n- **AI 无响应**：请确认您的 OpenAI API 密钥有效，并且有权访问所需的模型\n- **操作无法执行**：请确保沙盒正在运行，并且 AI 收到了正确的指令\n\n## 贡献\n\n欢迎贡献！请随时提交 Pull Request。\n\n## 许可证\n\n本项目采用 Apache License 2.0 许可证——详情请参阅 [LICENSE](LICENSE) 文件。\n\n## 支持\n\n如果您遇到任何问题或有任何疑问：\n- 请查看 [E2B 文档](https:\u002F\u002Fe2b.dev\u002Fdocs)\n- 加入 [E2B Discord](https:\u002F\u002Fdiscord.gg\u002FU7KEcGErtQ)\n- 打开 [问题](https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fcomputer-use-app\u002Fissues)","# Surf 快速上手指南\n\nSurf 是一个基于 Next.js 的开源应用，它结合了 **E2B 桌面沙箱**与 **OpenAI Computer Use** 能力，允许用户通过自然语言指令控制云端虚拟电脑。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **Node.js**: 安装版本需符合项目 `package.json` 要求（建议使用 LTS 版本）。\n*   **包管理器**: npm (随 Node.js 自动安装)。\n*   **E2B API Key**: 需在 [E2B 控制台](https:\u002F\u002Fe2b.dev\u002Fdocs\u002Fgetting-started\u002Fapi-key) 获取。\n*   **OpenAI API Key**: 需在 [OpenAI 平台](https:\u002F\u002Fplatform.openai.com\u002Fapi-keys) 获取，并确保账户有权访问 Computer Use 相关模型。\n\n> **注意**：由于 E2B 和 OpenAI 的服务特性，国内开发者可能需要配置网络代理才能正常连接 API。\n\n## 安装步骤\n\n1.  **克隆仓库**\n    ```bash\n    git clone https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fsurf\n    cd surf\n    ```\n\n2.  **安装依赖**\n    ```bash\n    npm install\n    ```\n    *(如需加速，可临时指定淘宝镜像源：`npm install --registry=https:\u002F\u002Fregistry.npmmirror.com`)*\n\n3.  **配置环境变量**\n    在项目根目录下创建 `.env.local` 文件，并填入您的 API 密钥：\n    ```env\n    E2B_API_KEY=your_e2b_api_key\n    OPENAI_API_KEY=your_openai_api_key\n    ```\n\n4.  **启动开发服务器**\n    ```bash\n    npm run dev\n    ```\n\n5.  **访问应用**\n    打开浏览器访问 [http:\u002F\u002Flocalhost:3000](http:\u002F\u002Flocalhost:3000)。\n\n## 基本使用\n\n1.  **启动沙箱**\n    在网页界面点击 **\"Start new Sandbox\"** 按钮。系统将初始化一个基于 Linux 的虚拟桌面环境（通常需要几秒钟）。\n\n2.  **发送指令**\n    在聊天输入框中输入自然语言指令。例如：\n    > \"Open Firefox and go to google.com\"\n    \n    按下回车或点击发送按钮。\n\n3.  **观察执行**\n    *   AI 会分析指令并在聊天窗口展示其推理过程。\n    *   右侧的虚拟桌面将实时演示 AI 的操作（如移动鼠标、点击图标、输入文字等）。\n    *   您可以持续发送新指令与 AI 交互，沙箱运行时间即将结束时会自动延长。","某自动化测试工程师需要快速验证一个跨平台的 Web 应用在 Linux 环境下的安装流程及基础功能，但本地缺乏对应的测试环境。\n\n### 没有 surf 时\n- **环境搭建耗时**：手动配置 Linux 虚拟机、安装桌面环境及浏览器依赖往往需要数小时，严重拖慢测试节奏。\n- **操作无法复用**：每次测试都需要人工重复点击和输入，难以将自然语言描述的测试用例直接转化为可执行步骤。\n- **调试过程黑盒**：当脚本报错时，缺乏实时的视觉反馈，开发者很难判断是环境问题还是操作逻辑错误。\n- **资源隔离困难**：在本地运行不可信的测试代码存在安全风险，且清理残留环境十分繁琐。\n\n### 使用 surf 后\n- **秒级环境就绪**：通过 surf 调用 E2B 沙箱，仅需一条指令即可在云端瞬间启动一个干净的 Linux 虚拟桌面，无需任何本地配置。\n- **自然语言驱动**：直接输入“打开 Firefox 访问测试页并登录”，surf 背后的 AI 代理会自动规划并执行点击、输入等具体操作。\n- **全流程可视化**：借助实时流媒体技术，工程师能在网页端亲眼看到 AI 如何操作桌面，每一步推理和执行都清晰可见，便于即时纠偏。\n- **安全隔离运行**：所有操作均在云端隔离的沙箱中进行，测试结束后环境自动销毁，既保证了安全性又免去了清理工作。\n\nsurf 将繁琐的环境准备和脚本编写转化为简单的自然语言交互，让跨平台自动化测试变得像聊天一样高效直观。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fe2b-dev_surf_a75ae3ff.png","e2b-dev","E2B | Cloud for AI Agents","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fe2b-dev_e286365d.png","Open-source, secure environment with real-world tools for enterprise-grade agents.",null,"hello@e2b.dev","e2b","https:\u002F\u002Fe2b.dev\u002Fdocs","https:\u002F\u002Fgithub.com\u002Fe2b-dev",[82,86,90],{"name":83,"color":84,"percentage":85},"TypeScript","#3178c6",94.8,{"name":87,"color":88,"percentage":89},"CSS","#663399",5,{"name":91,"color":92,"percentage":93},"JavaScript","#f1e05a",0.2,754,130,"2026-04-09T08:24:26","Apache-2.0","未说明",{"notes":100,"python":98,"dependencies":101},"该项目基于 Node.js 和 npm 运行，需配置 E2B API Key 和 OpenAI API Key。虚拟桌面环境运行在云端沙箱中，本地无需高性能硬件支持。",[102,103,104,105,106],"Next.js","@e2b\u002Fdesktop","openai","Tailwind CSS","Framer Motion",[13,15,14],[109,110,111,112,78,104,113,114],"ai","automation","cua","desktop","sandbox","virtual-desktop","2026-03-27T02:49:30.150509","2026-04-10T22:18:59.736378",[118,123,128,132,136,141],{"id":119,"question_zh":120,"answer_zh":121,"source_url":122},28364,"切换到其他 LLM 提供商需要修改大量代码吗？","不需要大幅修改。对于 Anthropic 等模型，核心逻辑已存在于代码库中，仅需取消注释即可。维护者也确认后续会更新版本以更方便地支持多种提供商。","https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fsurf\u002Fissues\u002F4",{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},28359,"遇到'AI 服务发生错误，请重试'或'E2B 虚拟桌面截图失败'的错误怎么办？","这通常是由于使用的 Desktop SDK 版本过旧导致无法获取详细堆栈跟踪或存在已知问题。解决方案是更新项目中使用的 Desktop SDK 版本。用户反馈更新版本后问题已解决。","https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fsurf\u002Fissues\u002F13",{"id":129,"question_zh":130,"answer_zh":131,"source_url":127},28360,"E2B 的免费计划会导致运行错误或功能受限吗？","不会。维护者明确表示免费计划不应该导致此类问题。如果遇到错误，通常与计划类型无关，建议检查 SDK 版本或查看具体的错误堆栈信息。",{"id":133,"question_zh":134,"answer_zh":135,"source_url":122},28361,"如何让项目使用 Anthropic (Claude) 或其他非 OpenAI 的大模型？","代码中已经包含了运行 Anthropic 模型所需的所有部分，但出于 API 不稳定性的考虑，官方默认将其注释掉了。用户可以通过取消相关代码的注释来在本地运行 Anthropic 模型。未来版本计划支持更多提供商。",{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},28362,"是否支持使用 DeepSeek-R1 等通过 OpenRouter 或 Together.ai 提供的开源模型？","当前仓库不支持使用不具备原生“计算机使用”（computer use）能力的模型。如果需要使用此类模型，请参考 E2B 的另一个项目：open-computer-use (https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fopen-computer-use)。","https:\u002F\u002Fgithub.com\u002Fe2b-dev\u002Fsurf\u002Fissues\u002F5",{"id":142,"question_zh":143,"answer_zh":144,"source_url":122},28363,"为什么官方暂时不正式推出对 Anthropic API 的支持？","主要是因为 Anthropic API 目前存在可靠性问题（unreliability）。虽然代码已准备好，但为了稳定性，官方暂未正式启用，不过用户仍可自行取消注释在本地尝试使用。",[]]