Skip to content

ahpxex/Aictionary

Repository files navigation

Aictionary

快速且异常好用的词典 App,基于 Tauri 2 + React,提供本地离线词库和可选大模型释义,专注于「查词体验」这件小事。

image

功能特性

  • 详细易懂的中文释义
    基于开源英汉词库和自定义处理,释义不仅给出“意思”,还尽量解释用法、语境和常见搭配。

  • 快速离线查询
    常用高频词会预先缓存到本地,即使离线也能秒开释义;词库更新通过 GitHub Release 一键下载。

  • 大语言模型驱动补充释义
    当本地词库没有某个词条时,可以调用配置好的 LLM(如 OpenAI 等)生成一份中文解释和例句,适合技术 / 学术场景。

  • 跨平台桌面应用
    基于 Tauri 框架,提供 Windows / macOS / Linux 原生安装包(dmg / msi / AppImage 等)。

  • 使用统计与个人词库
    记录查词历史、频次等统计信息,帮助你回顾高频生词、构建个人词库。

  • 细节体验优化

    • 支持键盘快捷键快速打开 / 关闭、查询当前剪贴板内容等;
    • 查询记录自动缓存,可随时刷新词条以获取最新释义;
    • 主题、语言、LLM 提供商、快捷键等都可在设置里集中配置。

下载与安装

从 GitHub Releases 安装

前往项目的 Releases 页面,每次发布都会为不同平台生成对应安装包,命名规则统一为:

Aictionary-[version]_[os]_[arch].[extension]

常见示例:

平台 架构 文件名示例 说明
macOS arm64 Aictionary-0.1.0_macos_arm64.dmg Apple 芯片(M1/M2/M3…)
macOS x86_64 Aictionary-0.1.0_macos_x86_64.dmg Intel 芯片 Mac
Windows x86_64 Aictionary-0.1.0_windows_x86_64.msi 优先提供 MSI 安装包
Windows x86_64 Aictionary-0.1.0_windows_x86_64.exe 若无法生成 MSI,则提供 NSIS 安装器
Linux x86_64 Aictionary-0.1.0_linux_x86_64.AppImage 通用 AppImage 可执行包

macOS

  1. 下载对应架构的 .dmg 文件;
  2. 打开 dmg,将 Aictionary 拖入 Applications 即可;
  3. 首次运行如遇到 Gatekeeper 提示,可在「系统设置 → 隐私与安全性」中允许打开。

Windows

  1. 优先下载 .msi 安装包;若 Release 中只有 .exe,则下载该安装器;
  2. 双击运行并按提示完成安装;
  3. 安装完成后可在开始菜单中搜索 Aictionary 启动。

Linux(AppImage)

  1. 下载 .AppImage 文件,例如 Aictionary-0.1.0_linux_x86_64.AppImage

  2. 赋予可执行权限并运行:

    chmod +x Aictionary-0.1.0_linux_x86_64.AppImage
    ./Aictionary-0.1.0_linux_x86_64.AppImage

初次使用,建议在「设置 → 词典与 LLM」中:

  • 先下载/更新本地词库(会通过内置下载器从 GitHub 拉取 zip 并自动解压);
  • 再配置 LLM 提供商与 API Key,当本地词库缺少词条时会自动调用大模型补充中文释义。

使用提示

  • 键盘操作优先
    应用尽量为常用操作提供快捷键(查词、切换结果、刷新词条等),阅读英文资料时几乎不需要鼠标。

  • 本地缓存与历史记录
    所有查过的词都会写入本地缓存,可离线查看;支持按需刷新,确保释义与在线词库同步。

  • 统计与复习
    统计页面展示一段时间内的查词量、高频生词等,适合作为「背单词/复习清单」。

  • 界面与语言
    支持深浅色主题切换、强调色选择,以及中英文界面(基于 react-i18next),都在设置中配置。


技术栈

  • 前端

    • React 19
    • Vite
    • TypeScript
    • Tailwind CSS v4 + shadcn/ui
    • Jotai(集中设置状态管理)
    • react-hook-form + zod 表单校验
    • react-router v7
  • 桌面端 / 后端

    • Tauri 2(Rust + WebView)

开发构建

环境准备

根据 Tauri 2 官方文档,需要:

  • 通用

    • Node.js / Bun
    • Rust(stable toolchain)
    • Tauri CLI(本项目通过 devDependencies 已内置)
  • Linux 额外依赖(Debian/Ubuntu):

    sudo apt-get update
    sudo apt-get install -y \
      libwebkit2gtk-4.0-dev \
      libwebkit2gtk-4.1-dev \
      libappindicator3-dev \
      librsvg2-dev \
      patchelf

启动开发环境

# 安装依赖
bun install

# 启动前端开发服务器(Vite)
bun run dev

# 启动 Tauri 开发模式(桌面窗口)
bun tauri dev

一般情况下直接运行 bun tauri dev 即可,它会按照 src-tauri/tauri.conf.json 中的配置先执行 bun run build / 使用 dev server。

构建发行版

# 构建当前平台的 Tauri 安装包
bun tauri build

构建完成后,Tauri 的所有原始产物都会放在:

  • src-tauri/target/release/bundle/

GitHub Actions 会在 CI 中对 macOS / Windows / Linux 分别执行构建,并将这些文件重命名为:

  • Aictionary-[version]_[os]_[arch].[extension]

然后自动上传到 GitHub Release。


反馈与贡献

  • 欢迎通过 Issues 反馈 Bug 或功能建议;
  • 也非常欢迎 PR
    • 尽量附上改动说明或截图,方便快速 Review;
    • 用户可见文案请记得同步更新中/英翻译;
  • 对以下方向感兴趣都可以一起讨论:
    • 扩展或替换词库来源;
    • 支持更多平台或打包格式;
    • 接入新的 LLM 提供商,优化释义风格或对话能力。

感谢使用 Aictionary,愿它能让你的查词过程更轻松一点点。

About

一个桌面词典:快速、简洁,并且真的让你学会英语

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published