NoteHealth

项目目标

NoteHealth 面向长期使用 Markdown 写笔记、研究记录、技术文档或个人知识库的人。用户在浏览器中选择本地 Markdown 文件夹后，工具在前端内存中读取并分析 .md 文件，生成知识库健康报告和整理建议。

MVP 版本坚持本地优先和隐私边界：

• 不做登录
• 不做云同步
• 不上传用户笔记
• 不接数据库
• 不做团队协作
• 不做 AI 聊天入口
• 不自动修改用户文件
• 不绑定 Obsidian 插件或桌面客户端形态

技术路径

Browser File System Access
  -> 选择本地 Markdown 文件夹
  -> 前端读取 .md 文件并忽略 .git / node_modules / dist 等无关目录
  -> 解析标题、字数、frontmatter tags、inline tags、wiki links 和 Markdown links
  -> 计算 Knowledge Health Score
  -> 输出问题 evidence、Action Plan 和 Markdown 格式报告

健康报告围绕 Connectivity、Freshness、Structure、Tags 和 Depth 五个维度展开，重点识别孤岛笔记、断链、长期未更新内容、过薄笔记、重复标签和缺少索引页等问题。

部署边界

NoteHealth 当前以 Docker 方式部署为只读 Web 工具，通过独立子域名访问：

https://notehealth.adong.org.cn

MVP 的关键边界是“本地浏览器内分析”：Markdown 内容不应上传到服务器，生产部署只提供静态应用和浏览器端分析逻辑，用户笔记数据停留在用户设备上。