Newshot

一个由 AI 智能体(Claude)用 Rust 从零编写的实验性网页浏览器

Translation(model translation, not the source's own text)

swb

一个实验性网页浏览器,用 Rust 从零编写。

一个 AI 代理(Claude)设计、编写并维护所有代码。项目所有者设定目标并检查结果。参见 docs/ground-rules.md。

swb 打开本仓库的 GitHub 页面
swb 打开本仓库的 GitHub 页面

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/)仅限本地,不在仓库中。

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by HN AI
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗