批量上传文件¶
当前行为¶
在线阅读器的批量上传由管理员使用,前端以 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 权限决定。