诚实完成的秘密mercury-agent v1.2.3 完成契约与防卡死恢复架构深度解析【免费下载链接】mercury-agentSoul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.项目地址: https://gitcode.com/gh_mirrors/me/mercury-agentmercury-agent 是一款 Soul-driven AI 智能体支持权限加固工具、Token 预算管理与多通道接入。v1.2.3 版本代号 Unstoppable Mercury引入了完成契约Completion Contract与防卡死恢复架构每个任务结束时都必须经过一次裁决——要么给出有证据的完成要么诚实地暂停并指明卡点。从此任务不再虚报成功、不再静默死亡、也不会无限循环。痛点AI 智能体为什么会谎报任务完成在 v1.2.3 之前大多数 Agent 循环只做一次乐观执行模型生成 → 工具执行 → 不管结果如何一律庆祝Task complete。常见的翻车场景包括步数预算耗尽活儿干了一半却因为工具调用次数用完而停下却挂出绿色完成横幅✂️输出被截断写大文件时撞上输出上限文件写到一半被切断叙述型模型一直说我正在构建 X……却迟迟不产生任何文件内存压力长任务在堆内存见顶时直接崩溃完整的问题与恢复路径图可以在官方文档 completion-architecture.md 中查看。完成契约任务结束的 5 种裁决完成契约的核心是一个简单的问题这一轮为什么结束这个结束算不算真正的完成源码位于 src/core/completion-verdict.ts它把每次回合结束分类为 5 种裁决之一裁决含义系统动作text-stop模型主动给出最终答案进入验证门禁需有证据才算完成steps-exhausted步数预算耗尽且仍有工具待执行暂停自动续跑 6 次预算后诚实暂停interrupted服务商中途断开连接触发重试 / 模型回退机制truncated输出撞上 Token 上限被截断分段写入指导 满预算续跑aborted用户手动中止明确失败状态保留产物其中流式完整性由 src/core/stream-completion.ts 负责判定服务商断流缺少 finish 信号永远不被当作成功length截断如果恰好切断了文件写入系统会要求改用分段写入——先create_file写前 ~80 行再用edit_file逐段追加。防卡死恢复升级阶梯的四步强制执行当模型只叙述不干活时mercury-agent 不依赖模型的自觉而是机械式地逐级升级全程不消耗模型的好感度接地Grounding—— Agent 自己执行一次确定性的目录列表不经 LLM把真实目录状态注入上下文模型再也无法声称缺少上下文强制行动—— 守护回合的第一步以toolChoice: required运行且只允许变更类工具write_file、create_file、edit_file、run_command 等该步骤上叙述在机制上不可能发生服务商轮换—— 守护回合沿回退链切换下一个模型被叙述锁死的模型不是唯一的工人叫醒服务—— 一整轮失败后上限翻倍共 10 个机械回合并附一条直白指令你的下一条回复必须以变更工具调用开头零散文只有走完全部 10 个回合仍无进展系统才会诚实暂停并点名卡点。三层防卡死机制内存、时间与看门狗v1.2.3 的可靠性来自三个互补的守护层内存治理器—— src/core/memory-governor.ts 在每个工具步边界检查堆增长内存压力时原地压缩对话并继续超过最新 8 条之外的超大工具结果被替换为头尾摘要只有持续压力才中止长构建不再死于内存上限⏱️卡死看门狗—— src/core/stall-watchdog.ts 守护时间维度静默 3 分钟 → 界面显示可见的still working脉冲静默 8 分钟 → 中止并进入恢复机制绝不让任务无声燃烧。阈值可用MERCURY_STALL_SOFT_MS/MERCURY_STALL_HARD_MS调整自动续跑—— 步数预算与服务商故障自动继续6 份新预算手动 continue 只是最后保险不是检查点诚实的收尾暂停、点名、可恢复这套架构最动人的部分不是不停而是说实话✅证据门禁—— 实现类任务必须先跑通 build/test/typecheck 才允许挂出完成横幅点名卡点—— 每次暂停都携带最后失败的变更工具结果如write_file: permission denied修复方向直接在聊天里可见可恢复暂停—— 工作台账记录paused状态src/core/work-ledger.ts重启后自动恢复发送 continue 即可续跑️诚实横幅—— 无文件改动时显示 git 验证过的 Response delivered · no file changes完成时附带每文件 /− 统计与验证证据✓ Verified: npm test ✓这些保证全部由回归测试钉死completion-contract.test.ts 确保预算耗尽永远只能产生paused状态暂停路径在代码上先于完成横幅子智能体在预算耗尽时上报paused而非completed。快速上手升级并体验诚实的完成升级无需任何配置变更一条命令即可npm install -g cosmicstack/mercury-agent安装后进入 Mercury Code 默认即启用 AUTO 模式先读、静默规划、立即实现只有大型变更才会弹出一次确认。想调参的话参考 configuration.mdx。延伸阅读与源码索引 官方文档完成架构 · v1.2.3 发布说明 核心源码完成裁决 · 执行守护 · 流完整性 · 卡死看门狗 更新日志CHANGELOG.md一句话总结mercury-agent v1.2.3 让 Agent 从LLM 的聊天外壳升级为带保证的编排器——模型叙述时它机械地迫使行动任务中断时它点名卡点而每一次完成都有证据背书。【免费下载链接】mercury-agentSoul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.项目地址: https://gitcode.com/gh_mirrors/me/mercury-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考