docs: 完善 README.md，增加常见问题排查指南 (FAQ)

README.md

@@ -51,7 +51,27 @@ Emby & Jellyfin 中文字幕插件，支持 **迅雷影音**、**射手网** 字
 
 **注意**：建议在媒体库设置中**不勾选**本插件作为默认下载器，仅在手动“编辑字幕”或“搜索字幕”时使用，以获得最佳体验。
 
-### Jellyfin 安装 (推荐)
+## 常见问题排查 (FAQ)
+
+如果您在搜索字幕时遇到“未找到结果”，请按以下步骤排查：
+
+### 1. 语言代码识别
+- **现象**: 在 Jellyfin 10.11+ 中搜索不到字幕。
+- **原因**: 新版 Jellyfin 可能会传递三位字母代码 (如 `zho`)。
+- **解决**: 本插件最新版已修复该问题，支持 `zho`、`chi`、`zh-CN` 等多种映射。请确保您使用的是最新版本的 DLL。
+
+### 2. 射手网 API 状态
+- **现象**: 部分电影能搜到，部分完全搜不到。
+- **原因**: 射手网 API 年久失修，对于无资源或 Hash 不匹配的文件，API 可能返回异常内容（如乱码）。
+- **表现**: 插件已增加防御性校验，若检测到 API 返回异常，会自动过滤并返回空结果以保证系统稳定。
+
+### 3. 如何反馈问题
+如果遇到确定有字幕但搜不到的情况，请查看服务器日志并提供以下关键信息：
+- 搜索开始时的 `Target` 文件名。
+- 接口返回的 `ResponseBody` 内容。
+- 计算得到的 `FileHash` 值。
+
+## Jellyfin 安装 (推荐)
 
 Jellyfin 用户可以通过添加插件存储库实现一键安装和自动更新：