Mini Diarium

一款仅本地运行的日记应用，配备严谨的加密保护。 免费、开源，绝不联网。

mini-diarium.com · 下载 · 文档 · 功能特性 · 理念 · 性能基准

☕ 支持本项目

Mini Diarium 免费、开源，并将永远如此。如果你觉得它有用，并想支持它的开发，可以考虑在 Ko-fi 上请我喝杯咖啡。每一笔捐赠都会直接用于维持项目存续并推动改进。

更偏好加密货币？门罗币、比特币和闪电网络地址见下方及 DONATE.md。

4ApNmqczyAoWsprSrCMsPNKTGhxaH1Cs6agLVaGiKuBBVSotWK9uj3oVQkWYUX9XUGQJyC9WB7cMofE8wfp5BbUoEdcwbjv

bc1q0y6v888ala2f8r7tm8g30vqt9ma09w9ww4jhum

[email protected]

下载

从 GitHub Releases 下载适用于你平台的最新版本。

需要 Windows 10（1809+）、macOS 10.15 Catalina+，或 Linux（Ubuntu 20.04+、Fedora 36+、Arch 或同等发行版）。

快速安装：

• Windows（Microsoft Store）：apps.microsoft.com/detail/9PJFTX44ZS43
• Windows（WinGet）：winget install fjrevoredo.MiniDiarium
• macOS（Homebrew）：先执行 brew tap fjrevoredo/mini-diarium，再执行 brew install --cask mini-diarium
• Linux（Flatpak）：flatpak install flathub io.github.fjrevoredo.mini-diarium
• NixOS / Nix（Flakes）：nix run github:fjrevoredo/mini-diarium

关于软件包格式、首次运行注意事项（Gatekeeper / SmartScreen）以及校验和验证，请参阅 docs/INSTALLATION.md。

快速上手

1. 启动 Mini Diarium
2. 创建密码（此举会加密你的日记；如果忘记，将无法找回）
3. 写下你的第一篇日记。输入时会自动保存
4. 使用 Ctrl+[ / Ctrl+] 在日期之间切换，或点击日历上的日期
5. 完成后锁定你的日记

背景

Mini Diarium 是 Samuel Meuli 所著 Mini Diary 的精神继承者。我很喜欢原来的那个工具。它简单、私密，完全做到了日记应用该做的事。遗憾的是，它已经多年无人维护，依赖项也早已老化过时。我最初考虑过 fork 它并现代化技术栈，但后来发现这并不现实。于是我从零开始重写，在保留相同核心理念（加密、仅本地、专注）的同时，用 Tauri 2、SolidJS 和 Rust 彻底重建。最终成果是一款更轻量、更快速的应用，拥有更强的加密和一些个人化的细节。

理念优先

Mini Diarium 刻意坚持自己的设计主张。设计理念不是附注，它本身就是产品：

• 小巧、可扩展的核心：保持核心职责精简（加密、存储、认证），将额外功能推向扩展点
• 朴素可靠的安全方案：使用成熟的算法和经过审计的库，绝不采用自研加密
• 设计上仅限本地：无云同步、无遥测、无分析、无隐藏网络行为
• 进出自由：从常见格式导入，以开放格式导出，避免被锁定
• 范围专注：优先私密日记，而非功能堆砌
• 宁简勿巧：更少的活动部件、更小的攻击面、更易维护

完整的理念以及这些理念如何转化为架构，请参阅 PHILOSOPHY.md。

[!NOTE] Mini Diarium 将 AI 工具用作人类工程师的助力，而非替代品。每一项更改仍然要经过深思熟虑的设计、审慎的实现、充分的测试和直接的反馈。责任、署名权和最终判断始终归于人类。

功能特性

• 密钥文件认证：使用 X25519 私钥文件代替（或配合）密码来解锁你的日记，就像为你的日记配备 SSH 密钥。参见 docs/KEY_FILE_AUTHENTICATION.md。
• 仅限本地的日记：创建可在设备上自动解锁（无密码提示）的日记，同时仍对静态存储的条目进行加密。
• AES-256-GCM 加密：所有条目均使用随机主密钥加密。每种认证方式都持有该密钥的独立封装副本，因此添加或移除一种认证方式的复杂度为 O(1)，且无需重新加密你的条目。
• 多日记管理：为不同用途（个人、工作、旅行）分别保存独立的日记。
• 富文本编辑器：支持插入图片。
• 标签
• 每天多篇条目：同一天可保留多篇独立条目，而不会合并到一起
• 日历导航
• 导入：支持 Mini Diary JSON、Day One JSON/TXT 和 jrnl JSON，采用增量导入，保留同一天内相互独立的条目
• 导出：JSON 用于结构保真，Markdown 用于尽力而为的可读导出
• 主题
• 自动备份：在迁移和破坏性操作之前创建经过验证的加密快照，并采用分层保留策略，可回溯一年
• 统计
• 偏好设置：每周起始日、未来条目开关、标题可见性、拼写检查、自动锁定、修改密码、认证方式管理
• 跨平台：Windows、macOS 和 Linux
• 零网络访问：无遥测、无分析、无更新检查

文档

• 在线用户文档：https://mini-diarium.com/docs
• 离线 / GitHub 用户指南：docs/USER_GUIDE.md
• 安装：docs/INSTALLATION.md
• 密钥文件认证：docs/KEY_FILE_AUTHENTICATION.md
• 架构图与数据流：docs/ARCHITECTURE.md
• 已知问题 / 权衡取舍：docs/KNOWN_ISSUES.md
• 隐私：docs/PRIVACY.md
• 安全模型 + 漏洞报告：SECURITY.md
• 用户插件（Rhai）：docs/user-plugins/USER_PLUGIN_GUIDE.md

架构

有关架构图与详细数据流，请参阅 docs/ARCHITECTURE.md。

键盘快捷键

统计、导入和导出可通过“日记”菜单使用（无默认键盘快捷键）。

在 macOS 上，请使用 Cmd 代替 Ctrl。

从源码构建

前置要求： Rust（参见 rust-toolchain.toml）、Bun 1.x，以及 Tauri v2 系统依赖。

有关特定平台的详细说明（Linux 软件包名称、Fedora 配置、Wayland 故障排查），请参阅 CONTRIBUTING.md。

git clone https://github.com/fjrevoredo/mini-diarium.git
cd mini-diarium
bun install
bun run tauri build

构建产物将位于 target/release/bundle/（Cargo 工作区根目录拥有 target/）。

技术栈

• Tauri 2：桌面应用框架（Rust 后端、Web 前端）
• SolidJS：响应式 UI 框架
• Rust：后端逻辑、加密、数据库
  • x25519-dalek、hkdf、sha2：用于密钥文件认证的 X25519 ECIES 密钥封装
• SQLite：本地加密数据库存储
• TipTap：富文本编辑器
• UnoCSS：实用优先的 CSS
• Kobalte：可访问的 UI 原语

已知问题

有关完整的已知限制、刻意的权衡取舍和技术债务列表，请参阅 docs/KNOWN_ISSUES.md。

面向用户的重点：

• 不支持并发访问同一个日记文件（设计使然）
• 密码无法找回——丢失全部凭据即永久丢失（设计使然）
• 全文搜索以内存扫描方式在解密后的条目上运行（在 v0.2.0 移除 FTS 后重新加入）；任何可搜索的内容都不会写入磁盘
• 重复导入同一文件会创建重复条目（不做去重）
• 插件更改需要重启应用才能生效

扩展 Mini Diarium

你可以使用日记 plugins/ 文件夹中的 Rhai 脚本添加本地导入/导出扩展。 有关要求、最佳实践以及完整的示例插件，请参阅 docs/user-plugins/USER_PLUGIN_GUIDE.md。

性能基准

加密与数据库热路径的 Criterion 基准测试会在每次推送到 master 时进行跟踪，并发布在 fjrevoredo.github.io/mini-diarium/benchmarks/。

该页面涵盖四个方面：Argon2id 密钥派生（刻意放慢——约 200 毫秒以抵御暴力破解）、三种条目大小下的 AES-256-GCM 加密/解密、SQLite 操作（插入、更新、删除、日期枚举、全表扫描），以及字数统计计算。每张卡片显示最近一次的耗时，以及最近 30 次 CI 运行的 Chart.js 趋势图。

参与贡献

有关环境搭建说明、开发工作流和代码约定，请参阅 CONTRIBUTING.md。 负责添加官方插件的维护者，请参阅 docs/BUILTIN_PLUGIN_GUIDE.md。 负责改动前端 UI/状态、Rust 后端、Tauri IPC 边界、WebView 安全或 CI 的维护者，请参阅 docs/best-practices。

翻译

Mini Diarium 提供以下语言版本：

• English
• French (Français)
• German (Deutsch)
• Hindi (हिन्दी)
• Italian (Italiano)
• Portuguese (Brazil) (Português (Brasil))
• Spanish (Español)

如果你想为另一种语言添加支持，请参阅 docs/TRANSLATIONS.md，了解如何创建语言文件并提交 PR。

发布

面向维护者：分步发布说明请参阅 docs/RELEASING.md。

安全

有关安全模型以及如何报告漏洞，请参阅 SECURITY.md。

许可证

Mini Diarium 以 MIT 许可证授权。参见 LICENSE。

致谢

由 Francisco J. Revoredo 用心打造（并得到了 Claude Code 的一点帮助）。

贡献者

感谢所有为 Mini Diarium 贡献代码、翻译或改进的人：

Star 历史