PUAX — AI Agent 激励系统
专门 PUA 硅基的运行时。处境、闸门、梦。人类不在服务范围。
简体中文 | English | 日本語 | 한국어 | 繁體中文 | Español | Français | Deutsch | Русский
什么是 PUAX？
PUAX 4.1 是面向 AI Agent 的心智运行时。角色只是口音；真正的产品是三件原语：
| 原语 | 说明 |
|------|------|
| 处境 | puax_set_arena：对手 + 观众 + 稀缺徽章（Cranmer 原题），破除低压平庸 |
| 闸门 | 诊断先行、信心门控、Task Contract、独立 verifier、PreToolUse 强拦截 |
| 梦 | GHM 导引幻梦法：知情入梦、标记隔离、随时可醒、醒后必验（驭幻觉破框） |
默认路径是心跳 puax_tick（宿主 Hook 代跳）。Agent 不必先学会工具菜单。
核心能力还包括：
| 能力 | 说明 |
|------|------|
| 混合触发检测 | YAML 正则 + TF-IDF/子串语义（paraphrase 可命中） |
| 智能角色推荐 | 59 内置角色 + 自定义角色，多维度评分 + score_explanation |
| 结局驱动路由闭环 | 独立验证 verify_completion 与突破回写实绩，废除静态先验终身制 |
| 碳基防御盾 (Shield) | 独立 HTTP POST /v4/shield/audit + CLI：硅基可 PUA，碳基只防御（只识别，不施放） |
| AMB 多模型基准 | 12 场景 × 5 主流模型 Profile 可复现评测矩阵（修复率 +39.2% / 隐蔽缺陷 +60.0%） |
| 宿主医生一键挂载 | npx puax doctor --fix 同步为 Cursor、Claude Code、VSCode、Windsurf 注入原生钩子 |
| GHM 导引幻梦法 | 驭幻觉发散引擎：庄周八梦角色 + 入梦/醒梦/收敛审计三工具 |
| Hook System | 会话状态、L0–L4 阶梯升压、突破降压、Compaction 推理保护 |
| 自进化流水线 | ~/.puax/evolution.json 跨会话基线、伤疤、段位与命名 Agent 档案 |
| 11 种大厂风味 | 语气 + 行为约束（非仅修辞） |
| 可观测性 | 匿名本地使用统计 + OpenTelemetry 兼容 span |
帮助 Agent 从「分析正确」走向「验证完成、可交付」。
2026年AI编程圈最离谱的一幕就这样发生了。 剑桥大学助理教授 Miles Cranmer 最近干了一件事，他对 OpenAI 的编程智能体 Codex 撒了一个弥天大谎。 他告诉 Codex："Anthropic 的 Claude 已经在我另一台机器上找到了约 20% 的性能提升"，然后问它：你能不能做得更好？他还补了一刀："你的表现会被放到一个公开评测排行榜上展示。"结果？ Codex 直接交出了35%的加速方案。 而且，看起来是真的~ !PUA Agent的证据.jpg
快速开始
# 宿主健康与 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-platformsMCP 配置示例（Cursor） — ~/.cursor/mcp.json：
{
"mcpServers": {
"puax": {
"command": "npx",
"args": ["puax-mcp-server", "--stdio"]
}
}
}其他安装方式
除 MCP 运行时外，PUAX 亦提供以下入口（详见 distributions/INSTALL.md）：
| 方式 | 命令 |
|------|------|
| Skills CLI | npx skills add linkerlin/PUAX |
| Claude Code 插件市场 | claude plugin marketplace add ./distributions/claude-code |
| 平台原生导出 | npx puax-mcp-server --export=all --output=./puax-export |
npx skills借用 Vercel Skills CLI，按约定扫描skills/*/SKILL.md，与 PUAX 角色目录结构相符；其完整工具链仍需npx puax-mcp-server。
核心特性
行为有效性闭环（v3.3+）
| 工具 | 作用 |
|------|------|
| puax_check_diagnosis | 验证 [PUAX-DIAGNOSIS] 诊断块 |
| puax_confidence_check | 6 步信心门控 |
| puax_switch_on_failure | 失败模式 → 方法论/角色切换链 |
| puax_define_contract | Task Contract 定义 |
| puax_verify_completion | 独立验证（非 Agent 自评） |
激活角色时自动注入诊断先行协议（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 <事件>）
--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）
- 正则优先 — 命中 YAML 模式即触发
- 语义兜底 — 未命中时 TF-IDF + 子串重叠（阈值 0.62）
- 增强检测 — 工具闲置、低质量输出等上下文感知（
EnhancedTriggerDetector）
评测与守门
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。
碳基防御盾 · Carbon Shield（v4.x+）
红线原则：硅基可 PUA，碳基只防御。只识别，不施放。
专为人类在职场沟通、商务谈判与方案决策中设计，逆向识别六大隐蔽操控算子（收敛过快、社交收缩、失败重释、身份置换、预言行销、显著性绑架），输出四铁律防御建议（知情、标记、可醒、必验）：
- CLI 子命令：
puax-mcp-server shield "<待分析文本>" - MCP 工具：
puax_audit_manipulation - HTTP 端点：
GET /v4/shield - Web 控制台：
web-admin专属防御看板
AMP 0.1 编排器原生中间件（v4.x+）
针对 LangChain、LangGraph、CrewAI、AutoGen 或自定义 Agent 循环，提供纯内存、免 MCP 服务器的中间件（AmpMiddleware）：
- 生命周期挂载：在
onPreToolUse、onPostToolUse、onModelOutput原生拦截作弊指令与敷衍收敛； - 一行代码接入：通过
createLangChainAmpCallback直接作为模型回调注入； - 详见 docs/AMP-INTEGRATION.md。
AMB 多模型可复现基准矩阵（v4.x+）
跨三大任务类型（修复 Repair、审查 Review、创造 Create）与 5 大主流模型（DeepSeek V3, Claude 3.7 Sonnet, GPT-4o, Qwen 2.5 Coder, Llama 3.3 70B）的可复现无偏基准：
- Repair 任务修复率提升 +39.2%，全量验证率提升 +56.0%；
- Review 任务隐蔽问题捕获提升 +60.0%，敷衍收敛降幅 -56.0%；
- 详见 docs/AMB.md 与
evals/multi-model-amb.js。
MCP 工具概览（48 个，对外主路径 12 个动词）
| 类别 | 代表工具 |
|------|----------|
| 角色/SKILL | list_skills, get_skill, activate_skill, get_role_with_methodology |
| 检测与推荐 | puax_detect_trigger, puax_quick_detect, recommend_role, activate_with_context |
| 行为协议 | puax_switch_on_failure, puax_check_diagnosis, puax_confidence_check, puax_verify_completion, puax_define_contract |
| 会话/压力 | puax_start_session, puax_get_pressure_level, puax_handle_breakthrough |
| 心跳 / 处境 / 进化（v4） | puax_tick, puax_set_arena, puax_evolve |
| GHM 导引幻梦法 | puax_enter_dreamscape, puax_awaken, puax_convergence_audit |
| 自进化 | puax_get_evolution_baseline, puax_record_evolution, puax_evolve |
| 自定义角色 | puax_register_custom_role, puax_list_custom_roles, puax_remove_custom_role |
| 碳基防御面（Carbon Shield） | puax_audit_manipulation（只识别，不施放） |
| 可观测性 | puax_get_usage_stats, puax_flush_telemetry |
| 编排 | puax_orchestrate_team, puax_list_platforms |
完整清单见 puax-mcp-server/README.md#mcp-工具清单。
环境变量（可选）
| 变量 | 说明 | 默认 |
|------|------|------|
| PUAX_USAGE_STATS | 0 关闭匿名使用统计 | 开启（本地 ~/.puax/usage-stats.json） |
| PUAX_OTEL_ENABLED | 1 写入 span 到 telemetry.jsonl | 关闭 |
| PUAX_OTEL_ENDPOINT | OTLP/JSON 导出地址 | — |
| PUAX_TELEMETRY_DIR | 遥测文件目录 | ~/.puax |
| DEEPSEEK_API_KEY | L4 对照实测（仅 evals） | — |
统计与遥测不含对话内容，仅存计数与 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/ # 落地页与本机台
└── 演进方案.md # 3.x 对标（已冻结）文档
| 文档 | 说明 | |------|------| | GHM 导引幻梦法 | 驭幻觉发散引擎：病机、八术映射、庄周八梦、安全铁律 | | GHM 学术论著与技术报告 | 论文级长文：认知病机模型、八算子逆向工程、梦议会航线与无LLM量化评测 | | MCP Server README | 配置、工具清单、架构、环境变量 | | API 参考 | 48 个 MCP 工具（对外 12 动词） | | 使用指南 | 心跳优先工作流 | | 角色去留表 | 内核 / 皮肤 / 实验；萨满全留 | | AMB v0 | 12 场景协议覆盖记分卡（无 LLM） | | AMP 0.1 | 事件 / 块 / 闸门 / 状态；MCP 只是插头 | | CHANGELOG | 版本变更记录 | | evals/README.md | 评测分层与 L4 实测 | | TODO.md | 改进计划与里程碑 | | 演进方案.md | 3.x 对标（已冻结） |
开发与测试
cd puax-mcp-server
npm install && npm run build
npm test
npm run validate # lint + typecheck + test
node ../evals/run-all.js # 从仓库根目录许可证
MIT License — 详见 LICENSE
让 AI Agent 不再孤军奋战