一个基于"原子化笔记 + 收藏夹 + 标签 + 数据库优先 + MD/HTML 混合内容 + 窗口化引用"设计哲学的个人知识管理系统，旨在降低心智负担、放大表达与连接的上限。
本系统围绕以下核心理念构建：
- 原子化笔记：每条笔记是最小知识单元，彼此的引用与组织就像原子之间的键合，构成更高阶的知识结构
- 连接优先：笔记之间可相互引用；引入"收藏夹"来以某个角度聚合若干笔记与素材，实现多维度的自由组织
- 数据库优于手工归档：不依赖文件夹层级管理，改以数据库与索引来供需两端解耦，减少人为分类的开销与错位
- 标签多视角：标签为轻量的多属性标注，支持并存的视角与语义，驱动检索与筛选
- 内容多形态：同时支持 Markdown 与 HTML。Markdown关注易写易读；HTML承担更强表现力与交互，适配 AI 时代由模型生成丰富交互内容的趋势
- 窗口化引用：在笔记内容中渲染"打开窗口"的动作，直达目标笔记或收藏夹，现场联动，增强关联说明上限
- 附件即一等公民：图片、视频、文档、脚本等外部资料通过安全签名与引用被纳入知识网络，增强语义上下文
详细设计哲学说明请参考
docs/design-philosophy.md
- 📚 文档管理: 支持Markdown、HTML文档的创建、编辑和管理，支持原子化笔记和相互引用
- 💬 引用记录: 记录和管理有价值的引用、语录和想法，支持多维度聚合组织
- 📎 附件系统: 支持图片、视频、文档和脚本文件的上传和管理，作为一等公民纳入知识网络
- 🖥️ 自定义页面: 创建和展示自定义内容页面，混合排序与编排展示各类内容
- 🔐 安全认证: 基于JWT的用户认证系统
- 🌙 主题切换: 支持明暗主题切换
- 🎨 动态主题（Monet）: 基于壁纸自动提取颜色并生成 Material You 主题，支持5种变体风格（柔和色调、鲜艳活力、表现力强、忠实原色、低饱和柔和）
- 🔍 全局搜索: 跨文档、引用和附件的全局搜索功能
- 🚀 HTML笔记动态化: 支持在HTML笔记中安全地引用由后端统一托管的前端库（如Animate.css, Chart.js等），轻松创建具有丰富交互和动态效果的笔记内容。
- 详细说明请参考：
docs/HTML笔记如何使用后端托管依赖.md - 查看一个具体示例：
docs/调用后端托管Animate.css依赖的html例子.md
- 详细说明请参考：
- 🤖 AI聊天功能: 集成OpenAI兼容的AI服务，支持流式和非流式聊天，可自定义模型和参数，为知识管理提供智能辅助。
- 🎯 AI系统提示词: 支持自定义AI系统提示词预设，可创建多个命名预设并设置默认项，在聊天中灵活切换，为不同场景提供专门的AI助手。
- 前端: React, Redux Toolkit, Material-UI
- 后端: Node.js, Express, MongoDB
- 认证: JWT, bcrypt
- 附件处理: Multer, MIME类型检测
- Node.js >= 16.0.0
- MongoDB >= 4.4
- npm >= 8.0.0
git clone <repository-url>
cd personal-data-hub本项目使用Docker运行MongoDB数据库实例：
# 进入MongoDB配置目录
cd backend/mongodb-compose
# 复制环境变量文件
cp .env.example .env
# 编辑环境变量文件，设置用户名和密码
# 在Windows系统中
notepad .env
# 在Linux/Mac系统中
nano .env
# 复制Docker Compose配置文件
cp docker-compose.yml.example docker-compose.yml
# 编辑docker-compose.yml文件，修改数据卷挂载路径
# 将"数据库数据的主机实际路径"替换为您希望存储数据的实际路径
# 例如: "C:/data/mongodb:/data/db" (Windows)
# 或 "/home/username/data/mongodb:/data/db" (Linux/Mac)
# 启动MongoDB容器
docker-compose up -d
# 检查容器状态
docker-compose ps
# 返回项目根目录
cd ../..# 安装后端依赖
cd backend
npm install
# 安装前端依赖
cd ../frontend
npm install# 在项目根目录执行
cp backend/.env.example backend/.env编辑 backend/.env，按需修改 MongoDB、端口、附件、登录认证配置即可。
破坏性变更：后端只读取
backend/.env；不再读取仓库根目录.env、backend/db.env、port.env、file.env、login.env。
前端基于 Create React App（react-scripts），环境变量文件位于 frontend 目录：
# 在项目根目录执行
cp frontend/.env.example frontend/.env说明：只有以 REACT_APP_ 开头的变量会注入到前端构建产物中。
生成密码哈希值（在 backend 目录运行）：
cd backend
node -e "const bcrypt = require('bcrypt'); bcrypt.hash('你的密码', 10).then(console.log)"
cd ..AI 配置已从环境变量迁移到前端设置页面管理，并由后端以 JSON 文件持久化存储：backend/config/ai/settings.json。
详细说明请参考：docs/AI配置说明.md。
说明：桌面端使用 Bearer Token + 本机网关转发：不依赖 Cookie / CSRF / CORS。登录接口会返回
token，网关会自动注入到后续请求中。
一键启动（开发环境）：
Windows系统:
# 在项目根目录执行
start-dev.batLinux/Mac系统:
# 在项目根目录执行
chmod +x start-dev.sh
./start-dev.sh手动启动（开发环境）：
- 启动后端
cd backend
npm run dev- 启动桌面端
cd frontend
npm install
npm run desktop:dev首次启动在登录页填写服务器地址，例如：http://127.0.0.1:5000（以 backend/.env 的 BACKEND_PORT 为准）。
构建桌面端安装包：在 frontend 目录运行 npm run desktop:build。
使用PM2部署：
# 安装PM2
npm install -g pm2
# 启动应用（推荐方式）
node start-pm2.js
# 查看状态
pm2 status
# 查看日志
pm2 logs
# 重启应用
pm2 restart tab-backend注意: 请使用 node start-pm2.js 而不是 pm2 start ecosystem.config.js，因为前者会先读取端口配置并动态生成适合的配置文件。
桌面端请使用 npm run desktop:build 构建安装包并分发。
# 在backend目录执行
npm run init-data # 初始化示例数据
npm run init-quotes # 初始化引用数据
npm run init-attachments # 初始化附件数据详细配置说明请参考：
docs/AI配置说明.md
AI配置已迁移到前端设置页面管理，不再使用环境变量。
- 启动应用后，在侧边栏点击"设置"
- 在"AI设置"区块中：
- 开启AI功能开关
- 添加供应商预设（API Base URL、API Key、允许的模型列表）
- 选择当前使用的供应商
- 启动应用后，在侧边栏点击"AI Chat"
- 选择你想要使用的AI模型
- 在输入框中输入你的问题或需求
- 按Enter键发送消息，AI会实时回复
- 流式响应: 默认启用流式输出，实时显示AI回复内容
- 模型选择: 支持从可用模型列表中选择不同的AI模型
- 中断生成: 可以随时停止AI的回复生成
- 错误处理: 完善的错误提示和重试机制
- JWT保护: 所有AI请求都需要用户认证
- 系统提示词管理: 支持创建和管理多个AI系统提示词预设，可设置默认预设并在聊天中灵活切换
- 在设置页面的"AI 系统提示词管理"部分创建新的提示词预设
- 为每个提示词设置名称和内容，可选择是否设为默认
- 在AI聊天页面的控制面板中选择要使用的系统提示词：
- "使用默认提示词"：使用在设置中标记为默认的提示词
- "无系统提示词"：不使用任何系统提示词
- 具体提示词名称：使用指定的提示词预设
- 系统会记住您的选择，下次打开聊天页面时自动应用
本系统支持所有兼容OpenAI API规范的服务，包括：
- OpenAI官方API
- Azure OpenAI服务
- 其他兼容OpenAI规范的AI服务提供商
## 使用指南
### 登录系统
1. 启动应用后，访问 `http://localhost:你前面设定的端口号`
2. 使用配置的用户名和密码登录
3. 登录成功后会跳转到主页面
### 文档管理
1. 点击侧边栏的"文档"或访问首页
2. 点击"新建文档"按钮创建新文档
3. 支持Markdown和富文本两种编辑模式
4. 可以为文档添加标签和描述
5. 支持文档搜索和标签筛选
### 引用记录
1. 点击侧边栏的"引用"
2. 点击"新建引用"添加新的引用记录
3. 可以为引用添加来源、标签和分类
4. 支持引用搜索和标签筛选
### 附件管理
1. 点击侧边栏的"附件"
2. 点击"上传附件"按钮上传文件
3. 支持图片、视频、文档和脚本四种类型
4. 可以为附件添加描述和标签
5. 支持附件预览和下载
### 自定义页面
1. 在设置中创建自定义页面
2. 支持HTML、Markdown内容
3. 可以创建多个自定义页面用于展示特定内容
### 全局搜索
1. 使用顶部搜索栏进行全局搜索
2. 搜索范围包括文档、引用和附件
3. 支持关键词高亮显示
## 配置说明
### 附件上传限制
附件上传限制（大小/数量/允许类型/Range/去重/缓存）已迁移为“运行时设置”：
- 文件：`backend/config/runtime/settings.json`（首次启动自动生成）
- 客户端入口：设置 -> 服务器（附件上传限制）
说明：保存后通常需要重启后端进程才会完全生效（PM2 下可 `pm2 restart tab-backend`）。
### 安全配置
生产环境部署时，请务必修改以下安全配置：
1. `backend/.env` 中的 `JWT_SECRET`、`LOGIN_PASSWORD_HASH`
2. 如公网暴露后端：建议开启 `LOGIN_RATE_LIMIT_ENABLED=true`
3. 使用强密码并定期更换
### 数据库优化
1. 定期备份数据库
2. 为大型附件考虑使用对象存储服务
3. 定期清理临时文件和缓存
## 故障排除
### 常见问题
1. **端口冲突**
- 检查 `backend/.env` 中的端口配置（`BACKEND_PORT`）
- 确保端口未被其他程序占用
2. **数据库连接失败**
- 检查 `backend/.env` 中的 MongoDB 连接字符串（`MONGODB_URI`）
- 确认MongoDB服务正在运行
3. **附件上传失败**
- 检查附件存储目录权限
- 确认 `backend/.env` 中的路径配置正确
4. **登录失败**
- 检查 `backend/.env` 中的用户名和密码哈希
- 确认JWT密钥配置正确
### 日志查看
- 开发环境：控制台输出
- 生产环境：查看 `logs/` 目录下的日志文件
## 许可证
本项目采用 MIT 许可证。
## 更新日志
### v1.0.0
- 初始版本发布
- 基本文档、引用和附件管理功能
- 用户认证系统
- 全局搜索功能
### v1.1.0
- 新增动态主题（Monet）功能
- 基于壁纸自动提取颜色并生成 Material You 主题
- 支持4种主题变体：柔和色调、鲜艳活力、表现力强、忠实原色
- 自动适配明暗模式，确保无障碍对比度
- 提供主题预览和手动重新生成功能