一个人的战争 | 凝霜的成长历程

SCM Breeze 平替与泛化: 打造更灵活的命令行增强工具

Sat, 09 Aug 2025 00:00:00 GMT

简介

SCM Breeze 是一个 git 命令行的增强工具, 其核心功能是给 git status 返回的文件加上数字编号, 后续的 git add 等命令可以直接使用这个编号, 而无需复制/粘贴文件名.

使用原生 git 命令行:

git add assets/git_breeze/config* assets/git_breeze/install.sh

使用 SCM Breeze 则是 (下面三种都可以):

ga $e2 $e3 $e11
ga 2 3 11
ga 2-3 11

为什么要替代 SCM Breeze

SCM Breeze 有如下痛点:

它预先定义了过多的 alias, 而如果恰好你用 Oh My Zsh 这种方案, 会有大量的冲突
它无法自由地跟系统指令进行组合, 仅限于 git 一个场景
其实现过于复杂, 想进行扩展非常困难

而在看到 Migrating away from SCM Breeze 这篇文章以后, 我发现这个博主给的解决方案非常优雅, 而且极具扩展性.

开启替代之旅

先睹为快

定义核心诉求

核心框架要足够简单, 并且可以自由扩展
可以扩展到日常高频的使用场景 (ls, grep...)
所有指令、别名都可以自定义, 符合个人使用习惯

原理解析

以下面的命令为例:

function l {
    { __print-path-argument $@; eza -lah --time-style=long-iso --color=always $@ } \
        | add-index --input-type eza_list --print-indexables | set-index-variables
}
compdef _ls l

第一部分是原始命令的输出 (__print-path-argument 这个可以先忽略):

第二部分则是给原有信息加上类似 [1] 这种数字序号, 再追加 @@indexables@@ 元信息.

NOTE: add-index 这个适配了 ag, git, ls, eza, tree 等专用命令, 以及一个通用的 list 格式.

第三部分则去掉元信息部分, 并且设置环境变量 ($e1 这种形式):

经过上面的步骤, 在执行特定的指令以后, 环境变量里会设置 e1 ... eN, 保存的是相应文件的路径.

接下来是展开部分的魔法:

function expand-indexes-or-expand-or-complete {
    # ...
}
zle -N expand-indexes-or-expand-or-complete

注册好这个自定义补全方法后, 会自动展示命令行输入的序号等信息.

# 输入 ls 1-2 按 Tab 键, 会被自动展开成
ls /Users/mdl/Code/NsLib/blog-code-snippet/scm-breeze-alternative/add-index /Users/mdl/Code/NsLib/blog-code-snippet/scm-breeze-alternative/README.md

完整方案

代码见: https://github.com/NsLib/blog-code-snippet/tree/master/scm-breeze-alternative

这里不是一个开箱即用的完整方案, 而是需要你自行整合进自己现有的 zsh 配置中:

add-index 文件放到自己喜欢的 bin 目录, 例如:
- ~/.local/bin/add-index
- /usr/local/bin/add-index
theme.yml 文件放到 ~/.config/eza/theme.yml (注意: eza 适配了这个主题的配色, 想用其他的要自行适配)
zshrc 则整合进自己的 ~/.zshrc

总结

生产力工具这个事情, 最好是自己动手, 这样才能真正适合自己的使用习惯.

使用 Obsidian 和 Astro 搭建个人博客

Mon, 12 May 2025 00:00:00 GMT

选型

编辑器: Obsidian
静态网站生成器: Astro
博客主题: Astrofy (自行扩充了很多功能)
部署: Cloudflare Pages

博客初始化

这里仅给出一些核心命令, 详情可以参考官网或者其他文章.

# 使用 astrofy 主题初始化博客
pnpm create astro@latest --template manuelernestog/astrofy

cd demo
# 安装依赖
pnpm install

# 启动本地开发服务，预览博客
pnpm run dev

# 构建可部署的静态网站
pnpm exec astro build

Obsidian 配置

博主日常使用 Obsidian 来维护笔记, 因此在写博客时也希望保持一致的编辑体验.

NOTE: 拥有低启动成本非常重要, 博客停更这几年, 有很多次想重新写, 但是因为编辑体验不好直接放弃.

插件 - Paste Image Rename

这个插件可以在粘贴图片时, 自动命名为 {{fileName}}-{{自增后缀}} 形式, 省去手动命名的烦恼.

配置如下图所示:

插件 - Linter

用于格式化 Markdown 并统一风格. 每个人的偏好不一样, 根据实际情况配置即可.

Obsidian 目录配置

初始化用于图片及附件的目录结构:

# 在项目根目录创建 images 文件夹, 用于存放图片及附件
mkdir images

cd public
# 创建符号链接, 用于 `Astro` 导出
ln -s ../images images

目录说明:

images: 存储图片及附件, Obsidian 内需要配置成此目录.
public/images: 软连接到 images 目录, 供 Astro 导出使用.
src/content/blog: 存放博客的 Markdown 文件 (如果想通过软链接把文章放到项目根目录, 需要修改 Astro 的解析规则, 让其跟随符号链接)

NOTE: 不能直接使用 public/images 目录作为图片目录, 因为本地贴图时链接为 ![xxx](public/images/xxx.jpg), 但是发布以后的真实路径是 images/xxx.jpg (Astro 规则限制).

关键配置已在下图中标记, 供参考:

部署博客

由于后续还想给博客添加服务端能力, 因此将部署平台从 GitHub Pages 迁移至 Cloudflare Pages.

部署操作比较简单, 这里给出官方文档, 按照步骤操作即可:

Astro 官网: Deploy your Astro Site to Cloudflare
Cloudflare Pages 官网: Framework guides - Astro

我的个人数据备份方案

Fri, 09 May 2025 00:00:00 GMT

背景

最近, 我的群晖 NAS 中一块刚使用一年的硬盘开始频繁报警, 因此我重新审视了目前的备份策略. 也正因如此, 催生了这篇文章.

基础知识

3-2-1 备份策略

这部分我直接引用 Dropbox 文章中的定义, 感兴趣的读者可以参考原文: 什么是“3-2-1 备份策略”？如何使用该策略？

3-2-1 原则是一种数据备份策略, 旨在确保您的数据可以在数据丢失事件发生后快速得到恢复和还原.

简而言之, 这种常用的备份策略涉及创建

三份数据副本
其中两份副本存储在本地的不同介质上，例如一份存储在电脑的内置硬盘上，一份存储在外置硬盘等可移动存储设备上
一份数据副本远程存储在云备份软件等异地解决方案中

实施 3-2-1 备份策略的目, 的是为了降低『单点故障』可能造成的影响. 这意味着, 如果您的一台设备崩溃并清除了一份数据副本, 那并不是世界末日您手头还有两个选择可以挽救局面!

WebDAV

WebDAV 是一种基于 Web 的文件管理协议, 常被用于文件远程访问和同步, 便于与多种软件集成.

详细定义请参考: WebDAV - 维基百科

RAID

RAID (Redundant Array of Independent Disks, 独立冗余磁盘阵列) 是一种将多个硬盘组合成一个逻辑存储单元的技术, 用于提升性能或实现数据冗余, 或两者兼具.

详细定义请参考: RAID - 维基百科

旧备份方案

我的群晖是一个双盘位的 NAS, 而在民用设备上配置 RAID 5 的做法, 其实很难做到真正的容错, 踩过坑的人都懂.

数据副本如下:

群晖 NAS 1 号盘位
群晖 NAS 2 号盘位
Backblaze B2 (对象存储非常便宜)
移动硬盘 (冷备)
百度云

NOTE: 至于为什么需要这么多分副本, 可以参考前文提到的「3-2-1 备份策略」

其中, 1 号盘位中的 /照片归档/files 路径是主数据源, 其他备份均由 Cloud Sync 工具从此路径同步.

Backblaze B2 备份

WebDAV 备份

这里通过 WebDAV 协议实现一块磁盘向另一块磁盘备份, 算是一个比较 Tricky 的做法.

/照片归档本地备份 位于 2 号盘位中, 我选用多副本而不是 RAID 5 来保证数据可靠性.

百度云备份

他给的实在是太多了.jpg (🐶

日常备份流程

定期把需要备份的数据上传到 NAS 1 号盘位中的 /照片归档/files
后续由 Cloud Sync 自动完成同步与备份

新备份方案

由于我有一套完整的 HomeLab 环境, 因此我的 NAS 使用场景其实非常有限, 故我准备完全脱离 NAS 来构建我长久的数据备份方案 (降本).

数据副本:

Mac Studio 内置硬盘: /Users/mdl/HomeLab
Mac Studio 外置移动硬盘: /Volumes/NsLib/全量备份
NUC 内置硬盘: /home/mdl/HomeLab
BackBlaze B2: b2://NsLib-manual-backup/照片归档
百度云盘: 全量备份
Google Drive: 全量备份

Mac Studio 内置硬盘 (主数据源)

这份数据是原始数据, 其他数据源均基于它来做同步.

我通过 Syncthing 工具把 /Users/mdl/HomeLab 与 NUC 上的 /home/mdl/HomeLab 做成同步盘, 实时热备.

Mac Studio 外置移动硬盘

我目前是挂载了一块三星 SSD T5 EVO 来存储大量的数据 (毕竟苹果家硬盘是金子做的).

NUC 内置硬盘

与我的 Mac Studio 数据源实时同步, 确保数据始终有两份副本.

BackBlaze B2

可以直接通过下面的命令做同步:

b2 sync "/Volumes/NsLib/全量备份/照片归档" "b2://NsLib-manual-backup/照片归档"

百度云盘 & Google Drive

目前是准备每半年手工上传一次, 不太想依赖工具, 因为长时间跨度下, 工具本身的升级维护成本其实也不小.

日常备份流程

日常的文件直接操作 Mac Studio 内置硬盘 /Users/mdl/HomeLab
Mac Studio 和 NUC 通过 Syncthing 实时同步, 因此随时会有两份完整副本 (自动)
定时任务自动同步到 BackBlaze B2, Mac Studio 外置移动硬盘
每半年手工上传到百度云和 Google Drive

总结

通过这次方案重构, 我成功将核心数据从 NAS 体系中抽离, 新方案成本更低, 更利于长期维护.

未来, 我只会将 NAS 用作普通云盘, 存储一些例如电影这种不需要可靠性的数据.

TODO: 寻找 Cloud Sync 的替代品, 尝试把新方案完全自动化.

使用 git-crypt 加密你的笔记

Wed, 07 May 2025 00:00:00 GMT

背景

市面上有很多主打隐私保护、内置加密功能的笔记应用, 但它们往往存在以下问题:

数据存储在云端, 用户无法掌控自己的数据
使用专有格式, 迁移不便
功能缺失 (例如: Vim 的键位对我是刚需)
无法高效与命令行组合使用, 即使支持本地存储, 也通常是加密格式, 难以直接操作

目标

支持任意编辑器/软件 (基于文件系统)
自动透明加解密
- 本地存储时是明文 (重要)
- 推送到 GitHub 等代码托管平台时自动加密
采用成熟可靠的加密方案
无服务端依赖
适合团队协作 (可选)

前置知识

GnuPG
GPG Suite

NOTE: 推荐使用 GPG Suite 来创建和管理密钥.

不了解 GnuPG 的同学强烈建议学习一下, 它是你打开新世界大门的钥匙 (GitHub 的提交签名了解下). 给几个参考资料供大家自行学习.

实践

安装

https://github.com/AGWA/git-crypt
https://gpgtools.org/

brew install git-crypt gpg-suite

配置

创建密钥对的过程略.

准备要用到的 GitHub 仓库:

git clone git@github.com:NsLib/dummy-repo.git

cd dummy-repo
git-crypt init

创建 .gitattributes 文件, 内容如下:

*.md filter=git-crypt diff=git-crypt
KnowledgeBase/** filter=git-crypt diff=git-crypt
Templates/** filter=git-crypt diff=git-crypt
assets/** filter=git-crypt diff=git-crypt

简单解释下上面的内容:

KnowledgeBase, Templates, assets 目录下的所有目录及文件都加密
filter=git-crypt diff=git-crypt 让你的 git diff 等工具链可以比对明文 (自动解密)

添加加密用的密钥:

git-crypt add-gpg-user "MDL13412 (personal) <xxx@example.org>"

提交本地的所有修改:

git add -A
git commit -m "init"
git push

在 GitHub 上查看 README.md 文件时, 会发现已经无法解析, 如下所示:

下载此文件, cat README.md:

查看本地仓库内的文件:

场景演示

使用 VSCode 新建 a.md, 内容如下:

提交此文件:

本地工具链查看 diff:

推送到 GitHub:

git push

查看 GitHub 上文件:

总结

使用 git-crypt 可以达成我们前面设定的目标, 但是也会有如下缺点, 请自行参考:

GnuPG 的上手门槛较高 (但是这东西学会了收益极大, 以后可能会写文章介绍)
这种方案由于性能问题, 不适合海量/大文件场景 (不过我在公司的工作笔记几百个文件日常使用无感)

aText教程

Tue, 29 Oct 2019 00:00:00 GMT

简介

aText 是一款文字输入效率工具，可以配置常用的文本、代码模板、邮件模板等，并通过短语形式进行触发替换。国内的同学可能听过名气更大的 TextExpander，但是 TextExpander 改成订阅制后性价比极低，且很多细节甚至没有 aText 打磨的精细，所以个人更推荐 aText。

这里给大家推荐一个视频，大家可以通过演示了解 aText 的基本功能。

基本配置

在菜单栏中选择 aText - Show aText...：

创建一个分组，参数按下图配置即可，注意 Abbreviation prefix 建议开启，这样可以大幅减少误操作。

创建一个片段：

输入 `test，再输入 空格、Tab、回车 等按键即可触发补全：

使用变量

选择 Insert - Field 来插入一个简单的变量：

这里我们使用最简单的 Single-line 类型，并勾选 Editable 选项，允许我们补全时进行修改：

输入 `var 加 空格 触发补全：

一些使用技巧

可以通过设置多个相同的触发词来进行补全选择，这种情况下，一般推荐填写 Label 来进行区分：

在候选补全列表弹出时，可以使用数字键快速选择；在弹出的补全模板窗口中，可以使用 Tab 键切换到下一个输入框，Shift + Tab 切换到前一个输入框。

总结

本文简单介绍了 aText 的基本使用方法，但其功能远不止如此，有兴趣的同学可以自行探索。

另外，如果是购买了 Alfred Powerpack 的用户，可以看看 Alfred 的 Snippets 功能，基本可以达到 aText 功能的 80%。

分享一些高效的Mac软件 (2019 年版本)

Sat, 26 Oct 2019 00:00:00 GMT

分享一些博主日常工作中常用的 Mac 软件，部分收费软件会给出免费的替代品。

NOTE: 本文只介绍图形应用，命令行工具会在后续博文中介绍。

效率

Alfred

官网：https://www.alfredapp.com/
推荐指数：★★★★★
售价：基础功能免费，Alfred Powerpack 版本买断 €29，终身升级 €39

Mac 上鼎鼎大名的效率工具，付费开通 Alfred Powerpack 后，效率更是大幅提升。

可以参考少数派的文章：

aText

官网：https://www.trankynam.com/atext/
推荐指数：★★★★★
售价：¥30

便宜好用的文字效率输入工具，售价 ¥30 的 aText 丝毫不逊色于一年几百块的 TextExpander，甚至有些细节做的更好。建议观看官网上的演示视频，并下载试用(21天免费试用)。

Hammerspoon

官网：https://www.hammerspoon.org/
推荐指数：★★★★★
售价：免费

一个开放式的自动化框架，可以通过 Lua 调用众多系统级别 API，完成诸如窗口管理、快速切换应用、Wifi 自动切换、控制播放器等功能。这款工具因为需要编写 Lua 脚本，因此上手难度较高，但是可定制程度极高。

Unclutter

官网：https://unclutterapp.com/
推荐指数：★★★★
售价：¥140

可通过快捷键或鼠标快速访问剪贴板、笔记、文件，可参考少数派文章在 Mac 上「速记」的正确姿势：Unclutter。

系统

Bartender

官网：https://www.macbartender.com/
推荐指数：★★★
售价：¥112

这款应用用来解决菜单栏图标过多的问题，对于喜欢折腾各种工具的群体很实用。如果不想付费，可以考虑开源免费的 Dozer。

iStat Menus

官网：https://bjango.com/mac/istatmenus/
推荐指数：★★★
售价：¥85

可以很方便的在菜单栏上显示系统的各种状态(CPU 使用率、内存占用、网速、磁盘 I/O)，适合程序员群体。此应用的免费替代品品质与其相差甚远，不做推荐。

ForkLift

官网：https://binarynights.com/
推荐指数：★★★★
售价：¥210

非常强大的双窗口管理工具，可参考少数派上的文章被忽视的 FTP 与文件管理工具：ForkLift 3 for Mac。

阅读

PDF Expert

官网：https://binarynights.com/
推荐指数：★★★
售价：¥570

快速、稳定、美观的 PDF 编辑器，不要被其售价吓到，有很多渠道可以以远低于官网售价的价格购买。

Reeder

官网：https://reederapp.com/
推荐指数：★★★★
售价：¥70

好用、美观的 RSS 阅读器，适合 RSS 重度用户使用。

Calibre

官网：https://calibre-ebook.com/
推荐指数：★★★★
售价：免费

电子书的一站式管理工具，非常强大。博主个人只用来做电子书的格式装换，并不用其来管理电子书。

媒体

IINA

官网：https://iina.io/
推荐指数：★★★★★
售价：免费

macOS 上的现代影音播放器，个人认为是最好用的播放器，没有之一。

HandBrake

官网：https://handbrake.fr/
推荐指数：★★★★★
售价：免费

视频转换工具，压缩比非常好。

Downie

官网：https://software.charliemonroe.net/downie/
推荐指数：★★★★★
售价：¥240

可以下载各种网站上的视频，别再浪费时间找各种免费工具或者网站了，毕竟时间成本也很高。此软件也可以通过第三方渠道购买，比官网便宜很多。

开发

SnippetsLab

官网：https://www.renfei.org/snippets-lab/
推荐指数：★★★★
售价：¥70

代码片段管理工具，日常工作、学习使用效率会很高。

iTerm2

官网：https://www.iterm2.com/
推荐指数：★★★★★
售价：免费

Mac 上最好用的免费终端，同样是没有之一。

CodeRunner

官网：https://coderunnerapp.com/
推荐指数：★★★★★
售价：¥105

可以非常快速的编写一些代码片段验证自己的想法，当然免费的替代品也很多，可以看看 VSCode 中的 Code Runner 插件。

Paw

官网：https://paw.cloud/
推荐指数：★★★★
售价：¥350

号称 Mac 上最高级的 API 工具，测试 HTTP API 非常方便、强大。如果需求不是很多，可以看看免费的 Chrome 插件 Talend API Tester - Free Edition。

Fork

官网：https://git-fork.com/
推荐指数：★★★★★
售价：免费

非常好用的 Git 客户端，支持 Mac 和 Windows 平台。

Sequel Pro

官网：https://www.sequelpro.com/
推荐指数：★★★★★
售价：免费

免费好用的 MySQL 客户端，喜欢命令行的同学，也可以试试 mycli。

旧博客

Sat, 26 Oct 2019 00:00:00 GMT

旧博客 https://blog.csdn.net/mdl13412