Open Source

note-cli

一个把 Markdown 笔记同步到任意目录的命令行小工具,支持双向同步和冲突提示。

作者 WJYGo★ 34
CLI工具Go

背景

我习惯用纯文本记笔记,但笔记散落在笔记本、实验室电脑和服务器上。 网盘同步会改文件时间戳,Git 又太啰嗦,于是写了这个。

用法

# 初始化一个笔记仓库
note init ~/notes

# 把远端的最新内容拉到本地
note pull

# 提交并推送
note push -m "操作系统第三章"

# 查看两边的差异
note diff

⚠️ repo 还是占位地址(github.com/yourname/...)—— 仓库建好后换成真实链接,并删掉这段提示。

设计取舍

  • 不做实时同步:实时同步意味着处理冲突,冲突处理意味着复杂度爆炸。宁可手动一点。
  • 不自己实现传输:底层直接用 rsync,稳定、快、断点续传都是现成的。
  • 配置文件只有一个 TOML,没有数据库,出问题用文本编辑器就能修。

现状

自用了一年多,日常够用。已知问题:Windows 上的路径分隔符处理得比较粗糙。