一个真正属于你的卢曼卡片盒。

固定编号、双向链接、关键词索引、关系图和本地 AI，
在 Windows、macOS 和 iPhone / iPad 上运行，每一张卡片都只保存在你自己的设备上。

下载 Windows 版 · 下载 macOS 版 · iPhone 版 · 介绍视频 · 使用指南 · 示例卡片盒 · 路线图 · 更新日志 · English

_{1 分钟看懂卡片盒 · 点图片下载视频（MP4，约 15 MB）· 画面由代码逐帧生成，配乐程序合成，旁白由本地语音模型生成}

卡片 · 编号序列、链接与反向链接

关系图 · 悬停一张卡片，只看它的联系

AI 助手 · 回答里的 [[编号]] 可以直接点开

为什么做卡片盒

社会学家 Niklas Luhmann 用一个木头卡片盒写出了七十多本书。秘诀不在卡片本身，而在三件事：每张卡片有一个永远不变的编号，卡片之间写着理由的链接，以及一份很薄的关键词索引。卡片足够多之后，卡片盒会给出你自己都没想到的组合，他称之为“沟通伙伴”。

现在的笔记软件大多是文件夹加标签，或者把你的笔记放在别人的服务器上。卡片盒把卢曼的做法原样搬到电脑上：卡片有 1、1a、1a1 这样的固定编号，链接写在正文里，结构从一次次“续写”和“分支”中长出来。所有数据都是你电脑上的一个 SQLite 文件，不需要账号、不联网、没有订阅。

AI 只在你点 AI 按钮时才在本机启动，它可以帮你整理闪念、找出可能相关的卡片，但链接写不写，由你决定。

功能

卢曼卡片盒

• 三种卡片：闪念（收件箱）、文献卡片（书目卡片盒）、永久卡片（主卡片盒）。
• Folgezettel 固定编号：“续写”和“分支”自动算出下一个空位，可以无限插入。
• 正文写 [[1a2]] 链接卡片，[[@Luhmann1981]] 引用文献，输入 [[ 自动补全；每张卡片都显示“被引用”。
• 关键词索引、编号树、按编号顺序翻上一张/下一张、随机漫步、全文搜索。
• 改号时整串分支一起移动，所有指向它们的链接自动更新。
• 多个卡片盒，按课程或项目分开；回收站、Markdown 正文、深色模式、快捷键。

写作记录

• 像 GitHub 的提交记录一样，一格一天：颜色越深那天写得越多，点一格就能看到那天新建和修改的卡片。
• 当前连续、最长连续、星期几最常写；第 1、10、50、100…… 张永久卡片是哪天写的；每天第一张卡片时一句小小的鼓励。
• 首页的“往日今天”：一周前、一个月前、一年前的今天写下的卡片，让旧想法重新冒出来。

_{写作记录：一眼看出多久写一次卡片}

看见联系

• 关系图：一张卡片两层之内的序列、链接和文献引用，可拖动、缩放。
• 鼠标放到任意节点上，无关的卡片淡出，相关的高亮。
• AI 梳理整个卡片盒：给每个主题序列起名，找出内容相关却还没链接的卡片对，按主题上色画成一张图。

多端同步

• Windows、Mac、iPhone 之间局域网同步：两台设备都打开“设备与同步”，在其中一台点“同步”，另一台当主机。
• 设备之间直连、全程加密，不经过服务器，不需要账号；第一次核对一组 6 位数字完成配对。
• 两边都改过的卡片保留较新的一份，另一份放进收件箱当“冲突副本”；同步前两边自动备份。见 多端互联。

_{设备与同步：点一下“同步”，摘要里写清楚两边各变了什么}

本地 AI（可选）

• 用 Ollama 在本机运行，默认模型 qwen3.5:4b（约 3.3 GB）。只在点击时加载，闲置自动释放内存，界面实时显示状态。
• 没装 Ollama？应用里点一下“一键安装 Ollama 和模型”，自动下载、安装、启动，显示进度。
• macOS 26 / iOS 26 打开了 Apple 智能的设备，可以直接用系统自带的 Apple 端侧模型，什么都不用装；iPhone 默认用它。
• AI 整理：把一条闪念改写成合格的永久卡片，建议标题、关键词、编号位置和应该链接的卡片。
• AI 梳理联系：判断一张卡片和相近卡片的关系（支持、反驳、举例、延伸、前提、对比、相似）。
• AI 助手：先从卡片盒里找出相关卡片，再根据它们回答。
• 所有结果都只是建议，确认后才会写进卡片。应用只允许连接本机的 Ollama（iPhone 上是局域网里的），卡片不会被发到互联网上。

_{AI 整理：把一条闪念改写成永久卡片，并建议它在卡片盒里的位置}

iPhone / iPad

• 同一份界面，手机上是底部标签栏的单栏布局；数据在“文件”App 里看得到。
• AI 可以连接同一个 Wi-Fi 下电脑上的 Ollama。

编号树

卡片

关系图

关键词索引

你的数据

• 每个卡片盒是一个 SQLite 文件，Mac、Windows、iPhone 格式相同，可以直接拷过去用。
• 每天自动备份，保留 30 份；随时导出 JSON 或一个文件夹的 Markdown（带 front matter，Obsidian 等可以打开）。
• 换电脑时同步一次，所有卡片盒就都过去了。

下载与安装

到 Releases 下载：

系统	文件	说明
Windows 10 / 11	Slipbox-<版本>-windows-x64-setup.exe	安装版，装到当前用户，开始菜单里叫“卡片盒”。缺 WebView2 时会自动补装
	Slipbox-<版本>-windows-x64-portable.exe	便携版，双击即用，不写注册表（需要系统自带的 WebView2，Windows 11 和更新过的 Windows 10 都有）
macOS 12+	Slipbox-<版本>-macos.zip	解压后把“卡片盒.app”拖进“应用程序”（Apple 芯片和 Intel 通用）
iPhone / iPad（iOS 16+）	Slipbox-<版本>-ios-unsigned.ipa	用 Sideloadly 或 AltStore 配合免费 Apple ID 安装，或用 Xcode 从源码安装，见 iPhone / iPad

每个文件旁边的 SHA256SUMS.txt 可以用来校验下载是否完整。

Note

应用没有购买代码签名证书。Windows 第一次打开时如果出现“Windows 已保护你的电脑”，点 更多信息 → 仍要运行。macOS 提示“无法验证开发者”时，到 系统设置 → 隐私与安全性 点 仍要打开，或在终端运行 xattr -dr com.apple.quarantine /Applications/卡片盒.app。

想先试试？在应用里点 设置与数据 → 从 JSON 导入，选择 docs/demo/demo-box.json，就能得到截图里的示例卡片盒。

从源码构建

git clone https://github.com/CamLUzy/slipbox
cd slipbox
npm install          # Tauri CLI
npm test             # 编号规则与数据操作的单元测试

bash mac/build.sh --install   # macOS：只需要 Xcode 命令行工具
npx tauri build               # Windows：需要 Rust 与 WebView2，产物在 src-tauri/target/release/

两个平台的构建、自测和打包都在 GitHub Actions 里自动完成，细节见 开发指南。

工作原理

• web/ 是整个界面：原生 HTML、CSS 和 JavaScript，没有框架、不需要构建。编号规则（luhmann.js）和所有数据操作（ops.js）都是纯函数，旁边有单元测试。
• apple/Shared/ 是 Mac 和 iPhone 共用的 Swift 核心：SQLite、卡片盒、备份和 zk 消息桥。
• mac/main.swift 是 macOS 外壳：窗口、菜单栏和存储面板，编译出来约 1 MB；ios/ 是 iPhone / iPad 外壳：分享面板、文件选择器，数据放在“文件”App 里能看到的位置。
• src-tauri/ 是 Windows 外壳：Rust + Tauri 2，用系统自带的 WebView2 显示同一份界面。
• 三个外壳回答同一套 zk 消息（读写卡片、管理卡片盒、备份、导出、AI 代理、同步），所以界面代码在所有平台上完全一样。
• 局域网同步：外壳负责发现设备（Bonjour / mDNS）和加密连接（Noise 协议，Swift 用 CryptoKit 实现、Rust 用 snow，两边用同一组测试向量逐字节核对），合并规则写在共享的 web/js/merge.js 里。
• 每个外壳都带一个无窗口的自测模式，CI 每次都会在真正的 Windows、macOS 和 iOS 模拟器里打开打包好的应用，跑一遍读写、改号、备份和页面渲染。

你的数据

所有内容都在一个文件夹里：Windows 是 %APPDATA%\卡片盒，macOS 是 ~/Library/Application Support/卡片盒，iPhone 是“文件”App 里的“我的 iPhone → 卡片盒”。

路径	内容
boxes/<卡片盒名>.db	一个卡片盒的全部卡片（SQLite，每张卡片一行，data 列是完整 JSON）
backups/<卡片盒名>/zettel-日期.db	每天一份自动备份，保留最近 30 份
settings.json（Windows）	上次打开的卡片盒

备份这个文件夹，就备份了一切。换设备时把它拷过去即可，三个平台的文件格式完全相同。

文档

我想	看这里
先了解卡片盒方法和这个应用怎么用	使用指南
在 Windows 上安装、升级、卸载	Windows
在 Mac 上安装或自己编译	macOS
装到 iPhone / iPad	iPhone / iPad
在电脑和手机之间同步	多端互联
打开本地 AI、一键安装 Ollama、用 Apple 端侧模型	本地 AI
备份、导入导出、换电脑	数据
找常见问题的答案	FAQ
参与开发	开发指南 · 贡献
报告安全问题	安全

路线图

完整计划在 ROADMAP.md。

版本	时间	主题
v1.0.0	2026 年 10 月	macOS 与 Windows 应用、多个卡片盒、本地 AI、关系图
v1.1.0	2026 年 10 月	iPhone / iPad 应用
v1.2.0	2026 年 10 月	局域网同步、Apple 端侧模型、一键安装 Ollama、写作记录
v1.3	下一个	图片附件、卡片历史版本
以后		网盘文件夹远程同步、向量检索的“可能相关的卡片”、英文界面

参与

• Issues：可以复现的 bug 和具体的功能建议。
• Discussions：使用方法、卡片盒心得、想法。
• Pull requests 欢迎，先看 CONTRIBUTING.md。

许可证

MIT。卡片盒方法属于 Niklas Luhmann，这个应用只是把它搬到了电脑上。