SuperAPI AI 工具集

obsidian-wiki-linter

写作与研究

查看项目

更新于 10-16 08:00

技能介绍

用途:对 Obsidian LLM wiki 做语义层面的健康检查,即所谓 linting。与 audit.py 的结构检查(孤立页、缺失摘要、失效 wikilink)不同,它借助 LLM 分析语义质量:矛盾、知识缺口,以及 wiki 规模变大后才出现的内部一致性需求。

主要能力:检查不一致(两个概念页之间的冲突说法)、缺失概念(现有文章暗示但尚未撰写的主题)、过时文章(内容含糊、陈旧或单薄)、连接候选(应加 wikilink 却未加的概念对)、新文章建议(基于当前范围应覆盖的主题)。

依赖与安装:需要 Python 3.8+,并至少安装 copilot、claude、gemini 中的一个 CLI。安装依赖:pip install -r requirements.txt

使用方式:默认引擎运行语义检查:python ./scripts/lint_wiki.py --wiki-root /path/to/wiki-root;大 wiki 可抽样:python ./scripts/lint_wiki.py --wiki-root /path/to/wiki-root --sample 30;强制指定引擎:python ./scripts/lint_wiki.py --wiki-root /path/to/wiki-root --engine claude;干跑(只打印提示词不调用 LLM):python ./scripts/lint_wiki.py --wiki-root /path/to/wiki-root --dry-run。

引擎回退链:copilot → gpt-5-mini(付费,AI Credits);claude → claude-haiku-4-5(回退,付费);gemini → gemini-3-flash-preview(最终回退,付费)。

输出:报告写入 {wiki-root}/meta/lint-report.md,含 YAML frontmatter(generated_at、engine、model),随后是五个部分:不一致、缺失概念、过时或薄弱文章、连接候选、新文章建议。

适用场景:wiki 达到约 20+ 概念节点后;作为每周维护步骤;感觉 wiki 不一致或碎片化时;在 --save-as 输出归档前先 lint 找缺口;作为 /wiki-rebuild 的最后一步(ingest、distill、build 之后)。

限制:需要 LLM 调用,因此有成本且依赖外部 CLI;始终以退出码 0 结束(仅报告,不阻断);audit.py 无需 LLM、速度快,每次 /wiki-query 前运行,而 lint 应周期性运行。相关脚本:lint_wiki.py(语义检查编排)、audit.py(结构覆盖检查,互补)、distill_wiki.py(共享引擎检测逻辑)。