维护脚本
3 endpoints.
修复乱码元数据(POST /database/scripts/repair-mojibake)
Section titled “修复乱码元数据(POST /database/scripts/repair-mojibake)”尚未在此参考中描述。这个端点会被列出,是因为服务端确实注册了它,但它的请求与响应形状还没有写下来。
下面这段是 handler 自己的文档注释(crates/lanrurugi-api/src/scripts.rs:61)的译文;原文以源码为准。
POST /database/scripts/repair-mojibake——为什么在导入器早已学会修复之后,已存储的记录里仍可能存在双重编码的文本,见 crate::mojibake 自身的文档。
响应
200该端点已响应;其确切结构尚未记录,见 crates/lanrurugi-api/src/scripts.rs:41 处的 handler。
该响应没有示例数据。
该端点需要管理员令牌:访客(只读)令牌会被服务端拒绝。
请求失败 — 常见原因:实例地址填错或不可达;实例未开启「为客户端 API 启用 CORS」;或者文档站是 HTTPS 而实例是局域网内的纯 HTTP(浏览器按混合内容拦截)。可以用上面的「复制为 cURL」在终端里发同样的请求。
填写你自己的实例地址,请求由浏览器直接发往该地址。
按子目录批量建分类(POST /database/scripts/subfolders-to-categories,扫描档案目录并为每个子目录建一个分类)
Section titled “按子目录批量建分类(POST /database/scripts/subfolders-to-categories,扫描档案目录并为每个子目录建一个分类)”尚未在此参考中描述。这个端点会被列出,是因为服务端确实注册了它,但它的请求与响应形状还没有写下来。
下面这段是 handler 自己的文档注释(crates/lanrurugi-api/src/scripts.rs:182)的译文;原文以源码为准。
POST /database/scripts/subfolders-to-categories——扫描档案目录,并为每个直接包含档案的子目录创建一个静态分类(FolderToCat.pm::run_script)。
响应里会报告它自己的墙上时钟耗时 elapsed_ms(从遍历目录到创建分类,含两端),以便与 plugins/script/foldertocat.ts 直接对比——那是一个真实的 .ts 脚本插件,自己完成完全相同的目录遍历与分组逻辑(用 Deno.readDir,而不是由宿主注入路径——用户要的是真正的正面对比,而不是让插件拿着别人遍历好的数据这种人为构造的场景),用来衡量把这类 I/O 密集的整库扫描放进 Deno 子进程插件沙箱、相对原生 Rust 究竟有多少真实开销。
响应
200该端点已响应;其确切结构尚未记录,见 crates/lanrurugi-api/src/scripts.rs:33 处的 handler。
该响应没有示例数据。
该端点需要管理员令牌:访客(只读)令牌会被服务端拒绝。
请求失败 — 常见原因:实例地址填错或不可达;实例未开启「为客户端 API 启用 CORS」;或者文档站是 HTTPS 而实例是局域网内的纯 HTTP(浏览器按混合内容拦截)。可以用上面的「复制为 cURL」在终端里发同样的请求。
填写你自己的实例地址,请求由浏览器直接发往该地址。
按子目录批量建 Tankoubon(POST /database/scripts/subfolders-to-tankoubons,只扫描第一层子目录)
Section titled “按子目录批量建 Tankoubon(POST /database/scripts/subfolders-to-tankoubons,只扫描第一层子目录)”尚未在此参考中描述。这个端点会被列出,是因为服务端确实注册了它,但它的请求与响应形状还没有写下来。
下面这段是 handler 自己的文档注释(crates/lanrurugi-api/src/scripts.rs:459)的译文;原文以源码为准。
POST /database/scripts/subfolders-to-tankoubons——只扫描档案目录的第一层子目录,并为每个这样的子目录创建一个 Tankoubon。该第一层子目录下的所有档案(包括更深层嵌套子目录里的)都会被加入同一个 Tankoubon;嵌套子目录不会创建自己的 Tankoubon。允许重名;这是非破坏性操作,绝不会删除或去重已有的 Tankoubon。
配置了 DeepSeek API 密钥时,该端点会尽力用 LLM 推断一个更好的 Tankoubon 名称以及一个 artist:/circle: 作者标签。没有密钥、或 LLM 调用失败时,它会回退到原始目录名并跳过作者标签。
响应
200该端点已响应;其确切结构尚未记录,见 crates/lanrurugi-api/src/scripts.rs:37 处的 handler。
该响应没有示例数据。
该端点需要管理员令牌:访客(只读)令牌会被服务端拒绝。
请求失败 — 常见原因:实例地址填错或不可达;实例未开启「为客户端 API 启用 CORS」;或者文档站是 HTTPS 而实例是局域网内的纯 HTTP(浏览器按混合内容拦截)。可以用上面的「复制为 cURL」在终端里发同样的请求。
填写你自己的实例地址,请求由浏览器直接发往该地址。