系统架构
NoteNow 采用「单后端托管前端静态资源」的部署形态:
| 组件 | 职责 |
|---|---|
| FastAPI 后端 | 鉴权、笔记/笔记本 CRUD、对话、视频转写与分析任务 |
| 前端静态资源 | 由后端 / 与 SPA 回退路由托管 |
| SQLite | 默认业务库(DATABASE_URL) |
| Nginx / OpenResty | TLS 终结;/note/ → 127.0.0.1:8000 |
| ffmpeg / yt-dlp | 视频处理与外链导入 |
浏览器 └─ https://notenow.cn ├─ / → 静态站点 (/var/www/notenow) ├─ /note/* → NoteNow API (127.0.0.1:8000) └─ /agent/* → Agent 服务 (127.0.0.1:8019)客户端调用 API 时,基址应使用:
https://notenow.cn/note后端能力分区
Section titled “后端能力分区”| 模块 | 路径前缀 | 说明 |
|---|---|---|
| Auth | /api/auth/* |
注册、登录、资料、头像、改密 |
| Notebooks | /api/notebooks* |
笔记本列表/创建/更新/删除/移动 |
| Notes | /api/notes* |
笔记 CRUD、保存、导出、重生成大纲 |
| AI | /api/ai/* |
对话、划词动作、转写配置 |
| Video | /api/video/* |
上传/URL 任务、转写、分析 |
| Payment | /api/payment/* |
会员、套餐、订单与配额 |
| Cloud Drive | /api/cloud-drive-resolver/* |
网盘链接解析 |
建议纳入备份:
backend/data/*.db— 业务数据backend/uploads/— 上传文件backend/.env— 密钥与运行配置(勿提交仓库)