用途：为 TYPO3 CMS 接入并调试 Apache Solr 搜索，提供全文检索、分面导航、自动补全，以及在支持的 Solr 9.x 上启用稠密向量/语义能力。
主要能力：EXT:solr 负责核心搜索集成；EXT:tika 用于从文件提取文本与元数据；EXT:solrfal 用于 FAL 文件索引；EXT:solrconsole 提供后台管理控制台；EXT:solrdebugtools 用于查询调试与评分分析。索引流程由 DataHandler 触发 PSR-14 事件，写入索引队列（tx_solr_indexqueue_item），再由 Scheduler Worker 轮询并 POST 文档到 Solr。
使用方式：Composer 安装 apache-solr-for-typo3/solr。本地推荐 DDEV 插件：ddev add-on get ddev/ddev-typo3-solr 后 ddev restart，并在 .ddev/typo3-solr/config.yaml 配置 config、typo3lib 与 configsets，可用 ddev solrctl apply 创建核心、ddev solrctl wipe 删除核心、ddev launch :8984 打开管理界面。生产可用 typo3solr/ext-solr 镜像，数据持久化在 /var/solr。站点配置在 config/sites/<identifier>/config.yaml 中设置 solr_enabled_read、solr_host_read、solr_port_read、solr_scheme_read、solr_path_read、solr_core_read。连接信息建议用 helhum/dotenv-connector 按环境注入，不要硬编码。
适用场景：页面与结构化记录（新闻、活动、产品）索引；需要搜索 PDF、DOCX 等文件内容时再引入 EXT:tika 与 EXT:solrfal。仅索引页面和记录时无需 Tika。
限制：技能目标为 TYPO3 v14.x，需按官方 Version Matrix 匹配 EXT:solr 与 Solr 版本；14.0.x 在 Packagist 上尚无稳定标签，需用 composer require apache-solr-for-typo3/solr:^14.0@beta，稳定版发布后应改回 ^14.0。Apache Solr 9.8.0+ 因 CVE-2025-24814 禁止通过 configset 的 lib 指令加载 JAR，solr-typo3-plugin 需从 /configsets/ext_solr_*/typo3lib/ 移到 Solr 根目录 /typo3lib/，Docker 用户可用 EXT:solr 容器镜像 13.0.1+ 自动完成迁移。EXT:tika 13.1 需 Apache Tika Server/App 3.2.3+，v14 兼容版本暂未提供。托管方案如 Mittwald、hosted-solr.com 的具体价格与规格请以官方页面为准。