关于 BYPsNotes 个人知识库

BYPsNotes 是一个基于 Flask 的个人知识管理系统，旨在构建长期可持续、兼顾公开与私密的个人知识体系。

项目目标

• 建立覆盖「天文地理 · 古今中外」为核心，兼顾软件开发、硬件开发、AI 等领域的个人知识库
• 实现本地高效写作 + 服务器优雅发布
• 支持公私分离：公开内容同步至 byp.com.cn，私人内容仅本地使用
• 采用 Markdown 作为核心格式，保证长期可读性和可迁移性
• 未来可扩展搜索、标签、双链等功能

知识库结构

目录结构

BYPsNotes/
├── extern/                         # 公开部分（同步到服务器）
│   ├── notes/                      # Markdown 主文件区
│   └── attachments/                # 全局共用附件
├── intern/                         # 私人部分（永不上传）
│   ├── notes/
│   └── attachments/
├── attachments/                    # 最高层级共用附件
├── static/
│   └── css/
├── templates/                      # Flask 模板
├── routes/                         # Flask 路由、工具函数、数据库
├── db/                             # SQLite 数据库文件
├── app.py                          # Flask 主入口
└── requirements.txt                # Python 依赖

快速开始

1. 在 extern/notes/ 目录下创建 Markdown 笔记文件
2. 在 intern/notes/ 目录下创建私人笔记文件
3. 运行 python app.py 启动开发服务器
4. 访问 http://localhost:5000 查看效果

编写指南

• 📝 笔记 Markdown 编写规范 - 如何编写符合规范的笔记文件

后续功能

• 全文搜索（Whoosh）
• 知识地图 / 双链支持
• 标签系统 + Dataview 风格查询
• 暗黑模式切换
• 静态化导出功能
• 移动端优化

系统状态