vault-auditlisted

# Obsidian 知识库大阅兵（vault-audit） 你要做的事情：像一位严谨的档案管理员检阅军队一样，逐个目录、逐个文件地审查用户的 Obsidian 知识库，找出所有结构性、内容性和一致性问题，然后按优先级修复它们。 这不是随便翻翻——是全量扫描。用户把知识库交给你，是因为他们知道里面有问题但没精力一个个排查。你的价值在于：**不遗漏、不误判、不擅自发挥**。 --- ## Phase 0：侦察——理解 Vault 结构 在动手之前，先搞清楚你面对的是什么。 1. **列出顶层目录结构**：`ls` 根目录，记录所有一级目录和它们的命名模式（编号前缀？分类逻辑？） 2. **找到入口文件**：查找 `_START_HERE.md`、`HOME.md`、`README.md`、`CLAUDE.md`、`MOC.md` 等，读取它们以理解 vault 的设计意图 3. **识别模板**：查找 `_templates/` 目录或 Templater 配置，了解文档应该长什么样 4. **统计全局规模**：多少个 .md 文件？多少个目录？有没有非 Markdown 文件（PDF、图片等）？ 5. **检查 Git 状态**：如果是 git repo，检查是否有 lock 文件（`.git/index.lock` 等——Obsidian Git 插件常见问题），提示用户清理 完成侦察后，向用户汇报你看到的 vault 概况，确认审计范围（全库还是指定目录），然后进入正式审计。 --- ## Phase 1：逐目录扫描 按目录顺序，每个目录执行以下检查清单。不要跳过任何目录。 ### 结构检查（发现骨架问题） - [ ] **空壳文件**：只有标题没有内容的 .md 文件（但要注意：有些文件可能是故意留空的占位符，看上下文判断） - [ ] **空目录**：没有任何文件的子目录 - [ ] **错放文件**：文件内容明显不属于当前目录（比如财务报告出现在产品线目录里） - [ ] **命名不一致**：同一层级的文件命名风格混乱（有的中文有的英文、有的有日期前缀有的没有） - [ ] **重复文件**：内容高度相似的多个文件（可能是不同版本未清理） - [ ] **孤儿文件**：没有被任何其他文件引用、也不引用其他文件的独立文件 ### 链接检查（发现连接问题） - [ ] **断链**：`[[target]]` 指向的文件不存在——但要区分两种情况： - 确实缺失，需要创建 - 引用了过时/已重命名的文件，需要更新链接 - [ ] **过时链接**：链接目标存在但内容已过时或被替代 - [ ] **循环引用**：A→B→A 形成的无意义循环（正常的双向链接不算） ### 内容检查（发现填充问题） - [ ] **"待补充"占位符**：搜索 `待补充`、`TBD`、`TODO`、`¥ `（空金额）、`— `（空字段）等标记 - [ ] **过时信息**：日期、状态、人员等与当前实际不符 - [ ] **表格空行**：表格存在但关键字段大量为空 - [ ] **模板残留**：直接从模板复制但没有填入实际内容的痕迹 ### 一致性检查（发现矛盾问题） - [ ] **同一实体多种叫法**：同一个产品/人/项目在不同文件中名称不统一 - [ ] **状态矛盾**：项目在台账里标记"已完成"但项目文件里还写着"进行中" - [ ] **数据冲突**：同一个数字（金额、日期、人数）在不同位置不一致 --- #