Open Source
note-cli
一个把 Markdown 笔记同步到任意目录的命令行小工具,支持双向同步和冲突提示。
背景
我习惯用纯文本记笔记,但笔记散落在笔记本、实验室电脑和服务器上。 网盘同步会改文件时间戳,Git 又太啰嗦,于是写了这个。
用法
# 初始化一个笔记仓库
note init ~/notes
# 把远端的最新内容拉到本地
note pull
# 提交并推送
note push -m "操作系统第三章"
# 查看两边的差异
note diff
⚠️
repo还是占位地址(github.com/yourname/...)—— 仓库建好后换成真实链接,并删掉这段提示。
设计取舍
- 不做实时同步:实时同步意味着处理冲突,冲突处理意味着复杂度爆炸。宁可手动一点。
- 不自己实现传输:底层直接用
rsync,稳定、快、断点续传都是现成的。 - 配置文件只有一个 TOML,没有数据库,出问题用文本编辑器就能修。
现状
自用了一年多,日常够用。已知问题:Windows 上的路径分隔符处理得比较粗糙。