--- title: Vault 专业审查报告 date: 2026-02-25 tags: - meta - review - vault-health type: review-report status: active --- # Vault 专业审查报告 **审查日期**:2026-02-25 **审查方法**:文件结构全量扫描 + frontmatter 统计 + 内容抽样 **索引概况(已校准)**: - 全仓 Markdown:590 - 核心区(00_~06_):541 - 知识区(00_~05_):518 --- ## 总体评分 > [!success] 综合得分:80 / 100 > PARA 框架落地良好,主要短板是 Dataview 失效、Inbox 积压、明文凭据风险和部分结构缺口。 | 维度 | 得分 | |------|------| | 信息架构与 PARA 落地 | 16/20 | | frontmatter 与元数据规范 | 12/15 | | 知识网络(双链密度) | 7/15 | | Inbox 处理与工作流可持续性 | 11/20 | | 安全与一致性 | 8/15 | | 插件生态 | 14/15 | --- ## 主要优点 1. **PARA 结构清晰**:`00_Inbox → 01_Projects → 02_Areas → 03_Resources → 04_Archive` 边界明确,迁移路径可预期。 2. **Hub 文件模式良好**:`Finance.md`、`Blog.md` 等 Area Hub 使用 frontmatter + Dataview 查询的设计思路正确。 3. **frontmatter 覆盖率中等**:核心区 541 篇中 280 篇(51.8%)有 frontmatter。 4. **插件选择合理**:22 个已启用插件覆盖捕获(QuickAdd)、查询(Dataview)、可视化(Excalidraw、Kanban)等关键场景。 --- ## 关键问题与风险 ### 🔴 P0:安全隐患(需立即处理) 在多类技术笔记中发现**明文凭据/令牌模式**,且仓库已纳入 git 历史,存在系统性泄露风险: > [!danger] 高风险文件示例(不限于此) > - **AI/ML 配置**:`03_Resources/Development/AI-ML/` 下 `Azure-config.md`、`Nvidia-config.md` > - **基础设施**:`01_Projects/Infrastructure/Services/` 下的 `Matrix-windy-pc.md`, `Dendrite.md`, `Matrix.md` (数据库密码、AccessToken、Shared Secret) > - **开发工具**:`03_Resources/Development/DevOps/Gitlab/rest api.md` (Private Token) > - **IoT**:`01_Projects/Home-Automation/esphome.md` (API Encryption Key) **建议**:立即执行全库正则扫描(使用 `password|secret|key|token`),将凭据迁移至加密管理器,并在 git 中使用 BFG 或 filter-repo 清除历史记录。 --- ### 🔴 P0:Dataview 查询路径全部失效 Area Hub 中存在 7 处旧路径 `200-area/...`,当前查询均返回空结果: | 文件 | 错误路径 | 正确路径 | |------|----------|----------| | `02_Areas/Finance/Finance.md` | `"200-area/Finance"` | `"02_Areas/Finance"` | | `02_Areas/Blog/Blog.md` | `"200-area/Blog"` | `"02_Areas/Blog"` | | `02_Areas/Health/Health.md` | `"200-area/Health"` | `"02_Areas/Health"` | | `02_Areas/House/House.md` | `"200-area/House"` | `"02_Areas/House"` | | `02_Areas/Personal Development/Personal Development.md` | `"200-area/Personal Development"` | `"02_Areas/Personal Development"` | | `02_Areas/Network & VPN/Network & VPN.md` | `"200-area/Network & VPN"` | `"02_Areas/Network & VPN"` | | `02_Areas/Productivity/Productivity.md` | `"200-area/Productivity"` | `"02_Areas/Productivity"` | --- ### 🟠 P1:Inbox 积压严重 ``` 00_Inbox/Clippings/2023/ 73 篇(积压 2-3 年) 00_Inbox/Clippings/2024/ 127 篇(积压 1-2 年) 00_Inbox/Clippings/2025/ 5 篇 00_Inbox/Clippings/2026/ 11 篇 ``` > [!warning] Inbox 不是归档库 > Capture 流程在正常运转,但 Process(处理→归档/删除)流程已断裂。216 篇未处理的 Clipping 正在消耗认知资源,同时使真正的 Inbox 条目淹没其中。 **建议**:对 2023-2024 年的 Clippings 执行批量决策——超过 90 天未处理即视为过期,直接移入 `04_Archive` 或删除。 --- ### 🟠 P1:知识网络极度稀疏 | 指标 | 数值 | |------|------| | 总笔记数(核心区) | 541 篇 | | `[[wikilink]]` 总数 | 292 处 | | 平均每篇链接数 | **0.54 个** | > [!note] 图谱基本是孤岛 > Obsidian 的核心价值在于发现意料之外的知识连接。当前密度意味着图谱几乎是孤立节点的集合,Obsidian 相对普通文件夹的优势未能体现。 > > 根本原因:大量笔记是技术配置的直接转储,缺少"阅读→思考→链接"的处理步骤。 --- ### 🟡 P2:Vault 根目录污染 当前 vault 是“知识库 + 自动化脚本”混合仓库,根目录包含较多工程文件。对纯笔记视角属于噪音,对开发工作流则是必要资产。 **工程文件**(如仅用于 Obsidian,可考虑外移;如持续使用脚本则应保留) - `node_modules/`、`package.json`、`package-lock.json`、`pnpm-lock.yaml` **元文档**(可按偏好统一归入 `06_Metadata/`) - `ULTRA_SIMPLE_WORKFLOW.md` - `WORKFLOW_TRANSITION_GUIDE.md` - `WORKFLOW_SIMPLIFICATION_ANALYSIS.md` - `WEEKLY_REVIEW.md` - `QUICK_REFERENCE.md` - `CHANGELOG.md` - `REFACTOR_SUMMARY.md` - `AGENTS.md`、`CONTRIBUTING.md`、`CLAUDE-BOOTSTRAP.md` **孤立文件**:`2026-01-05.md`(位于根目录,未归入任何目录) --- ### 🟡 P2:内容重复与目录混乱 **重复内容** - `02_Areas/Lifestyle/Cooking/Pickled-Cucumber-Recipe.md` 与 `03_Resources/Cooking/Pickled-Cucumber-Recipe.md` 内容高度重复(前者多 frontmatter) - `03_Resources/Cooking/` 内部冗余:`Pickled-Cucumber.md` (说明) 与 `Pickled-Cucumber-Recipe.md` (记录) 建议合并 - `02_Areas/Lifestyle/Cooking`、`02_Areas/Lifestyle/Gaming` 应为 Resources,不是 Areas(Areas = 持续的责任领域,菜谱是资源) **重复目录** - `03_Resources/PKM/` 与 `03_Resources/Personal Knowledge Management/` — 同一概念两个入口 --- ### 🟡 P2:插件使用与安装不匹配 - `dataview` 已安装,但 Hub 文件查询全部失效(见 P0) - `obsidian-tasks-plugin` 已安装,任务语法存在(约 105 行),但与插件能力相比使用深度有限 - `calendar` 已安装,但日期笔记只有零散几篇,没有形成每日笔记习惯 - `templater-obsidian` 与 `quickadd` 功能重叠,建议选一个作为主力 - 已启用插件 22 个,但启用列表中有 2 个插件目录缺失:`obsidian-opencode`、`opencode-obsidian` **缺失**:建议安装 `linter` 插件自动规范 frontmatter 格式,减少人工维护成本。 --- ### 🟡 P2:结构缺口(新增) - `02_Areas/GFW` 缺少同名 Hub 文件 - `02_Areas/Job` 缺少同名 Hub 文件 - `02_Areas/Lifestyle` 缺少同名 Hub 文件 --- ## 行动清单 - [ ] 🔴 **全库凭据清理**:使用正则全量搜索并清除 `01_Projects` 和 `03_Resources` 中的明文密钥 - [ ] 🔴 批量修复所有 Area Hub 的 Dataview 查询路径(需包含子目录层级) - [ ] 🟠 将根目录的元文档批量移入 `06_Metadata/` - [ ] 🟠 合并 `03_Resources/PKM` 与 `03_Resources/Personal Knowledge Management` - [ ] 🟠 合并 `03_Resources/Cooking/` 下的冗余笔记,并从 `02_Areas` 迁移内容 - [ ] 🟡 对 2023-2024 年的 Inbox Clippings 执行批量归档/删除决策 - [ ] 🟡 补齐 `02_Areas/GFW`、`02_Areas/Job`、`02_Areas/Lifestyle` 的 Hub 文件 - [ ] 🟡 修复或移除已启用但缺失目录的插件配置(`obsidian-opencode`、`opencode-obsidian`) - [ ] 🟡 建立每周 Inbox 清零的处理习惯(建议固定时间,30 分钟内完成) - [ ] 🟢 为 Projects 和 Areas 笔记补充双向链接,逐步建立知识网络 --- ## 参考(已校准) - [[00_Inbox/IMPROVEMENT_PLAN_2026-02-03]] — 上次改进计划 - [[06_Metadata/IMPROVEMENT_PLAN_2026-02-25]] — 本次修复计划(含执行阶段与计划审核) - [[REVIEW_REPORT_2026-02-03]] — 上次审查报告(评分 86/100)