#WorkBuddy# 用 WorkBuddy 管住 200 篇本地 Markdown：自动索引 + 断链体检（附零依赖脚本）

---
title: 选题池维护
tags: [内容运营, 流程]
updated: 2026-10-18
---

# 1) 跳过不该扫的目录（隐藏目录一律跳过）
SKIP_DIRS = {".git", ".obsidian", ".trash", ".trash-backup",
             ".workbuddy", ".tools", "node_modules", "__pycache__"}

# 2) 提取 wikilink 之前，先把代码块围栏剔掉，
#    否则教程里写的 [[示例]] 会被当成真链接，凭空多出一堆断链
FENCE_RE = re.compile(r"```.*?```", re.S)
WIKILINK_RE = re.compile(r"\[\[([^\]\|#]+)(?:#[^\]\|]*)?(?:\|[^\]]*)?\]\]")

def extract_wikilinks(body: str) -> list:
    cleaned = FENCE_RE.sub("", body)
    cleaned = re.sub(r"`[^`\n]*`", "", cleaned)
    return [nfc(x.strip()) for x in WIKILINK_RE.findall(cleaned) if x.strip()]

# 3) 建别名表：文件名 / 相对路径 / frontmatter 标题，都算可链接目标
for n in notes:
    alias.setdefault(nfc(n.path.stem), n)          # 文件名
    alias.setdefault(nfc(n.rel[:-3]), n)           # 相对路径
    alias.setdefault(nfc(n.title), n)              # 标题

# 4) 匹配不上的就是断链；入链为 0 的就是孤儿笔记

# macOS / Python 3.13
cd ~/Documents/MyVault            # 换成你自己的库路径
python3 .tools/kb_index.py .

====================================================
知识库：/Users/lee/Documents/MyVault
====================================================
笔记总数   : 8
wikilink   : 10 条，解析成功 8 条
断链       : 2 条
   ✗ 02-方法论/自动化选型 → [[失败自愈]]
   ✗ 02-方法论/自动化选型 → [[定时任务排查清单]]
孤儿笔记   : 3 篇
   · 03-周报/2026-10-06周报
   · 03-周报/2026-10-13周报
   · README
耗时       : 0.7 ms
====================================================
（只读模式，未写文件。加 --write 落盘）

python3 .tools/kb_index.py . --write

> 本文件由 `kb_index.py` 自动生成，**请勿手工编辑**，改了会被下次运行覆盖。

cat > ~/Library/LaunchAgents/com.user.kbindex.plist <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
 "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>com.user.kbindex</string>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/bin/python3</string>
    <string>/Users/lee/Documents/MyVault/.tools/kb_index.py</string>
    <string>/Users/lee/Documents/MyVault</string>
    <string>--write</string>
  </array>
  <key>StartCalendarInterval</key>
  <dict><key>Hour</key><integer>8</integer><key>Minute</key><integer>30</integer></dict>
  <key>StandardOutPath</key><string>/tmp/kbindex.log</string>
  <key>StandardErrorPath</key><string>/tmp/kbindex.err</string>
</dict>
</plist>
EOF

launchctl load -w ~/Library/LaunchAgents/com.user.kbindex.plist
launchctl list | grep kbindex        # 确认已注册

提示词模板（可直接复制）：

读取 ~/Documents/MyVault/00-索引.md 这个文件（只读，不要扫描其他文件）。
基于其中的「按目录」表回答我的问题：{你的问题}
如果索引里的信息不足以回答，告诉我你还需要读哪几篇具体笔记，
把文件名列出来等我确认，不要自己去遍历目录。

listdir: 'Café-が-ě 笔记.md' | NFD? True | NFC? False
朴素匹配:     False     ← 被误判成断链
NFC 归一后:   True