用途:在 TYPO3 项目中编写、编辑、审查或调试 TypoScript、TSconfig 与 Fluid 模板时提供版本感知的本地参考查询,当前目标版本为 v14.3 LTS。
主要能力:通过 scripts/lookup.sh 进行关键词查询,支持 --with-fluid 附带 Fluid 上下文、--recipe 获取常见任务配方、--review 附加弃用警告、--deprecations 列出弃用项、--checklist 获取审查清单(typoscript|tsconfig|fluid)、--lint-rules 查看项目 lint 规则、--debug 调试报错、--update 更新缓存、--version 覆盖版本。
使用方式:编写或审查前先运行 lookup.sh;遵循 required/deprecated/recommended/tip 标注;写 TypoScript 前检查 --lint-rules。新代码采用检测版本的最现代写法;审查旧代码时标记弃用模式并核对 --deprecations。TypoScript 与 Fluid 混合任务使用 --with-fluid。首次运行执行 scripts/lookup.sh --update。
版本要点:v12 使用 FLUIDTEMPLATE、sys_template 静态包含、constants.typoscript;v13 新页面模板优先 PAGEVIEW,引入 Site Sets,使用 settings.definitions.yaml;v14 Site Sets 强制,PAGEVIEW 为标准页面渲染方式(FLUIDTEMPLATE 为遗留但未正式弃用),@import 强制(INCLUDE_TYPOSCRIPT 移除),getTSFE() 条件移除,资源路径优先 PKG: 而非 EXT:。版本相关问题需查阅 references/review/deprecations.md 及对应迁移指南。
审查流程:按文件类型运行 --checklist,按项目版本过滤 --deprecations,交叉参考 common-mistakes.md,检查 security.md 的 Fluid XSS 模式(f:format.raw、f:sanitize.html),检查 performance.md 的 COA_INT/USER_INT 过度使用,关键词查询加 --review 追加弃用上下文。
限制:禁止在生产环境生成 config.no_cache = 1;Fluid 模板中优先 DataProcessors 而非 CONTENT cObject。参考索引涵盖 patterns、debugging、deprecations、security、performance、common-mistakes、迁移指南及 trailing-slash 配方等。具体安装与依赖信息暂未提供。