资料来源与版本
本站面向 B-box 用户,依据实际实现整理操作说明。它不是 sing-box、FlClash 或 Surge 的官方文档。
本轮内容基线
| 项目 | 核对版本 |
|---|---|
| B-box | 1006e00e2b24bd369b8c3f5ab08f057c192d8aae |
| 核对日期 | 2026-11-11 |
| 文档所用分支 | newui |
| sing-box 核心基线 | v1.15.0-alpha.13,以该提交的 version.properties 为准 |
| FlClash 界面参考 | v0.9.3;不作为核心版本号 |
当前源码不等同于已发布 APK。 入口、字段和功能支持以安装包所含提交为准;项目的旧构建成功记录也不能证明新提交已完成全部设备验证。
更新本文时应同时核对相关实现与示例,不能只刷新日期或替换版本号。
功能依据
以下链接固定到上述 B-box 提交,便于复查:
| 文档内容 | 依据 |
|---|---|
| 项目定位与安装范围 | README |
| 核心扩展、默认值、执行顺序和限制 | libbox.md |
| 证书、Android 信任与配置生命周期 | app.md |
| 配置编辑与连接请求入口 | flclash.md |
| MITM 字段与域名规则 | mitm_config.go、mitm_hosts.go |
| 改写字段与实现 | rewrite_config.go、rewrite.go |
| 脚本字段与返回值 | script_config.go、script.go |
| HTTP 客户端 | script_http.go |
| Cron、存储与定时器 | script_cron.go、script_storage.go、script_timers.go |
| 外部资源 | processing_resources.go |
| gRPC 单消息帧与 gzip 工具 | grpc_body.go、script_utils.go |
| 用户正文限额与缓冲记账 | processing_limits.go、body_budget.go |
| 记录设置、正文分页与导出 | config.go、body_preview.go、export.go |
| 统一请求页与正文卡片 | requests.dart、captured_body.dart |
| 本地资源导入与备份范围 | BoxProfiles.kt、app.md 配置处理生命周期 |
| 示例参考 | B-box examples |
本站示例按这些字段和行为编写,使用测试域名。原仓库提供的 Android/Go 验证记录见固定版本 app.md;文档站构建通过不替代 App 实机验证。
官方参考资料
- sing-box 配置文档与 mixed 入站。
- sing-box-for-android。
- FlClash v0.9.3 参考提交。
- Surge HTTP Processing、MITM、Host List、JavaScript API。这些资料用于理解参考语义,不能替代 B-box 的字段说明。
- Android Network Security Configuration,理解用户 CA 与应用信任。
- Magisk 模块指南、KernelSU 模块指南。
- SSL Pinning 排错推荐 TrustMe,安装条件及 hook 范围按
f0226dd的 README核对。它是独立的 LSPosed / 兼容 Xposed 模块,使用步骤见证书教程。 - gRPC 官方 HTTP/2 协议及 gRPC-Web 协议。B-box 的具体支持范围以表中的实现为准。
文档站维护
源码仓库:giturass/B-box-docs。本站用 VitePress 1.6.4,中文搜索在浏览器本地运行。
站标与浏览器标签页图标使用 B-box 的应用启动器图标,原样保存为 docs/public/b-box.png。
推送 main 后,GitHub Actions 检查 Markdown/示例引用,分别构建 GitHub Pages 子路径和 Vercel 根路径,并在手机与桌面浏览器中检查导航、搜索和下载。检查通过后部署 GitHub Pages;Vercel 可直接导入仓库部署。
页面底部的“文档更新”表示该页在文档仓库的编辑时间,不能据此推断 App 功能刚刚被验证。内容基线始终以上方表格为准。
