检测 PersonalWiki 知识库的健康状态,包括孤立页面、矛盾标注、概念缺口、未同步文件。当用户请求"健康检查"、"检查Wiki状态"、"诊断"时使用。
定期或按需检查 Wiki 知识库的完整性和一致性。
术语定义见 AGENTS.md。
无入链的页面。如有价值则添加引用,如无价值则考虑删除或合并。
存在于文件系统但未在 Wiki/Index.md 中列出的页面。更新 Index.md 添加缺失条目。
在页面中引用但目标页面不存在。扫描所有 [[Concepts/xxx]]、[[Entities/xxx]] 链接,检查目标文件是否存在。创建缺失页面。
可能为同一概念的不同表达。使用 qmd 搜索语义相似的概念页面,检查 canonical: false 的别名页面是否正确指向规范条目。
qmd query $'intent: 概念消歧\nvec: 概念定义' \
-c wiki --glob "Concepts/**" -n 10 --min-score 0.7
确认同一概念则合并并添加 aliases;需消歧则保留独立页面。
搜索 > [!warning] 矛盾标注 的页面。人工审核矛盾内容,判断是否需重写相关稳定知识页的"当前综合"部分。
调用 detecting-resources-sync Skill。识别新增、变更、删除、重命名文件。
结构上完整但知识仍然浅层、过时或未沉淀的页面。量化指标与质量评分公式见 health_checklist.md。
检测方法:读取页面 frontmatter 中的 stats 字段;如无则实时计算并填充。识别低质量页面和来源变更(modified)但未重审的页面。
处理建议:
检查 VERSION 和 CHANGELOG.md 是否与当前 Schema 实际状态一致:
参阅 health_checklist.md 中的报告模板。
健康检查结束后,若识别到以下任一情况,必须写入 Wiki/Log.md:
日志类型使用:lint
detecting-resources-sync(检测未同步文件)ingesting-resources(处理未同步文件)| 错误类型 | 处理方式 |
|---|---|
qmd 不可用 | 退化到 Index.md + 文件直读;报告标注"语义检测已降级" |
| frontmatter 缺失统计字段 | 实时计算并补齐 stats,无法计算时标记"待补数据" |
| 链接解析失败 | 报告中输出原始链接文本并标注"需人工确认" |