笔记
0工具
0此页用于记录用户反馈问题后的每一次改进
关于
“写笔记”支持四种格式——Word 文档、Excel 表格、Markdown、纯文本，起稿或二次编辑时都能随时切换，同一篇笔记想用哪种形态来记，都由你说了算。
md、txt、csv、json 这类纯文本则原样载入，不做多余加工。拿一张现成的表倒进来、改几笔、再导出去，等于白用一台免费的格式转换器。
要带走就在右上角点“下载”，可导出 PDF、Word、Markdown、Excel、TXT 等格式；列表卡片“⋯”菜单里，也有同样的下载入口。
在“工具”页点“＋ 上传工具”即可发布：填好名称与链接，再用 Markdown 把使用方法写清楚——能解决什么问题、怎么装、怎么用，比堆介绍实在。
要分发安装包就一并上传压缩包（ZIP、RAR、7Z、TAR.GZ，最大 35MB），别人在详情页一键下载；只放链接不带附件也可以。
工具按大家的收藏热度排序，好用的自然会被顶上来。发布后可在详情页或卡片菜单里编辑、下架。
写笔记时勾上“隐藏”，这篇就只存在于你自己的账号里：不进列表、不进搜索、不上首页精选，也不会出现在任何公开的页面，链接发给别人同样打不开。
适合放密码、草稿、日记这类只给自己看的内容；想公开，去“发布”打开它，把“隐藏”的勾去掉再保存，之后编辑会默认保持原状态，不会悄悄变回公开。
不想公开、只想临时给人看：点“分享”生成一条带密码和有效期的链接，到期自动失效，你也能随时撤销。
你的内容会同时保存在多个副本上，系统定期做备份与完整性校验，再配合异地容灾机制：就算某台机器出问题，数据也不会丢，可以长期放心存放；特别重要的资料，仍建议你另外再留一份备份。
全站跑在容器化、模块化的现代架构上，更新、部署、回滚都很快，扩展性和稳定性都按长期运营的标准来设计（Built for reliability, designed to scale）。
这个网站最早只是一个人的笔记仓库，后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法，只是干干净净地存放一些东西；既然做好了，就公开出来，万一有人用得上呢。
不做大而全，不做平台梦，保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护：不会突然冒出付费墙，不会在角落塞广告位，也不会把你的数据卖给第三方。
产品会持续迭代，站内日志页记录着每一次改动，改了什么都有迹可循；想了解这个站是怎么一步步走到今天的，翻翻日志就能看到来龙去脉。
如果在这里看到涉嫌违规的内容，点对应卡片右侧的“举报”按钮就能提交，我们会尽快核实处理；也谢谢你花一点时间，一起把这里维护干净。
趋势
Walgit：以Git对象库为灵感的极简文件同步与版本管理工具
Walgit —— 一个用 Rust 编写的、将文件系统视为 Git 对象库的极简同步与快照工具。
引言：当 Git 遇上文件同步
在软件开发的世界里，Git 几乎是无处不在的版本控制标准。但 Git 的设计初衷是管理代码仓库，而不是同步任意目录下的文件。当你试图用 Git 去同步一个包含大文件、二进制文件或频繁变更的目录时，往往会遇到性能瓶颈、仓库膨胀和操作复杂等问题。
Walgit 的出现，正是为了解决这个痛点。它由 Shopify 创始人 Tobi Lütke 发起，用 Rust 实现，核心思想非常大胆且优雅：将本地文件系统直接当作一个 Git 对象库来操作。它不依赖 .git 目录，不维护索引（index），不关心分支和提交历史，它只做一件事：把当前目录下的所有文件内容进行哈希去重，并保存为对象，然后通过一个极简的清单（manifest）记录文件路径与对象 ID 的映射。
解决什么痛点？
- 传统 Git 在大文件和非文本文件上的低效：Git 默认按行 diff，对二进制文件只能整文件存储，导致仓库体积急剧膨胀。Walgit 直接对文件内容做 SHA-256 哈希，相同内容只存一份，天然支持二进制去重。
- 同步场景的复杂性：使用 rsync 或 Dropbox 同步时，你无法回溯到某个时间点的文件状态。Walgit 每次同步都会生成一个不可变的快照（snapshot），你可以随时恢复到任意历史快照。
- .git 目录的脆弱性：Git 仓库如果
.git目录损坏，整个历史就没了。Walgit 将所有对象存储在一个objects目录下，这些对象是内容寻址的，即使 manifest 丢失，也可以通过扫描对象重建目录。 - 操作心智负担：Git 有暂存区、分支、合并、rebase 等概念，对于只想同步文件的人来说过于复杂。Walgit 只有两个核心命令：
walgit snapshot和walgit restore。
安装与快速上手
Walgit 需要 Rust 工具链（1.70+），推荐通过 cargo 安装：
bash
安装
cargo install walgit
或者从源码构建
git clone https://github.com/tobi/walgit.git
cd walgit
cargo build --release
sudo cp target/release/walgit /usr/local/bin/
安装后，进入你想要同步的目录，创建第一个快照：
bash
cd ~/Documents/my_project
walgit snapshot -m "初始快照"
执行后，目录下会生成一个 walgit 目录（默认隐藏，可通过 -d 指定其他位置），内部结构如下：
walgit/
├── objects/ # 内容寻址的对象存储
│ ├── 3a/ # 前两个字符作为分片
│ │ └── b1c2d3... # 剩余哈希作为文件名
│ └── ...
└── manifests/ # 快照清单
└── 2025-04-01_12-00-00.json
查看当前快照列表：
bash
walgit list
恢复某个快照到指定目录（不会覆盖原目录，除非指定 --overwrite）：
bash
walgit restore 2025-04-01_12-00-00 -o /tmp/restored
如果你只想恢复某个文件或子目录：
bash
walgit restore 2025-04-01_12-00-00 --path src/main.rs -o /tmp/restored_main.rs
删除旧快照以释放空间（对象仍会保留，直到垃圾回收）：
bash
walgit prune --keep 5 # 只保留最近5个快照的引用
核心亮点深度剖析
1. 内容寻址的存储引擎
Walgit 的 objects 目录完全模仿 Git 的对象存储。每个文件内容经过 SHA-256 哈希后，取前 2 个字符作为子目录名，剩余 62 个字符作为文件名。这种设计带来两个好处：
- 天然去重：相同内容的文件无论出现在哪里，只存储一份。
- 完整性校验：文件内容本身就是哈希值，任何位翻转都能被检测出来。
与 Git 不同的是，Walgit 不存储树对象（tree objects）。它的 manifest 是一个 JSON 文件，直接记录每个路径对应的对象哈希。这简化了实现，但也意味着移动或重命名文件会产生新的 manifest 条目，而对象本身不变。
2. 无索引、无暂存区的极简模型
Git 的索引（index）是性能瓶颈之一，尤其在大型仓库中。Walgit 完全放弃了索引。每次 snapshot 命令都会全量扫描目录，重新计算所有文件的哈希，并与上一次 manifest 对比，只写入新增或变更的对象。这种“全量扫描+增量写入”的策略，在目录文件数量小于 10 万时表现极佳，且实现逻辑非常清晰。
3. 硬链接与增量同步
Walgit 支持 --hardlink 选项。当启用时，恢复快照时会将对象文件硬链接到目标路径，而不是复制。这意味着如果你有多个快照共享相同内容的对象，磁盘上只有一份物理数据，而多个目录条目指向同一个 inode。这对于节省磁盘空间非常有效，尤其当你在做备份轮转时。
4. 与外部工具无缝集成
由于本质上是一个文件系统目录，你可以直接用任何同步工具（如 rsync、Syncthing）来同步 walgit 目录本身。这带来一个杀手级用法：将 walgit 目录放在云盘或 NAS 上，实现跨设备的加密快照同步。因为对象是内容寻址的，即使同步中断，也不会产生部分写入的文件。
5. 安全设计
默认情况下，Walgit 不会覆盖任何现有文件。restore 到非空目录时会报错，除非你显式传递 --overwrite。这避免了误操作导致的数据丢失。此外，所有操作都是原子性的：先写入临时文件，再重命名为最终名称。
适用场景
- 个人文档备份：对家目录下的文档、图片、配置进行定时快照，保留任意历史版本。
- 项目目录同步：在多个开发机之间同步代码，但不想初始化 Git 仓库（比如临时目录）。
- 数据库导出备份：对 MySQL/PostgreSQL 的 dump 文件做每日快照，利用内容寻址去重，节省大量空间。
- 配置管理：对
/etc或用户配置文件做版本化，配合 cron 定时快照，快速回滚配置错误。 - 离线归档：将不常用的文件目录压缩成 walgit 快照，然后删除原目录，需要时再恢复。
与其他工具对比
| 工具 | 核心机制 | 去重 | 历史版本 | 恢复粒度 | 学习成本 |
|---|---|---|---|---|---|
| Git | 基于快照的版本控制 | 有（但二进制效率低） | 完整 DAG | 任意提交+任意路径 | 高 |
| rsync | 增量文件传输 | 无（只做增量） | 无 | 只能恢复到当前状态 | 中 |
| restic | 加密备份 | 有（内容寻址） | 有（快照） | 快照级 | 中高 |
| bup | 基于 Git 的备份 | 有（分块） | 有 | 文件级 | 中 |
| Walgit | 类 Git 对象库 | 有（整文件） | 有（快照） | 文件/目录级 | 极低 |
Walgit 的优势：
- 比 Git 简单得多（没有分支、合并、冲突解决）。
- 比 rsync 多出历史版本能力。
- 比 restic 轻量（无加密、无远程仓库概念，但可配合外部工具）。
- 比 bup 更易用（bup 需要维护一个 Git 仓库）。
Walgit 的短板：
- 无加密（需要自行加密整个目录）。
- 无网络协议（不能直接推送/拉取远程仓库）。
- 整文件去重，而非分块去重。对于大文件（如虚拟机镜像）内部微小变化，无法高效存储。
- 无并发控制，多进程同时写同一 walgit 目录可能产生冲突。
技术实现细节（Rust 视角）
Walgit 的代码库非常精简（约 2000 行），体现了 Rust 的系统编程优势：
- 使用
rayon进行并行文件哈希计算，在多核 CPU 上能显著提升快照速度。 - 使用
serde_json处理 manifest 序列化，格式稳定且易于手工检查。 - 使用
fs2文件锁来保证同一时刻只有一个进程在写 manifests 目录。 - 使用
clap提供友好的命令行参数解析。
关键代码片段（伪代码）展示了核心逻辑：
rust
fn snapshot(dir: &Path) -> Result {
let mut manifest = Manifest::default();
let files = collect_files(dir)?;
files.par_iter().try_for_each(|path| {
let content = fs::read(path)?;
let hash = sha256(&content);
let obj_path = objects_dir.join(&hash[..2]).join(&hash[2..]);
if !obj_path.exists() {
atomic_write(&obj_path, &content)?;
}
manifest.entries.insert(path.to_string(), hash);
Ok(())
})?;
save_manifest(&manifest)?;
Ok(manifest)
}
社区与维护状态
项目由 Tobi Lütke 发起，目前处于早期阶段（0.x 版本），但 GitHub 上已有 2300+ Stars，说明其理念获得了广泛认可。Issues 中讨论主要集中在：
- 是否支持分块去重（目前不支持）
- 是否支持加密（作者建议使用外部加密文件系统）
- 是否支持 Windows（目前主要面向 Unix 系）
总结
Walgit 不是要取代 Git，也不是要成为下一个 rsync。它是在两者之间找到了一个独特的生态位：一个极简的、内容寻址的、带历史快照的文件同步工具。它的设计哲学是“少即是多”，用不到 2000 行 Rust 代码实现了核心价值，并且留出了足够的扩展空间（比如通过插件支持加密或远程存储）。
如果你厌倦了 Git 的复杂，又需要比 rsync 多一份历史保障，Walgit 值得你花十分钟尝试。它可能不会成为你的日常主力工具，但在某些特定场景（如备份配置文件、同步临时项目目录）下，它会让你觉得“原来可以这么简单”。