Skip to content

TODO.md

Latest commit

 

History

History
124 lines (94 loc) · 6.05 KB

TODO.md

File metadata and controls

124 lines (94 loc) · 6.05 KB
Raw

PUAX 项目全面改进计划

审阅日期: 2026-03-25 | 审阅人: 萨满·Linus
最近更新: 2026-09-12 | 文档同步: v4.0.0 心智运行时
3.x 对标清单见 演进方案.md（已冻结）

当前版本: 4.0.0（puax-mcp-server）

P0–P2 已全部完成；P3 除日文版外已全部完成。v4.0 落地心跳 / 处境 / 自进化流水线；shaman- 八角色全留。

v3.12 - GHM 导引幻梦法（驭幻觉发散引擎）

  • 庄周八梦角色套系 — dream 类 8 角色（坐忘/梦蝶/混沌/鲲鹏/秋水/庖丁/齐物/薪火），文言正文 + 五步法 + 梦境安全协议
  • 3 个梦境 MCP 工具 — puax_enter_dreamscape / puax_awaken / puax_convergence_audit
  • 4 个新触发条件 — premature_convergence / creative_block / assumption_lock / low_novelty（divergence 类别）
  • 设计评审 PK 会议 — 创造派 vs 验证派双 Agent 评审，采纳验证派安全修正案（标记权工具层/预算硬顶/L1 审计/永不升格）
  • docs/GHM.md 方法论白皮书 — 含操控识别防御篇
  • 13 项单测 + evals 12 项守门全过
  • 发散度量化 evals — distinct-n / 语义半径 / 假设存活率（evals/test-ghm-divergence.js，无 LLM）
  • 幻觉泄漏检测 — 无印 / 免罪修辞强制 DISCARDED（源码门 + Jest）
  • 梦系离线对照 — 有梦协议禁止自动升格 vs 无梦锁定语（evals/test-ghm-contrast.js）
  • L4 在线对照（真实模型梦系开 vs 关）— 需 API，不阻塞 4.0

P0 - 必须立即处理（行为有效性闭环）

对应 [演进方案.md] Phase 1

  • 失败后方法论/角色切换引擎 — puax_switch_on_failure（差距#1）
  • 诊断先行协议 — [PUAX-DIAGNOSIS] + puax_check_diagnosis（差距#4）
  • 信心门控（6 步 Confidence Gate） — puax_confidence_check（差距#5）
  • 行为基准实验 — evals/ 5+ 场景对照（差距#3）
  • 统一 TriggerDefinition 类型 — 收敛至 types.ts
  • 修复 PuaxErrorCode 命名规范 — SCREAMING_SNAKE_CASE（v3.2）
  • 合并 tools/ + handlers/ — 单一工具层 + registry.ts

P1 - 高优先级（深度与留存）

对应 Phase 2

  • 突破降压 + 深层换框 — puax_handle_breakthrough + L2–L4 换框（差距#8）
  • 自进化引擎 — ~/.puax/evolution.json + 段位（差距#6）
  • 防作弊治理 — puax_verify_completion + puax_define_contract（差距#2）
  • 味道行为约束层 — 11 种风味 flavor-methodologies.yaml（v3.9.1 含 Amazon/Google/Xiaomi）
  • Compaction 状态保护 — puax_update_reasoning_state + state-manager（差距#15）
  • High-Agency 正向激励 — Trust / Quality Compass / Recovery（差距#7）
  • 消除假异步 — v3.8.5 全路径同步化
  • 统一日志 — Logger.write（v3.7）
  • handlers 合并 — v3.7.1

P2 - 中优先级（生态广度）

对应 Phase 3

  • 多平台原生适配 — Cursor/VSCode/Windsurf/Kiro/CodeBuddy + Codex/OpenCode/…（差距#9）
  • 英文版（PIP Edition） — language=en + PIP 修辞层（差距#10；50 角色全文英译待迭代）
  • 分发渠道 — distributions/（差距#13）
  • Agent Team — puax_orchestrate_team（差距#12）
  • 语气变体 — strict / yes / mama（差距#16）
  • prompts-bundle 拆分 — bundles/ + skill-manifest（v3.7）
  • 文档归集 — docs/TESTING.md + archive（v3.7）
  • 模板简化 — generate-guides（v3.8）
  • 元数据验证 — validate-metadata.js + run-all
  • CI/CD — GitHub Actions
  • 推荐透明化 — score_explanation
  • 路径安全 — path-security.ts
  • L4 实测基线 — scorecard 100%（v3.8.2）

P3 - 低优先级（增强与完善）

  • 日文版 — 50 角色日文文化适配（暂不实施，用户确认跳过）
  • 行为级评测 — L4 + governance + heartbeat + benchmark
  • 依赖注入 — service-registry.ts
  • trigger-detector 合并 — Enhanced 并入 core/trigger-detector.ts
  • 模式匹配增强 — TF-IDF + 子串混合（v3.10.0）
  • 自定义角色 — custom-roles.json + MCP CRUD（v3.9.0）
  • 更多风味 — Amazon / Google / Xiaomi（v3.9.1）
  • 缓存层 — RoleRecommender 单例 + 跨调用缓存
  • 使用统计 — usage-stats.json + MCP（v3.10.0）
  • 可观测性 — telemetry.jsonl + OTel 导出（v3.10.0）
  • 性能基准 — evals/benchmark.js

版本里程碑

版本 主题 核心交付 状态
v4.0.0 心智运行时 tick / AMP / 剧场 / TTF / Hook×7 / 指南心跳优先 ✅ 当前
v3.12.0 GHM 导引幻梦法 庄周八梦 + 三梦境工具 + 四触发 + 安全铁律机制化 ✅
v3.10.0 智能检测与可观测 TF-IDF 混合检测 + 匿名统计 + OTel ✅
v3.9.1 风味扩展 Amazon/Google/Xiaomi + export 单一数据源 ✅
v3.9.0 自定义角色 custom-roles + skill-catalog 统一目录 ✅
v3.8.x 工程化 + L4 DI、benchmark、governance、heartbeat、假异步消除 ✅
v3.4 深度与留存 自进化 + 防作弊 + 换框降压 + 味道约束 ✅
v3.5 生态广度 多平台 + PIP + Agent Team + 语气变体 ✅

后续可选（非 P3 阻塞）

项 说明
50 角色 PIP 全文英译 P2 已交付修辞层；完整 SKILL 翻译可迭代
日文版 已明确不做
LLM-as-judge 评测 已明确不做；现有 evals 为无 LLM 守门 + 可选 L4 DeepSeek

历史版本摘要

v3.1.2 (2026-03-26)

  • 5 角色 SKILL 验证修复；git 大清理

v3.1.0 (2026-03-26)

  • Hook System、CC-BOS、平台导出、Agent Team

v2.x

  • 角色推荐、方法论引擎、YAML 外部化、MCP 服务器

详细变更见 puax-mcp-server/CHANGELOG.md。