Snaptium
English · 简体中文
AI智能体驱动Markdown笔记软件
官方网站 ·
使用文档 ·
下载 Snaptium
Snaptium 是一款跨平台 AI Markdown 笔记与知识管理软件，集成 CodeMirror 6 编辑器、AI 辅助写作、本地向量知识索引、RAG 知识库问答、快速记录，以及基于 WebDAV/S3 的端到端加密同步。
笔记默认保存在本地，可自定义存储路径，并支持 Markdown 导入导出。Snaptium 可运行于 Windows、macOS 和 Linux 主流桌面操作系统平台，同时支持云端 AI 服务与 Ollama 本地模型。
> 如果 Snaptium 对你有帮助，欢迎为项目添加 Star，让更多人发现这个项目。
> **NoteWizard 用户：** NoteWizard 已升级为 Snaptium，旧版本仍可从 [NoteWizard v1.2.1 发布页](https://github.com/jetyu/Snaptium/releases/tag/v1.2.1)下载。
## 目录
- [为什么选择 Snaptium](#为什么选择-snaptium)
- [核心功能](#核心功能)
- [界面与演示](#界面与演示)
- [技术栈](#技术栈)
- [支持平台](#支持平台)
- [下载](#下载)
- [本地开发](#本地开发)
- [常见问题](#常见问题)
## 为什么选择 Snaptium
Snaptium 并不仅仅是一款 Markdown 笔记工具。它更像是一个围绕「长期写作、知识沉淀与本地 AI 工作流」构建的智能写作空间。
项目强调：
- 本地优先（Local First）
- 数据自主可控
- 长期可持续存储
- AI 辅助而非 AI 绑定
- 可离线使用
- 多平台一致体验
---
## 核心功能
| 能力 | 简要说明 |
|------|----------|
| ✍️ 沉浸式 Markdown 编辑体验 | 基于 CodeMirror 6 构建高性能编辑器，支持实时预览、同步滚动、任务列表、表格编辑、代码块渲染、自定义快捷键等能力，并完整兼容标准 Markdown 工作流 |
| 📐 强大的数学公式支持 | 集成 KaTeX 高性能数学渲染引擎，支持行内公式与块级公式，覆盖分数、根式、上下标、求和、积分、矩阵等常用 LaTeX 数学表达场景 |
| 💻 专业的代码编辑体验 | 内置 24+ 种代码语法高亮、40+ 常用语言别名自动识别，支持 JavaScript、TypeScript、Python、Java、Go、Rust、C/C++、SQL、Shell 等主流开发语言，并提供代码块增强体验 |
| 📊 丰富的图表与可视化能力 | 内置 Mermaid 图表渲染能力，支持流程图、时序图、类图、状态图、甘特图等多种技术文档可视化场景，让 Markdown 文档具备专业文档表达能力 |
| 🤖 AI 智能写作助手 | 提供多维度 AI 写作能力，支持 3 种写作强度、5 种文风模式和 7 类写作场景，可用于技术文档、产品方案、会议总结、内容创作、知识整理等多种任务 |
| 🌐 多模型 AI 生态支持 | 提供免费额度官方 AI 服务，同时支持 12+ 主流 AI 服务平台（BYOK），包括 OpenAI、Gemini、DeepSeek、OpenRouter、硅基流动、通义千问、豆包、Kimi、智谱 AI、Grok、Ollama 以及 OpenAI 兼容 API，让用户自由选择适合自己的模型能力 |
| 🧠 本地知识库与 AI 智能体 | 基于 LangChain 构建知识增强系统，通过本地笔记索引、向量检索、语义搜索、可选重排序（Rerank）以及 Ask / Agent 模式，实现基于个人知识库的智能问答与任务处理 |
| 🔍 混合式智能搜索 | 融合传统全文搜索与 AI 语义检索能力，不仅能够快速定位关键词内容，还可以理解用户意图，从长期积累的海量笔记中发现隐藏关联知识 |
| 🔐 Local-first 数据安全架构 | 坚持本地优先理念，笔记默认存储于用户设备，无需注册账号即可使用；支持 AES-256-GCM 加密、工作区密码保护和恢复密钥机制，确保个人知识完全由用户掌控 |
| ☁️ 端到端加密同步 | 支持 WebDAV、Amazon S3、Cloudflare R2、MinIO、NAS 等多种存储方案，通过端到端加密实现跨设备同步，同时支持自托管私有存储方案 |
| 🗂️ 灵活的知识组织体系 | 支持笔记本、标签、收藏等多维度内容管理方式，内置空白笔记、日记、会议记录、阅读笔记、项目计划、任务清单等 6 类模板，提高知识记录效率 |
| ⚡ 快速捕捉与效率工具 | 支持系统托盘运行、全局快捷键快速创建笔记，让用户能够随时记录灵感、会议内容和临时想法，降低知识流失成本 |
| 🕒 历史版本与数据恢复 | 提供50个版本历史管理与回收站机制，支持查看笔记历史修改记录、恢复误删除内容，保障长期知识资产安全 |
| 🔄 开放的数据迁移能力 | 支持 Markdown 与 Snaptium 数据包导入导出，同时支持 印象笔记ENEX 导入以及单篇笔记 PDF 导出，降低迁移成本 |
| 🎨 深度个性化体验 | 支持 5 种主题色，3 种主题模式，和 14 套字体选择，编辑器、预览界面和应用 UI 均可独立配置，满足深度个性化需求 |
| 🌍 跨平台与国际化支持 | 基于跨平台桌面架构，支持 Windows、macOS、Linux 三大操作系统，并提供 13 种语言与地区设置，为全球用户提供一致的使用体验 |
| 🛠️ 完善的诊断与维护能力 | 支持导出包含运行日志、系统环境、应用版本、授权状态等信息的诊断报告，帮助用户快速反馈问题并提升故障排查效率 |
> AI 功能默认关闭，模型和 API 均由用户主动配置。
---
## 界面与演示
### Markdown 编辑模式
### Markdown 阅读预览
### AI 智能写作演示
[](https://github.com/jetyu/Snaptium/blob/main/docs/Screenshots/v2/en-US/SmartWriting.mp4)
### 知识库演示
[](https://github.com/jetyu/Snaptium/blob/main/docs/Screenshots/v2/en-US/KnowledgeBase.mp4)
---
## 技术栈
### 前端
- Vue 3.5.38
- TypeScript 6.0.3
- Vite 8.0.16
- Pinia 3.0.4
- Vue I18n 11.4.5
- CodeMirror 6
### 桌面端
- Electron 43.2.0
- Electron Builder 26.15.3
- Electron Updater 6.8.9
### Markdown 生态
- markdown-it
- KaTeX
- highlight.js
### AI 与数据能力
- LanceDB
- Apache Arrow
- AWS SDK S3
- WebDAV
- LangChain
- Ollama
---
## 支持平台
| 操作系统 | 支持版本 | 架构 | 安装包格式 |
|------|------|------|------|
| Windows | Windows 10 及以上 | x64 | `.exe` |
| macOS | macOS 11+ | arm64 | `.dmg` |
| Linux | Ubuntu / Debian / Fedora 等主流发行版 | x64 | `.deb` `.rpm` `.AppImage` |
> 请根据对应平台下载适合的安装包。
---
## 下载
### Windows
[](https://github.com/jetyu/Snaptium/releases/latest/download/Snaptium-Windows-x64.exe)
---
### macOS
#### Apple Silicon
[](https://github.com/jetyu/Snaptium/releases/latest/download/Snaptium-macOS-arm64.dmg)
---
### Linux
#### Debian / Ubuntu
[](https://github.com/jetyu/Snaptium/releases/latest/download/Snaptium-Linux-x64.deb)
#### Fedora / RHEL
[](https://github.com/jetyu/Snaptium/releases/latest/download/Snaptium-Linux-x64.rpm)
#### AppImage
[](https://github.com/jetyu/Snaptium/releases/latest/download/Snaptium-Linux-x64.AppImage)
---
> [查看全部版本](https://github.com/jetyu/Snaptium/releases)
---
## 本地开发
### 安装依赖
```bash
npm install
```
### 启动开发环境
```bash
npm run dev
```
### 构建应用
```bash
npm run dist
```
按平台构建：
```bash
npm run dist:win
npm run dist:mac
npm run dist:linux
```
### 验证修改
```bash
npm run typecheck
npm run lint
npm run test:unit
```
---
## 文档与 Wiki
- Docs：https://snaptium.com/docs
---
## 常见问题
### Snaptium 是本地优先的 Markdown 笔记软件吗？
是。笔记默认保存在本地，存储路径可以自定义，核心编辑功能不要求用户必须登录。
### Snaptium 支持本地 AI 模型吗？
支持。Snaptium 可接入 Ollama 本地模型，也支持 OpenAI、Gemini、DeepSeek、OpenRouter、SiliconFlow 以及其他兼容 API。AI 功能默认关闭，需要由用户主动配置。
### Snaptium 支持哪些笔记导入导出格式？
支持 Markdown 和原生 `.sppx` 数据包导入导出、Evernote `.enex` 导入，以及单篇笔记 PDF 导出。
### Snaptium 支持加密同步吗？
支持。Snaptium 可通过 WebDAV 和 S3 兼容对象存储进行端到端加密同步，包括 Cloudflare R2、MinIO 和私有 NAS 存储。
### Snaptium 是开源软件吗？
是。Snaptium 使用 Apache License 2.0 开源协议。
## 项目路线
未来计划包括：
- 协作编辑
- 插件系统
- 移动端支持
- 更完整的离线知识库能力
---
## 开源协议
本项目采用 Apache License 2.0 开源协议。
详情请参阅：
```text
LICENSE
```
---
## 致谢
感谢以下优秀开源项目：
- Electron
- Vue
- CodeMirror
- markdown-it
- KaTeX
- LanceDB
- Apache Arrow
以及所有为 Snaptium 提交 Issue、PR 与建议的开发者与用户。
特别感谢 [硅基流动 SiliconFlow](https://siliconFlow.com) 对 Snaptium 的支持，为产品提供 AI 模型服务能力。