内容
# Snaptium
<div align="center">
**语言 / Language:** [English](README.md) | [简体中文](README_CN.md)
</div>
<div align="center">
<img src="electron/assets/logo/app-logo-128.png" alt="Snaptium Logo" width="88">
# Snaptium
**提示:NoteWizard 已全面升级为 Snaptium。如果您需要使用之前的 NoteWizard 版本,请从 [此处](https://github.com/jetyu/Snaptium/releases/tag/v1.2.1) 下载。**
[官方网站](https://snaptium.com) [官方文档](https://snaptium.com/docs) [下载](https://snaptium.com/#download)
### 优先本地化的 Markdown 智能写作与知识管理空间
一个基于 Electron + Vue 3 构建的现代化跨平台 Markdown 智能工作空间。
专注于深度写作、知识管理和本地优先体验,支持 AI 辅助写作、知识库、端到端加密同步和多设备协作。
[](https://github.com/jetyu/Snaptium/actions/workflows/build.yml)
[](https://github.com/jetyu/Snaptium/releases/latest)

[](https://github.com/jetyu/Snaptium/releases)






[]()
[]()
[](https://github.com/jetyu/Snaptium/blob/main/LICENSE)
</div>
# ✨ 项目定位
Snaptium 不仅仅是一款 Markdown 笔记工具。
它是一个围绕“长期写作、知识积累和本地 AI 工作流”构建的智能写作空间。
项目强调:
- **本地优先**
- **数据主权**
- **长期可持续存储**
- **AI 辅助,而非 AI 锁定**
- **离线可用性**
- **一致的多平台体验**
---
# 🚀 核心功能
## 📝 Markdown 智能写作
- 基于 CodeMirror 的现代化编辑器
- 实时 Markdown 渲染预览
- 编辑器和预览同步滚动
- 数学公式(KaTeX)支持
- 代码高亮支持
- 任务列表 / 表格 / 脚注 / 标记语法支持
- 暗黑模式和沉浸式写作体验
---
## 🤖 AI 智能辅助
支持与多个 AI 服务集成,用于:
- AI 辅助写作
- 内容润色
- 智能问答
- 文档摘要
- 请教知识管家(RAG)
- 语义搜索
支持自定义模型和 API:
- OpenAI
- OpenRouter
- DeepSeek
- Gemini
- Claude
- Ollama(本地模型)
- 与 OpenAI API 兼容的第三方服务
> 默认情况下,AI 功能处于禁用状态。所有 AI 功能均由用户手动配置。
---
## 🔒 优先本地 & 隐私安全
Snaptium 设计采用本地优先架构:
- 默认本地存储
- 无强制登录
- 不依赖中心化服务器
- 用户完全控制数据
支持:
- AES-256-GCM 本地加密
- 工作空间密码
- 恢复密钥
- 端到端加密同步(E2EE)
即使使用对象存储进行同步,也只在云端存储加密数据。
---
## ☁️ 云同步支持
支持多种同步方式:
- S3 兼容对象存储
- Cloudflare R2
- WebDAV
- MinIO
- NAS 私有存储
支持完全自主托管和私有同步。
---
## 🧠 本地知识库(RAG)
内置向量知识库能力:
- 文档分块
- 向量嵌入
- 语义搜索
- 本地知识索引
- 基于知识库的 AI 问答
集成:
- LanceDB
- Apache Arrow
未来支持本地 Embedding 模型和离线 AI 工作流。
---
## 🌍 国际化
支持 18 种语言和地区设置。
目前支持:
- 简体中文
- 英语
- 日语
- 韩语
- 德语
- 法语
- 西班牙语
- 俄语
- 更多语言正在添加中...
---
# 🖼️ 预览
## 编辑模式

## 仅预览

## 智能写作(点击播放)
<video src="https://github.com/user-attachments/assets/9dd6fa86-5c0c-4a3e-93ed-f11acaa73ae2"></video>
## 知识库(点击播放)
<video src="https://github.com/user-attachments/assets/62be0260-8d7f-438c-a8d1-1d3101b3ae4d.mp4"></video>
# 🧩 技术栈
## 前端
- Vue 3
- TypeScript
- Vite
- Pinia
- Vue I18n
- CodeMirror 6
## 桌面端
- Electron
- Electron Builder
- Electron Updater
## Markdown 生态
- markdown-it
- KaTeX
- highlight.js
## AI / 数据能力
- LanceDB
- Apache Arrow
- AWS SDK S3
- WebDAV
---
# 💻 支持平台
| 操作系统 | 支持版本 | 架构 | 安装格式 |
|------|------|------|------|
| 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
```
---
# 📚 文档 & Wiki
- Wiki: https://github.com/jetyu/Snaptium/wiki
- 文档: https://github.com/jetyu/Snaptium/tree/feature/snaptive/docs
---
# 📌 路线图
未来计划包括:
- 本地 AI 模型集成
- AI Agent 工作流
- 多工作空间管理
- 协同编辑
- 插件系统
- 移动端支持
- 更完整的离线知识库能力
---
# 📄 许可证
该项目使用 Apache License 2.0 许可。
详情请参考:
```text
LICENSE
```
---
# ❤️ 致谢
感谢以下优秀的开源项目:
- Electron
- Vue
- CodeMirror
- markdown-it
- KaTeX
- LanceDB
- Apache Arrow
以及所有为 Snaptium 提交 Issues、PR 和建议的开发者和用户。
<img width="120" src="https://s2.loli.net/2025/09/10/KWPOA5XhIGmYTV9.png" />
特别感谢 [SiliconFlow](https://siliconFlow.com) 为 Snaptium 提供 AI 模型服务支持。
---
# ⭐ 星历史
[](https://star-history.com/#jetyu/Snaptium&Date)
连接信息
猜你喜欢
暂无推荐服务器