安装指南
Windows
常规安装（推荐）
- 前往 下载页 下载
Knowledge.Base_<version>_x64-setup.exe - 双击运行安装程序
- 安装向导会提示选择语言（简体中文 / English）
- 选择安装位置（默认
C:\Program Files\Knowledge Base） - 选择安装模式：
- 当前用户：只为当前登录用户安装（无需管理员权限）
- 所有用户：为本机所有用户安装（需要管理员权限）
- 点击 "安装" 等待完成，桌面快捷方式自动创建
WebView2 运行时
Knowledge Base 基于 Tauri 框架，需要系统自带的 WebView2 运行时。
- Windows 10 (1803+) 和 Windows 11 已预装 WebView2
- 如果启动时提示"WebView2 未安装"，从 微软官网下载 Evergreen Bootstrapper 安装即可
Windows Defender / 杀毒软件报警
应用未做代码签名（因其需要数千美元的证书），因此 Windows Defender 可能提示"未知发行者"。操作方法：
- 点击"更多信息"
- 点击"仍要运行"
- 或在 Defender 设置中添加信任
如果想 100% 确认安全，可 查看源码 自行审查/编译。
macOS
下载对应芯片的版本
点击左上角 → 关于本机 查看芯片类型：
| 显示 | 下载 |
|---|---|
| 芯片 Apple M1/M2/M3/M4 | Knowledge.Base_<version>_aarch64.dmg |
| 处理器 Intel Core i5/i7/i9 | Knowledge.Base_<version>_x64.dmg |
安装步骤
- 双击
.dmg文件打开 - 将 Knowledge Base 应用图标拖到 Applications 文件夹
- 在 Launchpad 或 Applications 中启动
Gatekeeper：已损坏 / 无法打开
macOS 会阻止未经 Apple 公证的应用。如果看到"应用已损坏"、"无法打开，因为 Apple 无法检查其是否包含恶意软件"等提示：
bash
sudo xattr -cr /Applications/Knowledge\ Base.app输入用户密码（输入时不显示），回车。再次打开即可正常启动。
这样做安全吗？
该命令只是移除了 macOS 给 DMG 下载文件加的"隔离"标记（com.apple.quarantine）。应用本身经过 Tauri 自己的签名验证，与 Apple 公证是两回事。
数据位置
所有笔记和配置保存在本地：
| 平台 | 数据目录 |
|---|---|
| Windows | %APPDATA%\com.agilefr.kb\ |
| macOS | ~/Library/Application Support/com.agilefr.kb/ |
主要文件：
knowledge.db：SQLite 数据库（笔记、标签、文件夹、链接）settings.json：应用配置attachments/：笔记附件（图片等）
备份
强烈推荐定期备份 knowledge.db：
- Windows：复制
%APPDATA%\com.agilefr.kb\knowledge.db到任意位置 - macOS：复制
~/Library/Application Support/com.agilefr.kb/knowledge.db到任意位置 - 自动备份：可在 设置 → 导出 中把所有笔记批量导出为 Markdown 文件夹
卸载
Windows
控制面板 → 程序和功能 → 找到 "Knowledge Base" → 卸载。
如需清除所有数据，手动删除 %APPDATA%\com.agilefr.kb\。
macOS
将 Applications 中的 Knowledge Base 拖到废纸篓。
如需清除所有数据，手动删除 ~/Library/Application Support/com.agilefr.kb/。