常见问题

🔐 隐私与数据安全

我的笔记会上传到云端吗？

不会。Knowledge Base 是本地优先应用：

• 所有笔记保存在你电脑的 SQLite 数据库
• 主程序不会把笔记发给任何服务器
• 只有当你主动使用 AI 问答时，笔记片段会发给你配置的 API（OpenAI / DeepSeek / 本地 Ollama 等），Knowledge Base 不做中转

我的数据存在哪里？

平台	位置
Windows	%APPDATA%\com.agilefr.kb\
macOS	~/Library/Application Support/com.agilefr.kb/

主要文件：knowledge.db（SQLite 数据库）、settings.json（配置）、attachments/（附件）。

换台电脑怎么迁移数据？

方法一（推荐）：

1. 旧电脑 → 设置 → 导入导出 → 导出所有笔记
2. 把导出目录（含 Markdown + attachments）复制到新电脑
3. 新电脑 → 从 Markdown 文件夹导入

方法二（简单粗暴）：

直接拷贝 knowledge.db 文件到新电脑的数据目录。

---

💰 付费 / 授权

Knowledge Base 是免费的吗？

完全免费，无订阅、无限额、无广告。

商业使用有限制吗？

开发者在私有软件范畴发布。应用本身可自由下载使用（包括商业场景），但代码不可转售。

有团队/企业版吗？

目前没有。可以多人独立安装，所有人数据各自独立，暂不支持协同编辑（未来规划）。

---

🛠️ 使用问题

支持 Linux 吗？

规划中。CI 已经裁剪了 Linux 构建以节省时间和产物体积。如果你有明确需求，可以在 GitHub Issues 投票。

支持手机 / iPad 吗？

暂不支持。Tauri 在桌面端体验最佳。移动端未来可能基于 React Native 做，但优先级较低。

有 Web 在线版吗？

没有。在线版意味着数据要传到服务器，违背"本地优先"原则。如果你需要跨设备同步，推荐：

1. 把数据目录放在云盘（OneDrive / iCloud / Dropbox）
2. 多台电脑上安装 Knowledge Base，指向同一个数据目录
3. 注意：不要同时编辑，否则可能产生冲突

macOS 打开提示"应用已损坏"？

这是 macOS Gatekeeper 对未公证应用的标准警告。执行：

sudo xattr -cr /Applications/Knowledge\ Base.app

详见 安装指南。

Windows 打开报毒 / Defender 报警？

应用没有做代码签名（证书昂贵）。你可以：

1. 在 Windows Defender 中添加信任
2. 或者 自行编译源码

数据库卡了 / 报错怎么办？

先备份再尝试：

1. 备份 %APPDATA%\com.agilefr.kb\knowledge.db（Windows）
2. 打开应用 → 设置 → 高级 → 运行数据库完整性检查
3. 如发现问题，设置 → 高级 → 尝试自动修复
4. 还不行就用 SQLite Browser 打开 knowledge.db 看具体错误，或反馈给我们

---

🤖 AI 问答相关

为什么第一次问问题很慢？

首次启用 AI 问答时，应用会对所有已有笔记构建向量索引。这需要调用 embedding API：

• 1 千笔记 → ~30 秒
• 1 万笔记 → ~3 分钟
• 10 万笔记 → ~30 分钟

之后新建 / 修改笔记时增量更新，不会再有等待。

用本地模型可以吗？

可以，推荐 Ollama：

ollama pull qwen2.5:14b
ollama pull nomic-embed-text
ollama serve  # 启动本地服务

Knowledge Base 设置 → AI 模型：

• API Base URL: http://localhost:11434/v1
• Model: qwen2.5:14b
• Embedding Model: nomic-embed-text

完全离线，完全免费。

AI 回答不准怎么办？

几个常见原因：

1. 笔记太简短：embedding 召回不到足够上下文，试着写得更详细
2. 问法不够具体：不要问"帮我总结"，要问"总结 2026 年 3 月所有关于 Rust 的学习笔记"
3. 模型能力不足：用 gpt-3.5-turbo / deepseek-chat 可能需要换 gpt-4o / claude-3-5-sonnet
4. 引用是错的：点开引用的笔记核对。如果引用不相关，说明 embedding 质量差，换更好的 embedding model

---

🔄 更新与兼容

应用会自动更新吗？

会。通过 R2 CDN 作为主源 + GitHub raw 兜底，设置 → 检查更新 可以立刻查看。

• 新版发布后，应用内弹出提示
• 一键下载安装包
• 应用自动重启完成升级
• 升级过程不会丢失任何笔记数据

三个下载镜像有什么区别？

镜像	作用	谁用
Cloudflare R2	应用内自动更新主端点 + 直链下载	所有人默认走这个
Gitee Release	国内镜像，浏览所有版本	国内用户免代理手动下载
GitHub Release	官方发布页 + 备用更新端点	海外用户；需要看发布说明时

三者内容完全一致，文件签名相同，可任选。

升级后数据还在吗？

完全保留。SQLite 数据库文件放在用户数据目录，和应用程序是分开的。即便卸载重装也不影响数据。

如何彻底清除所有数据？

卸载应用后，手动删除数据目录：

• Windows：%APPDATA%\com.agilefr.kb\
• macOS：~/Library/Application Support/com.agilefr.kb/

---

🐛 Bug / 功能建议

发现 Bug 在哪里反馈？

• GitHub Issues（源码仓库私有，可能需要先提交访问申请）
• 邮件到项目维护者（见项目 README）

报告 Bug 时请附上：

• 操作系统版本
• 应用版本（设置 → 关于）
• 复现步骤
• 错误截图或日志（设置 → 高级 → 打开日志目录）

可以贡献代码吗？

欢迎。但源码仓库目前是私有的，如果想贡献请先联系作者。

可以提功能建议吗？

当然。功能建议请在 GitHub Issues 标上 enhancement 标签，或发邮件说明场景和需求。