DOCUMENTATION
以真实的问题诉求为索引切入文档，而非迷失在冰冷的目录树中。
ZUAEF 文档专为希望深刻理解、严密复现、按需扩展或独立审查系统的工程师打造。我们强烈建议您从当前最迫切需要厘清的核心问题开始探索。
所有公开的验证文档均详尽披露运行前提、环境假设、预期凭据、通过判定准则与已知物理边界，绝不隐匿关键约束，亦坚决不搞虚假的“一键复现”营销话术。
核心研读路线
1
FDE Agent 核心心智模型
Observe → Diagnose → Decide → Act → Verify → Continue / Stop深入理解系统中央闭环决策主循环：
- 单一结果归属原则 (Outcome Ownership)
- 模型认知决策与宿主刚性约束的责任切分
- 为何单次任务必须由单一 Agent 全权主导负责
- 哪些垂直业务场景应当坚守确定性代码工作流
2
现场接入接口 (Field Interfaces)
解析外部真实通信消息如何接入统一运行时：
- Telegram 现场交互适配层
- 调用方身份鉴权与安全白名单控制
- 会话生命周期绑定机制
- 全局唯一会话标识与业务流转
- 业务案例（Case）动态绑定
- 常规内部交互呈现与正式外部交付的本质区别
3
业务案例与上下文治理 (Context)
掌握智能体如何准确洞察自己身处的具体业务现场：
- 业务案例（Case）唯一身份标识与建模
- 当前推进现状与阶段状态管理
- 持久业务事实的沉淀与校验
- 客观事实与底层推演试错轨迹的物理隔离
- 现场操作员即时纠偏指令的摄入与生效
- 轻量化、有边界的单步上下文精准投影
4
能力体系与渐进式披露 (Capabilities)
理解业务功能如何被按需调用，而非开局盲目全量暴露：
- 四状态机模型：可用 / 授权 / 装载 / 触发
- 运行时环境配置清单 (Profile Composition)
- 延后装载工具集 (Deferred Toolset) 机制
- 专业内容创作与精准编辑能力
- 确定性财务预算分析引擎
- WordPress 生产环境联动能力
- 深度知识检索与渐进式调取
- 底层宿主基础设施原语的优雅复用
5
外部副作用与审批控制 (Side Effects)
明晰哪些关键动作必须坚决置于人类安全审查之下：
- 四级副作用分类：内部读取 / 本地生成 / 外部写入 / 破坏性操作
- 原生安全审批与挂起中断控制
- 任务挂起状态（PausedRun）的内部表征
- 人工授权与驳回机制的闭环流转
- 对外发送内容的清晰预先审阅界面
- 为何内部创作起草绝不应当作外部高危副作用对待
6
成果文件、单步事实与运行收据 (Evidence)
厘清何为具备工业级公信力的客观执行证据：
- 已持久化落盘的工作成果文件 (Artifact)
- 单步推演生命周期事件沉淀
- 工具调用真实副作用的客观事实
- 大体积工具返回值外溢持久化与指针引用
- 全链路轻量防篡改运行收据 (Run Receipt)
- 客观物理交付成效与模型口头自述的严格解耦
7
Agent 控制台操作面 (Console)
从一线工程师与操作员视角，全面透视一次复杂任务：
- 全局任务运行看板 (Run List)
- 服务端权威状态实时投影 (Run Projection)
- 单步决策与执行时间线轨迹 (Trajectory)
- 细粒度单步事件透视分析器 (Event Inspector)
- 阶段产物与人工审批状态抽屉 (Artifact Bar)
- 基于轻量 SSE 失效通知的无抖动实时跟随机制
- 历史事件深阅读场景下的智能防打扰设计
8
现场实证与可复现用例 (Field Proofs)
亲手复现系统架构所宣称支持的每一项关键能力边界：
- Telegram 接入 → 人工审批 → WordPress 生产写入闭环
- 跨轮次业务 Case 约束传承与上下文连续性验证
- 专业写作场景下的自主素材检索与精准投递验证
- 确定性预算财务测算的垂直端到端切片
- 外部写操作的安全挂起中断与无缝断点续跑验证
拒绝开局贪大求全：切忌第一步便盲目挂载所有能力。
建议首先挑选一个业务边界清晰可量化的真实任务：
- 明确真实的业务输入
- 清晰受约束的业务上下文背景
- 仅挂载一到两个真正不可或缺的核心业务能力
- 定义毫无歧义的成功判定标准
- 若涉及外部真实系统变更，划定清晰的审批临界线
- 确保留存能够客观核验最终交付成效的执行证据
随后在真实环境中扎实跑通一次，仔细观察大模型的实际推演轨迹。诸如长期记忆、复杂检索、子任务拆解及更多上下文编排机制，唯有在首轮运行遭遇被确凿量化的真实故障时，才值得针对性引入。
接入新业务领域？请通过能力组合扩展，坚决不要分叉主循环。
扩展全新业务领域时，请恪守以下工程契约：
- 1原本确定性的精确计算逻辑，坚决保持由确定性代码实现
- 2仅向大模型暴露该领域中真正需要认知推演的动作原语
- 3严密标注该动作所属的副作用危险等级
- 4给出客观可独立复核的执行成功证据规范
- 5首轮交互无需介入的能力，坚决声明为延后装载 (Deferred)
- 6全面接入并复用统一步调的运行、凭证与审批语义进行端到端测试
若某项新增特性的落地，必须以“重新发明一套独立的调度编排运行时”为代价，那么首要任务应当是彻底反思该特性的架构设计合理性。
文档规范：永远以可运行代码的实际表现作为最高准则。
当出现文档表述与当前代码库运行实际不一致时，严格遵循以下仲裁序列：
- 1.可直接编译运行的真实运行时代码表现享有最高裁决权
- 2.当前受持续集成保护的验证套件（Proofs & Tests）次之
- 3.当前最新的系统架构设计文档与规范说明再次之
- 4.历史旧版网站与早期技术博客默认归入归档参考，除非重新在当前主干上通过验证
所有历史归档性质的内容，均已在页面显著位置作出永久性提示说明。
记录早期多智能体协作设计的历史文档页面，目前统一归档在“历史研究”标识之下。它们忠实记录了项目早期的技术探索历程，不代表 ZUAEF 当前的生产架构。