您的数据存储位置
TabBoy 是一款本地优先（Local-first）的 Chrome 扩展。与基于云端的标签页管理器不同，您的浏览数据绝不会离开您的设备。由于 TabBoy 完全开源，本页面上的每一项声明都可以在我们的代码仓库中直接查证。
物理存储位置
Section titled “ 物理存储位置”所有持久化扩展数据均通过 Chrome 原生的 chrome.storage.local API 保存在本地 Chrome 用户配置目录中。
在您的计算机上，Chrome 将这些数据存放在专属的 LevelDB 数据库中：
- macOS：
~/Library/Application Support/Google/Chrome/<Profile>/Local Extension Settings/<Extension-ID>/ - Linux：
~/.config/google-chrome/<Profile>/Local Extension Settings/<Extension-ID>/ - Windows：
%LOCALAPPDATA%\Google\Chrome\User Data\<Profile>\Local Extension Settings\<Extension-ID>\
零云端同步（未启用 storage.sync）
Section titled “ 零云端同步（未启用 storage.sync）”TabBoy 不使用 browser.storage.sync 或 chrome.storage.sync。
即使您在 Google 账户中开启了 Chrome 同步功能，您的 TabBoy 收藏集、分类规则和历史记录也绝不会上传至 Google 服务器，更不会在多台设备间自动同步。数据严格保留在您安装扩展的本地设备中。
存储键完整清单
Section titled “ 存储键完整清单”所有存储键均在 src/features/storage/repository.ts 中通过 Zod 进行了类型与架构验证：
| 存储区域 | 存储键名称 | 用途说明 |
|---|---|---|
storage.local |
local:collections |
用户收藏集（层级空间与标签页项）。 |
storage.local |
local:rules |
启用的自动分组规则。 |
storage.local |
local:savedGroups |
保存以备后用的标签页分组。 |
storage.local |
local:sessionsV1 |
浏览恢复点与历史状态。 |
storage.local |
local:recoverySnapshotsV1 |
执行破坏性操作前自动创建的安全网快照。 |
storage.local |
local:workspaceMoodThresholdsV2 |
工作区负载计算阈值配置。 |
storage.local |
local:dashboardSaveOptionsV1 |
仪表盘创建收藏集时的偏好设置。 |
storage.local |
local:collectionTreeDepthV1 |
收藏集树状图配置的展开层级深度。 |
storage.local |
local:collectionTreeExpandedIdsV1 |
树状视图中空间文件夹的展开/折叠状态。 |
storage.local |
local:collectionsViewOptionsV1 |
排序、标签过滤及收藏过滤选项。 |
storage.local |
local:appShortcuts |
自定义快捷键配置。 |
storage.local |
local:themePreferenceV1 |
主题偏好设置（system、light、dark）。 |
storage.local |
local:onboardingCompletedV1 |
初始引导完成标记。 |
storage.local |
local:celebrationShownV1 |
首次成功整理时的动画展示标记。 |
storage.local |
local:latestScan |
最近一次本地窗口/标签页扫描的元数据。 |
storage.local |
local:latestScanDebug |
最新扫描的临时诊断报告。 |
storage.local |
local:latestScanRulesFingerprint |
规则版本指纹（用于判断规则是否有变动）。 |
storage.session |
session:suggestions |
规则引擎生成的建议（临时数据，浏览器关闭时自动清除）。 |
storage.session |
session:byokCredential |
用户配置的 BYOK API 凭据（临时数据，浏览器关闭时自动清除）。 |
如果丢失 Chrome 配置文件会怎样？
Section titled “ 如果丢失 Chrome 配置文件会怎样？”由于 TabBoy 不在远程服务器保存任何数据，一旦您的 Chrome 用户配置被删除或硬盘损坏，TabBoy 无法远程恢复您的数据。
为了确保数据万无一失：
- JSON 导出与备份：定期在 TabBoy 仪表盘中导出备份文件（详见 备份与恢复）。
- 自动安全网快照：在关闭或合并标签页等破坏性操作前，TabBoy 会自动生成本地恢复快照（
local:recoverySnapshotsV1）。 - 无格式锁定：备份文件为开放的纯 JSON 格式，可使用任何文本编辑器查看。