Brave浏览器：隐私优先的开源浏览器项目全解析

// 构建系统会自动同步brave-core子模块
const braveCoreDir = path.resolve(__dirname, '..', 'src', 'brave')
const braveCoreRef = util.getProjectVersion('brave-core')

if (!fs.existsSync(path.join(braveCoreDir, '.git'))) {
  Log.status(`Cloning brave-core [${braveCoreRef}] into ${braveCoreDir}...`)
  fs.mkdirSync(braveCoreDir)
  util.runGit(braveCoreDir, ['clone', 
    util.getNPMConfig(['projects', 'brave-core', 'repository', 'url']), 
    '.'])
  util.runGit(braveCoreDir, ['checkout', braveCoreRef])
}

# 1. 克隆主仓库
git clone https://github.com/brave/brave-browser.git

# 2. 安装依赖并同步子模块
npm install
npm run sync -- --init

# 3. 按照平台指南配置构建环境

# 4. 执行构建命令（具体命令因平台而异）

// Copyright (c) 2019 The Brave Authors. All rights reserved.
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this file,
// you can obtain one at http://mozilla.org/MPL/2.0/.

const fs = require('fs')
const Log = require('../lib/logging')
const path = require('path')
const { spawnSync } = require('child_process')
const util = require('../lib/util')

Log.progress('Performing initial checkout of brave-core')

const braveCoreDir = path.resolve(__dirname, '..', 'src', 'brave')
const braveCoreRef = util.getProjectVersion('brave-core')

// 检查brave-core目录是否存在，若不存在则克隆
if (!fs.existsSync(path.join(braveCoreDir, '.git'))) {
  Log.status(`Cloning brave-core [${braveCoreRef}] into ${braveCoreDir}...`)
  fs.mkdirSync(braveCoreDir)
  // 从NPM配置获取仓库URL并克隆
  util.runGit(braveCoreDir, ['clone', 
    util.getNPMConfig(['projects', 'brave-core', 'repository', 'url']), 
    '.'])
  // 切换到指定版本
  util.runGit(braveCoreDir, ['checkout', braveCoreRef])
}

// 获取当前提交ID用于日志记录
const braveCoreSha = util.runGit(braveCoreDir, ['rev-parse', 'HEAD'])
Log.progress(`brave-core repo at ${braveCoreDir} is at commit ID ${braveCoreSha}`)

// 设置平台相关的npm命令
let npmCommand = 'npm'
if (process.platform === 'win32') {
  npmCommand += '.cmd'
}

// 安装brave-core依赖
util.run(npmCommand, ['install'], { cwd: braveCoreDir })

// 执行同步命令，传递额外参数
util.run(npmCommand, ['run', 'sync' ,'--', '--init'].concat(process.argv.slice(2)), {
  cwd: braveCoreDir,
  env: process.env,
  stdio: 'inherit',
  shell: true,
  git_cwd: '.',
})

brave-browser/
├── package.json          # 项目配置和依赖定义
├── src/
│   ├── brave/           # brave-core模块（挂载点）
│   │   ├── components/
│   │   │   └── adblock_rust_ffi/  # adblock-rust的FFI接口
│   │   └── DEPS         # Chromium依赖定义
│   └── chromium/        # Chromium源码（通过depot_tools获取）
├── lib/
│   ├── logging.js       # 日志工具
│   └── util.js          # 通用工具函数
└── scripts/
    └── sync.js          # 同步脚本（如上所示）

## 支持的版本
所有当前稳定发布版本及更高版本（与官网下载版本一致）

## 漏洞报告
通过HackerOne平台报告安全漏洞：https://hackerone.com/brave

## 安全增强示例
- 硬件钱包桥接通信的增强验证
- 定期Chromium安全更新合并
- 安全研究人员奖励计划

1. 问题分流：验证问题是否仍存在、提供重现步骤、识别重复问题

3. 代码贡献：遵循代码规范、提交详细的拉取请求
4. 翻译协助：通过Transifex平台帮助翻译界面文本

每个拉取请求应包括：
- 问题描述的清晰变更说明
- 测试覆盖证明
- 文档更新（如适用）
- 遵循代码风格指南