windy/my-vault
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
main
my-vault/06_Metadata/REVIEW_REPORT_2026-02-25.md
T

7.5 KiB
Raw Permalink Blame History

title, date, tags, type, status
title date tags type status
Vault 专业审查报告 2026-02-25
meta
review
vault-health
review-report 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 笔记补充双向链接，逐步建立知识网络

参考（已校准）

Reference in New Issue View Git Blame Copy Permalink