ZeroWeb 是一个用 Rust 从头写的实验性跨平台浏览器，支持 macOS、Linux、Windows 和 Android。它交付两样东西：
ZeroWebView：可嵌入其他应用的网页渲染库ZeroBrowser：基于同一内核的完整浏览器应用
DOM、CSS、布局、渲染、JavaScript 绑定、网络和安全边界都在这个仓库里实现，主要依赖宽松许可证的 Rust 组件。
这也是一个 AI-first 的工程实验：人只负责方案设计、关键决策和结果验证，代码几乎全部由 AI 编写。我们想看看，在架构边界、测试和验收都写清楚的前提下，AI 能把浏览器这种复杂系统推进到什么程度。
Important
项目处于实验阶段，不是日常可用的浏览器。它适合学习、研究和工程探索。商用或生产用途请自行评估功能、安全、兼容性、性能和许可证风险。
- 嵌入优先：除了浏览器应用，还要提供稳定的 Rust
ZeroWebViewAPI，方便其他应用直接集成。 - 许可证边界清楚：主线依赖优先选 MIT、Apache-2.0、BSD 等宽松许可证，核心能力不受 copyleft 约束。
- Rust 全栈：页面内核、宿主层和渲染基础设施尽量都在 Rust 生态内完成。
- AI 可以写，但要能审：每个改动都要讲得清、测得到、看得见。
状态说明：✅ 基础能力可用并有测试覆盖；🚧 在推进，还不完整；⏳ 计划中。
| 能力 | 状态 | 现状 |
|---|---|---|
| 桌面浏览器 | ✅ | macOS / Linux / Windows 真窗口；多标签、地址栏、下载、右键菜单、缩放、页面查找、收藏、历史、设置 |
| Android 浏览器 | ✅ | Kotlin/Compose 界面 + Rust 内核；多标签、键盘与输入法、下载、通知、中英双语 |
| 多进程架构 | ✅ | 渲染、图像解码、合成分别在独立进程；页面脚本只在渲染进程内运行 |
嵌入 API ZeroWebView |
✅ | 稳定 API 与 demo，接入 Service Worker、WASM 和安全检查 |
| HTML / CSS 渲染 | 🚧 | 上游 WPT reftest 约 95.4% 通过（15,830 / 16,590，2026-11-01） |
| JavaScript 与 DOM | 🚧 | V8 / QuickJS 双引擎，原生 DOM 绑定，Web Components、Worker、ES Modules |
| 网络、存储与安全 | ✅ | HTTP/1.1 和 HTTP/2、Cookie、IndexedDB、Cache API、OPFS、Service Worker；CSP、HSTS、混合内容阻止、站点隔离 |
| 编辑与输入 | ✅ | contenteditable、Selection、键盘默认动作、剪贴板、全屏、拖放、指针锁定 |
| 媒体 | 🚧 | VP9 / AV1 / H.264 视频，MP3 / Vorbis / Opus / AAC 音频，基础 Web Audio，MSE（MediaSource）流式喂片 |
| 自动化与调试 | ✅ | WebDriver、CDP（可被 Playwright 驱动）、复用 Chrome DevTools 前端的调试面板 |
| WebGL / WebGPU | 🚧 | WebGL 1.0 基础管线已进入主线（上下文、GLSL shader 编译、绘制光栅）；WebGPU 尚未开始 |
上表是概要。按里程碑的进度见 路线图，各领域的兼容性数字见 官网进度页。
- 真实网站兼容性：静态页面渲染接近可用，但登录、复杂脚本、长会话等真实站点交互还没系统验收。
- Web API 覆盖：部分 API 还在补齐；WebGL 1.0 刚进入主线，WebGPU 尚未开始。
- 性能：还没用 Speedometer、JetStream 等基准做系统优化。
- 完整产品体验：没有扩展系统、没有 WebRTC，完整媒体播放体验也不是近期重点。
- 正式发布：目前只有每周预发布构建，还没有稳定版本。
下载预构建包：在 Releases 下载每周构建（weekly-*），提供 Linux、macOS、Windows 版本。这些都是实验性预发布，macOS 版可能需要在“系统设置 → 隐私与安全性”里手动放行。
从源码运行：先按 Linux 和 macOS 或 Windows 文档配置环境，然后：
git clone https://github.com/leizongmin/ZeroWeb.git
cd ZeroWeb
make browser更多构建、测试和运行方式见 构建、测试与本地运行。
| 文档 | 说明 |
|---|---|
| 架构总览 | 整体分层、33 个 workspace member 的职责、从请求到像素的链路 |
| 路线图 | 已完成、进行中和计划中的里程碑 |
| 构建、测试与本地运行 | make 命令、测试门禁、reftest、本地入口 |
| 打包与发布 | 各平台打包、macOS 签名公证、自动发布 |
| 文档索引 | 规格、进度控制面、调研和治理文档 |
| CHANGELOG.md | 对外变更记录 |
欢迎贡献，包括 AI 辅助的贡献。提交前请先阅读 CONTRIBUTING.md 和 贡献责任说明，并遵守 行为准则。安全问题请按 SECURITY.md 私下报告。
本项目采用 MIT License。MIT 允许商用和二次集成，但项目仍是实验性质，用于生产前请自行评估风险。新增第三方依赖前请先确认许可证与项目策略兼容。