来源:docs/PLATFORM_GAPS_FROM_TEMPLATES.md 第 11 条(P2)。
现象
日期 / 时间相关的「宏」在不同 API 之间不一致:
- analytics filter:
{today} / {30_days_from_now} / {last_quarter_start}
- view filter:可能用
now() / today() 表达式
- CEL formula:
today() 函数
- flow value:又是另一套字符串约定
模板作者写一个模板要在 4 个地方查不同的宏名 / 函数名,反复踩坑。
复现
content 模板 dashboard filter 用 {last_quarter_start} 能工作
- 同样语义在 view filter 写
{last_quarter_start} 不识别
- 在 flow 节点 value 字段又得换成别的
建议范围
M1:统一宏 / 函数命名表
- 单一来源的宏字典(doc + spec 校验)
${today} / ${now} / ${days_ago:30} / ${days_from_now:30} / ${start_of:week} / ${start_of:quarter} 等
M2:所有 API 共用
- view filter / analytics filter / flow value / formula 统一解析
- 不再有「这里写宏 / 那里写函数」的二元化
M3:编辑器提示
验收
现象
日期 / 时间相关的「宏」在不同 API 之间不一致:
{today}/{30_days_from_now}/{last_quarter_start}now()/today()表达式today()函数模板作者写一个模板要在 4 个地方查不同的宏名 / 函数名,反复踩坑。
复现
content模板 dashboard filter 用{last_quarter_start}能工作{last_quarter_start}不识别建议范围
M1:统一宏 / 函数命名表
${today}/${now}/${days_ago:30}/${days_from_now:30}/${start_of:week}/${start_of:quarter}等M2:所有 API 共用
M3:编辑器提示
${触发自动补全列表验收