💾 数据库设置

数据库路径

默认路径

Windows：%APPDATA%\KkbarDB
macOS：~/Library/Application Support/KkbarDB

自定义路径

如需更改数据库存储位置：

打开设置面板
找到 数据库路径 选项
点击设置按钮选择新目录
选择 创建新数据库（空白数据库）或 复制现有数据

建议首次使用时设置自定义目录，便于备份和管理数据文件、多设备间同步数据。

数据导出

导出单个分类

在设置面板中：

选择要导出的分类
点击分类右侧的导出按钮
选择保存位置和文件名

导出文件包含该分类及其所有按钮数据（.kbar 格式）。

导出 UI 设置

在设置面板中：

找到 导出配置 按钮
选择 UI 设置 选项
选择保存位置

导出文件包含界面主题、图标大小、布局等设置（.json 格式）。

导出完整数据库

在设置面板中：

找到 导出配置 按钮
选择 完整数据库 选项
选择保存位置

导出文件包含所有分类、按钮、图标、UI 设置等完整数据。

数据导入

导入 KBar 数据库（.kbar/.kkbar/.zip）

Kkbar 支持导入 KBar 格式的数据库文件，方便从 KBar 迁移数据：

在设置面板中点击导入按钮
选择 .kbar、.kkbar 或 .zip 格式的文件
预览导入内容，查看分类和按钮数量
选择要导入的分类（支持全选/取消全选）
点击导入按钮完成数据迁移

支持的功能：

自动解析 KBar 格式的 manifest.json 文件
自动提取并导入脚本（.jsx）、预设（.ffx）、图标等资源文件
支持智能套娃解压（自动识别嵌套的 .kbar 文件）
导入时采用智能合并模式，不会覆盖现有数据
支持分类、按钮、动作、图标等完整数据迁移
自动处理文件名冲突，生成唯一文件名

导入 KBar 分类数据（.kbar）

在设置面板中点击导入按钮
选择要导入的 .kbar 文件
预览导入内容，选择要导入的分类
点击导入按钮，数据会智能合并到现有分类中

导入 UI 设置（.json）

在设置面板中点击导入按钮
选择要导入的 UI 设置文件（.json 格式）
确认后 UI 设置会被覆盖

导入完整数据库（.json）

在设置面板中点击导入按钮
选择要导入的完整数据库文件（.json 格式）
确认后所有数据会被覆盖

注意

导入完整数据库会覆盖所有现有数据
导入 UI 设置会覆盖当前界面配置
导入分类数据会与现有数据合并，不会覆盖
导入 KBar 数据库时，资源文件会自动提取到数据库目录

数据备份建议

定期导出完整数据库作为备份
重要配置单独导出 UI 设置
可导出单个分类与他人分享
使用云备份功能自动同步（高级功能）

适用场景

备份数据库防止数据丢失
迁移到新电脑时转移配置
与他人分享单个分类的按钮配置
仅迁移 UI 设置保留按钮配置