使用 entmesh-profile

entmesh-profile 查询已识别用户画像，并安全管理动态标签和条件、ID、受限 SQL 分群。它不负责通用统计分析或事件采集。

查询用户画像

python3 ~/.codex/skills/entmesh-profile/scripts/entmesh_profile.py users \
  --user-id customer-10086 --limit 20

python3 ~/.codex/skills/entmesh-profile/scripts/entmesh_profile.py user 画像subject_id

subject_id 是公开画像标识；外部 user_id 只用于当前项目精确查找，不推断跨项目身份。

查看标签历史：

python3 ~/.codex/skills/entmesh-profile/scripts/entmesh_profile.py history \
  画像subject_id \
  --label-id 标签UUID \
  --from 2026-08-01 \
  --to 2026-09-01

动态标签生命周期

创建或更新前先读取字段目录和标签当前版本。准备 label.json 后：

python3 ~/.codex/skills/entmesh-profile/scripts/entmesh_profile.py label-create --json label.json

python3 ~/.codex/skills/entmesh-profile/scripts/entmesh_profile.py dry-run \
  标签UUID --version 4 --snapshot-date 2026-09-03

python3 ~/.codex/skills/entmesh-profile/scripts/entmesh_profile.py wait-run \
  DryRunUUID --timeout 120

python3 ~/.codex/skills/entmesh-profile/scripts/entmesh_profile.py publish \
  标签UUID --version 4 --dry-run-id DryRunUUID

发布必须引用 24 小时内、与相同草稿版本匹配的成功 Dry run。发生 409 时重新读取并展示冲突，不覆盖他人修改。

历史回填只在用户明确要求后执行，必须位于服务端允许的最近 90 个已完成日期：

python3 ~/.codex/skills/entmesh-profile/scripts/entmesh_profile.py backfill \
  标签UUID --from 2026-08-01 --to 2026-08-31

用户分群

• 条件和 SQL 分群必须先运行 segment-preview --json 并等待匹配预览成功，再创建或更新。
• ID 分群只接受有界 UTF-8 单列 user_id CSV，导入会整批替换成员快照。

python3 ~/.codex/skills/entmesh-profile/scripts/entmesh_profile.py segment-preview --json segment.json
python3 ~/.codex/skills/entmesh-profile/scripts/entmesh_profile.py segment-create --json segment-with-preview.json

python3 ~/.codex/skills/entmesh-profile/scripts/entmesh_profile.py segment-id-import \
  --file users.csv \
  --code high_value_members \
  --name 高价值会员

失败的分群计算不会替换旧活动快照。刷新、归档、发布和回填都需要明确用户请求；Token 只能取消自己创建的画像任务。