添加 smanga 服务器

Koharia 内置 smanga 连接，目标是 smanga 4.3 API。服务器必须启用 OPDS，保存连接时 Koharia 会同时验证登录和 OPDS 是否可用。

准备信息

• smanga 服务器地址；可以包含反向代理子路径或 /api 后缀。
• 用户名和密码。
• 服务器已启用 OPDS，且账号可以访问目标媒体库。
• 可选的同一服务器 Wi-Fi 内网地址。

添加步骤

1. 在“库连接管理”中选择“添加连接 → smanga”。
2. 输入连接名称、服务器地址、用户名和密码。
3. 如有需要，在高级地址设置中填写内网地址。
4. 保存连接，等待登录和 OPDS 验证完成。
5. 选择全部媒体库或单个媒体库，再返回书架。

书架与阅读

可以按名称、更新时间或添加时间排序，也可以只显示当前连接中已下载的内容。作品详情支持章节列表、漫画逐页阅读和 PDF 阅读。

书架和详情数据会持久缓存，缓存内容可以在断网时浏览；未缓存的查询仍然需要联网。PDF 必须先取得完整原文件才能渲染页面。

章节进度、已读状态和阅读历史会保存到待同步队列，连接恢复后重试。遇到进度冲突或页面映射变化时，应用会要求确认采用本地或服务器位置。

常见问题

• OPDS 不可用：在 smanga 服务器端开启 OPDS 后重新保存连接。
• 登录失败：确认用户名、密码和反向代理路径，必要时尝试不带 /api 的基础地址。
• 看不到内容：检查当前账号的媒体库权限，或切换“全部媒体库”与单个媒体库。
• 离线阅读失败：确认章节正文已经完整下载，而不是只有书架元数据缓存。