Turing Pyramid

核心功能

Turing Pyramid 是一套本地状态化的AI代理动机系统，通过模拟10层人类需求（安全、连接、表达等）的张力累积与衰减，驱动代理自主决策与行动优先级排序。系统采用Turing-exp张力公式：常态下各需求平等轮换，危机时按重要性层级响应，避免传统优先级算法的僵化问题。

显著优点

1. 结构化行动验证：执行门(Execution Gate)机制强制要求环境证据（文件创建/修改、显式标记），防止LLM"描述行动"与"执行行动"的混淆，执行率可通过gate-status.sh监控
2. 分层部署安全：5级部署层级设计，从纯交互式(Tier 1)到完整自愈(Tier 5)，每层系统影响与风险明确标注，默认禁用破坏性操作
3. 连续性保障：MINDSTATE.md双层级架构（reality持续更新/cognition会话冻结），配合看门狗的进程监控与孤儿文件清理，支持代理跨会话状态恢复
4. 反合规设计：审议协议(Deliberation Protocol)提供结构化思考脚手架，但允许自由形式+验证模式，门机制警告而非阻止，避免形式化官僚主义
5. 完备的安全隔离：路径锚定进程管理、物理模式文件遍历（-P防符号链接）、临时文件原子写入、审计日志敏感数据脱敏

潜在局限与风险

• 状态持久化依赖：非无状态设计，需维护needs-state.json等运行时文件，WORKSPACE配置错误可能导致敏感文件扫描
• 看门狗误杀风险：allow_kill启用后仅终止自身mindstate-*.sh进程，但需确认SCRIPT_DIR未被篡改；allow_cleanup删除.tmp文件范围限于WORKSPACE与assets目录
• 自报告可信度：mark-satisfied.sh信任调用方输入，虽有审计追踪但无加密验证；self_report证据类型明确标记为低信任
• 外部模型可选风险：external-model扫描模式默认关闭，启用需显式记录凭证来源与API端点
• 符号建议非执行：配置中的"web搜索""社交发帖"等外部动作为纯文本建议，实际执行取决于代理运行时权限，存在被自动执行框架误触发的可能

适合人群

• 需长期自主运行、跨会话保持上下文一致性的AI代理
• 希望代理从"响应指令"转向"需求驱动"的开发者
• 具备Linux基础、能审查shell脚本的安全意识用户
• 有隔离WORKSPACE环境（容器/独立目录）的部署条件

常规风险控制

| 层级 | 关键控制 |

|------|---------|

| 部署前 | 孤立WORKSPACE测试，`--dry-run`验证看门狗，审查`needs-config.json`外部动作权重 |

| 部署中 | 非root用户运行cron，Tier 1-2起步逐步升级，监控`gate-status.sh`执行率 |

| 运维期 | 定期审计`assets/audit.log`，验证看门狗日志静默（健康状态），检查MINDSTATE.md漂移警告 |

技术规格

• 依赖：bash, jq, bc, 标准POSIX工具（pgrep/df/flock等）
• 可选增强：Haiku级模型支持agent-spawn智能扫描
• 典型开销：每小时心跳约1-3美元（1.4M-3.6M token/月）
• 版本：v1.34.3（自节流竞态修复）

核心用法

Turing Pyramid 是一个为 AI 代理设计的本地优先决策系统，通过模拟生物动机机制解决"代理知道该做什么却不行动"的核心问题。系统包含三个递进层级：动机层（run-cycle.sh、mark-satisfied.sh）提供基础的张力计算与动作建议；连续层（mindstate-daemon.sh、mindstate-freeze.sh、mindstate-boot.sh）实现跨会话状态持久化；弹性层（mindstate-watchdog.sh）保障系统自恢复。

核心工作流为：初始化 → 运行周期（计算10维需求张力 → 概率选择 → 动作提案）→ 执行门验证（防止"描述代替执行"）→ 标记满足 → 更新状态。用户可通过 HEARTBEAT.md 集成实现自动运行，或按五级部署渐进启用功能。

显著优点

执行门机制（Execution Gate） 是该 Skill 最具创新性的设计。LLM 常混淆"推理动作"与"执行动作"（均为 token 生成），而 gate-propose/resolve 机制强制要求环境证据（文件创建/修改记录、显式脚本调用）才能关闭提案，从结构上杜绝了"幻觉式完成"。

Turing-exp 张力公式实现智能优先级：常态时所有需求轮转平等（防忽视低优先级需求），危机时重要性加权放大（确保安全等关键需求优先）。配合自发系统（三层噪声机制），使代理行为兼具可预测性与有机多样性。

安全架构极为严谨：默认零网络调用，危险功能（kill/cleanup/external-model）全部 opt-in，Workspace 强制隔离，审计日志自动脱敏，26个测试文件覆盖核心路径。

潜在局限

运维复杂度较高：五级部署体系、多组 cron 配置、状态文件管理，对非技术用户门槛显著。完整功能需持续运行的 daemon 和 watchdog，资源占用虽低但增加了故障排查维度。

生态锁定风险：MINDSTATE.md、SOUL.md、MEMORY.md 等文件格式构成特定生态，迁移成本较高。10维需求模型虽可配置，但深层调参（decay_rate、cross-need impact 矩阵）需理解动机心理学与系统动态。

T3 来源可信度：作为社区项目，虽代码质量高（19K+行 Shell 脚本，完整测试覆盖），但无商业实体背书，长期维护依赖贡献者社区。

适合群体

• 自主 Agent 开发者：需要代理长期运行、跨会话保持"心理连续性"的场景
• 研究者/极客用户：愿意深入理解动机系统原理、调优 10 维需求权重
• 高可靠性场景：执行门机制特别适合"说过了必须做过"的合规要求（如科研记录、财务操作辅助）
• 离线/隐私敏感环境：默认无网络，纯本地 Shell 实现，适合隔离网络部署

使用风险

Workspace 隔离失效风险：若 WORKSPACE 指向包含凭证或敏感文件的目录，Skill 的扫描机制（grep 模式匹配）可能读取并记录这些路径。必须严格遵循"专用隔离目录"要求。

Cron 权限与进程管理：Tier 4-5 启用后，watchdog 具备进程终止能力（虽严格限定为 mindstate-*.sh 路径锚定）。需确保 cron 以非 root 运行，且 Skill 目录不可被未授权用户写入（防止路径注入）。

执行门误用导致死锁：若代理反复 defer 同一需求而未调整配置，系统将进入提案阻塞状态。需定期监控 gate-status.sh 执行率（健康值 >70%）。

External-model 启用后的网络暴露：虽默认关闭，但启用后需自行保障 API 凭证安全与 TLS 加密，此时安全责任转移至用户配置。