# drip-note

**Repository Path**: ggtool/drip-note

## Basic Information

- **Project Name**: drip-note
- **Description**: Drip Note 一款本地优先、打开就能写的轻量笔记本。
- **Primary Language**: Rust
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-22
- **Last Updated**: 2026-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="right">
  简体中文 | <a href="./README.en.md">English</a>
</p>

# Drip Note

一款本地优先、打开就能写的轻量笔记本。

Drip Note 面向的是日常高频记录：临时想法、工作资料、技术笔记、长文草稿，都应该能在一个安静、快速、可控的桌面应用里完成。它不把自己做成复杂的知识平台，而是先把“写下来、找得到、不会丢、不卡顿”这几件事做到顺手。

![Drip Note 主界面](./drip-note.png)

## 产品定位

Drip Note 当前版本聚焦个人本地笔记场景：

- 打开应用后直接进入笔记列表和编辑区，减少无关入口。
- 数据默认保存在当前执行目录，便于备份、迁移和随程序一起携带。
- 支持纯文本和 Markdown 两种笔记类型，覆盖便签式记录和结构化文档。
- 使用树形目录组织内容，适合按项目、主题、时间线逐层沉淀。
- 提供图标和标签作为轻量属性，不引入复杂的元数据管理负担。

## 核心体验

### 1. 本地优先

笔记数据存储在本地 `drip-note.db` 中。应用不依赖账号体系和云端服务，适合个人资料、工作草稿和离线环境使用。

### 2. 两种笔记类型

- 纯文本：适合快速记录、便签、清单、临时内容。
- Markdown：适合技术文档、长文、代码片段和结构化知识。

### 3. 树形笔记管理

左侧目录支持多级节点，右键可新建、重命名、移动、编辑属性和删除。删除节点时会校验是否存在子节点，有下级内容时不会直接删除，避免误操作。

### 4. 自动保存

编辑内容进入统一保存队列。常规输入会自动保存，切换笔记、窗口失焦、关闭窗口等关键时机也会强制保存一次，降低手动保存的心智负担。

### 5. 图标与标签

每个笔记节点可以配置图标和标签。图标选择器内置多分类图标库，适合快速区分项目、资料、任务、技术、媒体等不同类型内容。

### 6. 轻量桌面体验

应用基于 Tauri 构建，窗口、主题和编辑区围绕桌面笔记场景设计。浅色和深色主题可切换，整体界面保持克制，优先服务长期写作和查阅。

## 适合谁

- 需要一个本地资料库的开发者。
- 想把工作记录、项目资料和临时想法放在一起管理的人。
- 不希望笔记工具绑定账号、订阅或复杂云服务的个人用户。
- 偏好 Markdown，但又希望保留纯文本快速记录体验的用户。

## 当前边界

Drip Note 现阶段优先做好本地笔记本能力。同步、发布、协作等能力会在产品体验稳定后再逐步设计，避免过早引入复杂平台功能。

## 技术栈

- 桌面容器：Tauri v2
- 前端：Vue 3、TypeScript、Vite、Pinia
- UI：Ant Design Vue
- 编辑器：md-editor-v3
- 数据库：SQLite，基于 Tauri SQL 插件

## 开发运行

```bash
pnpm install
pnpm tauri dev
```

## 构建

```bash
pnpm build
pnpm tauri build
```

## 发布构建

项目内置 GitHub Actions 发布构建配置。推送任意 Git tag 后，会自动构建 Tauri 安装包并创建草稿 Release：

```bash
git tag v0.1.0
git push origin v0.1.0
```

## 数据文件

编译后的程序会优先使用执行文件同目录下的 `drip-note.db`。迁移数据时，将 `drip-note.db` 与程序放在同一目录即可。

## License

MIT License