[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-agentbay-ai--wuying-agentbay-sdk":3,"tool-agentbay-ai--wuying-agentbay-sdk":62},[4,18,26,36,46,54],{"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 真正成长为懂上",160411,2,"2026-04-18T23:33:24",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"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",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":68,"readme_en":69,"readme_zh":70,"quickstart_zh":71,"use_case_zh":72,"hero_image_url":73,"owner_login":74,"owner_name":75,"owner_avatar_url":76,"owner_bio":77,"owner_company":77,"owner_location":77,"owner_email":77,"owner_twitter":77,"owner_website":77,"owner_url":78,"languages":79,"stars":118,"forks":119,"last_commit_at":120,"license":121,"difficulty_score":32,"env_os":122,"env_gpu":123,"env_ram":123,"env_deps":124,"category_tags":127,"github_topics":128,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":134,"updated_at":135,"faqs":136,"releases":177},9401,"agentbay-ai\u002Fwuying-agentbay-sdk","wuying-agentbay-sdk","The Cloud Sandbox Built for AI Agents","wuying-agentbay-sdk 是专为 AI 智能体打造的云端沙箱开发工具包。它能让 AI 在几秒钟内获得一个独立、安全的云端环境，具备浏览器操作、桌面应用控制、移动端测试及代码执行等全方位能力。任务完成后，环境可立即销毁，开发者无需关心底层基础设施的维护与管理。\n\n该工具主要解决了 AI 智能体在本地运行时面临的环境依赖复杂、操作权限受限以及难以模拟真实用户交互（如浏览网页、操作手机 APP）等痛点。通过提供按需分配的隔离环境，它确保了自动化任务的安全性与稳定性，让 AI 能够像人类一样在真实的操作系统中完成复杂工作流。\n\nwuying-agentbay-sdk 非常适合需要构建高级自动化应用的开发者、AI 研究人员以及测试工程师使用。无论是进行网页数据抓取、企业软件流程自动化、移动应用 UI 测试，还是让 AI 辅助编写和调试代码，它都能提供强有力的支持。\n\n其独特亮点在于提供了 Python、TypeScript、Go 和 Java 等多种主流语言的 SDK，并通过统一的 API 接口屏蔽了底层复杂性。结合阿里云强大的资源调度能力，它不仅支持自然语言控制的跨浏览器操作，还","wuying-agentbay-sdk 是专为 AI 智能体打造的云端沙箱开发工具包。它能让 AI 在几秒钟内获得一个独立、安全的云端环境，具备浏览器操作、桌面应用控制、移动端测试及代码执行等全方位能力。任务完成后，环境可立即销毁，开发者无需关心底层基础设施的维护与管理。\n\n该工具主要解决了 AI 智能体在本地运行时面临的环境依赖复杂、操作权限受限以及难以模拟真实用户交互（如浏览网页、操作手机 APP）等痛点。通过提供按需分配的隔离环境，它确保了自动化任务的安全性与稳定性，让 AI 能够像人类一样在真实的操作系统中完成复杂工作流。\n\nwuying-agentbay-sdk 非常适合需要构建高级自动化应用的开发者、AI 研究人员以及测试工程师使用。无论是进行网页数据抓取、企业软件流程自动化、移动应用 UI 测试，还是让 AI 辅助编写和调试代码，它都能提供强有力的支持。\n\n其独特亮点在于提供了 Python、TypeScript、Go 和 Java 等多种主流语言的 SDK，并通过统一的 API 接口屏蔽了底层复杂性。结合阿里云强大的资源调度能力，它不仅支持自然语言控制的跨浏览器操作，还能实现并行的移动设备测试与智能化的代码空间管理，让构建“能动手”的 AI 智能体变得简单高效。","\u003Cdiv align=\"center\">\n\n[![arXiv](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPaper-arXiv-b31b1b.svg?logo=arxiv&logoColor=white)](https:\u002F\u002Farxiv.org\u002Fabs\u002F2512.04367)\n[![PyPI Downloads](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fdm\u002Fwuying-agentbay-sdk?label=PyPI%20Downloads&logo=python&logoColor=white&cacheSeconds=86400)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fwuying-agentbay-sdk\u002F)\n[![NPM Downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fwuying-agentbay-sdk?label=NPM%20Downloads&logo=npm)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fwuying-agentbay-sdk)\n[![Go Report Card](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_2b4a70945b89.png)](https:\u002F\u002Fgoreportcard.com\u002Freport\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fgolang)\n[![Maven Central](https:\u002F\u002Fimg.shields.io\u002Fmaven-central\u002Fv\u002Fcom.aliyun\u002Fagentbay-sdk?color=blue&logo=apache-maven)](https:\u002F\u002Fcentral.sonatype.com\u002Fartifact\u002Fcom.aliyun\u002Fagentbay-sdk)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache%202.0-blue)](https:\u002F\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fblob\u002Fmain\u002FLICENSE)\n[![Ask DeepWiki](https:\u002F\u002Fdeepwiki.com\u002Fbadge.svg)](https:\u002F\u002Fdeepwiki.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk)\n\n\u003C\u002Fdiv>\n\n\u003Cp align=\"center\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\".\u002Fassets\u002FAgentbay-dark.png\" width=\"800px\">\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_3ad1ff290774.png\" width=\"800px\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_3ad1ff290774.png\" alt=\"AgentBay\" width=\"800px\" \u002F>\n  \u003C\u002Fpicture>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cb>The Cloud Sandbox Built for AI Agents\u003C\u002Fb>\n\u003C\u002Fp>\n\nAgentBay provides **on-demand cloud sandboxes** for AI agents — isolated environments with browser, desktop, mobile, and code execution capabilities. Create a sandbox in seconds, let your agent do its work, and tear it down when done. No infrastructure to manage.\n\nWith SDKs for **Python**, **TypeScript**, **Golang**, and **Java**, AgentBay gives your agents a full cloud environment through a simple API: execute commands, browse the web, automate desktop apps, test mobile UIs, or run code — all in secure, disposable sandboxes.\n\n---\n\n## 🎯 What You Can Do\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd width=\"50%\" align=\"center\" valign=\"top\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_0eb092d17a99.png\" width=\"460px\" alt=\"Browser Use\"\u002F>\n  \u003Ch3>🌐 Browser Use\u003C\u002Fh3>\n  \u003Cp>Automate web operations including content scraping, testing, and workflows. Cross-browser compatible with natural language control and remote access.\u003C\u002Fp>\n  \u003Cp>\u003Ca href=\"docs\u002Fguides\u002Fbrowser-use\u002FREADME.md\">Learn more →\u003C\u002Fa>\u003C\u002Fp>\n\u003C\u002Ftd>\n\u003Ctd width=\"50%\" align=\"center\" valign=\"top\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_19880682c0f1.png\" width=\"460px\" alt=\"Computer Use\"\u002F>\n  \u003Ch3>🖥️ Computer Use\u003C\u002Fh3>\n  \u003Cp>Cloud desktop environment for enterprise application automation. Standardized interfaces enable legacy software automation with intelligent resource scheduling.\u003C\u002Fp>\n  \u003Cp>\u003Ca href=\"docs\u002Fguides\u002Fcomputer-use\u002FREADME.md\">Learn more →\u003C\u002Fa>\u003C\u002Fp>\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd width=\"50%\" align=\"center\" valign=\"top\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_92def4801760.png\" width=\"460px\" alt=\"Mobile Use\"\u002F>\n  \u003Ch3>📱 Mobile Use\u003C\u002Fh3>\n  \u003Cp>Cloud-based mobile environment for intelligent app automation. Precise UI recognition and control with parallel task processing for testing scenarios.\u003C\u002Fp>\n  \u003Cp>\u003Ca href=\"docs\u002Fguides\u002Fmobile-use\u002FREADME.md\">Learn more →\u003C\u002Fa>\u003C\u002Fp>\n\u003C\u002Ftd>\n\u003Ctd width=\"50%\" align=\"center\" valign=\"top\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_6e3bd1cf901b.png\" width=\"460px\" alt=\"Code Space\"\u002F>\n  \u003Ch3>💻 Code Space\u003C\u002Fh3>\n  \u003Cp>Professional cloud development environment supporting multi-language code generation, compilation, and debugging. Secure, intelligent automated programming experience.\u003C\u002Fp>\n  \u003Cp>\u003Ca href=\"docs\u002Fguides\u002Fcodespace\u002FREADME.md\">Learn more →\u003C\u002Fa>\u003C\u002Fp>\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## ✅ Prerequisites\n\nBefore using the SDK, you need to:\n\n1. Register an Alibaba Cloud account: [https:\u002F\u002Faliyun.com](https:\u002F\u002Faliyun.com)\n2. Get APIKEY credentials: [AgentBay Console](https:\u002F\u002Fagentbay.console.aliyun.com\u002Fservice-management)\n3. Set environment variable:\n   - For Linux\u002FMacOS:\n     ```bash\n     export AGENTBAY_API_KEY=your_api_key_here\n     ```\n   - For Windows:\n     ```cmd\n     setx AGENTBAY_API_KEY your_api_key_here\n     ```\n\n## 📦 Installation\n\n| Language | Install Command | Documentation |\n|----------|----------------|---------------|\n| Python | `pip install wuying-agentbay-sdk` | [Python Docs](python\u002FREADME.md) |\n| TypeScript | `npm install wuying-agentbay-sdk` | [TypeScript Docs](typescript\u002FREADME.md) |\n| Golang | `go get github.com\u002Faliyun\u002Fwuying-agentbay-sdk\u002Fgolang\u002Fpkg\u002Fagentbay` | [Golang Docs](golang\u002FREADME.md) |\n| Java | See Maven snippet below | [Java Docs](java\u002FREADME.md) |\n\n\u003Cdetails>\n\u003Csummary>Java Maven dependency\u003C\u002Fsummary>\n\n```xml\n\u003Cdependency>\n    \u003CgroupId>com.aliyun\u003C\u002FgroupId>\n    \u003CartifactId>agentbay-sdk\u003C\u002FartifactId>\n    \u003Cversion>0.19.0\u003C\u002Fversion>\n\u003C\u002Fdependency>\n```\n\n\u003C\u002Fdetails>\n\n## 🚀 Quick Start\n\n### Python\n\n```python\nfrom agentbay import AgentBay, CreateSessionParams\n\nagent_bay = AgentBay()\n\n# Create a cloud sandbox (options: \"code_latest\", \"browser_latest\", \"desktop_latest\")\nsession = agent_bay.create(CreateSessionParams(image_id=\"code_latest\")).session\n\n# Execute code in the sandbox\nresult = session.code.run_code(\"print('Hello AgentBay')\", \"python\")\nif result.success:\n    print(result.result)  # Hello AgentBay\n\nagent_bay.delete(session)\n```\n\n### TypeScript\n\n```typescript\nimport { AgentBay } from 'wuying-agentbay-sdk';\n\nconst agentBay = new AgentBay();\n\n\u002F\u002F Create a cloud sandbox\nconst session = (await agentBay.create({ imageId: \"code_latest\" })).session;\n\n\u002F\u002F Execute code in the sandbox\nconst result = await session.code.runCode(\"print('Hello AgentBay')\", \"python\");\nif (result.success) {\n    console.log(result.result);  \u002F\u002F Hello AgentBay\n}\n\nawait agentBay.delete(session);\n```\n\n### Golang\n\n```go\nimport \"github.com\u002Faliyun\u002Fwuying-agentbay-sdk\u002Fgolang\u002Fpkg\u002Fagentbay\"\n\nclient, _ := agentbay.NewAgentBay(\"\", nil)\n\n\u002F\u002F Create a cloud sandbox\nresult, _ := client.Create(agentbay.NewCreateSessionParams().WithImageId(\"code_latest\"))\nsession := result.Session\n\n\u002F\u002F Execute code in the sandbox\nres, _ := session.Code.RunCode(\"print('Hello AgentBay')\", \"python\")\nfmt.Println(res.Output)  \u002F\u002F Hello AgentBay\n\nclient.Delete(session, false)\n```\n\n### Java\n\n```java\nimport com.aliyun.agentbay.*;\n\nAgentBay agentBay = new AgentBay();\n\n\u002F\u002F Create a cloud sandbox\nCreateSessionParams params = new CreateSessionParams().setImageId(\"code_latest\");\nSession session = agentBay.create(params).getSession();\n\n\u002F\u002F Execute code in the sandbox\nCodeExecutionResult result = session.getCode().runCode(\"print('Hello AgentBay')\", \"python\");\nif (result.isSuccess()) {\n    System.out.println(result.getResult());  \u002F\u002F Hello AgentBay\n}\n\nagentBay.delete(session, false);\n```\n\n## 📚 Documentation\n\n> **New to AgentBay?** Start with the [Quick Start Tutorial](docs\u002Fquickstart\u002FREADME.md) — you'll be up and running in 5 minutes.\n\n| Resource | Description |\n|----------|-------------|\n| [Quick Start Tutorial](docs\u002Fquickstart\u002FREADME.md) | Get started in 5 minutes |\n| [Core Concepts](docs\u002Fquickstart\u002Fbasic-concepts.md) | Understand sessions, environments, and sandboxes |\n| [Feature Guides](docs\u002Fguides\u002FREADME.md) | In-depth guides for each capability |\n| [API Reference](python\u002Fdocs\u002Fapi\u002F) | Complete API docs ([Python](python\u002Fdocs\u002Fapi\u002F) · [TypeScript](typescript\u002Fdocs\u002Fapi\u002F) · [Golang](golang\u002Fdocs\u002Fapi\u002F) · [Java](java\u002Fdocs\u002Fapi\u002F)) |\n| [Cookbook](cookbook\u002FREADME.md) | Real-world examples and recipes |\n\n## 🔧 Core Features\n\n### 🎛️ Session Management\n- **Session Lifecycle** — Create, manage, and delete cloud sandboxes on demand\n- **Environment Configuration** — Configure regions, endpoints, and sandbox images\n- **Session Monitoring** — Monitor status and health\n\n### 🛠️ Built-in Modules\n- **Command Execution** — Run shell commands in cloud sandboxes\n- **File Operations** — Upload, download, and manage files\n- **Context & Data Persistence** — Save and retrieve data across sessions\n- **Git Operations** — Clone, commit, and manage repositories remotely\n\n## 🤖 AI-Assisted Development\n\nIf you're using AI coding assistants (Claude, Cursor, GitHub Copilot, etc.) to develop with AgentBay SDK, use these files as context:\n\n- **[llms.txt](.\u002Fllms.txt)** — Concise overview (~14k tokens, ~55 KB)\n- **[llms-full.txt](.\u002Fllms-full.txt)** — Full SDK source, API docs, and examples (~211k tokens, ~827 KB)\n\n## 🆘 Get Help\n\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fissues)\n\n## 📞 Contact\n\nWelcome to visit our product website and join our community!\n\n- 🌐 **AgentBay International Website**: [https:\u002F\u002Fwww.alibabacloud.com\u002Fproduct\u002Fagentbay](https:\u002F\u002Fwww.alibabacloud.com\u002Fproduct\u002Fagentbay)\n- 🇨🇳 **AgentBay China Website (Chinese)**: [https:\u002F\u002Fwww.aliyun.com\u002Fproduct\u002Fagentbay](https:\u002F\u002Fwww.aliyun.com\u002Fproduct\u002Fagentbay)\n- 💬 **Discord Community**: [Join on Discord](https:\u002F\u002Fdiscord.gg\u002FtzX52463Cp)\n- 💼 **DingTalk Group**: [Click to join](https:\u002F\u002Fqr.dingtalk.com\u002Faction\u002Fjoingroup?code=v1,k1,ZlCDtu+p3xq2MqVoIA3nYrvEWA21Gq86N91t9OuythQ=&_dt_no_comment=1&origin=11)\n\n## 📄 License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n","\u003Cdiv align=\"center\">\n\n[![arXiv](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPaper-arXiv-b31b1b.svg?logo=arxiv&logoColor=white)](https:\u002F\u002Farxiv.org\u002Fabs\u002F2512.04367)\n[![PyPI Downloads](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fdm\u002Fwuying-agentbay-sdk?label=PyPI%20Downloads&logo=python&logoColor=white&cacheSeconds=86400)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fwuying-agentbay-sdk\u002F)\n[![NPM Downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fwuying-agentbay-sdk?label=NPM%20Downloads&logo=npm)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fwuying-agentbay-sdk)\n[![Go Report Card](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_2b4a70945b89.png)](https:\u002F\u002Fgoreportcard.com\u002Freport\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fgolang)\n[![Maven Central](https:\u002F\u002Fimg.shields.io\u002Fmaven-central\u002Fv\u002Fcom.aliyun\u002Fagentbay-sdk?color=blue&logo=apache-maven)](https:\u002F\u002Fcentral.sonatype.com\u002Fartifact\u002Fcom.aliyun\u002Fagentbay-sdk)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache%202.0-blue)](https:\u002F\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fblob\u002Fmain\u002FLICENSE)\n[![Ask DeepWiki](https:\u002F\u002Fdeepwiki.com\u002Fbadge.svg)](https:\u002F\u002Fdeepwiki.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk)\n\n\u003C\u002Fdiv>\n\n\u003Cp align=\"center\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\".\u002Fassets\u002FAgentbay-dark.png\" width=\"800px\">\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_3ad1ff290774.png\" width=\"800px\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_3ad1ff290774.png\" alt=\"AgentBay\" width=\"800px\" \u002F>\n  \u003C\u002Fpicture>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cb>专为 AI 代理打造的云沙盒\u003C\u002Fb>\n\u003C\u002Fp>\n\nAgentBay 为 AI 代理提供**按需云沙盒**——具备浏览器、桌面、移动端及代码执行能力的隔离环境。您可在几秒钟内创建一个沙盒，让您的代理完成任务，并在完成后将其销毁。无需管理任何基础设施。\n\n凭借适用于**Python**、**TypeScript**、**Golang**和**Java**的 SDK，AgentBay 通过简单的 API 为您的代理提供完整的云环境：执行命令、浏览网页、自动化桌面应用、测试移动 UI 或运行代码——所有这些都在安全且可丢弃的沙盒中完成。\n\n---\n\n## 🎯 您可以做什么\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd width=\"50%\" align=\"center\" valign=\"top\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_0eb092d17a99.png\" width=\"460px\" alt=\"Browser Use\"\u002F>\n  \u003Ch3>🌐 浏览器使用\u003C\u002Fh3>\n  \u003Cp>自动化网页操作，包括内容抓取、测试和工作流。跨浏览器兼容，支持自然语言控制和远程访问。\u003C\u002Fp>\n  \u003Cp>\u003Ca href=\"docs\u002Fguides\u002Fbrowser-use\u002FREADME.md\">了解更多 →\u003C\u002Fa>\u003C\u002Fp>\n\u003C\u002Ftd>\n\u003Ctd width=\"50%\" align=\"center\" valign=\"top\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_19880682c0f1.png\" width=\"460px\" alt=\"Computer Use\"\u002F>\n  \u003Ch3>🖥️ 计算机使用\u003C\u002Fh3>\n  \u003Cp>面向企业应用自动化的云桌面环境。标准化接口可实现对遗留软件的自动化，并进行智能资源调度。\u003C\u002Fp>\n  \u003Cp>\u003Ca href=\"docs\u002Fguides\u002Fcomputer-use\u002FREADME.md\">了解更多 →\u003C\u002Fa>\u003C\u002Fp>\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd width=\"50%\" align=\"center\" valign=\"top\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_92def4801760.png\" width=\"460px\" alt=\"Mobile Use\"\u002F>\n  \u003Ch3>📱 移动端使用\u003C\u002Fh3>\n  \u003Cp>基于云的移动环境，用于智能应用自动化。精确的 UI 识别与控制，配合并行任务处理，适用于测试场景。\u003C\u002Fp>\n  \u003Cp>\u003Ca href=\"docs\u002Fguides\u002Fmobile-use\u002FREADME.md\">了解更多 →\u003C\u002Fa>\u003C\u002Fp>\n\u003C\u002Ftd>\n\u003Ctd width=\"50%\" align=\"center\" valign=\"top\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_readme_6e3bd1cf901b.png\" width=\"460px\" alt=\"Code Space\"\u002F>\n  \u003Ch3>💻 代码空间\u003C\u002Fh3>\n  \u003Cp>专业的云开发环境，支持多语言代码生成、编译和调试。提供安全、智能的自动化编程体验。\u003C\u002Fp>\n  \u003Cp>\u003Ca href=\"docs\u002Fguides\u002Fcodespace\u002FREADME.md\">了解更多 →\u003C\u002Fa>\u003C\u002Fp>\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## ✅ 前提条件\n\n在使用 SDK 之前，您需要：\n\n1. 注册阿里云账号：[https:\u002F\u002Faliyun.com](https:\u002F\u002Faliyun.com)\n2. 获取 APIKEY 凭证：[AgentBay 控制台](https:\u002F\u002Fagentbay.console.aliyun.com\u002Fservice-management)\n3. 设置环境变量：\n   - 对于 Linux\u002FMacOS：\n     ```bash\n     export AGENTBAY_API_KEY=your_api_key_here\n     ```\n   - 对于 Windows：\n     ```cmd\n     setx AGENTBAY_API_KEY your_api_key_here\n     ```\n\n## 📦 安装\n\n| 语言 | 安装命令 | 文档 |\n|----------|----------------|---------------|\n| Python | `pip install wuying-agentbay-sdk` | [Python 文档](python\u002FREADME.md) |\n| TypeScript | `npm install wuying-agentbay-sdk` | [TypeScript 文档](typescript\u002FREADME.md) |\n| Golang | `go get github.com\u002Faliyun\u002Fwuying-agentbay-sdk\u002Fgolang\u002Fpkg\u002Fagentbay` | [Golang 文档](golang\u002FREADME.md) |\n| Java | 参见下方 Maven 片段 | [Java 文档](java\u002FREADME.md) |\n\n\u003Cdetails>\n\u003Csummary>Java Maven 依赖\u003C\u002Fsummary>\n\n```xml\n\u003Cdependency>\n    \u003CgroupId>com.aliyun\u003C\u002FgroupId>\n    \u003CartifactId>agentbay-sdk\u003C\u002FartifactId>\n    \u003Cversion>0.19.0\u003C\u002Fversion>\n\u003C\u002Fdependency>\n```\n\n\u003C\u002Fdetails>\n\n## 🚀 快速入门\n\n### Python\n\n```python\nfrom agentbay import AgentBay, CreateSessionParams\n\nagent_bay = AgentBay()\n\n# 创建云沙盒（选项：“code_latest”、“browser_latest”、“desktop_latest”）\nsession = agent_bay.create(CreateSessionParams(image_id=\"code_latest\")).session\n\n# 在沙盒中执行代码\nresult = session.code.run_code(\"print('Hello AgentBay')\", \"python\")\nif result.success:\n    print(result.result)  # Hello AgentBay\n\nagent_bay.delete(session)\n```\n\n### TypeScript\n\n```typescript\nimport { AgentBay } from 'wuying-agentbay-sdk';\n\nconst agentBay = new AgentBay();\n\n\u002F\u002F 创建云沙盒\nconst session = (await agentBay.create({ imageId: \"code_latest\" })).session;\n\n\u002F\u002F 在沙盒中执行代码\nconst result = await session.code.runCode(\"print('Hello AgentBay')\", \"python\");\nif (result.success) {\n    console.log(result.result);  \u002F\u002F Hello AgentBay\n}\n\nawait agentBay.delete(session);\n```\n\n### Golang\n\n```go\nimport \"github.com\u002Faliyun\u002Fwuying-agentbay-sdk\u002Fgolang\u002Fpkg\u002Fagentbay\"\n\nclient, _ := agentbay.NewAgentBay(\"\", nil)\n\n\u002F\u002F 创建云沙盒\nresult, _ := client.Create(agentbay.NewCreateSessionParams().WithImageId(\"code_latest\"))\nsession := result.Session\n\n\u002F\u002F 在沙盒中执行代码\nres, _ := session.Code.RunCode(\"print('Hello AgentBay')\", \"python\")\nfmt.Println(res.Output)  \u002F\u002F Hello AgentBay\n\nclient.Delete(session, false)\n```\n\n### Java\n\n```java\nimport com.aliyun.agentbay.*;\n\nAgentBay agentBay = new AgentBay();\n\n\u002F\u002F 创建云沙盒\nCreateSessionParams params = new CreateSessionParams().setImageId(\"code_latest\");\nSession session = agentBay.create(params).getSession();\n\n\u002F\u002F 在沙盒中执行代码\nCodeExecutionResult result = session.getCode().runCode(\"print('Hello AgentBay')\", \"python\");\nif (result.isSuccess()) {\n    System.out.println(result.getResult());  \u002F\u002F Hello AgentBay\n}\n\nagentBay.delete(session, false);\n```\n\n## 📚 文档\n\n> **初次使用 AgentBay？** 从[快速入门教程](docs\u002Fquickstart\u002FREADME.md)开始——5 分钟内即可上手。\n\n| 资源 | 描述 |\n|----------|-------------|\n| [快速入门教程](docs\u002Fquickstart\u002FREADME.md) | 5 分钟内开始使用 |\n| [核心概念](docs\u002Fquickstart\u002Fbasic-concepts.md) | 理解会话、环境和沙箱 |\n| [功能指南](docs\u002Fguides\u002FREADME.md) | 各项能力的深入指南 |\n| [API 参考文档](python\u002Fdocs\u002Fapi\u002F) | 完整的 API 文档（[Python](python\u002Fdocs\u002Fapi\u002F) · [TypeScript](typescript\u002Fdocs\u002Fapi\u002F) · [Golang](golang\u002Fdocs\u002Fapi\u002F) · [Java](java\u002Fdocs\u002Fapi\u002F)） |\n| [示例集](cookbook\u002FREADME.md) | 实际应用示例和配方 |\n\n## 🔧 核心功能\n\n### 🎛️ 会话管理\n- **会话生命周期** — 按需创建、管理和删除云沙箱\n- **环境配置** — 配置区域、端点和沙箱镜像\n- **会话监控** — 监控状态和健康状况\n\n### 🛠️ 内置模块\n- **命令执行** — 在云沙箱中运行 Shell 命令\n- **文件操作** — 上传、下载和管理文件\n- **上下文与数据持久化** — 在不同会话间保存和检索数据\n- **Git 操作** — 远程克隆、提交和管理代码仓库\n\n## 🤖 AI 辅助开发\n\n如果您正在使用 AI 编码助手（Claude、Cursor、GitHub Copilot 等）配合 AgentBay SDK 进行开发，请将以下文件用作上下文：\n\n- **[llms.txt](.\u002Fllms.txt)** — 简明概述（约 1.4 万 token，约 55 KB）\n- **[llms-full.txt](.\u002Fllms-full.txt)** — 完整 SDK 源码、API 文档和示例（约 21.1 万 token，约 827 KB）\n\n## 🆘 获取帮助\n\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fissues)\n\n## 📞 联系方式\n\n欢迎访问我们的产品官网并加入社区！\n\n- 🌐 **AgentBay 国际官网**: [https:\u002F\u002Fwww.alibabacloud.com\u002Fproduct\u002Fagentbay](https:\u002F\u002Fwww.alibabacloud.com\u002Fproduct\u002Fagentbay)\n- 🇨🇳 **AgentBay 中国官网（中文）**: [https:\u002F\u002Fwww.aliyun.com\u002Fproduct\u002Fagentbay](https:\u002F\u002Fwww.aliyun.com\u002Fproduct\u002Fagentbay)\n- 💬 **Discord 社区**: [点击加入 Discord](https:\u002F\u002Fdiscord.gg\u002FtzX52463Cp)\n- 💼 **钉钉群**: [点击加入](https:\u002F\u002Fqr.dingtalk.com\u002Faction\u002Fjoingroup?code=v1,k1,ZlCDtu+p3xq2MqVoIA3nYrvEWA21Gq86N91t9OuythQ=&_dt_no_comment=1&origin=11)\n\n## 📄 许可证\n\n本项目采用 Apache License 2.0 许可证授权——详情请参阅[LICENSE](LICENSE) 文件。","# wuying-agentbay-sdk 快速上手指南\n\nAgentBay 是专为 AI Agent 打造的云端沙盒服务，提供浏览器、桌面、移动端及代码执行等隔离环境。通过简单的 API，即可在秒级创建按需沙盒，完成任务后自动销毁，无需管理基础设施。\n\n## 环境准备\n\n在使用 SDK 之前，请确保完成以下准备工作：\n\n1. **注册账号**：拥有阿里云账号（[https:\u002F\u002Faliyun.com](https:\u002F\u002Faliyun.com)）。\n2. **获取密钥**：登录 [AgentBay 控制台](https:\u002F\u002Fagentbay.console.aliyun.com\u002Fservice-management) 获取 API Key。\n3. **配置环境变量**：将 API Key 设置为环境变量，以便 SDK 自动识别。\n\n   - **Linux \u002F MacOS**:\n     ```bash\n     export AGENTBAY_API_KEY=your_api_key_here\n     ```\n   - **Windows (CMD)**:\n     ```cmd\n     setx AGENTBAY_API_KEY your_api_key_here\n     ```\n   - **Windows (PowerShell)**:\n     ```powershell\n     $env:AGENTBAY_API_KEY=\"your_api_key_here\"\n     ```\n\n## 安装步骤\n\n根据您的开发语言选择对应的安装命令。国内开发者如遇网络问题，建议配置相应的镜像源加速下载。\n\n| 语言 | 安装命令 | 备注 |\n| :--- | :--- | :--- |\n| **Python** | `pip install wuying-agentbay-sdk` | 建议使用清华\u002F阿里镜像源 |\n| **TypeScript** | `npm install wuying-agentbay-sdk` | 可配置 npm 淘宝镜像 |\n| **Golang** | `go get github.com\u002Faliyun\u002Fwuying-agentbay-sdk\u002Fgolang\u002Fpkg\u002Fagentbay` | 建议配置 GOPROXY |\n| **Java** | 见下方 Maven 依赖 | 添加至 `pom.xml` |\n\n**Java Maven 依赖配置：**\n```xml\n\u003Cdependency>\n    \u003CgroupId>com.aliyun\u003C\u002FgroupId>\n    \u003CartifactId>agentbay-sdk\u003C\u002FartifactId>\n    \u003Cversion>0.19.0\u003C\u002Fversion>\n\u003C\u002Fdependency>\n```\n\n## 基本使用\n\n以下示例展示如何创建一个代码执行沙盒（`code_latest`），运行一段 Python 代码，并在完成后销毁沙盒。\n\n### Python\n\n```python\nfrom agentbay import AgentBay, CreateSessionParams\n\nagent_bay = AgentBay()\n\n# 创建云端沙盒 (可选镜像：\"code_latest\", \"browser_latest\", \"desktop_latest\")\nsession = agent_bay.create(CreateSessionParams(image_id=\"code_latest\")).session\n\n# 在沙盒中执行代码\nresult = session.code.run_code(\"print('Hello AgentBay')\", \"python\")\nif result.success:\n    print(result.result)  # 输出：Hello AgentBay\n\n# 销毁沙盒\nagent_bay.delete(session)\n```\n\n### TypeScript\n\n```typescript\nimport { AgentBay } from 'wuying-agentbay-sdk';\n\nconst agentBay = new AgentBay();\n\n\u002F\u002F 创建云端沙盒\nconst session = (await agentBay.create({ imageId: \"code_latest\" })).session;\n\n\u002F\u002F 在沙盒中执行代码\nconst result = await session.code.runCode(\"print('Hello AgentBay')\", \"python\");\nif (result.success) {\n    console.log(result.result);  \u002F\u002F 输出：Hello AgentBay\n}\n\n\u002F\u002F 销毁沙盒\nawait agentBay.delete(session);\n```\n\n### Golang\n\n```go\nimport \"github.com\u002Faliyun\u002Fwuying-agentbay-sdk\u002Fgolang\u002Fpkg\u002Fagentbay\"\n\nclient, _ := agentbay.NewAgentBay(\"\", nil)\n\n\u002F\u002F 创建云端沙盒\nresult, _ := client.Create(agentbay.NewCreateSessionParams().WithImageId(\"code_latest\"))\nsession := result.Session\n\n\u002F\u002F 在沙盒中执行代码\nres, _ := session.Code.RunCode(\"print('Hello AgentBay')\", \"python\")\nfmt.Println(res.Output)  \u002F\u002F 输出：Hello AgentBay\n\n\u002F\u002F 销毁沙盒\nclient.Delete(session, false)\n```\n\n### Java\n\n```java\nimport com.aliyun.agentbay.*;\n\nAgentBay agentBay = new AgentBay();\n\n\u002F\u002F 创建云端沙盒\nCreateSessionParams params = new CreateSessionParams().setImageId(\"code_latest\");\nSession session = agentBay.create(params).getSession();\n\n\u002F\u002F 在沙盒中执行代码\nCodeExecutionResult result = session.getCode().runCode(\"print('Hello AgentBay')\", \"python\");\nif (result.isSuccess()) {\n    System.out.println(result.getResult());  \u002F\u002F 输出：Hello AgentBay\n}\n\n\u002F\u002F 销毁沙盒\nagentBay.delete(session, false);\n```\n\n> **提示**：除了代码执行，AgentBay 还支持浏览器自动化（Browser Use）、桌面应用操作（Computer Use）和移动端测试（Mobile Use）。更多高级用法请参考官方文档中的功能指南。","某电商数据团队需要每日自动监控竞品网站价格变动，并生成包含截图和数据分析的日报。\n\n### 没有 wuying-agentbay-sdk 时\n- **环境维护成本高**：团队需自行搭建和维护多台带有浏览器环境的服务器，处理驱动版本冲突、系统更新等繁琐的基础设施问题。\n- **并发能力受限**：本地或固定服务器资源有限，难以同时启动数十个浏览器实例进行大规模并行抓取，导致任务耗时过长。\n- **反爬对抗困难**：固定 IP 和指纹容易被目标网站识别并封锁，缺乏动态隔离环境来模拟真实用户行为以绕过风控。\n- **流程断裂**：网页抓取、数据清洗与代码执行分散在不同环节，需人工介入拼接数据，无法实现端到端的自动化闭环。\n\n### 使用 wuying-agentbay-sdk 后\n- **零基础设施负担**：通过 API 秒级创建按需云沙箱，内置完整浏览器环境，任务结束后自动销毁，彻底免除运维烦恼。\n- **弹性无限并发**：利用云端资源瞬间拉起上百个隔离沙箱并行处理任务，将原本数小时的抓取工作压缩至分钟级完成。\n- **天然隔离防封禁**：每个沙箱拥有独立的运行环境和网络特征，有效规避反爬机制，确保数据采集的稳定性与连续性。\n- **全链路自动化**：在同一个沙箱内即可完成“访问网页 - 提取数据 - 运行 Python 分析脚本 - 生成报表”的全流程，真正实现无人值守。\n\nwuying-agentbay-sdk 将复杂的云端环境管理转化为简单的 API 调用，让 AI 代理在安全、弹性的沙箱中高效完成现实世界的复杂任务。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentbay-ai_wuying-agentbay-sdk_0eb092d1.png","agentbay-ai","agentbay.ai","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fagentbay-ai_1c52a1d1.png",null,"https:\u002F\u002Fgithub.com\u002Fagentbay-ai",[80,84,88,92,96,100,104,107,111,115],{"name":81,"color":82,"percentage":83},"Python","#3572A5",51,{"name":85,"color":86,"percentage":87},"TypeScript","#3178c6",17.3,{"name":89,"color":90,"percentage":91},"Java","#b07219",15.8,{"name":93,"color":94,"percentage":95},"Go","#00ADD8",14.8,{"name":97,"color":98,"percentage":99},"JavaScript","#f1e05a",0.5,{"name":101,"color":102,"percentage":103},"CSS","#663399",0.2,{"name":105,"color":106,"percentage":103},"HTML","#e34c26",{"name":108,"color":109,"percentage":110},"Shell","#89e051",0.1,{"name":112,"color":113,"percentage":114},"Batchfile","#C1F12E",0,{"name":116,"color":117,"percentage":114},"Makefile","#427819",1106,46,"2026-04-17T07:14:08","Apache-2.0","Linux, macOS, Windows","未说明",{"notes":125,"python":123,"dependencies":126},"该工具为阿里云 AgentBay 的客户端 SDK（支持 Python, TypeScript, Golang, Java），用于调用云端沙箱服务。运行本地 SDK 无需特殊硬件配置，实际计算资源（如浏览器、桌面、代码执行环境）由云端按需分配。使用前需注册阿里云账号并配置 AGENTBAY_API_KEY 环境变量。",[],[15,13,14],[129,130,131,132,133],"agent","ai","agentbay","wuying","sandbox","2026-03-27T02:49:30.150509","2026-04-19T09:41:29.555723",[137,142,147,152,157,162,167,172],{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},42197,"Golang SDK 是否支持 Browser Use 功能？","由于 Golang 原生不支持 Playwright，目前 Golang SDK 暂未直接集成 Browser Use 功能。虽然社区有 playwright-go 库，但官方尚未基于此提供封装支持。建议关注后续版本更新或使用 Python SDK 进行相关操作。","https:\u002F\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fissues\u002F402",{"id":143,"question_zh":144,"answer_zh":145,"source_url":146},42198,"Java SDK 是否已经发布？","是的，Java SDK 已经正式发布！请查看 GitHub 仓库的 Release 页面或文档获取最新的安装包和使用指南。","https:\u002F\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fissues\u002F429",{"id":148,"question_zh":149,"answer_zh":150,"source_url":151},42199,"如何将 SDK 默认的 print 日志输出改为 logging 模块以便控制？","SDK 已支持通过配置使用 logging 模块。请参考官方文档进行配置：https:\u002F\u002Fgithub.com\u002Faliyun\u002Fwuying-agentbay-sdk\u002Fblob\u002Fmain\u002Fdocs\u002Fguides\u002Fcommon-features\u002Fconfiguration\u002Flogging.md，该文档详细介绍了如何自定义日志输出格式和级别。","https:\u002F\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fissues\u002F256",{"id":153,"question_zh":154,"answer_zh":155,"source_url":156},42192,"如何获取云环境的浏览器访问链接以实现可视化操作？","使用默认参数创建 Session 后，调用 `session.info` 方法即可获取直接通过浏览器访问云环境的 URL。该返回结果中还包含使用各种 Web SDK 或 Android SDK 访问云环境所需的参数。详细文档参考：https:\u002F\u002Fgithub.com\u002Faliyun\u002Fwuying-agentbay-sdk\u002Fblob\u002Fmain\u002Fdocs\u002Fguides\u002Fcommon-features\u002Fbasics\u002Fsession-management.md#getting-session-information","https:\u002F\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fissues\u002F392",{"id":158,"question_zh":159,"answer_zh":160,"source_url":161},42193,"Session 删除后再次执行命令为何没有报错且创建了新环境？","这是一个已知问题，旧版本中删除 Session 后对象未失效导致自动重建环境。该问题已在最新版本中修复，请升级 SDK 到最新版本以避免此行为。","https:\u002F\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fissues\u002F393",{"id":163,"question_zh":164,"answer_zh":165,"source_url":166},42194,"如何配置网络代理以在公司内网环境中使用 SDK？","SDK 支持通过标准环境变量配置代理。只需在运行环境中设置 `HTTP_PROXY` 和 `HTTPS_PROXY` 环境变量即可，无需在代码中额外配置参数。","https:\u002F\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fissues\u002F419",{"id":168,"question_zh":169,"answer_zh":170,"source_url":171},42195,"GetLink() 方法调用报错或无法使用怎么办？","Session Link 功能目前仅对白名单用户开放。如需申请权限，请将申请信息发送至邮箱 agentbay_dev@alibabacloud.com，运营团队会进行处理。也可通过阿里云工单系统提交反馈。详细指南：https:\u002F\u002Fgithub.com\u002Faliyun\u002Fwuying-agentbay-sdk\u002Fblob\u002Fmain\u002Fdocs\u002Fguides\u002Fcommon-features\u002Fadvanced\u002Fsession-link-access.md","https:\u002F\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fissues\u002F407",{"id":173,"question_zh":174,"answer_zh":175,"source_url":176},42196,"在使用 LlamaIndex 等框架调用 MCP 工具时，为何每次都会启动新的计算机实例？","这是因为某些客户端（如 LlamaIndex 的 BasicMCPClient）每次调用工具时都会建立新的 HTTP 会话。解决方案是记录当前的 `session_id`，在每次调用前通过 Session Recovery 机制恢复会话，从而复用同一实例。参考文档：https:\u002F\u002Fgithub.com\u002Faliyun\u002Fwuying-agentbay-sdk\u002Fblob\u002Fmain\u002Fdocs\u002Fguides\u002Fcommon-features\u002Fbasics\u002Fsession-management.md#session-recovery","https:\u002F\u002Fgithub.com\u002Fagentbay-ai\u002Fwuying-agentbay-sdk\u002Fissues\u002F406",[178,183,188,193,198,203,208,213,218,223,228,233,237,242,246,251,255,259,264,268],{"id":179,"version":180,"summary_zh":181,"released_at":182},334276,"golang\u002Fv0.19.0","## [0.19.0] - 2026-04-16\n\n### 新增功能\n\n- **Git 模块**（所有 SDK）：支持克隆、初始化、提交、状态查看、日志查看、分支管理、差异比较及远程操作。新增专用错误类型（`GitAuthError`、`GitConflictError` 等）。\n- **会话 `appInstanceId`**（所有 SDK）：在 Session 类中公开，用于跟踪云实例身份。\n- **FileSystem `watch_directory` 推送模式**（Go、Java、Python）：通过 WebSocket 推送方式实现实时文件监控，取代轮询机制。\n- **BrowserOperator**（Go）：新增 Go 版 BrowserOperator，与其他 SDK 保持一致。\n\n### 变更\n\n- **弃用 `getLinkUrl` \u002F `getToken`**（所有 SDK）：改用 `linkUrl` \u002F `token` 属性。\n- **FileSystem 读写优化**：针对 HTTP LinkUrl 通道，跳过分块传输，以提升性能。\n- **`sync()` 指数退避**（所有 SDK）：同步轮询现采用指数退避策略，以提高效率。\n\n### 修复\n\n- **Java POP API**：新增对临时性故障的自动重试机制。\n- **Java ApiKey**：修复多线程并发访问时可能出现的空值问题。\n- **Java call-for-user**：修复平台代理通知无法正常工作的问题。\n- **FileSystem 二进制读取**：修复 LinkUrl 读取时 `BinaryFileContentResult` 中缺少 `size` 字段的问题。","2026-04-16T03:29:21",{"id":184,"version":185,"summary_zh":186,"released_at":187},334277,"v0.19.0","## [0.19.0] - 2026-04-16\n\n### 新增功能\n\n- **Git 模块**（所有 SDK）：支持克隆、初始化、提交、状态查看、日志查看、分支管理、差异比较以及远程操作。新增专用错误类型（`GitAuthError`、`GitConflictError` 等）。\n- **会话 `appInstanceId`**（所有 SDK）：在 Session 类中公开，用于跟踪云实例身份。\n- **FileSystem `watch_directory` 推送模式**（Go、Java、Python）：通过 WebSocket 推送方式实现实时文件监控，取代轮询机制。\n- **BrowserOperator**（Go）：新增 Go 版 BrowserOperator，与其他 SDK 保持一致。\n\n### 变更\n\n- **弃用 `getLinkUrl` \u002F `getToken`**（所有 SDK）：改用 `linkUrl` \u002F `token` 属性。\n- **FileSystem 读写优化**：对于 HTTP LinkUrl 通道，跳过分块传输，以提升性能。\n- **`sync()` 指数退避**（所有 SDK）：同步轮询现采用指数退避策略，以提高效率。\n\n### 修复\n\n- **Java POP API**：新增针对瞬时故障的自动重试机制。\n- **Java ApiKey**：修复了多线程并发访问时可能出现的空值问题。\n- **Java call-for-user**：修复了平台代理通知无法正常工作的问题。\n- **FileSystem 二进制读取**：修复了 LinkUrl 读取时 `BinaryFileContentResult` 中缺少 `size` 字段的问题。","2026-04-16T03:28:18",{"id":189,"version":190,"summary_zh":191,"released_at":192},334278,"golang\u002Fv0.18.0","## [0.18.0] - 2026-03-19\n\n### 新增功能\n\n- **技能功能（Beta）**（所有 SDK）：新增技能元数据 API (`get_metadata`)，以及在创建会话时通过 `skill_ids` 参数加载会话级别的技能。\n- **智能体流式输出（Beta）**（所有 SDK）：基于 WebSocket 的智能体任务执行流式传输，提供 `TaskExecution` 句柄，通过类型化的回调函数（`on_reasoning`、`on_content`、`on_call_for_user`、`on_error`）实时推送推理和内容事件。包含 `MobileTaskOptions` 和 `StreamOptions`，用于结构化配置。\n\n### 重大变更\n\n- **MobileUseAgent.execute_task**（所有 SDK）：现在返回 `TaskExecution` 而不是 `ExecutionResult`。请使用 `execution.wait(timeout)` 来获取结果。`ComputerUseAgent` 和 `BrowserUseAgent` 不受影响。","2026-03-20T12:37:40",{"id":194,"version":195,"summary_zh":196,"released_at":197},334279,"v0.18.0","## [0.18.0] - 2026-03-19\n\n### 新增功能\n\n- **技能功能（测试版）**（所有 SDK）：新增技能元数据 API（`get_metadata`），以及在创建会话时通过 `skill_ids` 参数加载会话级别的技能。\n- **智能体流式输出（测试版）**（所有 SDK）：基于 WebSocket 的智能体任务执行流式传输，提供 `TaskExecution` 句柄，通过类型化的回调函数（`on_reasoning`、`on_content`、`on_call_for_user`、`on_error`）实时推送推理和内容事件。包含 `MobileTaskOptions` 和 `StreamOptions`，用于结构化配置。\n\n### 破坏性变更\n\n- **MobileUseAgent.execute_task**（所有 SDK）：现在返回 `TaskExecution` 而不是 `ExecutionResult`。请使用 `execution.wait(timeout)` 来获取结果。`ComputerUseAgent` 和 `BrowserUseAgent` 不受影响。","2026-03-20T12:36:45",{"id":199,"version":200,"summary_zh":201,"released_at":202},334280,"v0.17.0","## [0.17.0] - 2026-03-16\n\n### 新增功能\n\n- **run_code WebSocket 流式传输**（所有 SDK）：为代码执行新增基于 WebSocket 的流式传输功能，支持在 `run_code` 操作过程中实时返回输出结果。\n- **浏览器自动登录与唤人功能**（所有 SDK）：为浏览器会话新增 `autoLogin` 和 `callForUser` 选项，并提供验证码破解示例及唤人通知通道支持。\n- **动态上下文绑定**（所有 SDK）：支持在运行时动态地将上下文绑定到会话中。\n- **BrowserSyncMode**（所有 SDK）：为浏览器同步新增 `MINIMAL`\u002F`STANDARD` 白名单模式。\n- **Cookbook 补充内容**：新增 4 个 Cookbook（计算机使用、网页爬取、流式处理、多会话操作），并支持浏览器登录持久化、移动设备模拟等功能；同时实现了 OpenClaw Python\u002FJava Web 服务与钉钉机器人、FastAPI 的集成，以及飞书的一键部署功能，并支持钉钉凭证的自动应用。\n\n### 变更\n\n- **移除客户端端口范围校验**（所有 SDK）：`getLink` 方法不再在客户端进行端口范围校验，相关校验工作现由后端统一执行。\n- **日志记录重构**（所有 SDK）：将直接调用终端的 `print`、`console.log` 或 `fmt.Print` 替换为结构化日志记录调用，覆盖 Python、TypeScript、Golang 和 Java 等语言。\n- **SSE 支持 HTTPS get_link URL**：新增关于通过 HTTPS 链接 URL 使用 Server-Sent Events 的文档说明。\n\n### 修复\n\n- **watchDirectory 竞态条件**（Python、Golang、TypeScript）：修复了在文件系统基准建立之前执行文件操作会导致这些操作丢失的竞态问题。新增“就绪”信号机制（`ready_event`、`readyCh` 或 `ready` Promise），以便调用方可在基准建立完成后再执行文件操作。\n- **DirectoryWatcher 中 asyncio 事件循环隔离问题**（Python）：修复了 `watch_directory` 中 asyncio 事件循环隔离的问题。\n- **TypeScript 修复**：测试中缺少 `autoLogin`\u002F`callForUser` 参数，以及 POP SDK 模型中的 `toolList` 类型不匹配问题。\n\n### 安全性\n\n- 依赖库更新：Jackson 从 2.15.2 升级至 2.18.6（Java），并执行 npm audit 以修复安全漏洞。","2026-03-17T02:25:47",{"id":204,"version":205,"summary_zh":206,"released_at":207},334281,"golang\u002Fv0.17.0","## [0.17.0] - 2026-03-16\n\n### 新增功能\n\n- **run_code WebSocket 流式传输**（所有 SDK）：为代码执行新增基于 WebSocket 的流式传输功能，支持在 `run_code` 操作过程中实时返回输出结果。\n- **浏览器自动登录与唤人功能**（所有 SDK）：为浏览器会话新增 `autoLogin` 和 `callForUser` 选项，并提供验证码破解示例及唤人通知通道支持。\n- **动态上下文绑定**（所有 SDK）：支持在运行时动态地将上下文绑定到会话中。\n- **BrowserSyncMode**（所有 SDK）：为浏览器同步新增 `MINIMAL`\u002F`STANDARD` 白名单模式。\n- **Cookbook 补充内容**：新增 4 个 Cookbook（计算机使用、网页爬取、流式处理、多会话操作），并支持浏览器登录持久化、移动设备模拟等功能；同时实现了 OpenClaw Python\u002FJava Web 服务与钉钉机器人、FastAPI 的集成，以及飞书的一键部署功能，并可自动应用钉钉凭证。\n\n### 变更\n\n- **移除客户端端口范围校验**（所有 SDK）：`getLink` 方法不再在客户端进行端口范围校验，相关校验工作交由后端统一执行。\n- **日志记录重构**（所有 SDK）：将直接调用终端的 `print`、`console.log` 或 `fmt.Print` 替换为结构化日志记录调用，覆盖 Python、TypeScript、Golang 和 Java 等语言。\n- **SSE 对 get_link HTTPS URL 的支持**：新增关于通过 HTTPS 链接 URL 使用 Server-Sent Events 的文档说明。\n\n### 修复\n\n- **watchDirectory 竞态条件**（Python、Golang、TypeScript）：修复了在文件系统基准建立之前执行文件操作会导致这些操作丢失的竞态问题。新增“就绪”信号机制（`ready_event`、`readyCh` 或 `ready` Promise），以便调用方可以在等待基准建立后再执行文件操作。\n- **DirectoryWatcher 中 asyncio 事件循环隔离问题**（Python）：修复了 `watch_directory` 中 asyncio 事件循环隔离的问题。\n- **TypeScript 修复**：测试中缺少 `autoLogin`\u002F`callForUser` 参数，以及 POP SDK 模型中 `toolList` 类型不匹配的问题。\n\n### 安全性\n\n- 依赖库更新：Jackson 从 2.15.2 升级至 2.18.6（Java），并完成了 npm audit 以修复安全漏洞。","2026-03-17T02:25:03",{"id":209,"version":210,"summary_zh":211,"released_at":212},334282,"v0.16.1","## [0.16.0] - 2026-03-02\n\n### 新增功能\n\n- **WebSocket 基础设施**（所有 SDK）：会话的持久化 WebSocket 连接（`wsUrl`）、推送通知回调（`registerCallback`\u002F`unregisterCallback`）、使用 `WsCancelledError` 取消流操作，以及适用于 Python 的真正同步 WS 客户端。\n- **会话保活与空闲释放超时**（所有 SDK）：防止因空闲超时而断开连接；可在创建会话时配置 `idle_release_timeout`。\n- **全新 API 模型**（所有 SDK）：MQTT 令牌、音量操作、技能元数据列表，以及官方技能沙盒 API。\n- **Java 功能增强**：自动释放支持、`executeCommand` 标准输出与标准错误分离、浏览器代理接口统一。\n- **Python 功能增强**：浏览器代理接口统一、页面登录 API 支持。\n- **截图功能改进**：支持全页截图、新增 `type` 和 `mime_type` 字段、提供 JPEG 质量可调的测试版长截图。\n- **上下文同步**：可选的 ID 筛选功能，用于控制上下文同步范围。\n- **示例代码库**：LangChain DeepAgents 技能沙盒；Moltbot 更名为 OpenClaw。\n- **开发者工具**：面向 AI 上下文文件的分层知识构建器；增强的 Config 类，添加默认值。\n\n### 变更\n\n- **移除 `execute_command` 的 50 秒超时限制**（所有 SDK）：SDK 端的 50 秒超时限制已被移除。自定义的 `timeout_ms` 值现在将直接传递至后端，不再进行上限限制。请注意：后端网关仍可能强制执行其自身的超时策略。\n- 新增托管代理支持与清晰的 API 接口，并移除了旧版 Java 浏览器配置。\n\n### 修复\n\n- Python WsClient 在 macOS 上的 SSL 兼容性问题；丢弃不含 `invocationId` 的格式错误 WS 消息。\n- 浏览器：销毁操作未重置参数、`get_window` 返回标题为空、browser.agent 崩溃。\n- 移动端：截图中 `link_url` 为 null、`get_installed_apps` 报错。\n- 异步与同步 API 的暂停\u002F恢复功能；Protobuf 兼容性问题；dotenv 加载保护机制。\n- CI 环境下单元测试稳定性提升。\n\n### 安全性\n\n- 依赖项更新：protobuf 从 3.20.3 升级至 5.29.6，setuptools、urllib3、lodash、axios、js-yaml、Next.js 从 14.2.33 升级至 15.5.10。","2026-03-04T05:02:05",{"id":214,"version":215,"summary_zh":216,"released_at":217},334283,"golang\u002Fv0.16.0","## [0.16.0] - 2026-03-02\n\n### 新增功能\n\n- **WebSocket 基础设施**（所有 SDK）：会话的持久化 WebSocket 连接（`wsUrl`）、推送通知回调（`registerCallback`\u002F`unregisterCallback`）、使用 `WsCancelledError` 取消流操作，以及适用于 Python 的真正同步 WS 客户端。\n- **会话保活与空闲释放超时**（所有 SDK）：防止因空闲超时而断开连接；可在创建会话时配置 `idle_release_timeout`。\n- **新 API 模型**（所有 SDK）：MQTT 令牌、音量操作、技能元数据列表，以及官方技能沙盒 API。\n- **Java 功能增强**：自动释放支持、`executeCommand` 标准输出与标准错误分离、浏览器代理接口统一。\n- **Python 功能增强**：浏览器代理接口统一、页面登录 API 支持。\n- **截图改进**：支持全页截图、新增 `type` 和 `mime_type` 字段，以及提供带有 JPEG 质量设置的测试版长截图功能。\n- **上下文同步**：可选的 ID 过滤功能，用于控制上下文同步范围。\n- **Cookbook**：LangChain DeepAgents 技能沙盒；Moltbot 更名为 OpenClaw。\n- **开发者工具**：面向 AI 上下文文件的分层知识构建器；增强的 Config 类，增加了默认值。\n\n### 变更内容\n\n- **移除 `execute_command` 的 50 秒超时限制**（所有 SDK）：SDK 端的 50 秒超时限制已被移除。自定义的 `timeout_ms` 值现在将直接传递到后端，不再进行上限限制。请注意：后端网关仍可能强制执行其自身的超时策略。\n- 新增托管代理支持与清晰的 API，并移除了旧版 Java 浏览器配置。\n\n### 修复内容\n\n- Python WsClient 在 macOS 上的 SSL 兼容性问题；丢弃缺少 `invocationId` 的格式错误 WS 消息。\n- 浏览器：销毁操作未重置参数、`get_window` 返回标题为空、browser.agent 崩溃。\n- 移动端：截图中 `link_url` 为 null、`get_installed_apps` 报错。\n- 异步与同步 API 的暂停\u002F恢复功能；Protobuf 兼容性问题；dotenv 加载保护机制。\n- 各 CI 环境下的单元测试稳定性提升。\n\n### 安全更新\n\n- 依赖库更新：protobuf 从 3.20.3 升级至 5.29.6，setuptools、urllib3、lodash、axios、js-yaml、Next.js 从 14.2.33 升级至 15.5.10。","2026-03-03T07:41:36",{"id":219,"version":220,"summary_zh":221,"released_at":222},334284,"v0.16.0","## [0.16.0] - 2026-03-02\n\n### 新增功能\n\n- **WebSocket 基础设施**（所有 SDK）：会话的持久化 WebSocket 连接（`wsUrl`）、推送通知回调（`registerCallback`\u002F`unregisterCallback`）、使用 `WsCancelledError` 取消流操作，以及适用于 Python 的真正同步 WS 客户端。\n- **会话保活与空闲释放超时**（所有 SDK）：防止因空闲超时而断开连接；可在创建会话时配置 `idle_release_timeout`。\n- **全新 API 模型**（所有 SDK）：MQTT 令牌、音量操作、技能元数据列表，以及官方技能沙盒 API。\n- **Java 功能增强**：自动释放支持、`executeCommand` 标准输出与标准错误分离、浏览器代理接口统一。\n- **Python 功能增强**：浏览器代理接口统一、页面登录 API 支持。\n- **截图功能改进**：支持全页截图、新增 `type` 和 `mime_type` 字段、提供 JPEG 质量可调的测试版长截图。\n- **上下文同步**：可选的 ID 筛选功能，用于控制上下文同步范围。\n- **示例代码库**：LangChain DeepAgents 技能沙盒；Moltbot 更名为 OpenClaw。\n- **开发者工具**：面向 AI 上下文文件的分层知识构建器；增强的 Config 类，添加默认值。\n\n### 变更\n\n- **移除 `execute_command` 的 50 秒超时限制**（所有 SDK）：SDK 端的 50 秒超时限制已被移除。自定义的 `timeout_ms` 值现在将直接传递至后端，不再进行上限限制。请注意：后端网关仍可能强制执行其自身的超时策略。\n- 新增托管代理支持与清晰的 API，并移除了旧版 Java 浏览器配置。\n\n### 修复\n\n- Python WsClient 在 macOS 上的 SSL 兼容性问题；丢弃不含 `invocationId` 的格式错误 WS 消息。\n- 浏览器：销毁时不重置参数、`get_window` 返回空标题、`browser.agent` 崩溃等问题已修复。\n- 移动端：截图中 `link_url` 为 null、`get_installed_apps` 报错等问题已解决。\n- 异步与同步 API 均支持暂停与恢复；修复了 Protobuf 兼容性问题；增加了 dotenv 加载保护机制。\n- 全面提升了 CI 环境下的单元测试稳定性。\n\n### 安全更新\n\n- 依赖库升级：protobuf 从 3.20.3 升级至 5.29.6，setuptools、urllib3、lodash、axios、js-yaml、Next.js 从 14.2.33 升级至 15.5.10。","2026-03-03T07:40:57",{"id":224,"version":225,"summary_zh":226,"released_at":227},334285,"golang\u002Fv0.15.1","## [0.15.0] - 2026-01-24\n\n### 新增功能\n\n#### 🌐 网络（所有 SDK）\n- **Beta 版网络管理 API**：引入了 Beta 版网络生命周期 API（创建\u002F描述）以及会话参数中的 `network_id` 支持。\n\n#### 🔗 MCP 会话路由（所有 SDK）\n- **LinkUrl 路由**：为 MCP 会话（工具调用和命令执行）添加了基于 LinkUrl 的路由，并提供了集成测试和示例。\n- **MCP 代理环境变量**：支持在启动 Page Use Agent MCP 时传递环境变量。\n\n#### 📱 移动版 Beta 截图与 UI 元素\n- **移动版 Beta 截图**：新增了 Beta 截图 API（包括 JSON 响应处理）以及相关文档和示例。\n- **UI 元素格式**：增加了以 **JSON\u002FXML** 格式获取所有 UI 元素的支持。\n\n#### 🧰 代码助手食谱\n- **代码生成与分析工具**：新增了 Qwen 代码生成器和 Mistral Codestral 分析器软件包，并附带数据分析工作流的集成指南和脚本。\n\n#### 🤖 代理模块\n- **`execute_task` 输出模式**：在各 SDK 中的任务执行选项中增加了对输出模式的支持。\n\n### 变更\n\n#### ⚠️ 不兼容的变更\n- **暂停\u002F恢复标记为 Beta 版**：将 `Pause\u002FResume` 重命名为 `BetaPause\u002FBetaResume`（以及相应的 snake_case 形式），并在所有 SDK 中统一使用，以表明其处于实验阶段。\n- **VPC 路由清理**：移除了 VPC 链路\u002F会话参数及遗留的仅限 VPC 的逻辑；保留 LinkUrl 直接工具调用路径作为统一的路由。\n\n### 修复\n\n- **任务超时正确性**：修复了任务执行超时处理逻辑，确保等待任务完成后再进行后续操作。\n- **服务器录制标志**：修复了 `enableRecord=False` 无效的问题（通过 SDK 测试暴露了后端行为）。\n- **TypeScript 文档与代码清理**：移除了 CDATA 记录，并优化了代理实现中的导入格式。\n- **Java SDK 修复**：补充了缺失的 `getMobile` API，并更新了依赖项命名清理。","2026-02-11T08:55:30",{"id":229,"version":230,"summary_zh":231,"released_at":232},334286,"golang\u002Fv0.15.0","## [0.15.0] - 2026-01-24\r\n\r\n### Added\r\n\r\n#### 🌐 Network (All SDKs)\r\n- **Beta network management APIs**: Introduced beta network lifecycle APIs (create\u002Fdescribe) and `network_id` support in session params.\r\n\r\n#### 🔗 MCP Session Routing (All SDKs)\r\n- **LinkUrl routing**: Added LinkUrl-based routing for MCP sessions (tool calls and command execution), with integration tests and examples.\r\n- **MCP agent environment variables**: Support passing environment variables when starting Page Use Agent MCP.\r\n\r\n#### 📱 Mobile Beta Screenshot & UI Elements\r\n- **Mobile beta screenshots**: Added beta screenshot APIs (including JSON response handling) and documentation\u002Fexamples.\r\n- **UI element formats**: Added support for retrieving all UI elements in **JSON\u002FXML** formats.\r\n\r\n#### 🧰 Code Assistant Cookbook\r\n- **Code generation & analysis tools**: Added Qwen Code Generator and Mistral Codestral Analyzer packages plus integration guides\u002Fscripts for data analysis workflows.\r\n\r\n#### 🤖 Agent Module\r\n- **`execute_task` output schema**: Added support for output schema in task execution options across SDKs.\r\n\r\n### Changed\r\n\r\n#### ⚠️ Breaking Changes\r\n- **Pause\u002FResume marked as beta**: Renamed `Pause\u002FResume` to `BetaPause\u002FBetaResume` (and snake_case equivalents) across SDKs to indicate experimental status.\r\n- **VPC routing cleanup**: Removed VPC chain\u002Fsession params and legacy VPC-only logic; keep LinkUrl direct tool-call path as the unified route.\r\n\r\n### Fixed\r\n\r\n- **Task timeout correctness**: Fixed task execution timeout handling to wait for task termination.\r\n- **Server recording flag**: Fixed `enableRecord=False` not taking effect (backend behavior exposed via SDK tests).\r\n- **TypeScript docs\u002Fcode cleanup**: Removed CDATA artifacts and improved import formatting in agent implementation.\r\n- **Java SDK fixes**: Added missing `getMobile` API and updated dependency naming cleanup.","2026-01-26T02:24:28",{"id":234,"version":235,"summary_zh":231,"released_at":236},334287,"v0.15.0","2026-01-26T02:23:45",{"id":238,"version":239,"summary_zh":240,"released_at":241},334288,"golang\u002Fv0.14.0","## [0.14.0] - 2026-01-10\r\n\r\n### Added\r\n\r\n#### ☕ Java SDK\r\n- **Formal Release**: Introduced comprehensive support for the Java SDK, enabling Java developers to build agentic applications.\r\n- **Four Major Environments**: Full support for Browser, Computer, Mobile, and CodeSpace environments.\r\n- **Core Capabilities**: Support for session management, file operations (including `delete_file`), and multi-region configuration.\r\n- **Code Execution**: Enabled `run_code` and `run_command` support within the Java SDK.\r\n- **Observability**: Integrated session metrics and standardized logging.\r\n\r\n#### 📱 Mobile Agent\r\n- **Formal Launch**: Introduced the Mobile Agent (Natural Language Task Execution) across Python, TypeScript, Go, and Java SDKs.\r\n- **Natural Language Control**: Support for executing mobile tasks using natural language via `execute_task`.\r\n\r\n#### 📊 Observability & Metrics\r\n- **Session Metrics**: Implemented unified session metrics collection across all SDKs (Python, TypeScript, Go, Java).\r\n- **SLS Logging**: Added support for SLS-formatted logs to improve log analysis capabilities.\r\n\r\n#### 🛠️ Core Enhancements\r\n- **CodeSpace Languages**: Added support for **R** and **Java** language execution in CodeSpace.\r\n- **Binary Files**: Added comprehensive support for binary file reading (`read_file`) across all SDKs.\r\n- **Session List Filtering**: Added `status` parameter to `agentbay.list()` for filtering sessions by status (RUNNING, PAUSED, etc.).\r\n- **Ergonomic Aliases**: Introduced API aliases to improve usability and success rates for LLM interactions.\r\n\r\n### Changed\r\n\r\n#### ⚠️ Breaking Changes\r\n- **Agent Task Execution**: Removed `max_step_retries` parameter. In `execute_task_and_wait`, replaced `max_try_times` with `timeout` (seconds).\r\n- **Filesystem**: Renamed `error` field to `error_message` in `UploadResult` and `DownloadResult` objects.\r\n- **Session API**: Renamed `GetSession` method to `GetStatus` across all SDKs. The old `GetSession` is now internal or removed.\r\n\r\n#### Other Changes\r\n- **Documentation**: Added warnings regarding service restrictions for overseas users.\r\n\r\n### Fixed\r\n\r\n- **File System**: Fixed an MQTT size limit error in `write_file` by optimizing content splitting.\r\n- **Stability**: Resolved various issues related to session status checks, timeouts, and file transfers.\r\n- **CI\u002FCD**: Fixed version file paths and workflow configurations for smoother releases.","2026-01-10T03:02:31",{"id":243,"version":244,"summary_zh":240,"released_at":245},334289,"v0.14.0","2026-01-10T03:01:02",{"id":247,"version":248,"summary_zh":249,"released_at":250},334290,"golang\u002Fv0.13.1","## [0.13.0] - 2025-12-19\r\n\r\n### Core SDK capabilities (user-visible)\r\n\r\n#### 🐍 Python API architecture (migration required)\r\n- **Sync\u002Fasync split**: Python SDK now provides separate sync and async APIs (`AgentBay` vs `AsyncAgentBay`, etc.).\r\n- **Unified naming**: Removed `_async` suffix from method names; async APIs are `await`-able with the same method names as sync.\r\n- **Unified imports**: Public imports were consolidated under `agentbay`.\r\n\r\n#### 🧑‍💻 Code Execution (`run_code`)\r\n- **Rich outputs (backward compatible)**: Added `EnhancedCodeExecutionResult` to support multi-format outputs (HTML\u002FMarkdown\u002Fimages\u002FSVG\u002FLaTeX\u002Fcharts) while keeping compatibility with `CodeExecutionResult`. (See commit `46cffd02`.)\r\n- **Jupyter-like persistence**: Added docs\u002Fexamples for long-lived code execution workflows in CodeSpace.\r\n\r\n#### 🧾 Command execution\r\n- **Structured outputs**: Standardized command execution outputs to expose `stdout` and `stderr` as explicit fields across SDKs. (See commit `c404ae48`.)\r\n- **Correctness**: Fixed parsing of `exit_code` from command execution responses. (See commit `25d543cb`.)\r\n\r\n#### 🤖 Agent module\r\n- **BrowserUseAgent task API**: Introduced\u002Fextended task-oriented APIs for BrowserUseAgent. (See commit `c69b3596`.)\r\n- **`execute_task` refinement**: Refined task execution API and updated docs\u002Fexamples\u002Ftests accordingly. (See commit `aa98c5d8`.)\r\n\r\n#### 📁 Context filesystem\r\n- **`delete_file` (all languages)**: Added `delete_file` support with tests and examples.\r\n- **Internal context loading**: Switched to `GetAndLoadInternalContext` to avoid incorrect context listing behavior.\r\n\r\n#### 🔄 Context sync API\r\n- **`sync_context` → `sync` (breaking)**: Renamed context sync API for consistency across SDKs and removed the legacy alias.\r\n\r\n#### 🌍 Multi-region configuration\r\n- **`region_id` support across SDKs**: Added region selection support for Python\u002FTypeScript\u002FGo.\r\n\r\n#### 🖥️ Computer & window automation\r\n- **Window API simplification (breaking)**: Removed `timeout` parameter from `get_active_window` across languages.\r\n- **Typed screenshot results (TypeScript)**: `computer.screenshot()` returns a typed `ScreenshotResult`.\r\n- **Cross-platform reliability**: Added\u002Fexpanded window management integration tests (Python + Go).\r\n\r\n#### 📱 Mobile automation\r\n- **Mobile UI bounds**: Added `bounds_rect` support for mobile UI elements (Python), including tests and examples.\r\n\r\n#### ☁️ OSS\r\n- **Parameter naming**: Standardized Python OSS client `securityToken` → `security_token` and updated tests\u002Fdocs.\r\n\r\n#### 🐹 Go SDK\r\n- **File transfer**: Added file transfer support in Go SDK with integration tests.\r\n- **Session deletion semantics**: Adjusted delete session flow to align with async deletion API behavior.\r\n\r\n### Developer experience (docs & reference)\r\n\r\n- **Async programming docs**: Added\u002Fupdated sync-vs-async comparison and v0.12.x → v0.13.x migration guide.\r\n- **API reference**: Regenerated API docs for Python\u002FTypeScript\u002FGo and improved doc generation metadata filtering.\r\n\r\n### Examples & cookbook (end-to-end usage)\r\n\r\n- **Mobile login persistence cookbook**: Added `cookbook\u002Fmobile\u002Fapp-login-persistence` examples covering cross-session login state for multiple apps. (See commit `0e47976b`.)\r\n- **NL mobile control cookbook**: Added a LangChain-based NL mobile control example with a web demo and tests.\r\n\r\n### Quality, CI, and release tooling\r\n\r\n- **Smart integration test workflow**: Added\u002Fiterated `.aoneci\u002Fsmart-integration-test.yaml` (multi-language, improved reporting, AI analysis prompts, and stability improvements).\r\n- **Examples inspection workflow**: Added\u002Fiterated `.aoneci\u002Fexample-check.yaml` (multi-language examples verification with AI analysis and DingTalk notifications).\r\n- **KB preprocessing**: Added\u002Fiterated `preprocess_kb` pipeline to generate knowledge-base-friendly docs in batches.\r\n- **llms artifacts**: Updated `llms.txt` \u002F `llms-full.txt` generation workflow and content.","2025-12-22T12:34:05",{"id":252,"version":253,"summary_zh":249,"released_at":254},334291,"golang\u002Fv0.13.0","2025-12-19T09:44:02",{"id":256,"version":257,"summary_zh":249,"released_at":258},334292,"v0.13.0","2025-12-19T09:43:20",{"id":260,"version":261,"summary_zh":262,"released_at":263},334293,"golang\u002Fv0.12.3","## [0.12.0] - 2025-11-28\r\n\r\n### Added\r\n\r\n#### 📱 Mobile Simulation\r\n- **Device Simulation Support**: Added support for mobile device simulation features\r\n  - Enhanced mobile testing capabilities\r\n  - Support for simulating various mobile device characteristics\r\n\r\n#### ⏸️ Session Pause & Resume\r\n- **Session Control**: Added support for pausing and resuming sessions\r\n  - `pause()` \u002F `pause_async()`: Pause a running session to save resources\r\n  - `resume()` \u002F `resume_async()`: Resume a paused session\r\n  - Available across Python, TypeScript, and Golang SDKs\r\n\r\n### Fixed\r\n\r\n#### 🐛 Bug Fixes\r\n- **Browser Automation**: Fixed browser-use timeout issues\r\n- **Context Management**: Fixed issue where `get_session` was creating a new context ID instead of returning the real one\r\n- **Context Sync**: Fixed `sync` call to correctly use `context_id` and `path` together\r\n- **Session Control**: Fixed return value handling when pause or resume backend operations fail\r\n- **Local Testing**: Fixed issue preventing browser tests from running locally\r\n- **Python SDK**: Simplified exception log output for cleaner logs\r\n- **Infrastructure**: Updated logo fallback path for Aone compatibility\r\n\r\n### Documentation\r\n\r\n- **Use Cases**: Improved Use Cases section UX in README\r\n- **Examples**: Updated Quick Start examples to use `CodeSpace` `run_code`\r\n- **General**: Regenerated API documentation and improved code examples\r\n- **Golang**: Added new examples for Golang SDK","2025-12-09T08:48:29",{"id":265,"version":266,"summary_zh":262,"released_at":267},334294,"golang\u002Fv0.12.2","2025-12-08T08:29:57",{"id":269,"version":270,"summary_zh":262,"released_at":271},334295,"golang\u002Fv0.12.1","2025-12-05T11:05:50"]