Yang's Notes

与 AI 的 Neovim 现代化折腾纪实 (2026版)

yang@yhu.me (Yang Hu) — Mon, 06 Apr 2026 22:30:00 +0800

太久没写代码，重拾 Neovim 时发现不仅肌肉记忆有些生疏，而且因为插件生态的“疯狂内卷”，原来的配置报出了一连串的错误。于是和 AI 结结实实地“折腾”了一番，完成了一次 Neovim 架构的现代化升级。

这篇博客是我和 AI 聊天复盘的摘要记录，方便以后如果又断档了，可以快速接上思路。

1. 认知转换：从“极客生存手册”到“现代 IDE”
#

在重新梳理快捷键和工作流时，AI 敏锐地指出我之前的旧文档思维还停留在原生 Vim 时代。而我现在的配置，其实已经是一个极其现代化的 IDE，工具其实在主动配合直觉：

搜索与查找：从敲命令退化到了全屏互动（全面拥抱 fzf-lua，支持代码预览和悬浮窗）。
精准跳转：不再依赖盲按 j/k 或者原生的标记，而是依靠视觉反馈的 Leap (s 瞬移) 和 Flash (S 语法树节点选择)。
多文件管理：用 Grapple (<leader>ma 打标, <leader>n 轮切) 替代了需要心智负担的数字 Buffer 管理，只把核心文件钉在书签里。
大纲与排错：用 Trouble 和 Aerial 侧边栏替代了底部的纯文本 Quickfix 列表。

2. 踩坑纪实：Treesitter 0.10+ 断代大迁移
#

这次遇到了 Neovim 社区目前最大的一个“断层更新”巨坑。因为我使用了 Neovim 0.12.0，核心 API 的变化导致了连环爆炸：

摄像头崩溃级联排查：LLM 每日健康检查如何发现一个隐藏的 Frigate Bug

yang@yhu.me (Yang Hu) — Fri, 03 Apr 2026 00:00:00 -0800

每日 LLM 健康检查报告显示 10 台摄像头中有 8 台当天崩溃次数达到数百次。追查下去，根因是两台婴儿监控摄像头、一个 go2rtc 重连窗口，以及一次 vaapi 级联崩溃——没有一个环节是直接显而易见的。以下是完整的排查与修复过程。

问题是如何发现的
#

我在搭建一个每日家庭健康代理——一个定时脚本，查询所有家庭服务（Frigate、Home Assistant、Paperless、arr 媒体栈），然后将数据交给本地 LLM 分析。核心思路是：不再手动逐个检查仪表盘，而是每天早上收到一份摘要，自动标出异常项。

Frigate 的检查项查询 /api/stats，提取每台摄像头的崩溃次数。某天早上，报告返回了这样的数据：

1
2
3
4
5
6


nanit_adelia: 2228 次崩溃
nanit_leonard: 2228 次崩溃
backyard: 847 次崩溃
front_door: 391 次崩溃
side_a: 203 次崩溃
...

如果没有健康检查，我根本不会注意到——Frigate 容器本身从未重启，Web UI 上各摄像头仍然显示"在线"，也没有任何告警弹出。

根因：崩溃级联
#

顺着日志往前追，每天上午 9 点的事件链如下：

Claude Code WSL 通知与 WezTerm 窗口聚焦

yang@yhu.me (Yang Hu) — Tue, 24 Mar 2026 00:00:00 -0800

在 WSL 中运行 Claude Code 时，很容易错过它等待输入的时刻——尤其是当你切换到其他窗口的时候。本文记录了我搭建的通知系统：当 Claude 停止响应或请求权限时，会弹出 Windows 气泡通知，点击通知可直接聚焦到对应的 WezTerm 面板。

工作原理
#

Claude Code 在 ~/.claude/settings.json 中提供了钩子（hooks）系统，其中两个事件特别有用：

Stop — Claude 完成一次响应、等待用户输入时触发。钩子载荷包含 last_assistant_message、cwd 和 transcript_path。
PermissionRequest — Claude 需要批准才能运行某个工具（Bash 命令、文件写入等）时触发。载荷包含 tool_name 和 tool_input。

两个钩子均以异步方式（async: true）运行 shell 命令，不会阻塞 Claude。

1
2
3
4
5
6


{
 "hooks": {
 "PermissionRequest": [{ "hooks": [{ "type": "command", "command": "bash ~/.claude/notify-permission.sh", "async": true }] }],
 "Stop": [{ "hooks": [{ "type": "command", "command": "bash ~/.claude/notify-stop.sh", "async": true }] }]
 }
}

脚本说明
#

`~/.claude/notify-stop.sh`
#

从钩子的标准输入 JSON 中提取标题、消息正文和 cwd，然后启动 PowerShell 发送通知：

Frigate 换用 YOLOv9t + OpenVINO（Intel N97）

yang@yhu.me (Yang Hu) — Thu, 19 Mar 2026 00:00:00 -0800

将 Frigate 默认的 SSD MobileNet 检测器替换为 YOLOv9t（tiny），通过 OpenVINO 运行在 Intel N97 的核显上。涵盖模型导出、正确的 Frigate 配置，以及一个会导致 100% 误报的关键坑。

环境
#

服务器： Intel N97（Debian 13），8 路摄像头
Frigate： 0.17，Docker 运行
检测器： OpenVINO GPU（/dev/dri/renderD128）
原模型： SSD MobileNet v2（内置，300×300）
新模型： YOLOv9t ONNX（320×320，8.3 MB）

为什么换 YOLOv9t？
#

Frigate OpenVINO 镜像自带的 SSD MobileNet v2 速度快、资源占用低，但对画面边缘目标和部分遮挡目标的识别能力较弱。YOLOv9t（tiny）在精度上有明显提升，计算量却相差不大——在 320×320 输入、N97 核显约 18ms 推理速度下，跑 8 路摄像头完全够用。

Frigate NVR 配置全记录：从 Docker 到 HA 推送通知

yang@yhu.me (Yang Hu) — Wed, 18 Mar 2026 00:00:00 -0800

在 Debian 服务器（Intel N97）上部署 Frigate NVR，替代传统 NVR 的检测功能。涵盖 Docker Compose、go2rtc 流配置、硬件加速、HA 集成、推送通知及基于区域的告警。 VLAN 间流量经由主路由器（UCG Ultra）转发。

硬件与背景
#

服务器： Intel N97 迷你主机（debian.lan，10.0.10.11），Debian 13
摄像头： 8 台 Reolink PoE 摄像头（摄像头 VLAN，10.0.40.0/24），2 台 Nanit 婴儿监控器（IoT VLAN，10.0.20.0/24）
现有 NVR： 保留运行，负责持续录像；Frigate 专注于检测和事件片段
Home Assistant： 位于 IoT VLAN（10.0.20.10），已运行 MQTT Broker

存储设计
#

录像存储在 NAS 专用共享目录，避免占用本地 NVMe。

使用 paperless-ai 与 Ollama 为 paperless-ngx 添加 AI 文档分类功能

yang@yhu.me (Yang Hu) — Thu, 12 Mar 2026 00:00:00 -0800

本文是一份完整的操作手册，介绍如何通过 paperless-ai 和本地运行的 Ollama 为 paperless-ngx 集成 AI 自动标签和分类功能。整套方案使用本地大语言模型读取文档文本，自动填充元数据字段——包括标题、文档类型、标签、联系人、日期以及自定义字段。

硬件与架构
#

NAS（群晖 DS1621+，10.0.10.10）：在 5656 端口运行 paperless-ngx
台式 PC：Windows，安装了 WSL2、Docker Desktop，配备 RTX 4090
目标：使用本地 LLM 实现 AI 自动打标/分类，零云端依赖

核心架构决策是拉取模式（pull model）：paperless-ai 运行在 WSL2 的 Docker 容器中，轮询 paperless-ngx API 寻找带有 ai-pending 标签的文档，调用 Ollama 处理后将元数据写回。对于不是 24 小时开机的台式机而言，这是最正确的方案——NAS 保存待处理队列，台式机开机后自动消费。

1
2
3
4
5
6
7


paperless-ngx (NAS)
 ↑ ↓ (REST API)
 paperless-ai (WSL2 Docker)
 ↑ ↓ (HTTP)
 Ollama (Windows 原生)
 ↑
 RTX 4090 (GPU)

Ollama 以原生方式运行在 Windows 上（而非 WSL 内），以获得最佳 GPU 访问性能。在 WSL2 的 Docker 容器内，通过特殊主机名 host.docker.internal 访问 Ollama。

在 Plex 中整理本地讲座视频并添加 Metadata

yang@yhu.me (Yang Hu) — Thu, 12 Mar 2026 00:00:00 -0800

如何将本地讲座/课程视频（没有 TMDB/TVDB 收录的）在 Plex 中整理成结构清晰的电视节目，并通过 Plex API 写入自定义描述文字。

示例是 Jonathan Biss 的 Exploring Beethoven’s Piano Sonatas——Curtis 音乐学院与 Coursera 合作的 5 部分课程，存储在 Synology NAS 上。

问题
#

Plex 默认的 metadata 爬虫依赖 TMDB 或 TVDB。没有收录的本地讲座视频要么显示成一堆无封面的乱列表，要么被错误匹配到不相关的节目。

解决方案：将课程当作**电视节目（TV Show）**处理，使用 Plex 的 Personal Media Shows 代理，再通过 Plex API 推送自定义 metadata。

第一步：按 Season/Episode 结构整理文件
#

Plex 的 TV Show 扫描器要求文件名包含 SxxExx：

用 Paperless-ngx 整理十年文档：从 Google Drive 文件夹到全文检索归档库

yang@yhu.me (Yang Hu) — Wed, 11 Mar 2026 00:00:01 -0800

将近十年积累的个人文档从 Google Drive 文件夹体系迁移到 Paperless-ngx 的完整记录。涵盖分类体系设计、从 Google Takeout 批量导入、ML 分类器训练，以及日常收件箱工作流。

为什么要迁移
#

过去多年，我的"文档管理"是一棵手工维护的 Google Drive 文件夹树：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


10 - 文书材料/
 10 - 证件材料/身份证件/
 30 - 移民文档/
 30 - Tax Filing/
 40 - Finance/
 50 - 车辆注册/
 60 - 住房买房/
 80 - Medical/
20 - 家装住房信息/
80 - 旅行计划/

归档时还算顺手，但检索很痛苦。想找"2022 年的保险表格"，要翻六个文件夹，还得猜当时的命名。 Paperless-ngx 提供全文检索、OCR、以及会从你自己的标注中学习的 ML 分类器—— 对于横跨移民手续、税务申报、房产合同、医疗记录的文档库来说，这是本质性的提升。

在 Synology NAS 上通过 CUPS Docker 实现 AirPrint

yang@yhu.me (Yang Hu) — Wed, 11 Mar 2026 00:00:00 -0800

在 Synology NAS 上配置 AirPrint 的操作手册，让 iOS/macOS 设备可以通过局域网打印到 USB 或网络打印机。使用 Docker CUPS 容器和 Synology 内置的 avahi（mDNS）守护进程实现服务发现。

架构
#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


iPhone
 │ mDNS 发现 (_ipp._tcp)
 ▼
Synology avahi-daemon（eth4，端口 5353）
 │ 从 /etc/avahi/services/ 读取服务文件
 │
CUPS Docker 容器（host 网络模式，端口 631）
 │ 生成 /etc/avahi/services/AirPrint-*.service
 │ 将打印任务代理到打印机
 ▼
打印机（如 socket://10.0.20.50:9100）

关键设计决策：

Synology Photos 迁移到 Immich 操作手册

yang@yhu.me (Yang Hu) — Mon, 09 Mar 2026 00:00:00 -0800

将家庭相册从 Synology Photos 迁移到自托管 Immich 实例的个人操作手册。涵盖批量上传、Google Takeout 导入，以及通过 Synology PostgreSQL 数据库重建相册。

环境说明
#

来源：运行 Synology Photos 的 Synology NAS（多用户）
目标：同一 NAS 上自托管的 Immich
上传工具：immich-go v0.31+
客户端：Windows 上的 WSL2，SSH 访问 NAS
相册脚本：自定义 Python（migrate_albums.py），使用 Immich REST API

第一阶段：照片上传
#

策略
#

每位用户有两个来源：

3-4个月宝宝的睡眠训练

yang@yhu.me (Yang Hu) — Thu, 16 May 2024 21:44:33 -0700

四个月睡眠倒退期
#

宝宝进入包含5个不同阶段的新睡眠周期：

REM（快速眼动）：做梦睡眠
第一阶段：非常浅/昏昏欲睡的睡眠
第二阶段：浅睡眠
第三/四阶段：深度恢复性睡眠

宝宝在整个夜晚每隔一两个小时就会进入浅睡眠状态。他们需要学会在浅睡/短暂清醒后自行重新入睡。

七步指南

加满油箱
检查引擎
设定巡航控制
再次补充油量
踩下刹车
规划休息站
卸下包袱

1. 加满油箱
#

白天保持充足的喂奶量。

生长突增期很常见，我们需要根据饥饿信号来喂奶。如果白天喂得不够，宝宝在夜间就需要补充热量。我们要防止"反向循环"：

夜间频繁喂奶 --> 白天吃奶不好 --> 夜间需要更多喂奶

2. 检查引擎
#

审查夜间作息流程

给宝宝独立的睡眠空间
创造有利于入睡的环境

幼儿睡眠训练

yang@yhu.me (Yang Hu) — Sat, 11 May 2024 22:41:36 -0700

为小家伙做好准备
#

B-E-S-T
#

B - Building confidence（建立自信）：聊聊关于睡觉的"好处"。可以表扬他们睡得很好，或者跟他们说自己睡得好、变强壮了，etc. 产生正面影响
E - Expectations（明确期望）：明确表达你对他们的期望，希望他们做什么。“I’m going to give you lots of kisses, and you’re going to lay down on your bed, close your eyes and have a good sleep.”
S - Simulate（模拟练习）：练习睡前流程。“show me how to close your eyes?”; talk to stuffed animals.

Neovim 工作流

yang@yhu.me (Yang Hu) — Tue, 07 May 2024 12:58:05 -0700

与 Vim 相比，Neovim 内置了许多实用插件和功能，Lua 配置也更易读、更强大。以下是一些在 Nvim 中编写代码的实用技巧。

搜索（文件、文本、诊断、帮助）
#

与 search-in-vim 中介绍的技巧类似，我们可以在文件中搜索文本，或通过过滤文件名来查找文件。在 Neovim 中，我们使用 fzf-lua，与 fzf.vim 非常相似。

使用 FZF 选择器

FZF 的界面由一个选择器（对条目列表进行模糊搜索）和一个预览窗口组成。在选择器中，使用 c-j/k/n/p（或 c-u/d）移动。Tab/S-Tab 用于选择文件。默认操作（Enter）是编辑文件或发送到 qflist，具体取决于选中数量。若要编辑多个文件，使用 c-e。

另一个实用命令是"恢复"（<Leader>sr），可以继续上次的 FZF 搜索。

模糊匹配查找文件
#

用途	快捷键	说明
当前目录中的文件	`<Leader>f`	PWD
最近文件（MRU）	`<Leader>o`	非常适合搜索之前打开过的文件
缓冲区的同级文件	`<Leader>s.`	也包含子目录中的文件
项目范围的文件（git）	`<Leader>gf`	只显示 git 跟踪的文件
以缓冲区目录为起点的任意路径	`<Leader>sf`	按 `Enter` 前可以修改路径

搜索文本
#

在文件中 Grep
#

用途	快捷键	说明
当前目录中的文件	`<leader>/`	使用 `keyword -- glob` 过滤文件（`!` 表示排除模式）
Git 根目录	`<leader>g/`	同上
当前 word/WORD	`<leader>w`/`W`	`w` 在可视模式下也有效

实时 grep：两个快捷键都使用"实时 grep"，即每次按键都会运行一条新的 ripgrep 命令并更新结果，可以即时测试 grep 表达式。

在 Vim 中搜索

yang@yhu.me (Yang Hu) — Sun, 09 May 2021 11:33:39 -0700

搜索是开发中最常用也是最重要的操作之一。Vim 提供了非常高效和方便的搜索功能。这篇笔记记录了一些常用的搜索命令、例子以及自定义的 key mapping。

使用 ripgrep 搜索文件内容（:Rg2 或 ,gg，,gw/,gW）
使用 git-grep 搜索 git branch/commit，以及使用 fzf 显示 git grep 的结果（:Ggrep）
使用 fzf/coc list 搜索当前文件/buffers 中的行，实现快速定位/跳转
使用 quickfix lists 快速访问上述搜索的结果，以及利用 :cdo/:cfdo 等命令对结果进行批量操作

在文件中通用搜索
#

Ripgrep 与 fzf
#

fzf.vim 提供了 :Rg 命令来调用 ripgrep 搜索当前目录。不过，我构建了一个更实用的变体，支持指定路径并向 ripgrep 传递其他参数，映射到快捷键 <Leader>gg。

Vim 技巧

yang@yhu.me (Yang Hu) — Thu, 15 Apr 2021 00:01:16 -0700

搜索与处理多个文件
#

搜索
#

关于在文件中搜索词语/符号，请参见 search-in-vim。

要快速按文件名查找并打开文件，我使用 fzf 和 coc-list，以及以下按键绑定。

通用搜索

要在_工作目录_（而非当前文件/缓冲区目录）中打开文件，使用 :Files 或 ,lc（list current，列出当前目录）。

我还创建了快捷命令 ,lf（list file，列出文件），从当前缓冲区所在目录开始，可以在开始搜索前输入路径。

此外，还有 :Buffers / ,b 用于列出已打开的缓冲区，方便快速跳转。当打开了很多文件时非常有用。不过，使用 quickfix 列表、标记，或 :Lines / ,l* 精确跳转到某一行往往更高效。

Git 相关

要打开当前 git 仓库中的文件，使用 :GFiles 或 ,gc（git content），这使用 git ls-files 的文件列表，会遵循 .gitignore。

要只查看已修改的文件，使用 GFiles? 或 ,gs（git status）。

键盘 PCB 设计

yang@yhu.me (Yang Hu) — Sun, 11 Apr 2021 18:37:25 -0700

功能亮点
#

最初我想做一块分体键盘，但由于已经有了一块分体板（crkbd），做一块类似 Arteus/Reviunge 的一体板更有意义。

设计采用激进式行列错位（与我的分体设计相同的列错位），列方向倾斜 15 度。

其他功能：

OLED 状态显示
RGB 底部灯
音频
编码器

STM32 设计考量
#

由于 F072 缺货，将使用 F411。

在 QMK 中配置 STM 芯片的技巧：https://discord.com/channels/440868230475677696/440870965728116754/839978277489082370

查找使用特定芯片的键盘的代码片段：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


 % git grep 'MCU\s*=\s*STM32F411' keyboards/
 keyboards/handwired/onekey/blackpill_f411/rules.mk:MCU = STM32F411
 keyboards/handwired/onekey/blackpill_f411_tinyuf2/rules.mk:MCU = STM32F411
 keyboards/handwired/pill60/blackpill_f411/rules.mk:MCU = STM32F411
 keyboards/handwired/riblee_f411/rules.mk:MCU = STM32F411
 keyboards/matrix/m20add/rules.mk:MCU = STM32F411
 keyboards/matrix/noah/rules.mk:MCU = STM32F411
 keyboards/tkw/grandiceps/rules.mk:MCU = STM32F411
 keyboards/tkw/stoutgat/v2/f411/rules.mk:MCU = STM32F411
 keyboards/zvecr/zv48/f411/rules.mk:MCU = STM32F411

外设的 DMA 通道
#

I2C、SPI、ADC、DAC 等外设使用 DMA 通道。PWM 也可以使用 DMA 以获得更好的性能，例如用于 LED 驱动器。STM32F072 有 7 个 DMA 通道（详情见参考手册）。选择外设时需要谨慎，避免 DMA 通道冲突。

Yang's Notes

与 AI 的 Neovim 现代化折腾纪实 (2026版)

1. 认知转换：从“极客生存手册”到“现代 IDE” #

2. 踩坑纪实：Treesitter 0.10+ 断代大迁移 #

摄像头崩溃级联排查：LLM 每日健康检查如何发现一个隐藏的 Frigate Bug

问题是如何发现的 #

根因：崩溃级联 #

Claude Code WSL 通知与 WezTerm 窗口聚焦

工作原理 #

脚本说明 #

~/.claude/notify-stop.sh #

Frigate 换用 YOLOv9t + OpenVINO（Intel N97）

环境 #

为什么换 YOLOv9t？ #

Frigate NVR 配置全记录：从 Docker 到 HA 推送通知

硬件与背景 #

存储设计 #

使用 paperless-ai 与 Ollama 为 paperless-ngx 添加 AI 文档分类功能

硬件与架构 #

在 Plex 中整理本地讲座视频并添加 Metadata

问题 #

第一步：按 Season/Episode 结构整理文件 #

用 Paperless-ngx 整理十年文档：从 Google Drive 文件夹到全文检索归档库

为什么要迁移 #

在 Synology NAS 上通过 CUPS Docker 实现 AirPrint

架构 #

Synology Photos 迁移到 Immich 操作手册

环境说明 #

第一阶段：照片上传 #

策略 #