用途：让 TYPO3 项目支持 friendsoftypo3/visual-editor，使编辑者可在前端页面上下文中直接编辑字段与内容区域，而非打开后端表单。关键不只是安装扩展，还需让前端输出可追溯到记录、字段和内容区域。
主要能力：提供后端内的前端编辑模式，支持行内文本编辑、拖拽重排、增删内容元素、实时预览、工作区、可选自动保存、容器支持与 Context Panel 集成。自定义 sitepackage 依赖 Fluid 钩子：f:render.text 标记 TCA 文本字段可编辑；f:render.contentArea 渲染 TYPO3 v14.2+ 页面内容区域；f:mark.contentArea 是 v13 或旧渲染器的回退方案。
使用方式：安装用 ddev composer require friendsoftypo3/visual-editor 后 ddev typo3 cache:flush；无 DDEV 用 composer require friendsoftypo3/visual-editor 与 vendor/bin/typo3 cache:flush；非 Composer 则在扩展管理器中安装并激活 visual_editor、清缓存、按需执行数据库更新。模板迁移：将可编辑文本字段改为 f:render.text，字段名用数据库/TCA 名；v14.2+ 用 f:render.contentArea 替换 lib.dynamicContent 等旧列渲染，并配置 PAGEVIEW 与 page-content；无法迁移时用 f:mark.contentArea 包裹旧渲染器。若模板只有 {data}，需先加 record-transformation。
适用场景：安装/移除该扩展、使 sitepackage 兼容可视化编辑、替换 f:cObject 列渲染、更新 Fluid 模板、诊断行内编辑或拖拽失效、升级 v13/v14 模板至 v14.2+ PAGEVIEW。
限制：Visual Editor 不替代后端表单，复杂字段、媒体替换、权限、校验、本地化、工作区与高级表单仍依赖 TYPO3 后端。f:render.text 不适用于计算值、虚拟 getter、FAL、链接、布尔、选择、日期或已渲染 HTML。需用真实编辑者账号、翻译、工作区与受限权限测试；富文本样式需在前端 CSS 中可用。移除时用 composer remove 或扩展管理器卸载，v14.2+ 可保留 Core ViewHelper。具体版本约束以安装包声明为准。