184 lines
7.5 KiB
Markdown
184 lines
7.5 KiB
Markdown
|
---
|
|||
|
|
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）
|