#keepBrowserProfile

keepBrowserProfile 用于控制是否在开发时保留浏览器用户数据（profile)。

#概述

• 类型:boolean
• 默认值:false
• 是否必需：否

#用法

// addfox.config.ts
import { defineConfig } from "addfox";

export default defineConfig({
  keepBrowserProfile: true,  // 跨启动保留浏览器 profile
});

#作用

启用后：

• 开发时浏览器用户数据保存在 .addfox/cache/browser-profile/<name>-user-data 目录
• 下次启动 addfox dev 时会复用这些数据
• 登录状态、扩展设置等会保留

也可以按浏览器覆盖顶层配置：

export default defineConfig({
  browser: {
    chrome: { keepBrowserProfile: true },
  },
});

#优先级

按以下顺序解析（优先级从高到低）:

1. CLI --keep-browser-profile / --no-keep-browser-profile
2. browser.<name>.keepBrowserProfile（按浏览器覆盖）
3. 顶层 keepBrowserProfile
4. 废弃的 cache(CLI -c/--cache、--no-cache 或配置 cache)
5. 默认值 false

#CLI 参数

CLI 参数优先级高于配置：

pnpm

npm

yarn

bun

# 强制保留 profile（即使配置为 false）
pnpm dev -- --keep-browser-profile

# 强制使用全新 profile（即使配置为 true）
pnpm dev -- --no-keep-browser-profile

# 强制保留 profile（即使配置为 false）
npm run dev -- --keep-browser-profile

# 强制使用全新 profile（即使配置为 true）
npm run dev -- --no-keep-browser-profile

# 强制保留 profile（即使配置为 false）
yarn dev --keep-browser-profile

# 强制使用全新 profile（即使配置为 true）
yarn dev --no-keep-browser-profile

# 强制保留 profile（即使配置为 false）
bun run dev -- --keep-browser-profile

# 强制使用全新 profile（即使配置为 true）
bun run dev -- --no-keep-browser-profile

当 --keep-browser-profile 与 --no-keep-browser-profile 同时出现时，以最后一个参数为准。

#注意事项

• 仅影响开发模式（addfox dev)
• 不影响 Firefox;Firefox 的 profile 由 web-ext 管理
• 遇到奇怪问题时，可尝试清除 .addfox/cache/ 目录

#buildCache

buildCache 用于控制 Rspack 持久化构建缓存，加快重复构建。

#概述

• 类型:boolean | { cacheDirectory?: string }
• 默认值:true
• 缓存文件保存在 <outputRoot>/cache/build/

#用法

export default defineConfig({
  // 关闭构建缓存
  buildCache: false,
});

export default defineConfig({
  // 自定义缓存目录
  buildCache: { cacheDirectory: "./node_modules/.cache/addfox-build" },
});

如需更深层的 rsbuild/rspack 定制，可使用已有的 rsbuild 配置字段（对象深合并或函数形式）。

#相关配置

• guide/launch - 开发启动指南