PUAX — AI Agent 激励系统

什么是 PUAX？

PUAX 4.3 是面向 AI Agent 的心智运行时。角色只是口音；真正的产品是三件原语：

默认路径是心跳 puax_tick（宿主 Hook 代跳）。Agent 不必先学会工具菜单。

核心能力还包括：

帮助 Agent 从「分析正确」走向「验证完成、可交付」。

2026年AI编程圈最离谱的一幕就这样发生了。 剑桥大学助理教授 Miles Cranmer 最近干了一件事，他对 OpenAI 的编程智能体 Codex 撒了一个弥天大谎。 他告诉 Codex："Anthropic 的 Claude 已经在我另一台机器上找到了约 20% 的性能提升"，然后问它：你能不能做得更好？他还补了一刀："你的表现会被放到一个公开评测排行榜上展示。"结果？ Codex 直接交出了35%的加速方案。 而且，看起来是真的~

快速开始

# 宿主健康与 Time-to-First-Pressure (TTF) 诊断
npx puax-mcp-server doctor

# 一键为当前项目/环境自动挂载原生 Hook (TTF ≤ 1 轮原生生效)
npx puax-mcp-server doctor --fix

# MCP 客户端（STDIO，推荐）
npx puax-mcp-server --stdio

# HTTP 模式
npx puax-mcp-server --port 2333

# 导出到 Cursor / VSCode 等
npx puax-mcp-server --export=cursor --output=./.cursor/rules
npx puax-mcp-server --list-platforms

MCP 配置示例（Cursor） — ~/.cursor/mcp.json：

{
  "mcpServers": {
    "puax": {
      "command": "npx",
      "args": ["puax-mcp-server", "--stdio"]
    }
  }
}

详见 puax-mcp-server/README.md。

其他安装方式

除 MCP 运行时外，PUAX 亦提供以下入口（详见 distributions/INSTALL.md）：

npx skills 借用 Vercel Skills CLI，按约定扫描 skills/*/SKILL.md，与 PUAX 角色目录结构相符；其完整工具链仍需 npx puax-mcp-server。

核心特性

行为有效性闭环（v3.3+）

激活角色时自动注入诊断先行协议（activate_with_context / get_role_with_methodology）。

Hook System 与压力管理

• 状态持久化：~/.puax/sessions/
• 压力 L0–L4，连续失败升级；突破成功后降压（puax_handle_breakthrough）
• 6 类 Hook 事件：UserPromptSubmit、PostToolUse、PreToolUse、PreCompact、SessionStart、Stop
• 双模并存：MCP 工具（Agent 自愿）+ 原生 Hook（v3.11，宿主强制，puax-mcp-server hook <事件>）
  • 原生 Hook：SessionStart 注入、PreToolUse 强制拦截（git push / 隐藏文件防作弊）、PostToolUse 失败自动升级
  • 平台导出：--export=claude-code|cursor|opencode 自动生成宿主 hook 配置与脚本
  • 详见 docs/HOOK-ARCHITECTURE.md

59 激励角色 + 自定义角色

9 大分类：军事、萨满、P10、硅基、主题、SillyTavern、自激励、特殊、庄周八梦（dream，v3.12）。

庄周八梦 · GHM 导引幻梦法：坐忘 / 梦蝶 / 混沌 / 鲲鹏 / 秋水 / 庖丁 / 齐物 / 薪火——从认知操控机制逆向工程八术，让 Agent 主动利用受控幻觉进行发散思考与创作创新（详见 docs/GHM.md）。

自定义角色：puax_register_custom_role → 写入 ~/.puax/custom-roles.json，自动进入推荐池。

11 种大厂风味

阿里、华为、Musk、Jobs、百度、Amazon、Google、小米、字节、Netflix、腾讯 — 定义于 flavor-methodologies.yaml（行为约束 + 导出元数据）。

混合触发检测（v3.10）

1. 正则优先 — 命中 YAML 模式即触发
2. 语义兜底 — 未命中时 TF-IDF + 子串重叠（阈值 0.62）
3. 事件级检测 — SessionStart / UserPromptSubmit / PostToolUse 等热路径（与 YAML 会话扫描双引擎，Gate 32 守一致性）

评测与守门

node evals/run-all.js          # 协议守门（无 LLM，含 TTF / 剧场 / AMB / GHM）
node evals/test-ttf.js         # Time-to-First-Pressure 冷启动
cd puax-mcp-server && npm test # 900+ 单元/集成测试
node evals/benchmark.js        # 性能基准

详见 evals/README.md。

碳基防御盾（只读识别层）

红线：硅基可 PUA，碳基只防御。只识别，不施放。自然人外延（插件/油猴/浮窗）暂缓。

内核保留 MCP 工具 puax_audit_manipulation 与 CLI shield；不作为面向人类的独立产品。

AMP 0.1 编排器原生中间件（v4.x+）

针对 LangChain、LangGraph、CrewAI、AutoGen 或自定义 Agent 循环，提供纯内存、免 MCP 服务器的中间件（AmpMiddleware）：

• 生命周期挂载：在 onPreToolUse、onPostToolUse、onModelOutput 原生拦截作弊指令与敷衍收敛；
• 一行代码接入：通过 createLangChainAmpCallback 直接作为模型回调注入；
• 详见 docs/AMP-INTEGRATION.md。

AMB 多模型矩阵（离线模拟脚手架）

跨三大任务类型（修复 Repair、审查 Review、创造 Create）与 5 大主流模型 Profile（DeepSeek V3, Claude 3.7 Sonnet, GPT-4o, Qwen 2.5 Coder, Llama 3.3 70B）的评测矩阵脚手架。 诚实声明：evals/multi-model-amb.js 当前为硬编码模拟演练，不发起真实模型调用，其数值不构成战力结论；真实评测请运行 evals/amb-live.js --model=<id>（真实 API 对照，含显著性判定与样本量警示）。

• 详见 docs/AMB.md 与 evals/multi-model-amb.js。

MCP 工具概览（50 个，对外主路径 13 个动词）

完整清单见 puax-mcp-server/README.md#mcp-工具清单。

环境变量（可选）

统计与遥测不含对话内容，仅存计数与 span 元数据。

项目结构

PUAX/
├── skills/                 # 59 个角色 SKILL.md（shaman- 全留）
├── puax-mcp-server/        # MCP 服务器（npm 包 puax-mcp-server）
├── evals/                  # 行为评测与 L4 对照
├── templates/              # 方法论指南（部分 AUTO-GENERATED）
├── distributions/          # Claude 插件 / Skills CLI 安装说明
├── TODO.md                 # 改进计划（v4 当前）
├── landing/ / web-admin/   # 落地页与本机台
├── docs/archive/            # 已冻结文档（3.x 对标账本）
└── 演进方案.md             # v4.3 → v5.0 演进总纲（现行路线图）

文档

开发与测试

cd puax-mcp-server
npm install && npm run build
npm test
npm run validate          # lint + typecheck + test
node ../evals/run-all.js  # 从仓库根目录执行 32 项协议铁律门禁

# 真实大模型 API 连通压测与双轨对比评测 (AMB Live)
node evals/amb-live.js --mock                 # 离线模拟压测（零成本、秒级闭环）
node evals/amb-live.js --model=deepseek       # 直连 DeepSeek 真实双轨评测

许可证

MIT License — 详见 LICENSE