Papyra 开源便签：Google Keep 式卡片流，底层是纯粹的本地 Markdown

开源项目 Papyra 在 2026 年 10 月下旬连发数版更新至 v1.1.1，拿出了自托管笔记领域罕见的架构设计：表面是类似 Google Keep 的轻量彩色便签网格，底层却是一套纯粹的本地 Markdown 文件系统。每一条笔记在磁盘上都是一个带有 YAML 元数据的普通 .md 文件，不绑定任何私有数据库，单一 Docker 容器直接跑在个人 NAS、服务器或 Mac 虚拟机上。项目遵循 GPLv3 协议开源，支持 arm64 与 amd64 平台。

磁盘即真理：为什么它能让 Obsidian 和 VS Code 同时读写

不少宣称开源的自托管笔记软件，依然把正文塞进 PostgreSQL、MongoDB 或复杂的关系型数据表中。一旦服务停止维护或者想要换用其他软件，导出往往伴随着繁琐的格式转换与元数据丢失。Papyra 把设计原则倒转了过来：文件系统才是唯一权威（The filesystem is the source of truth）。

在 Papyra 的存储卷里，所有笔记都是平铺在目录下的原生 Markdown 文件，顶部带着标准的 YAML 标头记录标签、颜色与置顶状态。软件内置的 SQLite 数据库与 Lucene 全文搜索引擎被明确定义为「可丢弃的轻量缓存」。就算手动删掉整个数据库文件，Papyra 重新启动后也会直接扫盘，在几秒内从原生 .md 文件群中自动重建出完整的索引与结构。

这也意味着用户完全可以在同一套数据文件夹上并存多款工具：用 VS Code 直接写代码片段、用 Mac 上的 Obsidian 打开同个仓库梳理双链、或者在终端里直接用 grep 搜索内容。Papyra 在后台通过文件监听机制（FileSystemWatcher）实时感知外部改动并推送到网页界面，就算外部同步产生冲突，系统也会把冲突文件清晰列出，不会直接锁死或吞掉文字。

写完直接走：没有保存按键的实时协同与离线编辑

交互层面上，Papyra 彻底砍掉了传统网页编辑器的「保存」按钮。点开任意一张便签卡片即可直接打字，手指停顿的瞬间内容便会自动存盘。前端基于 React 19 与 Lexical 深度封装的 Luthor 编辑器打造，支持通过斜杠呼出标题、任务清单、表格、图片插入与外链嵌入。

在需要团队或家庭共享的场景下，Papyra 借由 SignalR 提供了平滑的多人实时协同体验。两名成员打开同一篇笔记时，光标位置会带着对方的昵称实时浮现，但存入底层的依然是没有任何专有协同脏标记的干净 Markdown。即便网络意外中断，浏览器内置的 IndexedDB 也会在离线时暂存修改，并在重连后静默同步。

带指纹锁的私密保险箱与版本回溯

针对包含财务信息、账号密码或私人随笔的敏感内容，Papyra 提供了内置的保险箱（Vault）功能。开启锁定的便签在主视图中会被高斯模糊全面遮蔽，需要输入安全 PIN 码解开，同时也全面支持基于 WebAuthn 的 Passkey，在 Mac 与 iPhone 上轻触 Touch ID 或双击 Face ID 即可秒级解锁。更为关键的是，这些私密便签落在磁盘上时同样处于加密状态，避免在挂载磁盘被直接读取时泄露隐私。

每一条笔记还会自动记录每一次修改切片。点开底部的历史图标，可以逐个版本查看文字改动高亮，误删一段长文时能一键回退到指定时间节点。笔记之间打上 [[ 符号即可建立双向链接，卡片底部会自动汇总所有引用该条笔记的反向关联，满足基础的网状知识整理需求。

v1.1 新增每日日记系统：一页一天连通待办

在 10 月 29 日发布的 v1.1.0 与 v1.1.1 中，项目引入了一套完整的内置日记（Journal）面板。系统每天自动准备一个专属页面，顶部记录当天日期与心情指示器，正文无缝连接当日待办任务清单与快速速记。写好的整本日记支持按照 Markdown 原件归档，也可以一键排版导出为带格式的 PDF 电子书。

在 v1.1.1 中，开发者还专门响应自托管社区关切，在 Docker Compose 配置中加入了 PAPYRA_UPDATE_CHECK_ENABLED: "false" 开关。如果部署者不希望服务器每天向官方发起一次版本检查请求，关闭后整套容器便会处于绝对的内网离线孤岛状态，不向外发送任何遥测、统计或心跳包，软件本身亦遵循 GPLv3 开源协议，不包含任何商业追踪脚本。

如何部署与 Apple 生态使用技巧

Papyra 的部署极其精简，整套后端基于 .NET 10 Minimal APIs 与 C# 14 编写，编译后直接与前端整合进同一个轻量镜像中。服务器端只需要 Docker 与 Docker Compose 环境：

curl -O https://raw.githubusercontent.com/lyfie-org/papyra/main/docker-compose.hub.yml
docker compose -f docker-compose.hub.yml up -d

容器启动后访问本地 8080 端口即可初始化首个管理员账号，配合 Caddy、Nginx Proxy Manager 或 Cloudflare Tunnel 即可快速配置公网 HTTPS 访问。如果需要在本地挂载指定文件夹，把 compose 模板中的命名卷直接改成 ./papyra-data:/data，笔记文件就会实时落在本地目录。

对于 Mac、iPhone 与 iPad 用户，Papyra 做了完整的 PWA 渐进式网页应用适配。在 iPhone 或 iPad 的 Safari 中打开自建站点，点击分享按钮并选择「添加到主屏幕」，它就会剥离浏览器地址栏，以独立 App 形态常驻在桌面，支持深浅色外观自适应与触控手势滑动。

官方入口

项目仓库：github.com/lyfie-org/papyra。项目主页与在线体验 Demo：papyra.app。软件遵循 GPLv3 开源许可协议，支持第三方导入工具直接解析 Obsidian 压缩包、Google Keep 与 Day One 导出的归档数据。