1. 项目缘起为什么我会想做一个“原始人”方案如果你最近也跟我一样被各种“All-in-One”笔记软件、知识库工具折腾得头大——功能越做越重启动越来越慢同步越来越玄学格式越来越封闭那你大概率能理解我第一次听说caveman这个词作为项目名时的会心一笑。把个人知识管理做得像山顶洞人一样原始是的这个项目要的就是这种近乎“赤裸”的纯净感。caveman不是什么新框架也不是什么云原生工具链它的核心描述可以浓缩成一句话一套只依赖纯文本、标准命令行工具和简单脚本的个人工作流与信息管理系统。你可以把它理解成一个极简版的“数字岩洞”——所有信息都以最原始、最透明的 .txt / .md 文件形式躺在你的硬盘上没有专有数据库没有云锁定没有任何你不可见的黑盒逻辑。我自己是被“笔记软件搬家”折磨过两轮的人深知那种数据被困在某个无人维护的 App 里的无力感。所以当看到caveman这个项目思路时第一反应就是这才是把掌控感还给用户的东西。这项目特别适合三类人一是对知识管理工具选型有选择困难、想要彻底“减负”的人二是习惯在终端里干活、相信“文件即数据”的工程师三是对隐私和数据长期可访问性有执念的数字囤积者。整个方案不要求你有多高深的技术水平只要会用终端敲几十个命令、愿意维护几条简单的命名规范就能把属于自己的“洞窟”建起来。下面我就把这个项目从设计思路到落地全程拆开逐个环节讲清楚。2. 整体设计与核心思路拆解2.1 为什么非要退回“原始时代”现在市面上几乎没有哪款笔记工具敢把“原始”当成卖点恰恰因为caveman选择了“返祖”它才有了一堆现代工具给不了的好处。零锁定风险所有内容都是纯文本文件任何系统、任何文本编辑器、哪怕一个 20 年前的老终端都能打开。不需要担心软件停运、云服务关停、数据库损坏导致十年笔记一夜蒸发。极低心智负担没有嵌套层级、没有标签云、没有复杂的双链图目录就是分类文件名就是索引一切所见即所得。打开一个文件夹你立刻知道这条知识在哪里。配合顺手纯文本天生适合 Git 做版本管理天然兼容 grep、rg、find 这些 Unix 经典工具配合 shell 脚本能实现任何你想得到的自动化操作。这里回答一个几乎每个朋友都会问的问题“那我直接用记事本不就行了”其实差很远。裸的记事本没有组织规范没有索引逻辑信息一旦多了就变成一锅粥。而caveman提供的不是工具本身而是一套带规范的方案——它规定了你如何命名、如何记录、如何归档、如何检索这层薄薄的约定才是“原始”和“混乱”的分界线。2.2 方案选型背后的取舍逻辑在设计这个方案时我做过三次明显的取舍每次都踩住了一条原则凡是能被明文解决的功能绝不用二进制格式凡是能靠命名解决的问题绝不上数据库。取舍之一文件格式用 Markdown 而不是富文本。Markdown 本质是带极轻标记的纯文本加粗、列表、链接都能轻松表达同时打开后就是可读的源代码。富文本看着花哨可一旦混排复杂样式底层 XML 冗长到想哭。Markdown 的渲染可交给 Typora、VS Code、Obsidian 等任选工具但数据本身永远是干净清爽的。取舍之二分类用“文件夹 文件名前缀”而不是数据库标签。标签系统在信息量小的时候很好用一旦标签数量膨胀维护成本比收益还大。而caveman用固定命名规则如20250101-跑步随想.md天然支撑时间轴排序、主题前缀筛选比标签系统更直观也更抗遗忘。取舍之三同步用 Git 而不是网盘。网盘同步会制造大量冲突副本而且对纯文本的版本回溯能力极差。Git 是所有开发者都熟悉的版本工具caveman借助 Git 可以做到每次改动都有历史记录每个阶段都能标注 commit message随时 diff 查看改了什么再也不会出现“这个笔记到底是哪版本”的错乱。2.3 已实现的功能清单功能模块实现方式解决的问题快速记录终端命令caveman new 标题自动生成带日期和模板的新文件降低记录的启动摩擦全文检索直接使用 rg / grep 递归搜索毫秒级返回信息查找不求人版本回溯每次记录后自动 git commit支持逐版查看防止误删和写坏分类聚合按文件夹 文件名日期前缀脚本一键汇总周报/月报告别手工复制粘贴轻量加密针对特定敏感文件用 gpg 单独加密并不影响整体明文隐私保护有兜底多端可用任意支持 Git 的设备均可克隆仓库继续使用跨设备不再是噩梦这套体系没有“太多功能”每个功能都是我在使用中真实需要的没有一个是赶时髦堆上去的。这也是caveman的初衷——功能只保留能站稳的多余的一律砍掉。3. 核心细节解析与实操要点3.1 目录结构与命名规范的设计心法整个caveman的骨架其实非常朴素下面是我实际采用的目录结构你可以直接照抄~/cave/ ├── 00-inbox/ # 临时收件箱所有想法先丢进来 ├── 10-projects/ # 按项目归档每个项目一个子目录 ├── 20-areas/ # 长期关注的领域健康、理财、阅读等 ├── 30-archives/ # 完成、沉淀、不再频繁变动的文件 └── 99-templates/ # 各类文件模板这个结构借鉴了 PARA 方法的精髓但做了极简化不设“资源”文件夹因为很多东西介于资源和项目之间硬分类会带来选择困难收件箱只有 1 个给所有临时信息一个不用纠结的落脚点归档区明确让认知负荷显著下降。归档符号化之后我每次新建文件只需问一个问题这是临时还是长期临时进00-inbox长期再考虑去哪个编号目录。文件命名我统一采用YYYYMMDD-主题关键词.md。日期放前面不光是排序需要更重要的是能提醒自己信息的时效性。前缀编号00/10/20/30/99看似随意实际留足了扩充空间——比如以后想加一个 15-research 分类完全不需要打断现有的十位分法。3.2 模板与元信息设计每个新建文件都从模板生成。拿一篇日志模板举例内容极短但信息字段齐全--- title: date: 2025-01-01 type: log tags: [] --- ## 今天做了什么 ## 有什么想法 ## 明日待办YAML 头frontmatter里只放了三个必要字段标题、日期、类型。标签字段保留但我不强求有就填没有就空着。这里有个我在实操中总结出的经验元信息最多五条超过这个数字你很快就会懒得填最后模板形同虚设。模板存在的意义是降低记录时的思考负担而不是给你增加负担。模板文件放在99-templates目录用 shell 脚本复制出来并替换变量。后面第 4 节我会把脚本完整写出来到时你一看就懂。3.3 轻量加密实现的注意点整套方案主推“明文主义”但有些特殊文件比如银行卡账单、个人私钥备份不适合直接放在文件夹里。我用gpg对特定隐私文件做对称加密所有.md.gpg后缀的文件可以直接丢在原来的目录里不会被误读也不会影响其他文件的检索。注意加密文件一定要记得保存好密码短语gpg一旦丢密码神仙也救不回来。我见过不止一个人加密一时爽、解密火葬场。我更强调一点加密仅限极少数文件如果发现加密文件数量超过总文件的 2%就要反思是否把太多东西默认成了“敏感内容”加密范围一旦扩大管理成本会指数级上升。4. 实操过程与核心环节实现4.1 环境准备先从干净开始要跑起caveman你需要的东西异常普通一台 mac/Linux 电脑Windows 下用 WSL 也能跑装了基础的git、rgripgrep可选但强烈推荐、gpg需要加密时才用。所有工具终端自然自带或包管理器一行安装。创建目录骨架并初始化 Git 仓库这一步直接决定了你的“洞府”根基mkdir -p ~/cave/{00-inbox,10-projects,20-areas,30-archives,99-templates} cd ~/cave git init git commit --allow-empty -m caveman 项目启动洞窟初立执行完你可以看一眼~/cave下的目录干干净净没有任何多余信息。从这一步开始这个文件夹就是你的数字世界中心了。4.2 核心脚本new、search、archive 三兄弟光有目录还不够caveman的灵魂在于几个顺手得离谱的脚本。我把它们放在~/bin下用最简单直白的 Bash 编写不求炫技只求看代码的人一秒读懂。先看new它的作用是纳新把记录的摩擦降低到“一条命令”#!/bin/bash # 用法: caveman new 跑步随想 TITLE$* DATE$(date %Y%m%d) CLEAN_TITLE$(echo $TITLE | tr -) FILE$HOME/cave/00-inbox/${DATE}-${CLEAN_TITLE}.md cp $HOME/cave/99-templates/log.md $FILE sed -i s/^date: .*/date: $(date %Y-%m-%d)/ $FILE 2/dev/null || \ sed -i s/^date: .*/date: $(date %Y-%m-%d)/ $FILE sed -i s/^title: .*/title: ${TITLE}/ $FILE 2/dev/null || \ sed -i s/^title: .*/title: ${TITLE}/ $FILE echo 文件已创建: $FILE命令细节说明先用date生成格式化时间戳再把标题中的空格替换成连字符避免文件名里出现难处理的空字符。复制模板后用sed替换掉 title 和 date 两行——macOS 的 BSD sed 和 Linux 的 GNU sed 语法稍有差异我就用||给两个系统做了兼容实测都能跑。输出文件路径这点很重要能减少“我建的文件去哪了”的困惑。再写search它的作用是查老信息借助 ripgrep 实现毫秒级实时搜索#!/bin/bash # 用法: caveman search 关键词 rg -n --coloralways $1 $HOME/cave --glob !99-templates/**别小看这一行命令它比绝大多数图形软件内置的搜索都快且准。配合--glob排除模板文件搜索结果不会混入干扰项干净漂亮。第三个脚本archive作用是归档与盘点让信息生命周期闭环#!/bin/bash # 用法: caveman archive inbox文件名 INBOX_FILE$1 [ -z $INBOX_FILE ] echo 请指定要归档的文件名 exit 1 read -p 归档到哪个分类(projects/areas) DEST mkdir -p $HOME/cave/10-${DEST} mv $HOME/cave/00-inbox/${INBOX_FILE} $HOME/cave/10-${DEST}/为什么归档只给两个选项这是我从实际使用中抠出来的简化。过去我设置过五个目录让用户选结果每次归档都在纠结缩成 projects/areas 两类之后决策路径短了归档率肉眼可见地提升了。别小看这个细节选择越少系统越能被坚持用下去。4.3 自动提交与 Git 钩子new给了记录入口但版本控制不能全靠手动git commit——那样你一定会偶尔偷懒一偷懒历史就断档。我的方案是写一个简单的自动提交脚本并放在任务计划里每 15 分钟跑一次#!/bin/bash cd $HOME/cave if [[ -n $(git status --porcelain) ]]; then git add -A git commit -m 自动备份 $(date %Y-%m-%d %H:%M) /dev/null 21 fi思路很直白先用git status --porcelain检查是否有变更没有就静默退出有就全部提交。提交信息带上具体时间方便日后查阅。这样即使我某天随手写了两行想法忘提交最多 15 分钟后 Git 也会自动把状态保存得妥妥帖帖。用 Git 做自动快照有一个巨大的好处就是任何一次作死修改都能无痛回滚写错的内容不会从历史里消失只会从当版里消失。4.4 让脚本全局可用脚本写好后别忘记给执行权限并放进 PATHchmod x ~/bin/caveman-new ~/bin/caveman-search ~/bin/caveman-archive # 如果你把脚本名定义成 caveman-*可以再做一个软链 ln -s ~/bin/caveman-new /usr/local/bin/cave-new # 可选实际使用中我更建议直接把脚本当成一组以cave开头的小工具凑成一套完整工具箱而不是硬塞进单个命令的“玛璐德”。如果你在 zsh 里开了补全命令敲到一半就能看到所有候选体验相当顺滑。5. 常见问题与排查技巧实录5.1 文件多了找不到怎么办刚开始用caveman时我一度膨胀到往收件箱里堆了 100 多个文件结果收件箱变成了垃圾回收站。后来我强制给自己加了一条规则任何进入收件箱的文件24 小时内必须归档或删除。归档的准则是有长期价值就移入20-areas跟具体交付相关就移入10-projects连自己都不知道留着干嘛的一律删掉。即便归档做得再好偶尔还是会在找资料时大脑短路。这时候别硬用rg了我常用的救援组合是# 模糊查找只记得大概主题词 find ~/cave -name *跑步* # 内容查找只记得某句话 rg -l 心律 ~/cave # 高频查看找出最近两周改过的所有文件 find ~/cave -name *.md -mtime -14这三个命令覆盖了“记不住名字”“记不住路径”“记不住时间”三种经典记忆模糊场景基本能做到十秒内定位。这里特别强调rg -l的-l参数只打印文件名而不打印匹配内容在资料多的时候输出体验会清爽好几倍。5.2 跨设备同步的冲突处理Git 做同步很棒最烦人的场景是两台设备同时改了一个文件。我踩过这个坑经验如下先看冲突长什么样Git 会把、、这三段标记直接写进文件里。处理冲突的方法靠的不是什么高深技术而是冷静三步走打开冲突文件先看上下两段各自写了什么结合git log --oneline -5看最近改动背景判断哪版才是真正的新内容手动删除冲突标记保留正确内容再git addgit commit注意如果你发现某个文件反复成为冲突焦点几乎可以断定是这台设备上用了旧版本覆盖新版本。最好的规避方式是在切设备前先git pull一遍不要凭“记得上次已经同步过了”的风险直觉操作。5.3 我差点放弃的几个瞬间从项目启动到今天稳定使用中间确实有差点放弃的阶段。分享一下当时最想弃坑的瞬间以及最后是怎么走出来的。最想弃坑的时候是第三周当时新建文件、归档、搜索这套流程已经跑熟但发现每周写回顾总结时我还要一份份翻各个分类的文件人工汇总超累。那时我一度想引入数据库、想上一个本地 Wiki差点让方案从极简走向复杂。后来我换了个思路既然有 git为什么不借 git log 生成周报基础数据我写了个每周回顾脚本把所有20-areas下的本周新建/修改文件列出按文件名排序输出。这么一来回顾时我只需要对着清单看一遍回忆成本大幅下降。所以我的心得是工具“原始”不代表不能自动化恰恰是因为数据和命令足够原始自动化反而变得无比容易。另一个想弃坑的瞬间是某次误操作把整个~/cave目录删了。当时大脑一片空白幸好 Git 自动提交救了我——一分钟后我已经通过git reset --hard HEAD~0把仓库完整恢复。当时特别庆幸自己坚持了自动化提交否则几年的知识资产就真的变成了“一顿操作猛如虎回到解放前”。5.4 更多避坑心得别在文件名里用中文空格和特殊符号虽然 mac/Linux 都支持但跨设备同步、url 化、搜索时容易出幺蛾子。个人经验是用“-”连接干净利落。模板不要加无意义的大段示例模板是激励你自己写的不是展示“格式精美的样板书”。留核心骨架其他都是干扰。定期做全量备份Git 仓库虽然保留历史但如果你把整个目录拷贝到 U 盘时忽略了.git文件夹那版本历史就没带走。我一般每月做一次tar -czf cave.tar.gz ~/cave存到另一个物理硬碟上。GPG 加密不要成为日常习惯日常默认明文加密只做特殊章节的隐私保护。一旦你养成了“什么都加密”的情绪检索效率会断崖式下跌。6. 扩展方向如何把“洞窟”变成根据地caveman项目想走得更远可以像给岩洞接水电一样陆续添加配置。下面列的是我给自己的扩展路线图你完全可以根据实际需要选做。Quick Capture 集成手机端不便打开电脑快速记录时我临时用一个共享收件目录把随手拍的照片、灵感语音通过自带“文件传输”功能丢进00-inbox回来后统一整理。这功能无需写代码一个 SFTP 或者 WebDAV 挂载即可完成。周期报告自动化用脚本直接生成“月报”摘要。grep 当月所有文件里的关键标题按领域分组输出 Markdown 报告。以前觉得这种操作得写几百行代码实际上用awk和循环就能做得很像样。索引文件自动生成在~/cave/下维护一个README.md每次归档时自动把目录编号和分类说明更新到里面新加入的设备或协作者一目了然看懂全貌。与前端的轻量联动如果你懂一点 Node/Python可写一个极简本地服务把~/cave当作数据源渲染成网页实现手机浏览器阅读和检索。这层是可选的因为caveman的核心永远是底层文件系统上层表现随时可换。我个人目前最想做的后续动作是把它和定时任务深度整合每周日晚自动统计本周新增内容、显示未归档数量并提醒我完成归档与回顾。这样整个系统才真正像一个有生命的“洞窟”不断积累、清点、沉淀而不是静静地躺在硬盘某个角落吃灰。7. 写在最后的一点私人体会做caveman这个项目最打动我的不是它比某些大厂软件多了什么功能恰恰是它少了很多东西。它不催我交月费不推荐我升级套餐不在我写作时弹窗广告更不会在我笔记数量达到一万条时倒逼我要么接受付费、要么忍受卡顿。我现在每天打开终端的频率远高于打开任何笔记软件这种“返祖体验”反而让我觉得掌控感极强——我的每一条想法都落在一个可见、可控、可移动的普通文件里这种感觉像是自己重新做回了数字世界的主人。如果你也对那些越来越重的知识工具感到疲惫不妨找一个下午照着上面的步骤搭建一个属于自己的caveman那种简洁带来的踏实感试过才知道。