SuperAPI AI 工具集

typo3-typoscript-ref

测试与质量

查看项目

更新于 10-15 21:10

技能介绍

用途:在编写、编辑、审查或调试 TYPO3 项目的 TypoScript、TSconfig 与 Fluid 模板时提供版本感知的本地参考查询,并附带始终生效的最佳实践提示。

主要能力:通过 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;新代码用当前版本最现代写法,审查旧代码时标记弃用模式;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。其余收费、平台等信息暂未提供。