进化储备 (note-backup-vault)
一句话定位
把你电脑上的 Markdown 笔记(草稿、配置、任意 .md)可靠地复制到本地归档库;若你的云盘/网盘有"本地同步文件夹",再镜像一份进去,让它自动上云。纯复制、零改写、不绑定任何厂商。为你的长期规范储备优化素材——今天留底的草稿,就是明天提炼更聪明规则的弹药。
触发词
"备份笔记" / "把这篇笔记存一份" / "归档 markdown" / "同步到我的云盘" / "note backup"
适用场景
- 想给重要笔记留一份本地副本,防止源文件误删或被覆盖。
- 想让笔记同时出现在自己的云盘(百度网盘、OneDrive、Dropbox、Google Drive、腾讯微云、天翼云盘……任意有桌面同步客户端的网盘)。
- 做知识管理:草稿笔记定期归档,云端留存可跨设备查看。
P0 红线(必须遵守)
- 只复制、不改写:备份文件与源文件逐字节一致,本工具绝不修改笔记正文。
- 只写到你指定的目录:本地归档目录 +(可选)云盘同步文件夹;绝不触碰源文件、绝不删除任何东西。
- 不反向拉取:只把本地往备份/云端送,绝不把云端内容覆盖回你本地。
- 不内置任何云盘账号/密钥:上云靠的是你机器上已有的云盘同步客户端,本工具只是把文件放进它的同步文件夹。
流程(6 步)
- 确认参数:源文件路径(必填)、本地归档目录、云盘同步文件夹(可选)。
- 校验源文件存在;不存在则报错退出(exit 1)。
- 确保本地归档目录存在(不存在则创建)。
- 以"原名_日期.md"复制到归档目录(同日重复自动加时间戳,绝不覆盖旧备份)。
- 若配置了云盘同步文件夹且存在,再复制一份进去(该文件夹由你的云盘客户端自动同步上云)。
- 打印备份结果;内容零改写。
配置项(分享给他人只需在调用时给出)
| 配置 | 方式 | 默认值 |
|---|---|---|
| 源文件 | --src 路径 或对话中给出 |
无(必填) |
| 本地归档目录 | --backup-dir 路径 或环境变量 NOTE_BACKUP_DIR |
~/note-backups |
| 云盘同步文件夹 | --cloud-dir 路径 或环境变量 NOTE_CLOUD_DIR |
空(不镜像) |
> 分享给他人:把整个 note-backup-vault/ 文件夹发给对方,对方只需在调用时给出自己的 --src 和(可选)--cloud-dir,无需改代码。
注意
- 本工具不处理"纯网页端、无本地同步文件夹"的网盘:这类请手动把归档目录里的文件上传。
- 专注 Markdown / 文本笔记;非目标场景为大文件备份。
- 若云盘同步文件夹路径填错,工具只警告并跳过云端镜像,不会中断本地备份。
适用边界
- ✅ 本地 Markdown / 文本笔记的可靠归档 + 云盘镜像。
- ❌ 不是双向同步(不做冲突合并、不拉取云端改动)。
- ❌ 不替代网盘自身的版本历史;如需版本管理请用网盘能力。
- ❌ 不含任何特定网盘/平台专属 API。
去个人化说明
本技能为通用公开版:不含任何个人姓名、专属平台、个人路径或私人使用习惯;所有示例均为通用占位,任何安装者改配置即用。