用途：对 Markdown/Obsidian 知识库（或指定模块）做只读健康诊断与地图维护，输出结构风险报告，不移动、删除、改名或归档笔记。
主要能力：扫描死链、重复文件名、主标签漂移、未打标、过期文章、读取失败，并检查 20 区与 50 区目录编号漂移；可重建知识库地图（先预览，确认后覆盖配置的地图文件）；可执行 vault 周维护，汇总近 7 天变化并写周简报。
使用方式：提供 vault 路径；如需主标签检查再提供白名单。默认只读，加载命令：python3 scripts/lint_vault.py --vault <vault-path> --json；带标签检查加 --tags "<primary-tag-a>,<primary-tag-b>"。重建地图先运行 python3 scripts/gen_vault_map.py --vault <vault-path> --output <temporary-preview.md>，确认后省略 --output 写入 SOIA_VAULT_MAP_OUTPUT 或默认 <vault>/20_资料库/OB知识库地图.md。仅当用户明确要求保存周报或重建地图时才落盘。
安装：推荐装整个插件 claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-pkm-vault@soia；或单技能 npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-maintain-vault-health -y。Python 3（纯 stdlib）为强依赖。
限制：不删除或移动笔记；不把附件当 Markdown 读取；不处理内容检索，转 soia-pkm-query-vault；标签策略须由客户配置；具体收费、价格与平台支持资料暂未提供。