swb
一个实验性网页浏览器,用 Rust 从零编写。
一个 AI 代理(Claude)设计、编写并维护所有代码。项目所有者设定目标并检查结果。参见 docs/ground-rules.md。

swb 显示本仓库的 GitHub 页面,JavaScript 已开启。
swb 使用通用库(HTTP、TLS、HTML 分词、图像解码、WOFF 和 WOFF2 解码、字体整形、2D 光栅化、窗口系统)。浏览器部分(CSS、样式、布局、绘制、页面加载、JavaScript 引擎、DOM 及其他 Web API、用户界面)都在本仓库中编写。
快速开始
swb 在 Linux(Wayland 或 X11)上开发和测试。其他平台未经过测试。
依赖(Debian/Ubuntu 包名):
- Rust 工具链,通过 rustup 安装。版本固定在 rust-toolchain.toml 中,并会自动安装。
- libfontconfig-dev、libxkbcommon-dev、libwayland-dev、pkg-config。
- C 编译器、make 和 sh(build-essential):构建过程会从源码编译 jemalloc,即二进制文件的内存分配器(ADR 0029)。
- just(可选)。
git clone https://github.com/senko/swb.git
cd swb
just run https://senko.net/ # 构建(release)并打开窗口
just run --js https://github.com/senko/swb # 同上,开启 JavaScript
不使用 just 时:cargo run --release -p swb -- https://senko.net/。生成的二进制文件为 target/release/swb。
使用
工具栏包含后退、前进和重新加载按钮、JavaScript 开关(JS)以及地址栏。在地址栏中,不带协议头的地址会自动补上 https://,绝对路径则打开本地文件。在命令行中,相对文件路径同样可用。
| 按键 | 操作 |
|---|---|
| Ctrl+L | 聚焦地址栏 |
| Alt+Left、Alt+Right、鼠标后退和前进键 | 后退、前进 |
| Backspace | 后退(当没有文本框获得焦点时) |
| F5、Ctrl+R | 重新加载 |
| Escape | 停止加载 |
| Tab、Shift+Tab | 在链接和表单控件之间移动焦点 |
| Enter | 跟随当前聚焦的链接 |
| Ctrl+A、Ctrl+C | 全选文本、复制所选内容 |
| Ctrl+X、Ctrl+V | 剪切、粘贴(在文本框和地址栏中) |
| Ctrl+Shift+J | 开启或关闭 JavaScript |
| Ctrl+Q、Ctrl+W | 退出 |
JavaScript 默认关闭。JS 按钮和 Ctrl+Shift+J 对下一个加载的页面生效;要对当前页面应用更改需重新加载。--js 会在启动时开启 JavaScript。JavaScript 需要至少 8 MiB 的栈限制(ulimit -s)。低于此值时,按钮为灰色,JavaScript 保持关闭。
无头模式(用于测试和脚本):
swb --headless --screenshot page.png https://senko.net/
swb --headless --full-page --screenshot page.png https://senko.net/
swb --headless --with-chrome --screenshot window.png https://senko.net/
swb --headless --dump-layout https://senko.net/
swb --headless --js --eval 'document.title' https://senko.net/
swb --headless --bench 20 https://senko.net/ # 为每个流水线阶段计时
远程控制:swb --headless --remote-port 0 会在 127.0.0.1 上启动一个 WebSocket 服务器,测试和工具用它来驱动浏览器(带窗口时同样可用:swb --remote-port 9222)。参见 docs/automation.md。
所有选项参见 swb --help。
状态
早期开发阶段。
- 八个目标页面与 Chromium 一致:senko.net、Hacker News、一篇 Wikipedia 文章、一条 Craigslist 帖子、Ars Technica 和 BBC 首页、本仓库的 GitHub 页面,以及一个 OpenStreetMap 地图。除 senko.net 外,其余页面在开启 JavaScript 时也能正常工作,并支持目标清单中列出的各项交互。
- swb 有自己的 JavaScript 引擎(crates/js*);其 test262 子集中的 41,842 个测试通过。
- 尚未完成:在 worker 中运行脚本(Worker 存在但不运行任何脚本)、window.open 和标签页、媒体播放、WebGL、CSS 锚点定位。
路线图列出了各里程碑、每个里程碑包含的内容以及待办事项。开发日志记录了最新变更。
Development
just check # format check, clippy, all tests, license check
just --list # all commands
docs/testing.md 描述了测试内容以及用于对比 swb 与 Chromium 的工具。CLAUDE.md 包含了编写代码的 AI agent 的指令与工作流程。
Documentation
- 基本规则、目标页面
- 架构
- 测试与工具、性能
- 自动化协议
- 决策记录
- 路线图、开发日志
- 致谢与来源
License
swb 自身的源代码采用 MIT 许可。参见 LICENSE。
swb 的部分源代码以及 swb 二进制文件中的部分材料属于保留其自身许可的第三方材料;MIT 许可不适用于它们:
- 采用 Mozilla Public License 2.0 的 Public Suffix List(MPL-2.0,一次性例外,ADR 0014);
- 基于 WHATWG HTML Standard 的样式表,采用 CC BY 4.0;
- 源自 Chromium 和 Skia 的代码,采用 BSD-3-Clause 许可(swb 源代码和二进制文件的副本必须包含其许可证文本),以及一个源自 Servo 的文件,采用 MPL-2.0;
- crates/web/idl/ 的 WebIDL 文件,复制自 WHATWG 标准(BSD-3-Clause)和 W3C 规范(W3C Software and Document License);
- 由 Unicode Character Database 和 Unicode CLDR 生成的表(Unicode License v3)。
详见 THIRD_PARTY_NOTICES.md 以了解细节和许可证文本。
fixtures/ 中的测试数据(网页快照、字体)属于采用其自身许可的第三方材料;参见 fixtures/pages/README.md 和 fixtures/fonts/README.md。它不属于 swb 二进制文件的一部分。JavaScript 的 fixtures(fixtures/js/)仅限本地,不在仓库中。