journal

Journal

一个由 Markdown 文件夹构成的日志，配有一款体验类似 Day One 的应用，以及一个 MCP 服务，让你的 Agent 能够读取和写入日志。

• 你的文件。 每篇条目对应一个 .md 文件，包含 YAML frontmatter；照片存放在按内容寻址的文件夹中。可使用 iCloud Drive、Dropbox、Syncthing、git 同步。可用任何编辑器打开。参见 docs/format.md。
• 从 Day One 导入。 在 Day One 中导出为 JSON，然后导入压缩包。条目、照片、标签、位置、天气和评分都会导入。重复导入不会产生重复内容。
• On This Day、全文搜索（FTS5，支持韩文、日文和 CJK）、标签、多个日志、日历视图、深色模式、连续记录天数和字数统计。
• 模板（templates/*.md，内置 3 个）、每日提醒、密码锁，以及保留已删除条目 30 天的回收站。
• Agent。 journal mcp serve 通过 MCP 提供 11 个工具；CLI 也能在 Shell 中完成相同操作。参见 docs/mcp.md。
• 无需账户、无需服务端、无遥测。 可选的位置和天气功能会在系统位置服务可用时使用该服务；否则会根据网络连接（ipapi.co）估算城市级位置，再通过 Open-Meteo 获取天气（无需密钥）。一个开关即可关闭此功能。

安装

桌面应用：从 Releases 下载适用于 macOS、Windows 或 Linux 的版本。macOS 版本已签名并经过公证。

CLI（也可用作 MCP 服务）：

brew install --cask sjh9714/tap/journal   # macOS; or grab a binary from Releases
journal init                       # creates ~/Journal (or follows the desktop app's folder)
journal add "First entry" -t life
journal list
journal search first
journal on-this-day
journal add --template gratitude   # see `journal templates`
journal delete <id>                # to the trash; `journal trash restore <id>` undoes it
journal stats

接入你的 Agent

claude mcp add journal -- journal mcp serve

Claude Desktop：从 Releases 下载 journal-0.1.0.mcpb 并打开。

然后可以说：“在今天的日志里加一句关于部署的记录”“我去年写过什么关于搬家的内容？”“总结一下我的这一周”。如果只想让它读取日志，可使用 --read-only。

从 Day One 导入

Day One → Export → JSON。然后在应用中选择：Settings → Import Day One export，或者：

journal import dayone ~/Downloads/Export.zip

在手机上使用

目前还没有移动应用。由于条目是纯 Markdown 文件，可以将日志文件夹保存在 iCloud Drive（或 Dropbox、Syncthing）中，并用手机上的任意 Markdown 编辑器打开。在 iPhone 上，Obsidian（免费）用起来很方便：创建一个库，选择“Existing folder”，选取 iCloud Drive 中的日志文件夹，新建的条目便会遵循 docs/format.md 中的格式。iA Writer 和 1Writer 也可以直接打开该文件夹。桌面应用在下次获得焦点时会读取这些编辑内容。

从源代码构建

cargo test --workspace
cd apps/desktop && npm install && npm run tauri build

状态

桌面应用（macOS、Windows、Linux）、CLI、MCP、Day One 导入、模板、提醒、密码锁、回收站。尚未支持：移动端、内置同步服务、PDF 导出、静态加密、编辑历史（可将文件夹放入 git 来实现）。

MIT。“Day One”是 Automattic 的商标；本项目只读取其导出格式。