Lexicon 是一款本地优先的写作助手，提供无干扰的富文本编辑环境，集成了本地语法检查（LanguageTool）和可选的本地 AI 模型（用于重写、调整语气、总结等）。所有文字处理均在你的机器上完成，无需网络连接，无需账户，确保隐私安全。

1. 系统要求

  • 操作系统：支持 Windows、macOS 和 Linux。
    • Windows：x64、ARM64、x86 版本。
    • macOS：Apple Silicon (M系列) 和 Intel 版本。
    • Linux：.deb 和 .AppImage 格式（适用于 Debian/Ubuntu 等）。
  • 硬件：建议至少 4GB 内存。如果计划下载并使用本地 AI 模型（约 0.8-1.4 GB），请确保有足够的磁盘空间。
  • 网络：仅在首次下载 AI 模型时需要网络连接。后续使用完全离线。

2. 安装步骤

2.1 下载安装包

  1. 访问项目的 GitHub Releases 页面。
  2. 根据您的操作系统，下载对应的最新安装包：
    • Windows：下载 .exe 安装程序（根据系统选择 x64/ARM64/x86）。
    • macOS：下载 .dmg 文件（根据芯片选择 Apple Silicon 或 Intel）。
    • Linux：下载 .deb（Debian/Ubuntu 系）或 .AppImage 文件。

2.2 安装与首次启动

  • Windows：

    1. 双击运行下载的 .exe 文件，按照安装向导完成安装。
    2. 首次运行可能会触发 SmartScreen 或 Windows Defender 的警告（因为当前版本未进行代码签名）。这是正常现象。
      • 若出现 SmartScreen 警告，请点击 “更多信息”，然后选择 “仍要运行”。
      • 若被防病毒软件隔离，请确认下载来源（GitHub Releases）后，将文件从隔离区恢复并允许运行。

  • macOS：

    1. 打开下载的 .dmg 文件，将 Lexicon.app 拖入 Applications 文件夹。
    2. 由于当前版本未经过 Apple 公证，首次打开时 Gatekeeper 会阻止运行。
      • 解决方法：右键点击 Lexicon.app，在弹出菜单中选择 “打开”，然后再次点击 “打开” 即可。
      • 或在终端执行 xattr -cr /Applications/Lexicon.app 清除隔离属性。

  • Linux (.deb)：

    1
    sudo dpkg -i /path/to/lexicon.deb

2.3 首次启动配置

  1. 启动 Lexicon 后，您可以选择是否下载本地 AI 模型（语法检查功能不需要模型即可工作）。
  2. 如果选择下载，请从 Light（约 0.8 GB，更快） 和 Standard（约 1.4 GB，更强） 中选择一个。
  3. 等待下载完成。模型文件将存储在本地，后续启动无需再次下载。

3. 核心功能与使用

3.1 写作工作区

  • 富文本编辑：支持标题、列表、任务清单、链接、图片、代码块、表格、引用、文本对齐和高亮等。
  • 数学公式：支持行内和块级 LaTeX 数学公式，并有实时预览。
  • 快捷操作：通过 / 调用斜杠命令，使用键盘导航。
  • 个性化设置：可调整语言、字体大小、行距，并维护个人词典（自定义不被标记的词语）。

3.2 校对与审查 (Proofreading)

  • 本地语法检查：基于 LanguageTool，实时显示语法和拼写错误（带下划线）。
  • 建议卡片：点击错误处会显示建议修改卡片，可应用、忽略单个建议，或全部应用/全部忽略。
  • 语气检测：提供文本语气检测和可读性评分。

3.3 本地 AI 工具（需下载模型）

  • 重写与精简：对选中文本进行重写或精简。
  • 语气调整：一键将文本转换为友好、专业、学术、正式、随意、幽默等风格。
  • 内容转换：对文档生成摘要、提取要点、创建列表或表格。
  • 长文档支持：对长文档进行分块处理，并显示处理进度。

3.4 导入与导出

  • 导入：支持 .txt、.md、.markdown、.html 和 .htm 文件。
  • 导出：支持导出为 HTML、纯文本、Markdown 或 PDF（PDF 导出会生成干净的手稿风格文档，去除应用界面和校对标记）。

4. 高级配置与开发

4.1 使用外部 Ollama 服务

Lexicon 也可以连接到您本地已运行的 Ollama 服务，使用其提供的模型进行 AI 操作，而无需下载内置模型。

4.2 从源码运行（面向开发者）

如果您想从源代码运行或开发，请遵循以下步骤：

  1. 克隆仓库：

    1
    2
    git clone https://github.com/AashishH15/Lexicon.git
    cd Lexicon

  2. 一键启动（推荐）：

    • macOS/Linux：在项目根目录运行 ./start.sh。
    • Windows：在项目根目录运行 .\start.bat。
    • 这些脚本会自动设置后端环境、安装依赖，并启动前端和后端服务。

  3. 手动启动：

    • 后端 (Backend)：

      1
      2
      3
      4
      5
      6
      cd backend
      python -m venv venv
      source venv/bin/activate  # macOS/Linux
      # 或 venv\Scripts\activate # Windows
      pip install -r requirements.txt
      uvicorn main:app --reload --port 8000

    • 前端 (Frontend)（在另一个终端）：

      1
      2
      3
      cd frontend
      npm ci
      npm run dev

  4. 访问 http://localhost:5173 即可使用开发版。

5. 常见问题排查

问题 可能原因 解决方案
Windows 安装被 SmartScreen/防病毒软件阻止 应用未进行代码签名，触发信誉度警告 1. 确认从官方 GitHub Releases 下载。2. 点击“更多信息”->“仍要运行”。3. 如被隔离，手动从隔离区恢复。
macOS 提示“无法打开，因为无法验证开发者” 应用未经过 Apple 公证 右键点击应用图标，选择“打开”，然后确认打开。或使用终端命令 xattr -cr /Applications/Lexicon.app。
AI 工具无响应或报错 本地 AI 模型未下载或未正确加载 1. 在设置中检查模型下载状态。2. 可尝试重新下载模型。3. 如果使用 Ollama，确认 Ollama 服务正在运行。
语法检查功能不工作 LanguageTool 后端未启动或出错 检查应用日志（如有），重启应用。确保系统安装了 Java（打包版本自带，从源码运行需要 Java）。
应用占用大量存储空间 下载了 AI 模型文件 模型文件（0.8-1.4 GB）存储在用户应用数据目录。可在设置中查看并考虑删除以释放空间，但 AI 功能将不可用。

6. 总结

Lexicon 是一款为隐私保护和离线使用而设计的写作工具。

核心使用路径：

  1. 下载：从 GitHub Releases 获取符合您系统的安装包。
  2. 安装与信任：绕过操作系统对未签名应用的警告（确认来源安全后）。
  3. 首次配置：选择是否下载本地 AI 模型，并等待完成。
  4. 日常写作：利用富文本编辑器、实时校对、AI 重写和语气调整功能。

建议：先不下载 AI 模型，体验基础的语法检查功能。如果确实需要 AI 辅助，再在设置中下载模型。所有下载的文件都保存在本地，您始终掌握自己的数据。

项目地址：https://github.com/AashishH15/Lexicon