平台生态与可观测性

混合触发与可观测性

v3.10 两块关键能力：混合触发与可观测性。

混合触发检测

  1. 正则优先 — YAML pattern 命中即触发
  2. 语义兜底 — 未命中时 TF-IDF + 子串重叠（阈值 0.62）
  3. 增强上下文 — 工具闲置、低质量输出等（Enhanced 路径已并入核心 detector）

可观测性

能力工具 / 配置
匿名使用统计puax_get_usage_stats / puax_set_usage_stats_opt_out
关闭统计PUAX_USAGE_STATS=0
本地 spanPUAX_OTEL_ENABLED=1 → telemetry.jsonl
OTLP 导出PUAX_OTEL_ENDPOINT + puax_flush_telemetry

统计与 span 不含对话正文；测试环境（Jest worker）默认跳过写入。

代码示例 

# 语义也能命中 paraphrase
puax_quick_detect(text="我好像卡住了，换个思路也不知道从哪开始")

# 统计摘要
puax_get_usage_stats()

# 刷出 OTel 缓冲
puax_flush_telemetry()
上一课