概念/概念定义

应用背景：下一步需要的是原值

创建薪资组后，API 返回 pay_group_id=pg_84721。下一步关联员工必须使用这个精确 ID，而且要能证明它来自哪次调用、属于哪个租户。如果先让模型摘要“已创建新加坡薪资组”，再让它回忆 ID，工具返回的事实就变成了一次概率生成。

凡是后续 API 会直接消费的值，包括实体 ID、币种、时间范围和幂等键，都应由程序保留原值与来源。

概念定义

机械状态平面保存业务 API 调用所需的严格参数。参数由程序从工具回执中解析、存储和传递，不经过模型重新生成。每个值都附带 Provenance，用于记录生产工具、调用实例、作用域和原始回执。

一个状态 Cell 可以表示为：

Cell = scope + key + value + producer + provenance

消费者按坐标读取 Cell，并在调用前校验来源。找不到唯一坐标、来源不符合契约或值已过期时，调用立即终止。

工程机制

工具注册时声明输入和输出坐标：

• 输入需要哪个 key；
• 从哪个 scope 读取；
• 预期由哪个工具和步骤生产；
• 输出写入哪个坐标；
• 值的有效期和覆盖规则。

系统级状态在登录等关键事件写入，API 级状态由工具回执写入。机械状态平面维护最新值和事件历史，工具负责声明自己生产和消费的坐标。

案例用法

薪资组模板匹配接口返回 template_id，模板导入接口必须使用同一值。此类 ID 可达 64 位或 128 位。模型从对话上下文重新输出时可能误写字符；格式正确也不能证明来源正确。

东方屹腾把 template_id 写入 SessionState，并保存产生它的工具回执。导入工具按坐标读取，RunPipeline 在调用前检查 Provenance。叙事上下文只记录“已匹配模板”，不承担 ID 传递。

该实现基于企业管理的封闭工具体系。所有工具由团队注册，因此系统可以在启动时建立状态键字典。开放工具接入场景还需要动态命名空间、来源信任和冲突处理。

适用条件

当步骤之间传递 ID、流水号、状态码等不可重新生成的参数，且错误值可能造成数据损坏或错误交易时，应使用机械状态平面。三个运行状态的职责见会话统一状态，任务依赖见任务 DAG 与状态机。