Web – macOS AI Browser：本地AI驱动的macOS浏览器

Web 是一个开源的 macOS 浏览器项目，由 nuance-dev 开发，托管在 GitHub 上。它基于 Apple 的 WebKit 引擎，采用 SwiftUI 和 Combine 框架，遵循 MVVM 架构。Web 的核心特色是集成本地 AI 功能，通过 Apple MLX 框架提供网页内容分析，生成简短摘要（TL;DR）并结合浏览历史提供上下文信息。该项目使用 MIT 许可证，支持 macOS 14.0 及以上版本，需 Apple Silicon 芯片以启用 AI 功能。目前为早期测试版（v0.0.2），适合开发者和技术爱好者体验，功能尚未完善，但其本地 AI 集成的创新理念已吸引 421 个星标和 38 次分叉。

功能列表

• 本地 AI 侧边栏 ：利用 Apple MLX 框架分析网页，生成简短摘要（TL;DR）并提供页面和历史上下文。
• 多标签管理 ：支持创建、切换和休眠标签，优化性能。
• 书签管理 ：保存、编辑和快速访问网页链接。
• 下载管理 ：内置下载管理器，跟踪下载进度（测试中）。
• 隐私浏览 ：支持隐身模式，保护用户隐私。
• 广告拦截 ：集成广告拦截服务（测试中，可禁用）。
• 密码管理 ：安全处理用户密码（测试中）。
• 键盘快捷键 ：支持多种快捷键，如 ⌘T 新建标签、⌘W 关闭标签。
• WebKit 渲染 ：基于 Apple WebKit 引擎，网页加载快速且兼容性强。

使用帮助

安装流程

Web 仅支持 macOS 14.0 或更高版本，且 AI 功能需 Apple Silicon 芯片（M1/M2 系列）。以下是详细安装步骤：

1. 检查系统要求 ：
   • 确保设备运行 macOS 14.0 或更高版本。
   • 开发环境需安装 Xcode 15.0 或更高版本。
2. 克隆项目 ：
   在终端运行以下命令克隆 Web 仓库：

git clone https://github.com/nuance-dev/Web.git
cd Web

1. 打开项目 ：
   使用 Xcode 打开项目：

open Web.xcodeproj

1. 构建与运行 ：
   • 在 Xcode 中选择目标设备（模拟器或真实设备）。
   • 点击运行按钮（⌘R）构建并启动项目。
   • 如遇依赖问题，检查网络连接，Xcode 会自动下载所需依赖。
2. 直接安装（可选） ：
   • 访问 GitHub 发布页面（https://github.com/nuance-dev/Web/releases），下载最新版本（如 Web-0.0.2.dmg）。
   • 双击 DMG 文件，拖动应用到“应用程序”文件夹完成安装。

功能操作流程

1. 本地 AI 侧边栏

AI 侧边栏是 Web 的核心功能，利用 Apple MLX 框架和 Gemma 模型进行本地网页分析。操作步骤：

• 打开网页 ：在地址栏输入网址或通过书签访问。
• 激活 AI 侧边栏 ：按快捷键 ⇧⌘A 或点击界面右侧 AI 图标。
• 查看摘要 ：侧边栏显示网页的 TL;DR 摘要，提炼核心内容。
• 浏览上下文 ：侧边栏根据浏览历史和当前页面，展示相关关键词或链接。
• 调整设置 ：在侧边栏设置中，可调整摘要长度或上下文显示范围。

注意 ：AI 功能运行在本地，无需联网，但可能因网页复杂性导致分析较慢。当前版本存在 bug，建议在测试环境中使用。

2. 多标签管理

Web 支持高效的多标签浏览，操作方法：

• 新建标签 ：点击工具栏“+”按钮或按 ⌘T。
• 切换标签 ：点击标签或使用 Command + Tab。
• 休眠标签 ：未活跃标签自动休眠，释放内存，点击可重新激活。
• 关闭标签 ：点击标签上的“x”或按 ⌘W。
• 恢复标签 ：按 ⇧⌘T 重新打开最近关闭的标签。

3. 书签管理

书签功能便于保存和访问网页：

• 添加书签 ：打开网页，点击菜单栏“书签” > “添加到书签”。
• 管理书签 ：在书签菜单中编辑、删除或整理书签。
• 快速访问 ：从书签菜单点击链接跳转。

4. 下载管理

下载管理功能正在测试中，操作步骤：

• 启动下载 ：点击网页中的下载链接，任务自动开始。
• 查看进度 ：按 ⇧⌘J 打开下载管理器，查看进度和状态。
• 访问文件 ：下载完成后，点击链接在 Finder 中打开文件。

5. 隐私与安全

• 隐身模式 ：在菜单栏选择“新建隐身窗口”，浏览不记录历史。
• 广告拦截 ：自动拦截广告，可在设置中禁用（测试中）。
• 密码管理 ：安全存储密码，需进一步测试。
• 隐私设置 ：在设置中调整隐私选项，如阻止跟踪器（测试中）。

6. 键盘快捷键

Web 提供丰富的快捷键，提升操作效率：

• 新建标签 ：⌘T – 打开新标签。
• 关闭标签 ：⌘W – 关闭当前标签。
• 重新加载 ：⌘R – 刷新页面。
• 地址栏 ：⌘L – 聚焦地址栏。
• 查找 ：⌘F – 页面内搜索。
• 开发者工具 ：⌥⌘I – 打开调试工具。
• 切换顶栏 ：⇧⌘H – 切换顶栏模式。
• 切换侧边栏 ：⌘S – 切换侧边栏或顶部标签。

7. 开发者支持

Web 采用 MVVM 架构，代码组织清晰，适合二次开发：

• 目录结构 ：
  • Models/：定义 Tab、Bookmark 等数据模型。
  • Views/：SwiftUI 界面组件。
  • ViewModels/：业务逻辑和状态管理。
  • Services/：下载、历史记录等核心服务。
  • AI/：本地 AI 集成逻辑。
  • Utils/：工具和扩展。
• 贡献代码 ：
  • Fork 仓库，创建特性分支（git checkout -b feature/new-feature）。
  • 提交更改（git commit -m 'Add new feature'）。
  • 推送分支（git push origin feature/new-feature）。
  • 在 GitHub 提交 Pull Request。

注意 ：项目遵循 Swift 6 严格并发规则，保持零警告/错误。开发者可通过修改 AI/ 文件夹调整 AI 功能。

应用场景

1. 开发者测试
   Web 适合 macOS 开发者测试本地 AI 集成的浏览器功能。开发者可修改代码，优化 AI 侧边栏的分析能力。
2. 技术爱好者探索
   技术爱好者可安装 Web，体验本地 AI 驱动的网页摘要和上下文分析，探索 AI 在浏览器中的应用。
3. 学术研究
   学生和研究人员可利用书签和历史记录整理资料，AI 侧边栏快速提取论文或文章核心内容。
4. 隐私优先浏览
   需要隐私保护的用户可使用隐身模式和广告拦截功能，享受无跟踪的浏览体验。

QA

1. Web 支持哪些系统？
   仅支持 macOS 14.0 或更高版本，AI 功能需 Apple Silicon 芯片。
2. AI 侧边栏如何运行？
   使用 Apple MLX 框架和 Gemma 模型，分析网页内容并生成摘要，全部处理在本地完成。
3. 需要联网使用 AI 功能吗？
   否，AI 功能完全本地运行，无需联网。
4. 如何报告问题或贡献代码？
   在 GitHub 仓库（https://github.com/nuance-dev/Web）提交 issue 或 Pull Request，遵循 MIT 许可证。
5. Web 适合日常使用吗？
   当前为早期测试版（v0.0.2），功能不完整，适合开发和测试，不推荐作为主要浏览器。