用途：Fractor 是通用文件重构工具，负责 TYPO3 升级中的非 PHP 迁移，与处理 PHP 的 Rector 互补。本技能面向 TYPO3 v14.x 目标代码库，上游规则集可能仍以 TYPO3_12、TYPO3_13 等历史名称发布。
主要能力：处理 FlexForms/XML、TypoScript/TSconfig、Fluid 模板、YAML、XLIFF 翻译文件、Htaccess 和 composer.json。提供累积级别集（如 Typo3LevelSetList::UP_TO_TYPO3_14）与单版本集（Typo3SetList::TYPO3_12/13/14），支持跳过规则或文件、单独应用规则。
安装：composer require --dev a9f/typo3-fractor，或 ddev composer require --dev a9f/typo3-fractor。需 PHP 8.2+ 以解析 TYPO3 v14 包。composer.json 处理需额外安装 a9f/fractor-composer-json。
使用方式：运行 vendor/bin/typo3-fractor-init 生成默认配置，或在项目根创建 fractor.php 配置路径与规则集。预览用 vendor/bin/fractor process --dry-run，应用用 vendor/bin/fractor process；DDEV 下加 ddev exec。可用 --no-diffs、--rules-summary、--memory-limit=2G 等选项，v1.0 起移除 --quiet。
限制与安全：绝不在生产环境运行，须在带版本控制的开发环境执行并测试后再发布。使用前应确认所用 API 在 TYPO3 v14 中未被弃用。详细规则与示例请查阅完整指南。