Skip to content

[P2] macros: date macros inconsistent across APIs — same intent has 3 different syntaxes #1312

@xuyushun441-sys

Description

@xuyushun441-sys

来源: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:编辑器提示

  • 模板编辑时 ${ 触发自动补全列表

验收

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions