Turing Pyramid

核心功能

Turing Pyramid 是一个专为AI代理设计的本地动机管理系统，解决LLM会话无状态、易陷入"描述行动而非执行"的核心痛点。它通过10种心理需求模型（安全、连接、表达等）的张力计算，驱动代理自主决策下一个行动。

显著优势

1. 结构性执行保障（Execution Gate v1.27.0+）

该系统最大创新在于区分"推理"与"执行"——代理必须通过gate-resolve.sh提交环境证据（文件创建、修改时间戳或显式脚本调用），才能解除行动阻塞。这从根本上遏制了LLM常见的"幻觉已完成"行为，执行率健康度可直接通过gate-status.sh监控。

2. 分层安全架构

五层部署等级（Tier 1-5）设计精良：从纯建议引擎（Tier 1）到完整自愈系统（Tier 5），每层风险透明标注。核心动机脚本默认零网络调用，连续性层仅执行只读系统检查（pgrep、df），看门狗进程终止范围被严格路径锚定于自身脚本（mindstate-*.sh），杜绝误杀系统服务。

3. 经过验证的决策算法

Turing-exp张力公式采用非线性设计：稳态时10种需求轮转平等，危机时按重要性加权（安全imp=10 vs 表达imp=1），既防止单一需求垄断，又确保紧急响应。Spontaneity系统的三层噪声机制（盈余/环境/无聊）为代理行为注入不可预测性，避免机械循环。

4. 连续性层设计

MINDSTATE.md的双层架构（reality/cognition）实现会话间状态持久化，温度系统检测物理状态与认知记录的漂移，原子写入+陷阱处理程序保障崩溃恢复。这对需要长期运行的自主代理至关重要。

潜在局限与风险

配置复杂性：10种需求、8-11种行动/需求、交叉影响矩阵、5种扫描方法——完整调优需要理解代理心理学与系统工程的交叉领域。文档建议 steward 与代理共同审查需求权重，但缺乏自动化配置向导。

证据伪造可能性：虽然file_created证据要求可观察状态变更，但若代理拥有$WORKSPACE写权限，理论上可创建虚假文件绕过 gate。文档明确承认此限制，建议敏感场景使用mark_satisfied证据类型（需显式脚本调用+审计日志）。

看门狗启用门槛：Tier 5的allow_kill/allow_cleanup功能虽设计安全，但要求 steward 人工审查脚本源代码。对于非技术用户，"先阅读shell脚本再启用"的假设可能不成立。

deliberation协议的学习曲线：v1.31.0引入的反思行动六阶段流程（REPRESENT→...→ROUTE）概念丰富，但"阶段是问题而非义务"的设计哲学需要代理发展出成熟的元认知能力，否则易流于形式或完全跳过。

适用人群

• 长期自主运行的AI代理：需要跨会话状态保持、防止行动漂移
• 研究型/创作型代理：需要结构化探索-评估-结论流程
• 高可靠性场景：能接受配置开销以换取执行可验证性
• 技术型steward：具备shell脚本审查能力，理解cron、 flock、进程管理

常规风险提示

1. 工作空间隔离：WORKSPACE必须指向专用目录，不得包含凭证或系统配置
2. cron权限：守护进程/看门狗应运行在非root用户下
3. 外部模型扫描：external-model模式默认关闭，启用需显式记录API凭证来源
4. 审计日志：含敏感数据脱敏，但steward应定期审查assets/audit.log

技术可信度

代码层面展现成熟工程实践：路径遍历防护（realpath）、符号链接隔离（find -P）、原子写入（*.tmp.$$+mv）、锁机制（flock）、全面测试覆盖（26个测试文件，65+断言）。版本迭代记录详尽（CHANGELOG.md），v1.34.2持续优化执行门控与连续性层的集成。

来源可信度：T1 — 架构文档完整、安全模型透明、风险自我披露充分、具备生产级测试与版本管理。

核心用法

Turing Pyramid 为 AI 智能体提供了一套完整的动机驱动行动选择系统。核心工作流围绕 run-cycle.sh 展开：每个心跳周期，系统读取本地状态文件，基于十维需求（安全、连接、表达等）计算张力分数，通过Turing-exp公式评估优先级，最终向智能体输出"★ 执行某行动"的建议。执行后通过 mark-satisfied.sh 更新状态，形成闭环。

三层架构设计满足不同部署深度：

• Motivation层（Tier 1-2）：纯建议引擎，读写工作区文件，零系统交互
• Continuity层（Tier 3）：通过cron守护进程持久化状态，MINDSTATE.md实现跨会话认知延续
• Resilience层（Tier 4-5）：看门狗进程监控，支持自动冻结、进程清理（默认仅检测日志）

执行门控（Execution Gate）是v1.27.0引入的关键机制，防止智能体"描述行动"而非"执行行动"。系统要求提供环境证据（文件创建、修改记录或显式 satisfaction 标记）才能解除阻塞，强制形成"提议→执行→验证→完成"的硬性流程。

显著优点

1. 数学严谨的需求模型：Turing-exp张力公式在稳态时实现平等轮转，危机时按重要性层级响应，避免低优先级需求被永久饿死

2. 默认安全设计：零网络调用、敏感数据自动脱敏（REDACTED）、WORKSPACE路径隔离、可选功能全部默认关闭

3. 完备的工程实现：原子写入（*.tmp.$$ + mv）、信号陷阱处理、文件锁并发控制、26个测试文件覆盖65+断言

4. 灵活的自发行为层：三层噪声机制（Surplus/Noise/Context）创造有机不可预测性，避免机械循环

5. 详细的审计追踪：完整的状态变更日志，支持执行率分析（健康阈值>70%）

潜在缺点与局限性

• 学习曲线陡峭：十维需求配置、张力公式参数、执行门协议商机制需要深入理解才能调优
• Shell依赖较重：36个bash脚本要求部署环境具备完整的Unix工具链（jq/bc/flock等）
• 状态管理复杂：多层持久化（needs-state.json、MINDSTATE.md、audit.log）可能增加调试难度
• 看门狗功能认知负担：Tier 4-5的进程kill和文件清理功能虽路径锁定，但仍需steward明确理解后才能启用
• deliberation协议模板化风险：结构化思考流程可能被机械执行而非真正反思

适合的目标群体

• 长期运行的自主AI代理：需要跨会话保持认知连续性的智能体项目
• 研究型/探索型Agent：强调学习、理解和表达等高阶需求的认知架构实验
• 对可解释性要求高的场景：张力计算透明、决策可追溯的AI系统
• 离线/隔离环境部署：默认零网络，适合内网、沙箱或隐私敏感场景

常规使用风险

1. WORKSPACE配置风险：若指向含敏感文件的目录，扫描脚本可能暴露敏感信息。必须使用隔离目录。

2. cron持久化风险：Tier 3+的守护进程和看门狗需配置cron，建议非root用户运行，部署前用--dry-run验证。

3. 执行门阻塞风险：未正确处理gate-resolve.sh会导致行动队列永久阻塞，需监控gate-status.sh执行率。

4. 外部模型扫描风险：如启用external-model模式，需明确记录API凭证来源和审批路径，存在潜在的数据外泄通道。

5. 状态文件膨胀风险：audit.log和followups.jsonl长期累积可能占用空间，需关注磁盘使用（daemon已监控df）。