运行时依赖
安装命令
点击复制技能文档
卢曼卡片学习法(Zettelkasten)基于卢曼卡片盒笔记法的个人知识管理系统,四级笔记流与九大人生领域分类深度整合,支持撤销操作和流程化卡片创建。
存储位置 卡片数据存储在:~/Desktop/cardsdata/ cardsdata/ ├── inbox/ # 闪念笔记(临时,需定期清理) ├── lit/ # 文献笔记(阅读笔记) ├── zettel/ # 永久笔记(核心知识资产) │ ├── 身心/ # 健康、心理、运动 │ ├── 学习/ # 学习方法、技能提升 │ ├── 投资/ # 理财、资产配置 │ ├── 家庭/ # 亲密关系、育儿 │ ├── 事业/ # 职业发展、工作 │ ├── 社交/ # 人际关系、沟通 │ ├── 物品/ # 物品管理、消费 │ ├── 爱好/ # 兴趣爱好 │ └── 体验/ # 旅行、美食、文化活动 ├── project/ # 项目笔记 ├── map/ # 索引/地图(MOC) │ └── index.md # 主索引(按九大领域组织) ├── attach/ # 附件 ├── template/ # 本地模板 └── .system/ # 系统文件 ├── trash/ # 回收站 └── operation_history.json # 操作历史(用于撤销)
四级笔记 + 九大领域 类型 目录 生命周期 用途 闪念笔记 inbox/ 1-2天 快速捕获想法 文献笔记 lit/ 长期 读书笔记 永久笔记 zettel/分类/ 永久 按九大领域组织的核心知识 项目笔记 project/ 项目周期 特定项目相关
九大人生领域 身心 - 健康、心理、运动、睡眠 学习 - 学习方法、技能提升、知识管理 投资 - 理财、资产配置、风险管理 家庭 - 亲密关系、育儿、家务 事业 - 职业发展、工作技能、创业 社交 - 人际关系、沟通技巧、人脉 物品 - 物品管理、消费决策、极简主义 爱好 - 兴趣爱好、休闲活动 体验 - 旅行、美食、文化活动
核心脚本
- 基础管理脚本 card_manager.py - 卡片增删改查
- 撤销管理脚本 undo_manager.py - 操作撤销
支持的撤销操作: ✅ 撤销创建(删除刚创建的卡片) ✅ 撤销删除(从回收站恢复) ✅ 撤销批量删除(批量恢复) ✅ 撤销更新(恢复更新前的内容)
操作历史存储:~/.zettelkasten/memory/history.json
- 交互式创建脚本 card_creator.py - 流程化卡片创建
交互式流程: 输入阶段 - 选择类型、输入标题和内容、选择分类、添加标签、关联记忆 处理阶段 - 验证输入、生成ID、渲染模板、写入文件、记录历史 输出阶段 - 显示创建结果、提供后续操作建议
与记忆系统整合 卡片 → 记忆 # 创建时关联记忆 python3 scripts/card_manager.py create permanent "笔记标题" --category 学习 --memory 2026-03-01 # 事后添加记忆引用 python3 scripts/card_manager.py memory add 20260301-0001 2026-03-01 --context "讨论时产生"
记忆 → 卡片 # 查找某天关联的所有卡片 python3 scripts/card_manager.py memory find 2026-03-01
工作流程 日常捕获 # 方法1:使用基础脚本 python3 scripts/card_manager.py create fleeting "灵感" --content "详细内容" # 方法2:使用交互式脚本(推荐) python3 scripts/card_creator.py
定期整理 # 查看未处理的闪念 python3 scripts/card_manager.py list --type fleeting # 有价值的转化为永久笔记 python3 scripts/card_manager.py convert 20260301-0001 --category 学习 # 如果转化错了,撤销 python3 scripts/undo_manager.py undo
分类浏览 打开 ~/Desktop/cardsdata/map/index.md,按九大领域浏览知识结构。
笔记ID格式 YYYYMMDD-NNNN 示例:20260301-0001 自动生成,无需手动指定 全局唯一,永不改变 按时间排序,便于追溯
高级功能 详见 references/advanced.md: 批量导入导出 知识图谱生成 标签云统计 自动归档策略
脚本架构 scripts/ ├── card_manager.py # 基础增删改查(自动记录操作历史) ├── undo_manager.py # 撤销管理(独立历史记录) ├── card_creator.py # 交互式创建流程 └── search_index.py # 搜索索引(可选)
操作历史机制 自动记录:card_manager.py 的 create/delete/update 操作自动记录 独立存储:历史存储在 JSON 文件,不污染卡片数据 有限保留:只保留最近100条操作记录 撤销标记:已撤销的操作会标记,避免重复撤销
最佳实践 使用交互式创建:card_creator.py 提供更友好的体验 定期撤销检查:误操作后立即 undo_manager.py undo 关联记忆:创建卡片时尽量关联记忆日期,便于追溯 分类清晰:永久笔记必须选择九大领域之一
Skill 版本:2.0 | 更新:2026-03-02