核心用法
BangunAI Blog Manager 是一套面向 React + Vite + MDX 技术栈的数字花园内容管理方案，专注于知识型博客的撰写、组织与发布。核心功能覆盖三大维度：
内容创作层：支持 6 种内容类型（writing/articles/read/daily/about/now），每种类型配有标准化 YAML frontmatter。写作时可直接调用 14 种 Callout、Mermaid 11 图表、KaTeX 数学公式、WikiLink 双向链接、YouTube 嵌入等 MDX 组件，语法兼容 Obsidian 风格（如 > [!info] 块引用）。
工作流自动化层：内置 8 条 shell 工作流——daily 自动生成带任务滚转的日笔记；fetch_last 拉取最新文件作为风格参考；write 按模板创建标准化文章；log 追加时间戳日志；read 智能搜索内容；update_about/update_now 更新静态页面；verify_index 统计内容资产。
技术集成层：基于 import.meta.glob 的零配置自动导入系统，新 MDX 文件创建即生效，无需手动注册路由。
显著优点
1. Obsidian 生态平替：双向链接、反向链接面板、知识图谱视图、标签系统完整复刻，且基于开源 Web 技术栈，摆脱本地软件锁定。
2. 前端现代架构：React 18 + TypeScript + Tailwind CSS + shadcn/ui，组件化程度高，可扩展性强。
3. 内容即代码：Git 版本控制、代码审查友好、支持 CI/CD 自动化部署。
4. 多格式统一：技术教程、阅读笔记、日常日志、Now/About 页面共用同一套设计系统与组件库。
5. 自动化减负：任务滚转、阅读时间估算、内容统计等重复劳动脚本化。
潜在缺点与局限
- 本地文件系统依赖：所有工作流硬编码
/home/hades/BangunAI-Blog路径，跨设备或容器环境需手动适配。 - 无云端同步机制：依赖用户自行配置 Git 或第三方同步，无内置冲突解决策略。
- MDX 学习曲线：非 Markdown 用户需适应 JSX 语法与组件化思维，调试 frontmatter 错误需熟悉构建日志。
- Shell 脚本维护：工作流以 bash 实现，Windows 用户需 WSL 或重写为 PowerShell。
- Graph View 性能：大规模知识库下力导向图可能卡顿，未提及虚拟化或分页优化。
适合人群
- 技术博主、开发者布道师，希望将笔记系统公开为数字花园
- Obsidian 重度用户寻求 Web 发布方案
- 偏好 Git 工作流、拒绝 SaaS 绑定的内容创作者
- 需要技术文档与个人博客统一管理的全栈工程师
常规风险
- 路径遍历风险：
fetch_last等脚本若 CATEGORY 参数未严格校验，可能被利用读取敏感文件（当前实现通过 case 语句白名单缓解）。 - frontmatter 注入：用户输入未经转义直接拼接进 YAML，若内容含
---或特殊字符可能破坏解析。 - Mermaid/LaTeX XSS：客户端渲染数学与图表时，需确保 KaTeX 与 Mermaid 版本无已知 CVE，避免恶意 LaTeX 或图表定义执行脚本。
- Git 凭据暴露：自动化提交若配置不当，可能将 token 或密钥写入历史记录。
- 依赖过时：技能文档未指定依赖版本锁定策略，存在供应链攻击面。