Knowledge Base

深色模式

常见问题 ​

🔐 隐私与数据安全 ​

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

不会。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/（附件）。

换台电脑怎么迁移数据？ ​

方法一（v0.2.0+ 推荐）：用 多设备同步（WebDAV）

  1. 旧电脑配置 WebDAV（如坚果云）→ 点"立即推送"
  2. 新电脑配置同一个 WebDAV → 点"从其他设备拉取" → 选旧电脑的快照
  3. 完成，之后两台随时保持同步。详见 多设备同步

方法二：导出 / 导入 Markdown

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

方法三（简单粗暴）：

直接拷贝数据目录到新电脑。

💰 付费 / 授权 ​

Knowledge Base 是免费的吗？ ​

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

商业使用有限制吗？ ​

应用本身对个人、团队、企业均免费使用，无任何功能限制。

源代码采用 AGPL-3.0 + 商业授权双许可：

  • 个人使用 / 开源项目二次开发 / 企业内部工具：遵守 AGPL-3.0 即可，免费
  • 闭源商用 / SaaS 私有化部署 / OEM 打包销售：需要购买商业授权（联系 QQ/微信 770492966）

简单说：自己用、开源玩 → 完全免费；想闭源卖钱、做 SaaS 不开放源码 → 买商业授权。详见 源码仓库 LICENSE 和 COMMERCIAL-LICENSE.md。

有团队/企业版吗？ ​

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

🛠️ 使用问题 ​

支持 Linux 吗？ ​

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

支持手机 / iPad 吗？ ​

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

有 Web 在线版吗？ ​

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

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

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

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

bash
sudo xattr -cr /Applications/知识库.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：

bash
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

☁️ 多设备同步（v0.2.0+） ​

数据会上传到第三方服务器吗？ ​

不会。同步功能需要你自己提供 WebDAV 服务（坚果云 / NextCloud / 自建 rclone），Knowledge Base 只是把本地数据打包成 ZIP 上传到你自己的网盘。

密码用 AES-256-GCM 加密后存本地 SQLite，密钥从设备主机名派生，不随密文一起存。即便 SQLite 被别人拷走也无法解密。

两台电脑同时编辑会冲突吗？ ​

会。Knowledge Base 的同步是"全量快照覆盖"策略，不做三路合并。建议同一时刻只在一台设备上编辑，其他设备先从云端拉取最新再开始写。

如果真的发生冲突（两台都有新内容），建议：

  1. 暂时关掉自动同步
  2. 在哪台电脑丢失内容最少，就从那台推送覆盖其他
  3. 或分别导出后手动合并

支持哪些 WebDAV 服务？ ​

只要遵循标准 WebDAV 协议的都行。已验证可用：

  • 坚果云（推荐，国内速度好）
  • NextCloud（自建 / 云托管都可）
  • 用 rclone serve webdav 把任何 S3/OSS 包一层
  • 群晖 WebDAV

同步 ZIP 大小多大？ ​

取决于你的笔记体量 + 图片 + 导入的 PDF / Word。典型范围：

  • 纯文本笔记 1000 条 ≈ 几 MB
  • 重度使用图片 / PDF ≈ 几十 MB 到几百 MB

全量快照每次上传并不慢，因为用 ZIP 压缩 + rclone 增量算法，未变化的文件不会重复上传。

🔄 更新与兼容 ​

应用会自动更新吗？ ​

会。启动 5 秒后应用会静默 check，之后每 30 分钟再 check 一次。三级更新端点（R2 → GitHub raw → Gitee raw）互为兜底。

  • 发现新版本时顶部栏右上角出现绿色"有可用更新"徽章（v0.2.0+）
  • 点击徽章查看版本说明 → 一键下载
  • 下载完成后应用自动重启完成升级
  • 升级过程不会丢失任何笔记数据

也可以 设置 → 关于 → 检查更新 手动触发。

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

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

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

升级后数据还在吗？ ​

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

如何彻底清除所有数据？ ​

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

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

🐛 Bug / 功能建议 ​

发现 Bug 在哪里反馈？ ​

  • GitHub Issues（推荐，源码仓库已开源，请使用 Issue 模板提交 Bug / 功能建议）
  • QQ 交流群 1090770702（轻量级讨论 / 实时交流，复杂问题仍建议走 Issue 留底）

报告 Bug 时请附上：

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

可以贡献代码吗？ ​

非常欢迎！ 源码仓库已于 2026-04-23 正式开源（AGPL-3.0 + 商业授权双许可）。

参与方式：

  1. Fork 源码仓库
  2. 阅读 CONTRIBUTING.md 了解开发规范
  3. 在本地开发 + 测试
  4. 提交 PR（首次 PR 时会自动要求签署 CLA，勾选同意即可）
  5. 等待 review 与合并

⚠️ 由于采用双许可模式，所有外部 PR 必须签署 CLA（贡献者许可协议） 才能被合并。这是为了保证贡献的代码可以同时分发到开源版和商业版。详见 CONTRIBUTING.md。

可以提功能建议吗？ ​

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

最后更新:

你的知识，你的电脑，你说了算

© 2026 AgileFR. Released under the private license.