支持作者

Notion
终极文件管理方案

_

FastAPI
Vue 3 Web Console
HTTP / SSE
API Key
立即获取 快速开始
Logo
NFM Web Console
v2.0.0-Beta · FastAPI + Vue 3
Beta
Notion Token
已配置
运行中任务
3
缓存管理
自动清理
批量下载
扫描 · 选择 · ZIP 打包 · 链接刷新
批量上传
文件夹 · 子页面 · SSE 进度
STATUS: READY

# NOTICES // 公告

查看全部
Loading notices...

# QUICK START // 快速上手

01

获取程序

下载 Windows 迁移包,或按文档使用 Docker / systemd 部署。默认端口统一为 18765。

02

配置 Token

在 Notion 开发者平台创建集成，获取 Internal Integration Token 并填入设置。

03

开始管理

在页面中添加文件或从数据库批量下载，享受极致的传输体验。

需要更完整的使用文档？

访问 NFM Docs 查看快速开始、部署说明、开放 API 和版本记录。

查看文档 Wiki

# SYSTEM MODULES // 功能矩阵

批量下载引擎

智能探测文件大小，支持多线程并发下载。覆盖全部 Notion 媒体类型，链接过期自动刷新。

  • 支持 file / image / pdf / audio / video 五种媒体块 + 页面 icon/cover + 数据库 files 属性
  • HEAD + Range GET 双策略探测文件大小，精确显示下载量
  • 下载链接过期自动刷新（HTTP 401/403/410 检测），实时速度与 ETA 预测

智能上传系统

自动检测文件类型，使用原生块挂载。队列管理，实时进度反馈。

  • 自动识别文件类型：图片→image 块、视频→video 块、音频→audio 块、PDF→pdf 块
  • 队列化批量上传，跨页面切换任务状态不丢失

工具箱聚合

丰富的 Notion 批量操作工具集，覆盖页面信息查询、数据迁移、批量编辑等场景。

  • 页面大小自动更新/查询：扫描文件块累加大小，自动写入数字属性
  • 数据源迁移：按属性映射批量同步属性值到另一数据库，多线程并发
  • 批量去除页面标题后缀、查看应用日志、清除一切缓存

公告系统

从远端拉取公告索引与 Markdown 正文，卡片流式布局内联渲染，本地缓存与离线回退。

  • markdown-it 渲染 Markdown 正文，支持置顶、标签色块、日期排序
  • 已读管理 + 主页未读提醒横幅，服务端热更新无需发版

主题与缓存策略

在 Web 设置页管理主题色、并发、缓存 TTL 和清理策略，配置统一持久化。

  • 主题色设置：前端实时应用，适配 Element Plus 暗色界面
  • 缓存策略：上传缓存、下载产物和临时 zip 可查看、下载、删除或按 TTL 自动清理

版本检查 & 配置

从发布站读取版本信息和公告，在设置页查看更新内容；当前 v2 Web 不执行自动下载安装。

  • Windows 安装包由 GitHub Release 托管，发布站只提供版本信息和下载入口
  • Notion Token、API 地址、并发数、API Key 和 CORS 白名单可视化配置

# ARCHITECTURE // 技术架构

前后端分离

Vue 3 前端
基于 Vue 3、Vite 和 Element Plus 构建的浏览器控制台
FastAPI 后端
Python 3.11 处理 Notion API、鉴权、任务注册和文件传输
HTTP / SSE 通信
前端通过 REST API 创建任务，通过 Server-Sent Events 接收进度

任务隔离机制

每任务独立实例
Download、Upload、ScanSession 按 task_id 隔离，避免状态污染
后台线程执行
耗时扫描、上传、下载任务在后台运行，不阻塞 Web 请求
统一终态事件
任务完成、失败或取消统一通过 SSE done 事件通知前端

任务与缓存管理

全局任务注册表
统一保存任务状态、进度、重试闭包和产物入口
缓存元数据
上传缓存、下载产物和生成 zip 都带可读名称和稳定存储 ID
运行中保护
自动清理会跳过仍被任务引用的缓存目录

实时进度机制

SSE 推送
浏览器通过 EventSource 订阅任务进度，减少页面主动轮询
任务看板
跨页面查看运行中、完成、失败和取消任务
短期 SSE token
第三方订阅进度使用 nfmsse_ 短期 token，长期 API Key 不放 URL

# TECH STACK // 技术栈

层次 技术 版本 用途
前端框架 Vue 3 + Vite Vue 3 / Vite 5 浏览器端 Web 控制台
UI 组件库 Element Plus 2.7+ 暗色 UI 组件与交互控件
后端框架 FastAPI + Uvicorn Python 3.11 REST API、鉴权、任务调度和静态托管
实时进度 Server-Sent Events sse-starlette 长任务进度、终态和重连
Markdown 渲染 markdown-it 14.x 公告正文渲染
后端逻辑 Python Scripts 3.11+ 文件传输与 Notion API
Logo

准备好体验极致文件管理了吗？

开源免费，可下载 Windows 迁移包本地运行，也可用 Docker / systemd 部署到服务器。

// version.json
Loading...
下载最新 Beta 版 查看文档 Wiki Star on GitHub