Hakuneko项目：OlympusScanlation连接器API参数变更解析

问题背景

在漫画下载工具Hakuneko的使用过程中，用户发现OlympusScanlation连接器突然无法正常工作。经排查，这是由于该漫画网站近期进行了API接口的升级改造，导致原有的请求方式失效。

技术分析

原连接器实现中存在一个关键缺陷：未正确处理网站API的必选参数。网站更新后，其API端点强制要求必须包含type参数才能正常返回漫画列表数据。具体表现为：

1. 请求结构变化：新版API要求所有请求必须携带type=comic参数
2. 错误表现：当缺少该参数时，API会返回错误响应而非漫画数据
3. 调试信息：开发者工具控制台会显示相关网络请求失败信息

解决方案

核心修复方案是对API请求URL进行重构，确保包含所有必需参数。关键代码修改如下：

async _getMangasFromPage(page) {
    const uri = new URL(`/api/series?page=${page}&direction=asc&type=comic`, this.apiUrl);
    // 其余实现代码...
}

该修改主要包含三个重要参数：

• page：分页参数
• direction：排序方向
• type：新增的必选参数，固定值为comic

技术启示

1. API兼容性：第三方工具对接网站API时，需要关注接口规范的变更
2. 参数验证：开发连接器时应完整实现所有必选参数
3. 错误处理：建议增加对API响应数据的验证逻辑，及时发现参数缺失等问题

用户建议

普通用户遇到类似连接器失效问题时，可以：

1. 首先确认网站本身是否可正常访问
2. 检查开发者工具中的网络请求情况
3. 关注项目更新日志，及时升级到最新版本

该修复已合并到Hakuneko主分支，用户更新后即可恢复正常使用。对于其他连接器的类似问题，也可参考此解决思路进行排查。