Skip to content

批量上传文件

当前行为

在线阅读器的批量上传由管理员使用,前端以 multipart/form-data 向 Node API POST /api/batch-upload-novel 发送一个或多个名为 files 的文件字段。该路由要求 JWT 和管理员角色。

当前校验规则:

  • 一次最多 10 个文件。
  • 每个文件最大 5 MiB。
  • 仅允许 .txt、.md、.markdown 扩展名(大小写不敏感)。
  • 内容必须是有效 UTF-8 文本,拒绝包含 NUL 的内容。
  • 文件在内存中解析后插入 MariaDB book 表;默认作者为“佚名”、价格为 0,摘要取正文前 300 个 UTF-16 code unit。
  • 上传书籍初始不带标签;Node 定时任务之后调用 Python API 生成标签。

超限文件大小返回 413,文件类型/编码不支持返回 415,其他上传格式错误通常返回 400。业务错误响应结构以 Node 的错误处理中间件为准。

客户端调用示例

const formData = new FormData();
files.forEach((file) => formData.append("files", file));
await api.post("/api/batch-upload-novel", formData);

Axios 实例需配置 Authorization: Bearer <token>。不要手工设置 multipart Content-Type,让浏览器生成 boundary。

服务端实现位置

  • 路由和授权:genshin-novel-reader-api-node/src/routes/api.js
  • Multer、数量/大小/扩展名/UTF-8 校验:src/middlewares/upload-novels.js
  • 数据写入:src/routes/api-novel.js
  • 后续标签任务:src/schedule.js

前端阅读器中的批量导入入口只在 online 模式显示;上传能力由服务端 admin 权限决定。