贝叶树使用说明

版本：1.0  |  本地优先的 AI 智能助理与知识库系统

贝叶树是一款本地优先的 AI 智能助理桌面应用。它可以索引您电脑上的文档，通过 AI 进行智能搜索和问答，并精确定位到原文出处。除了知识库检索，贝叶树还提供笔记、日程、待办、收藏等效率工具，是您的 AI 私人秘书。

目录
一、产品简介 二、硬件与系统要求 三、安装与首次设置 四、核心功能 五、扩展功能 六、设置说明 七、存储与资源占用 八、安全与隐私 九、注意事项 十、常见问题与故障排除 十一、支持的文件格式

一、产品简介

二、硬件与系统要求

最低配置

项目要求
操作系统macOS 12 (Monterey) 及以上 / Windows 10 及以上
处理器Apple M1 或 Intel 四核 / Windows 含 NVIDIA 显卡的 PC
内存 (RAM)16GB
硬盘空间20GB 可用空间
网络首次安装需要联网下载 AI 模型

推荐配置

项目要求
操作系统macOS 14 (Sonoma) 及以上
处理器Apple M1 Pro / M2 及以上，或 NVIDIA RTX 系列显卡
内存 (RAM)16GB 及以上
硬盘空间50GB 及以上（取决于文档量）
档位说明：贝叶树会根据您的硬件自动推荐合适的档位

Windows 用户：如果没有 NVIDIA 显卡，将自动锁定为轻量模式

存储空间预估

组件大小说明
应用本体~200MB贝叶树安装包
AI 模型（轻量）~2GB对话模型 + 向量模型 + 视觉模型
AI 模型（标准）~4GB对话模型 + 向量模型 + 视觉模型
知识库索引约原文档 1/4 大小如 30GB 文档约产生 7-8GB 索引
首次使用约需下载 2-4GB 模型数据，请确保网络畅通。下载支持断点续传，从国内镜像加速。

三、安装与首次设置

3.1 安装应用

macOS

  1. 双击 .dmg 文件打开安装镜像
  2. 将「贝叶树」拖入「Applications」文件夹
  3. 首次打开时，若提示"无法验证开发者"，请前往系统设置 → 隐私与安全性 → 仍然打开

Windows

  1. 双击 .msi 安装包
  2. 按提示完成安装
  3. 首次打开时，若 SmartScreen 提示，点击「更多信息 → 仍要运行」

3.2 首次设置向导

首次启动会进入四步设置向导：

第一步：欢迎

点击「开始设置」进入配置流程。

第二步：选择性能档位 + 下载 AI 引擎

模型文件存储在应用数据目录中，无需单独安装任何第三方软件。下载完成后会自动校验文件完整性。

第三步：选择文档文件夹

点击「选择文件夹」，选择您要建立知识库的文档目录。应用会自动扫描并索引该目录下的所有支持格式文件。也可跳过本步骤，稍后在知识库页面添加。

第四步：完成

点击「开始使用」进入主界面。索引过程会在后台继续运行。

3.3 重新配置档位

如果想从轻量模式切换到标准模式（或反之），无需重装应用：

  1. 进入设置 → AI 引擎
  2. 点击「重新选择」按钮
  3. 确认后应用会重新进入向导流程，可重新选择档位
  4. 已下载的旧模型文件不会被删除，可手动清理

四、核心功能

主界面左侧有图标导航栏，对应各功能模块。核心模块始终可用，扩展模块可在设置中按需开启。

4.1 首页（仪表盘）

入口：左侧导航第一个图标

首页是您的工作总览，包含：

4.2 对话

入口：左侧导航第二个图标（对话气泡）

对话页面是贝叶树的核心交互界面，支持四种对话模式，可在输入框上方切换：

模式图标说明
对话💬普通自由对话，不检索知识库
搜索🔍本地知识库搜索，返回匹配文档片段
文档📚文档问答 — 检索相关文档后 AI 生成带引用的回答
助理🤖智能助理模式 — AI 可调用工具、执行操作、多步推理

使用方法

  1. 选择对话模式
  2. 在底部输入框输入您的问题
  3. 可以附加文件（图片或文档），支持拖拽或点击附件按钮
  4. AI 回答以流式方式实时显示

回答特性

角色选择

对话页面首次进入时可选择工作角色，AI 会根据角色推荐相关的工作场景卡片：

角色适用场景
个人助理日程、笔记、搜索、生活助手
运维检修助理设备诊断、缺陷记录、检修报告
调度助理操作票、故障分析、交班汇报
试验助理高压试验、标准查询、试验报告
行政助理公文、会议、报表、流程

对话管理

4.3 知识库

入口：左侧导航第三个图标（文件夹），包含「搜索」和「文件夹」两个标签页

搜索标签页

在搜索框输入关键词或自然语言问题，按回车搜索。

搜索结果包含：

操作：

文件夹标签页

管理知识库中索引的文件夹和文档。

顶部统计：显示文件夹数量和已索引文档总数

文件夹操作：

操作说明
添加文件夹选择新文件夹加入知识库（不允许添加符号链接目录）
更新增量索引 — 仅处理新增和修改的文件
重建清除该文件夹所有索引，完整重新索引
移除停止监控并清除索引（不影响原始文件）

文档状态指示：

颜色状态
绿色已成功索引
黄色正在处理中
红色索引失败
灰色等待处理

索引过程中会实时显示进度条和当前处理的文件名，可随时点击「停止」中断。

4.4 笔记

入口：左侧导航第四个图标（编辑图标）

笔记模块提供富文本编辑器，可以：

五、扩展功能

以下功能默认开启，可在 设置 → 功能模块 中关闭。

5.1 日程与待办

5.2 收藏

六、设置说明

入口：左侧导航最底部的齿轮图标

6.1 功能模块

可在此开启或关闭扩展功能模块：

模块类型默认说明
首页 / 对话 / 知识库 / 笔记 / 设置核心✓ 始终启用不可关闭
日程进阶✓ 默认开启日历、待办事项、提醒
收藏进阶✓ 默认开启网页收藏与管理

6.2 AI 引擎

设置项说明
对话模型用于问答的本地 AI 模型，从已下载模型列表中选择
重新选择档位重新进入向导，切换轻量/标准模式或重新下载模型
更换对话模型后设置即时生效，无需重启。

6.3 云端服务（可选）

设置项说明
DeepSeek API启用后可使用 DeepSeek 云端模型替代本地模型
API KeyAPI 密钥（加密存储，不会以明文写入磁盘）

6.4 系统状态

设置页面显示各组件运行状态：

状态项说明
对话引擎对话模型是否就绪
向量引擎文档索引模型是否已加载
重排序搜索结果重排序服务是否运行（可选，改善搜索精度）
文档解析PDF/Office 解析服务是否运行
已索引文档当前知识库中已索引的文档数量
数据目录索引数据存储路径（仅显示，可点击在文件管理器中打开）

6.5 数据管理

备份/恢复包含：笔记、日历、待办、设置、提醒、新闻订阅。不包含 AI 模型文件和文档索引（这些可从源文件重建）。

6.6 关于

七、存储与资源占用

7.1 存储说明

应用数据目录包含以下内容：

经验公式：索引数据约为原始文档的 1/5 ~ 1/4 大小。

7.2 内存占用

模式应用本体AI 推理推荐总内存
轻量~300MB~2-3GB8GB+
标准~400MB~4-5GB16GB+

7.3 数据目录位置

平台路径
macOS~/Library/Application Support/cn.beiyeshu/
Windows%APPDATA%\cn.beiyeshu\

八、安全与隐私

8.1 数据本地化

8.2 模型完整性校验

8.3 隐私清除

九、注意事项

9.1 关于 AI 引擎

9.2 关于索引

9.3 关于文件格式

9.4 关于图片理解

9.5 关于云端模型

十、常见问题与故障排除

Q1: 应用启动后 AI 引擎未就绪

原因：AI 模型尚未下载或引擎启动中

  1. 首次启动时，请等待模型下载完成
  2. 模型已下载的情况下，引擎通常在 10-15 秒内启动就绪
  3. 检查设置页面的系统状态面板，查看各组件是否变为绿色
  4. 如果持续未就绪，尝试重启应用

Q2: 重装应用后想换模型档位（如 标准型 → 轻量型）

原因：重装不会删除数据目录，原档位配置仍然存在

  1. 进入设置 → AI 引擎
  2. 点击「重新选择」按钮
  3. 确认后会重新进入向导，选择新档位
  4. 旧的模型文件不会自动删除，可在数据目录手动清理（可选）

Q3: 模型下载失败或校验失败

原因：网络中断、镜像故障，或文件被篡改

  1. 应用会自动尝试多个镜像下载
  2. 支持断点续传，重新下载即可
  3. 如果提示「模型文件校验失败」，说明文件被篡改，已自动删除，请重试
  4. 检查网络连接

Q4: 向量模型未加载

原因：索引模型未下载或引擎未启动

  1. 进入设置页面，检查"向量引擎"状态
  2. 如果模型未下载，运行"重新选择档位"
  3. 等待几秒钟后状态应自动刷新

Q5: PDF/Office 文件无法索引

原因：文档解析服务未运行

  1. 检查设置页面"文档解析"状态
  2. 重启应用（文档解析服务随应用自动启动）
  3. 纯文本文件 (.txt/.md) 不受影响

Q6: 搜索没有结果

  1. 文档尚未索引完成 → 前往知识库 → 文件夹标签页查看索引进度
  2. 搜索词太具体 → 尝试更通用的关键词或换种表达方式
  3. 文档格式不支持 → 检查是否为支持的格式（见第十一节）
  4. 向量模型未加载 → 检查设置页面"向量引擎"状态

Q7: AI 对话回答不准确

  1. 由于本地模型参数小，请尽量提出明确、具体的问题
  2. 使用「文档」模式确保 AI 基于知识库内容回答
  3. 确保相关文档已成功索引
  4. 参考回答下方的参考来源，点击查看原文验证

Q8: 应用占用存储空间太大

  1. 在知识库页面移除不需要的文件夹（会清除对应索引数据）
  2. 索引数据位于应用数据目录中，可手动查看占用情况
  3. 在「重新选择档位」时切换到轻量模式，可节省 ~2GB 模型空间

Q9: 图片无法识别

  1. 确认已下载视觉模型（在第二步选择档位时会一并下载）
  2. 重启应用使视觉模型生效
  3. 检查图片大小，单张图片建议不超过 10MB

Q10: 首次打开提示"无法验证开发者"（macOS）

  1. 前往系统设置 → 隐私与安全性
  2. 找到关于贝叶树的提示，点击「仍然打开」
  3. 再次启动应用

Q11: Windows 提示 SmartScreen 拦截

  1. 在 SmartScreen 警告界面，点击「更多信息」
  2. 然后点击「仍要运行」
  3. 后续打开不再提示

Q12: 数据备份恢复后某些功能异常

原因：备份不包含 AI 模型和索引数据

  1. 备份恢复后，模型文件需要重新下载
  2. 文档索引需要重新建立（在知识库页面点击文件夹的"重建"）
  3. 笔记、日历、待办等用户数据应正常恢复

十一、支持的文件格式

本地直接处理（无需额外服务）

格式扩展名说明
纯文本.txt所有文本编码
Markdown.md含标题层级解析

需要文档解析服务

格式扩展名说明
PDF.pdf支持文本提取、页码定位和图片识别
Word.doc, .docxMicrosoft Word 文档
Excel.xls, .xlsxMicrosoft Excel 表格
PowerPoint.ppt, .pptxMicrosoft PowerPoint 演示文稿
图片 (OCR).png, .jpg, .jpeg, .bmp, .tiff, .tif通过 OCR 识别图片中的文字
CAD.dxfAutoCAD 交换格式

对话中支持上传的文件

除上述格式外，对话中还可上传以下文件作为上下文：

格式扩展名
日志 / 配置.log, .csv, .json, .yaml, .yml, .xml
网页.html, .htm
图片.png, .jpg, .jpeg, .gif, .bmp, .webp, .tiff, .tif
对话中附加文件上限：10 个，单个文件不超过 10MB。

快捷键

快捷键功能范围
⌘+Shift+N / Ctrl+Shift+N快速记录窗口（提问 AI、记笔记、加待办）系统全局
⌘+K / Ctrl+K应用内全局搜索应用内
⌘+N / Ctrl+N新建笔记笔记页面
⌘+Enter / Ctrl+Enter发送对话消息对话页面

💡 如果 ⌘+Shift+N 与其他软件冲突无法注册，应用照常启动，仅该全局快捷键失效。

贝叶树 — 让知识触手可及，让隐私牢牢在手。


首页  |  隐私政策  |  用户协议

© 2024-2026 陕西和峰智电科技有限公司 保留所有权利