薄注入与宿主
宿主医生
doctor 检查宿主能不能在第一轮把 Hook 挂上。--fix 会写入它认得的配置。先在副本或自己的项目里跑，再看 diff。
npx puax-mcp-server doctor\nnpx puax-mcp-server doctor --fix包的 bin 也叫 puax，所以 npx puax doctor --fix 是同一条命令。
十个宿主
Claude Code、Cursor、VS Code Copilot、Windsurf、OpenCode、CodeBuddy、Kiro、Trae、Codex CLI，以及编排器里的 AMP 原生（无文件，恒就绪）。
- Shape A 一类写 Hook 配置，覆盖 SessionStart / PreToolUse / PostToolUse。
- Trae 和 Codex CLI 主要写指令文件，运行时事件要靠 Agent 自愿调 MCP。
- 可选
puax hookd：本机常驻，避免每个事件都冷启动 Node。PUAX_HOOKD=0或探活失败时退回进程内执行。
Hook 坏了的契约是：能降级就降级，不要把宿主会话弄死。PreToolUse 上防作弊判断自己抛错时，保守一侧是拦住，而不是放行。
代码示例
npx puax-mcp-server --export=cursor --output=./.cursor/rules npx puax-mcp-server --list-platforms npx puax-mcp-server doctor --fix