MCP 服务器使用
v3.10 MCP 工具全景
从 v2.2 Hook System 起步，到 v3.10 已形成完整工具栈。教学站本章只列按任务选型；细节见第 15–17 章。
按目标选工具
| 你的目标 | 推荐工具 |
|---|---|
| 快速判断要不要干预 | puax_quick_detect |
| 有会话、要压力升级 | puax_detect_trigger + puax_start_session |
| 只要推荐哪个角色 | recommend_role（含 score_explanation） |
| 完整 prompt + 方法论 | get_role_with_methodology |
| 一条龙自动化 | activate_with_context |
| 同一思路反复失败 | puax_switch_on_failure |
| 准备改代码前 | puax_check_diagnosis |
| 准备交付前 | puax_confidence_check → puax_verify_completion |
| 长任务 / Compaction | puax_update_reasoning_state |
| 连续失败后终于成功 | puax_handle_breakthrough |
| 会话结束复盘 | puax_record_evolution + puax_end_session |
可选环境变量
| 变量 | 说明 | 默认 |
|---|---|---|
PUAX_USAGE_STATS=0 | 关闭匿名使用统计 | 开启（本地 ~/.puax） |
PUAX_OTEL_ENABLED=1 | 写入 telemetry.jsonl | 关闭 |
PUAX_OTEL_ENDPOINT | OTLP/JSON 导出 | — |
PUAX_TELEMETRY_DIR | 遥测目录 | ~/.puax |
课后测验
使用 PUAX 的首要边界是什么？