使用 entmesh-analysis

entmesh-analysis 管理统计分析、注册指标、数据可信度、保存分析、看板、事件标注和访问明细。它不负责事件采集，也不管理用户画像规则。

以下命令以 Codex 安装目录为例；Claude Code 把路径中的 ~/.codex/skills 替换为 ~/.claude/skills。

先发现能力和字段

python3 ~/.codex/skills/entmesh-analysis/scripts/entmesh_analysis.py capabilities

python3 ~/.codex/skills/entmesh-analysis/scripts/entmesh_analysis.py fields \
  --from 2026-08-01T00:00:00Z \
  --to 2026-09-01T00:00:00Z \
  --event order_paid

不要凭空发明事件、属性、聚合或可视化；先读取当前项目能力、事件目录和字段目录。

离线生成并运行 V2 分析

generate-* 命令不需要 Entmesh 凭据，也不会发起请求：

python3 ~/.codex/skills/entmesh-analysis/scripts/entmesh_analysis.py generate-event-v2 \
  --metric 指标UUID \
  --from 2026-08-01T00:00:00Z \
  --to 2026-09-01T00:00:00Z \
  --subject user \
  --output analysis.json

人工检查 JSON 后再提交：

python3 ~/.codex/skills/entmesh-analysis/scripts/entmesh_analysis.py run --json analysis.json
python3 ~/.codex/skills/entmesh-analysis/scripts/entmesh_analysis.py wait 分析任务UUID --timeout 120

同样可以使用 generate-funnel-v2 和 generate-retention-v2。V1 自由分析适合临时事件/属性编辑，最长 90 天；V2 只在用户选择治理指标 ID 或长周期事实时使用。

检查数据完整性

python3 ~/.codex/skills/entmesh-analysis/scripts/entmesh_analysis.py data-status \
  --from 2026-08-01T00:00:00Z \
  --to 2026-09-01T00:00:00Z \
  --event order_paid \
  --metric 指标UUID

结果必须同时报告 data_status、覆盖起点、data_through、指标版本和物化缺口。incomplete/unavailable、missing_property 和 skipped run 都不能显示为可信零值，也不能盲目重试。

指标变更流程

# 1. 读取当前资源和乐观锁版本
python3 ~/.codex/skills/entmesh-analysis/scripts/entmesh_analysis.py metric-get 指标UUID

# 2. 激活前查看每个环境的范围与回填计划
python3 ~/.codex/skills/entmesh-analysis/scripts/entmesh_analysis.py metric-activation-plan 指标UUID

# 3. 只有用户明确要求后才执行普通激活
python3 ~/.codex/skills/entmesh-analysis/scripts/entmesh_analysis.py metric-activate \
  指标UUID --effective-from 2026-09-05 --auto-backfill

--historical 会改变历史语义，只能在用户明确要求历史口径变更时使用。范围重算先运行 metric-backfill-preview；重试前先检查 summary、batch 和单个 run。

其他任务

• saved-list/get/create/update/archive/run：保存分析；
• dashboard-list/get/create/update/archive/run：数据看板；
• event-label-list/put/delete：项目级事件可读名称；
• report、report-export：会话、事件和用户明细；
• result-export、drilldown：持久分析结果和下钻。

访问明细可能包含完整 IP、指纹、URL、身份关联和客户属性，只在任务确实需要时申请 reports:* scopes。遇到 409 时重新读取并展示冲突，不自动覆盖。项目 Token 只能取消自己创建的任务。