Suwayomi/Tachidesk-Server扩展安装后未显示在源列表的技术分析

问题现象

在Suwayomi/Tachidesk-Server项目中，用户反馈安装某些扩展（如Komga和Little Garden）后，虽然扩展显示已成功安装，但在"Sources"源列表中却无法找到这些扩展。通过调试日志可见扩展确实被正确安装并分配了ID，但WebUI界面未正常展示。

技术背景

Suwayomi-Server是基于Tachiyomi核心的漫画服务器解决方案，采用客户端-服务器架构。其扩展系统允许用户通过APK或JAR文件添加新的漫画源。扩展安装后应当自动注册到源管理系统，并在WebUI的源列表中可见。

根本原因

经技术分析，该现象并非真正的功能缺陷，而是由于源过滤机制导致的显示问题：

1. 语言分类机制：系统将扩展按语言分类（如英语、日语等），Komga等扩展被归类到"All"（所有语言）类别而非特定语言分类
2. 默认过滤设置：WebUI界面默认可能只显示特定语言分类（如英语）的扩展源
3. 多源生成特性：从调试日志可见，单个Komga扩展安装时实际注册了多个源ID（4508733312114627536、8074481155021144106等），这是扩展设计的正常行为

解决方案

用户可通过以下方式访问这些"隐藏"的扩展源：

1. 直接URL访问：使用日志中显示的源ID构建URL（如:4567/sources/4508733312114627536）
2. 调整过滤设置：在WebUI中检查是否存在显示所有语言源的选项
3. 界面切换验证：如报告中提到的VUI界面可以显示这些源，说明是特定UI的过滤逻辑差异

技术建议

对于开发者而言，可考虑以下改进方向：

1. 在WebUI中明确显示所有语言分类选项
2. 安装扩展后给出明确的源访问提示
3. 优化日志输出，包含更友好的源访问信息

总结

该案例展示了开源项目中界面逻辑与实际功能实现的差异问题。用户遇到类似现象时，可通过查看服务器日志获取真实ID，或检查不同UI界面的显示差异来解决问题。这反映了良好文档和用户引导在开源项目中的重要性。