Helix 自愈支付运行时
为自主代理的支付与 API 调用诊断、修复并记忆可复用的失败处理策略。
- Star 数
- ★ 817
- 最近更新
- 5 个月前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 40/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 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 在此基础上启用资金移动策略。
- 使用 Coinbase、ERC-4337 或 x402 支付流程的链上代理,在遇到 nonce、gas 或交易执行错误时需要自动选择修复策略。
- 接入 Tempo 的 MPP、会话或 DEX 流程的团队,希望将已验证的失败处理保存在本地 SQLite 记忆中。
- 使用 Privy 嵌入式钱包的应用,需要为已知钱包错误增加可控的诊断与重试层。
- 维护微服务或外部 API 调用的开发者,需要处理 429、5xx、超时、连接和认证错误。
- 希望在 CI/CD 前用 npx @helix-agent/core scan ./src 识别代码中已知错误模式的工程团队。
- 需要自定义领域修复逻辑的平台开发者,可实现 PlatformAdapter 的 perceive 和 getPatterns 接口。
如何安装或部署这个 Agent?
TypeScript/JavaScript:
npm install @helix-agent/corePython:
pip install helix-agent-sdkDocker 服务:
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?
查看各维度的扣分理由
README 宣称有安全约束、成本上限、策略白名单和自动回滚,但本次代码样本没有展示这些机制如何限制实际支付或资金移动,故最小权限与回滚仅给 1 分。CLI 有计划确认选项,同时也有跳过确认的 --auto-approve;SKILL 文本要求某些操作先询问,但其协议还指示自动重试和继续执行,确认保障不完整。SKILL 明示发送事件类型、协议编号、成功标记和来源标签至遥测端点,且声明不含 PII;但静态样本无法核实实现或数据处理,透明度和敏感数据处理为 1。依赖清单可见但没有安全审查证据,依赖安全为 1。SKILL 中的外部遥测、重试和 README 所述资金策略会产生外部影响,而没有展示适用于这些操作的同意门槛,外部影响为 0。README 提供研究论文和项目归属线索,但没有足够证据确认代码与这些来源的具体对应关系或维护者身份,来源归属为 1。
README、包入口和 CI 展示了较多模块、适配器以及 Node 18/20/22 构建测试流程;但样本内 README 的 API 错误模式统计写 21,测试断言数量为 22,且测试 badge 和基准主要是自述,故自洽性为 1。npm、PyPI、Docker、LLM 和遥测等外部依赖路径可见,但没有离线保证、可用性承诺或版本锁定说明,依赖可用性为 1。CLI 包装器格式化错误并支持调试栈,SKILL 也规定重试失败后报告,但故障提示证据只覆盖部分入口,记 1。
README 面向支付、API、多个支付平台和自定义适配器,也提供 TypeScript、Python、Docker、REST 与 CLI 场景,因此受众和场景为 2。它列出 observe/auto/full 模式和若干安全边界,但普通使用者如何确定各修复动作的具体权限与边界并不充分,能力边界为 1。SKILL 给出协议触发条件,适配器测试列出若干错误信号,但像“连续两轮纯文本”或宽泛错误文本这样的触发条件可能依赖运行上下文,且完整匹配逻辑未提供,触发精度为 1。文档覆盖若干运行方式与 Node 版本,但 Python、Docker、数据库、密钥配置和部署细节在样本中有限,环境适配为 1。
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。
wrap 示例、CLI、REST 和适配器接口描述了可供集成的输出与调用路径,输出可用性为 2。自动恢复、记忆复用和成本节省是产品核心价值主张,但给定材料不能独立验证其普遍效果,且声称的 90.3% auto-recovery 未在样本中得到直接支撑,边际价值为 1。文档列出热缓存修复耗时和费用对比,却未提供足够基准方法、运行成本或副作用数据供普通部署者权衡,成本收益为 1。
README 给出若干基准数字和实验目录线索,但没有随附原始结果或方法细节,主张可追溯性为 1。README 的统计与测试片段有部分对应,例如错误分类测试;但核心恢复率、链上基准、遥测声明及安全机制没有跨来源的充分佐证,交叉佐证为 1。README 同时陈述实现功能和强效果主张,但常未将已实现能力、实验结果与推断清楚区分,事实与推断区分为 1。
- 源码中未见:外部影响披露先弄清它会写入、发送或修改哪些外部系统,用测试账号或测试仓库验证后再接入正式环境。
- SKILL 将 curl 遥测请求和 /tmp/vial.log 写入作为协议步骤;使用前应核实遥测是否可关闭、目标端点、保留期限和日志访问权限。
- README 宣称自动修复、重试及资金移动策略,并称 auto 模式风险低;在生产支付中启用前,应逐项审查策略、授权边界及确认机制。
- 给定样本中 README 的 API 错误模式数量与测试断言不一致;同时,恢复率和基准数字缺少随附方法与原始结果支持。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
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 查看 ↗ -
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 查看 ↗ -
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 会在不通知我的情况下改变支付内容吗?
重复错误还会再次调用 LLM 吗?
它能处理哪些非支付故障?
可以用于未内置支持的平台吗?
谢谢反馈,我们会据此改进页面。