AI Reader V2

桌面应用安装

AI Reader V2 提供基于 Tauri 2 构建的原生桌面客户端，支持 macOS 和 Windows 平台。桌面应用将前端界面和 Python 后端打包为一体，无需单独配置开发环境即可使用。

概述

桌面应用包含以下特性：

  • 原生窗口：系统级窗口管理，原生标题栏
  • 自定义图标：书籍 + 知识图谱设计的应用图标
  • .air 文件关联：双击 .air 文件即可直接导入
  • 完整功能：与网页版完全一致的 12 个功能页面（阅读、图谱、地图、时间线、百科、势力、导出等）
  • 主题切换：浅色/深色/跟随系统
  • 版本检查：自动检测 GitHub 新版本

下载

平台 下载 架构
macOS AI Reader_0.51.0_aarch64.dmg Apple Silicon (M1/M2/M3/M4)
Windows AI Reader_0.51.0_x64-setup.exe x86_64

更多版本请查看 GitHub Releases 页面。

macOS 安装

标准安装

  1. 下载 .dmg 文件
  2. 双击打开 .dmg
  3. 将 AI Reader 拖入"应用程序"文件夹
  4. 从"应用程序"文件夹或 Launchpad 启动

Gatekeeper 安全提示

首次打开时，macOS 可能提示"无法打开"或"已损坏"。这是因为应用未经 Apple 签名。解决方法：

方法一：终端命令（推荐）

xattr -cr "/Applications/AI Reader.app"

执行后再次双击即可正常打开。

方法二：右键打开

  1. 在"应用程序"中找到 AI Reader
  2. 右键点击（或 Control + 点击）
  3. 选择"打开"
  4. 在弹出对话框中点击"打开"

Windows 安装

标准安装

  1. 下载 .exe 安装包
  2. 双击运行安装程序
  3. 按提示完成安装（支持"仅当前用户"和"所有用户"两种模式）

SmartScreen 安全提示

首次运行时，Windows SmartScreen 可能弹出保护提示（应用未经 Microsoft 签名）：

  1. 点击"更多信息"
  2. 点击"仍要运行"

技术架构

Python Sidecar

桌面应用通过 PyInstaller 将 FastAPI 后端打包为独立二进制文件（约 75MB），作为 sidecar 进程随应用启动和退出。

  • 冷启动：首次启动约需 30 秒（PyInstaller 解压临时文件），请耐心等待
  • 热启动：后续启动速度显著加快，通常数秒内完成
  • 端口分配：自动选择可用随机端口，避免冲突
  • 健康检查：启动后 60 秒内持续检查后端服务状态
  • 退出清理：关闭应用时自动终止 sidecar 进程

桌面版与网页版的区别

方面 桌面版 网页版
安装方式 下载安装包 git clone + 启动前后端
后端管理 自动启动/停止 需手动运行 uvicorn
功能范围 完全一致 完全一致
LLM 配置 应用内设置 环境变量或应用内设置
适用人群 普通用户 开发者、需要自定义的用户

两个版本共享相同的 12 个生产页面，功能完全对等。桌面版的优势在于开箱即用，无需配置 Python 和 Node.js 开发环境。

注意事项

  • 桌面应用仍需本地安装并运行 Ollama（除非使用云端 LLM 模式）
  • 数据存储路径与网页版相同：~/.ai-reader-v2/data.db
  • 更新桌面应用不会影响已有的分析数据