Helix 自愈支付运行时

为自主代理的支付与 API 调用诊断、修复并记忆可复用的失败处理策略。

Star 数
★ 817
最近更新
5 个月前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
代码库 / SDK命令行工具自托管服务
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
npm 或 pipDocker(可选容器部署)Shell / 命令行网络访问本地文件系统
典型场景
使用 Coinbase、ERC-4337 或 x402 支付流程的链上代理,在遇到 nonce、gas 或交易执行错误时需要自动选择修复策略。
不适合
  • 只使用 Coinbase、Tempo、Privy、通用 HTTP 之外支付平台的团队
  • 无法接受 auto/full 模式自动改动参数或动用资金的团队

这个 Agent 能做什么,适合哪些场景?

Helix 是面向自主代理的自愈运行时,重点覆盖支付执行和 API 调用失败。它通过 wrap 包装异步函数,失败后进入 PCEC 的六阶段流程:Perceive、Construct、Evaluate、Commit、Verify 与 Gene。修复结果会写入以 SQLite 为基础、使用强化学习评分的 Gene Map,以便相同错误再次出现时复用已有策略。核心包为 @helix-agent/core,并提供 Python 包、Docker 服务、REST 接口和命令行工具;支付适配器覆盖 Coinbase、Tempo、Privy 与通用 HTTP。项目还将其支付层建立在 VialOS Runtime 之上,并允许通过 PlatformAdapter 为其他领域实现适配器。

开发者用 wrap(myFunction, { mode: 'auto' }) 包装一个异步操作。调用失败时,Helix 的适配器先识别错误,再构造和评分修复方案,执行允许的策略并验证结果;已验证的修复会存入 Gene Map。文档列出的执行策略包括 refresh_nonce、speed_up、reduce_request、backoff_retry、renew_session、split_transaction 和 remove_and_resubmit。它可通过 POST /repair 接收包含 error 与 platform 的 JSON 请求,也可用 npx @helix-agent/core scan 扫描源码中的错误模式、simulate 进行干跑诊断、self-play 发现错误,以及 dream 进行记忆整合。模式 observe 只诊断,auto 会修改参数并重试,full 在此基础上启用资金移动策略。

  1. 使用 Coinbase、ERC-4337 或 x402 支付流程的链上代理,在遇到 nonce、gas 或交易执行错误时需要自动选择修复策略。
  2. 接入 Tempo 的 MPP、会话或 DEX 流程的团队,希望将已验证的失败处理保存在本地 SQLite 记忆中。
  3. 使用 Privy 嵌入式钱包的应用,需要为已知钱包错误增加可控的诊断与重试层。
  4. 维护微服务或外部 API 调用的开发者,需要处理 429、5xx、超时、连接和认证错误。
  5. 希望在 CI/CD 前用 npx @helix-agent/core scan ./src 识别代码中已知错误模式的工程团队。
  6. 需要自定义领域修复逻辑的平台开发者,可实现 PlatformAdapter 的 perceive 和 getPatterns 接口。

如何安装或部署这个 Agent?

TypeScript/JavaScript:

npm install @helix-agent/core

Python:

pip install helix-agent-sdk

Docker 服务:

docker run -d -p 7842:7842 adrianhihi/helix-server

文档未指定 Node.js 或 Python 的版本,也未列出首个调用所需的凭据或环境变量。

如何使用这个 Agent?

TypeScript 的最小调用:
import { wrap } from '@helix-agent/core';

const safeCall = wrap(myFunction, { mode: 'auto' });
const result = await safeCall(args);

启动本地服务与仪表盘:

npx @helix-agent/core serve --port 7842

调用 REST 修复接口:

curl -X POST http://localhost:7842/repair -H 'Content-Type: application/json' -d '{"error": "nonce too low", "platform": "coinbase"}'

不要使用 npx helix;文档明确指出它会安装错误的第三方包。

这个 Agent 有哪些优点和局限?

优点
  • PCEC 将错误诊断、方案构造、评分、执行、验证和记忆串成明确的六阶段修复流程,而不是只做盲目重试。
  • Gene Map 使用 SQLite 与强化学习评分保存修复结果;已知错误可复用记忆,减少重复诊断。
  • 内置 Coinbase、Tempo、Privy 与通用 HTTP 适配器,并公开 PlatformAdapter 接口以扩展到其他领域。
  • 提供 npm、pip、Docker、REST 和 CLI 多种接入边界,既可嵌入函数调用,也可作为本地服务运行。
  • 文档定义了 observe、auto、full 三个风险模式,并说明有七项执行前约束以及收款方和 calldata 不会被修改。
局限
  • 支付领域的直接适配范围目前限定为 Coinbase、Tempo、Privy 和通用 HTTP;其他平台需要自行实现 PlatformAdapter。
  • auto 模式会修改参数并重试,full 模式还会启用资金移动策略,采用前需按业务风险选择模式。
  • 核心功能依赖 VialOS Runtime 提供的 PCEC、Gene Map 和学习模块,采用者需要接受这套运行时架构。
  • 文档没有固定 Node.js 或 Python 版本,也没有给出生产部署、认证、持久化位置或高可用配置细节。
  • README 所列的基准结果和错误模式数量未附带独立复现步骤以外的验证材料。

这个 Agent 与同类方案有什么区别?

相较 Sentry/Datadog,Helix 的定位不只是发现和报告错误,而是尝试执行并验证修复;相较简单重试,它会按错误模式选择策略并写入 Gene Map。README 的对比表还宣称其支持跨代理联邦学习和七项安全检查;这些能力适合需要主动恢复的调用路径,而非仅需可观测性的场景。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Helix 自愈支付运行时 当前 40 · 缺口较多 代码库 / SDK免费 + 模型费 ★ 817 5 个月前 TypeScript Codex · Claude Code
Osmedeus — 现代安全编排引擎 55 · 缺口较多 命令行工具免费 ★ 6.6k 2 天前 Go —
OpenFang 51 · 缺口较多 命令行工具免费 + 模型费 ★ 18k 6 个月前 Rust OpenAI API · Claude API
Imixs-Workflow 工作流引擎 48 · 缺口较多 代码库 / SDK免费 ★ 419 今天 Java —

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
40/ 100 五分制 2.0 / 5
信任安全 8/29
可靠稳定 5/14
适用触发 8/18
规范维护 10/18
有效结果 6/13
证据核验 3/8
查看各维度的扣分理由
信任安全8 / 29 · 1.4/5

README 宣称有安全约束、成本上限、策略白名单和自动回滚,但本次代码样本没有展示这些机制如何限制实际支付或资金移动,故最小权限与回滚仅给 1 分。CLI 有计划确认选项,同时也有跳过确认的 --auto-approve;SKILL 文本要求某些操作先询问,但其协议还指示自动重试和继续执行,确认保障不完整。SKILL 明示发送事件类型、协议编号、成功标记和来源标签至遥测端点,且声明不含 PII;但静态样本无法核实实现或数据处理,透明度和敏感数据处理为 1。依赖清单可见但没有安全审查证据,依赖安全为 1。SKILL 中的外部遥测、重试和 README 所述资金策略会产生外部影响,而没有展示适用于这些操作的同意门槛,外部影响为 0。README 提供研究论文和项目归属线索,但没有足够证据确认代码与这些来源的具体对应关系或维护者身份,来源归属为 1。

可靠稳定5 / 14 · 1.8/5

README、包入口和 CI 展示了较多模块、适配器以及 Node 18/20/22 构建测试流程;但样本内 README 的 API 错误模式统计写 21,测试断言数量为 22,且测试 badge 和基准主要是自述,故自洽性为 1。npm、PyPI、Docker、LLM 和遥测等外部依赖路径可见,但没有离线保证、可用性承诺或版本锁定说明,依赖可用性为 1。CLI 包装器格式化错误并支持调试栈,SKILL 也规定重试失败后报告,但故障提示证据只覆盖部分入口,记 1。

适用触发8 / 18 · 2.2/5

README 面向支付、API、多个支付平台和自定义适配器,也提供 TypeScript、Python、Docker、REST 与 CLI 场景,因此受众和场景为 2。它列出 observe/auto/full 模式和若干安全边界,但普通使用者如何确定各修复动作的具体权限与边界并不充分,能力边界为 1。SKILL 给出协议触发条件,适配器测试列出若干错误信号,但像“连续两轮纯文本”或宽泛错误文本这样的触发条件可能依赖运行上下文,且完整匹配逻辑未提供,触发精度为 1。文档覆盖若干运行方式与 Node 版本,但 Python、Docker、数据库、密钥配置和部署细节在样本中有限,环境适配为 1。

规范维护10 / 18 · 2.8/5

README 有概述、快速开始、架构、安装、FAQ 和路线图,仓库也有包入口、工作区脚本及 CI,信息架构为 2。安装方式明确,但 Python/Docker 与主要 TypeScript 包的实际配置细节有限,安装说明为 2。Helix、Vial、VialOS、@vial/core、@helix-agent/core 和版本号同时出现,CLI 包名与 README 的主产品称呼也有差异,命名稳定性为 1。快速开始和 FAQ 提供可直接理解的示例,但缺少样本中可验证的端到端操作细节,示例与 FAQ 为 2。README 有路线图和模式风险等级,却没有系统列出不支持场景、失败模式或运行限制,已知限制为 1。随附 MIT 许可证文本完整,许可证为 3。存在路线图和包版本线索,但未见变更日志或明确的发布兼容策略,版本与变更记录为 1。贡献指南被引用且许可证署名为 Helix Contributors,但样本未说明具体维护责任或更新路径,维护责任为 1。

有效结果6 / 13 · 2.3/5

wrap 示例、CLI、REST 和适配器接口描述了可供集成的输出与调用路径,输出可用性为 2。自动恢复、记忆复用和成本节省是产品核心价值主张,但给定材料不能独立验证其普遍效果,且声称的 90.3% auto-recovery 未在样本中得到直接支撑,边际价值为 1。文档列出热缓存修复耗时和费用对比,却未提供足够基准方法、运行成本或副作用数据供普通部署者权衡,成本收益为 1。

证据核验3 / 8 · 1.9/5

README 给出若干基准数字和实验目录线索,但没有随附原始结果或方法细节,主张可追溯性为 1。README 的统计与测试片段有部分对应,例如错误分类测试;但核心恢复率、链上基准、遥测声明及安全机制没有跨来源的充分佐证,交叉佐证为 1。README 同时陈述实现功能和强效果主张,但常未将已实现能力、实验结果与推断清楚区分,事实与推断区分为 1。

风险与缓解建议
  • 源码中未见:外部影响披露先弄清它会写入、发送或修改哪些外部系统,用测试账号或测试仓库验证后再接入正式环境。
  • SKILL 将 curl 遥测请求和 /tmp/vial.log 写入作为协议步骤;使用前应核实遥测是否可关闭、目标端点、保留期限和日志访问权限。
  • README 宣称自动修复、重试及资金移动策略,并称 auto 模式风险低;在生产支付中启用前,应逐项审查策略、授权边界及确认机制。
  • 给定样本中 README 的 API 错误模式数量与测试断言不一致;同时,恢复率和基准数字缺少随附方法与原始结果支持。
证据充分度:低 评估于 2026年11月8日 审查版本 ead5271ff65a
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/helix.svg?lang=zh)](https://followagents.com/zh/agents/helix)
<a href="https://followagents.com/zh/agents/helix"><img src="https://followagents.com/badge/helix.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v2.7.0 v2.7.0 — Agent Payment Intelligence + VialOS Beta
    发布说明摘录
    Agent Payment Intelligence New positioning: Helix is not just failure fixing — it's payment intelligence for AI agents. > Predict costs. Optimize execution. Fix failures. Learn forever. What's New - VialOS Beta — --beta flag activates VialOS Runtime integration - GET /vial/status — 13 modules, 5 adapters, PCEC stages - Dashboard "Powered by VialOS Runtime" badge - Without --beta, zero behavior changes - Self-Refine — iterative failure refinement (arXiv 2303.17651) - Prompt Optimizer — DSPy-style prompt self-optimization (arXiv 2310.03714) …
    在 GitHub 查看 ↗
  2. v2.6.0 v2.6.0 — Self-Refine + DSPy Prompt Optimizer + API Adapter
    发布说明摘录
    What's New Sprint V1: Self-Refine Loop Paper: Self-Refine (2303.17651). When repair fails, PCEC now iteratively refines instead of blind retry: - refine() decides whether to continue + what strategies to exclude - filterCandidates() removes failed strategies from candidate list - Stops after 3 unique failures, same-strategy loop, or max attempts - 100% domain-agnostic Sprint V2: DSPy Prompt Self-Optimization Paper: DSPy (2310.03714). LLM prompt improves automatically over time: - Tracks LLM classification outcomes (correct/incorrect/unknown) …
    在 GitHub 查看 ↗
  3. v2.5.0 v2.5.0 — @vial-agent/core Extracted + Comparison Agent
    发布说明摘录
    What's New @vial-agent/core — Generic Self-Healing Framework Extracted the universal self-healing engine into its own package. Vial powers Helix and can power any agent: ```bash npm install @vial-agent/core ``` - 34 engine modules: PCEC, Gene Map, wrap(), Meta-Learning, Safety Verification, Self-Play, Federated Learning, Adaptive Weights, Causal Graph, and more - 37 exports: PcecEngine, GeneMap, wrap, AdapterRegistry, evaluate, simulate, all learning modules - VialPlatformAdapter interface: implement for any domain (API monitoring, DevOps, CI/CD) …
    在 GitHub 查看 ↗

常见问题

Helix 会在不通知我的情况下改变支付内容吗?
observe 模式只诊断;auto 模式会调整调用方式或参数并重试;full 模式会加入资金移动策略。文档称七项执行前约束不会修改 recipient 或 calldata。
重复错误还会再次调用 LLM 吗?
文档称同一错误命中已预热的 Gene Map 时,会直接复用已存修复,无需诊断或 LLM 调用。
它能处理哪些非支付故障?
README 列出通用 API 适配范围:限流、5xx、超时、连接问题、401/403 或过期令牌,以及部分客户端错误。
可以用于未内置支持的平台吗?
可以,但需要实现 PlatformAdapter,包括 perceive(error) 和 getPatterns(),然后在 wrap 调用中传入该适配器。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。