1. 项目定位与用途
OneBox 是一款面向普通用户的跨平台图形化代理客户端，基于成熟的 sing-box 内核开发。其核心定位是降低网络代理工具的使用门槛，将原本需要命令行操作和复杂配置文件编辑的专业工具，转化为直观易用的桌面应用程序。主要用途是帮助用户在 macOS、Windows 和 Linux 系统上快速配置和管理代理规则，实现网络流量的转发与过滤，适用于需要科学上网、网络调试或隐私保护等场景。项目强调“开箱即用”，避免用户陷入繁琐的配置细节。
项目档案应用项目
OneOhCloud/OneBox 是什么？用途、安装与使用指南
OneBox 是一款基于 sing-box 内核的跨平台图形化代理客户端，专为普通用户设计，提供简单、稳定、安全的网络代理体验。支持 macOS、Windows、Linux，无需复杂配置，开箱即用。本页提供项目介绍、安装指南、使用说明及技术架构详情。
AI 总结
OneBox 是一款基于 sing-box 内核的跨平台图形化代理客户端，专为普通用户设计，提供开箱即用、简单稳定且安全的网络代理体验，无需复杂配置。
中文项目介绍
OneBox 是一个基于 sing-box 内核构建的跨平台桌面代理客户端，旨在解决专业代理工具配置复杂、命令行操作门槛高的问题。项目主打“简单、稳定、安全”的理念，通过直观的图形界面让普通用户无需编辑配置文件即可快速使用网络代理功能。
在技术实现上，OneBox 采用 Tauri 框架，后端使用 Rust 语言以保证高性能与低资源消耗，前端基于 React、Vite 和 Tailwind CSS 构建现代化用户界面。应用深度集成 Tauri 插件生态系统，支持自动启动、剪贴板管理、文件系统访问、HTTP 请求、日志记录、应用更新等系统级功能，并使用系统钥匙串安全存储敏感信息。
平台支持分为三个等级：macOS 为 Tier 1 官方支持，Windows 和 Ubuntu 为 Tier 2 社区支持，其他 Linux 发行版为 Tier 3 实验性支持。用户可通过官网或 GitHub Releases 页面下载对应平台的安装包，macOS 版本已通过苹果公证可直接安装。
详细信息与使用说明
2. 解决的问题
OneBox 主要解决 sing-box 等内核级代理工具的两大痛点：一是配置复杂性，原始工具依赖手写 JSON 配置文件，对非技术用户不友好；二是操作门槛，命令行交互方式需要用户具备一定技术背景。通过提供图形界面，OneBox 将配置过程可视化，支持一键式设置和实时状态管理，显著降低使用难度。同时，项目注重安全与隐私，采用系统钥匙串存储密码等敏感信息，并遵循平台安全规范（如 macOS 公证）。但需注意，底层内核的安全漏洞修复依赖 sing-box 项目，OneBox 无法直接控制。
3. 适用场景
OneBox 适用于以下场景：一是普通用户有网络代理需求但不愿处理复杂配置，希望即装即用；二是跨平台用户（同时使用 macOS、Windows 或 Linux）寻求统一、一致的代理客户端体验；三是注重安全与隐私的用户，利用系统级密钥链保护凭证。此外，开发者或网络爱好者也可用于快速测试代理规则。项目不推荐给偏好深度定制、手动配置高级规则的用户，此类用户应选择其他更灵活的工具。平台支持等级表明，macOS 用户能获得最稳定体验，Windows 和 Ubuntu 用户次之，其他 Linux 发行版用户需承担不稳定风险。
4. 安装方式
根据仓库信息，安装方式为：访问 OneBox 官方网站 https://sing-box.net 或 GitHub Releases 页面（https://github.com/OneOhCloud/OneBox/releases），下载对应操作系统（macOS、Windows 或 Linux）的安装包。macOS 版本已通过苹果官方公证（Notarization），双击即可安装无需额外授权；Windows 和 Linux 版本需运行相应的安装程序（如 .exe 或 .deb 包）。仓库中未明确提供命令行安装指令或包管理器集成方式，用户需通过图形安装程序完成部署。
5. 使用方式
安装完成后，启动 OneBox 应用程序即可通过图形界面进行代理配置与管理。主界面（Home）显示连接状态和快捷控制，配置页面（Config）用于添加和编辑代理规则、出站设置等，设置页面（Settings）提供常规选项如开机自启、主题切换等。应用支持系统托盘驻留，方便快速开关代理。自动更新功能通过内置插件实现，可在设置中管理。具体操作细节可参考应用内各页面的提示，仓库中未提供详细的使用手册或教程文档，但界面设计力求直观，降低学习成本。
6. 补充说明与实现特点
从代码结构看，OneBox 采用 Tauri 架构，前端为 React + TypeScript，构建工具为 Vite，样式使用 Tailwind CSS；后端为 Rust，负责与 sing-box 内核交互及系统集成。项目集成多个 Tauri 插件（如 autostart、clipboard-manager、fs、http、log、updater 等），扩展系统功能。数据持久化使用 SQL 和 store 插件存储配置。开发流程包含测试（Vitest）和 Git hooks（Husky）。构建配置针对平台优化（Windows 目标 chrome105，其他平台 safari13）。软件遵循 Apache License 2.0，但品牌名称和图标为 proprietary assets，使用需遵守 NOTICE 政策。测试命令为 `cargo test -- --nocapture`（针对 Rust 后端），前端测试通过 `npm test` 运行。
思维导图
当前仓库信息不足，或结构不够稳定，暂时没有生成可靠的思维导图。
常见问题
OneBox 是什么？适合谁使用？
OneBox 是基于 sing-box 内核的跨平台图形化代理客户端，适合希望使用代理但不想处理复杂配置的普通用户。它提供直观界面和开箱即用体验，不推荐给需要深度定制高级规则的技术爱好者。
如何下载和安装 OneBox？
请访问官网 https://sing-box.net 或 GitHub Releases 页面下载对应平台的安装包。macOS 版本已苹果公证，双击即可安装；Windows 和 Linux 需运行提供的安装程序。仓库中未给出命令行安装方式。
OneBox 支持哪些操作系统？稳定性如何？
支持 macOS（Tier 1 官方维护，生产就绪）、Windows 和 Ubuntu（Tier 2 社区维护，稳定但更新可能滞后）、其他 Linux（Tier 3 实验性，不稳定）。建议 macOS 用户获得最佳体验。
OneBox 的安全性如何保障？
应用采用系统钥匙串存储密码等敏感信息，macOS 版本经苹果公证。但需注意，底层 sing-box 内核的安全漏洞修复由 upstream 项目负责，OneBox 无法直接控制，相关风险需用户知悉。
如何更新 OneBox 到最新版本？
应用内置自动更新功能（基于 Tauri updater 插件），可在设置中检查并安装更新。也可手动从官网或 GitHub Releases 页面下载新版本安装包覆盖安装。