Runx 技能工作流运行时

让 Agent 技能在明确授权下执行,并为每次运行留下可验证记录。

源仓库
runxhq/runx
Star 数
★ 104
最近更新
1 天前
License
Apache-2.0
主语言
Rust

30 秒速览

运行形态
命令行工具MCP 服务器代码库 / SDK
可在哪里用
通用 · 跨平台Codex · Claude Code(部分支持)
费用
免费,无需付费服务
上手难度
中 · 需要几步配置
开始前需要
GitNode.js 20 或更高版本Shell / 命令行网络访问本地文件系统MCP Server
典型场景
工程团队通过 github-issue-to-pr 将有界的代码计划接入仓库工作流,并保留运行收据。
不适合
  • 需要操作系统级隔离来限制本地进程的团队
  • 需要运行时替人验证审批者身份的团队
官网
runx.ai ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-20最新版本 cli-v0.11.1(2026-11-02)

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

Runx 是一个用 Rust 编写的技能工作流运行时,提供 CLI、MCP 服务器以及 TypeScript/Node.js 和 Python 客户端。技能以包含 SKILL.md 的可移植包定义;需要执行步骤时,可用 run.yaml 声明输入输出、能力和方法。运行时在调用边界检查授权、交付凭据、监督执行,并以 Ed25519 签署收据,记录执行、授权和产物来源。执行、状态与签名可在本地运行,托管注册表、凭据托管和公证服务均为可选。它适合需要把多个技能串联起来并审查执行记录的团队;本地进程仍使用主机操作系统权限。

通过 runx skill 从本地目录、URL 或注册表解析技能,并按其 SKILL.md 和 run.yaml 执行方法。工作流可组合 agent、tool、operation、ask 和 skill 步骤,传递类型化输入输出;运行可以暂停以等待主机提供 Agent 答案或人工审批,再通过 runx resume 继续。连接器操作按声明的请求、范围和效果契约执行,凭据只在获准的传输边界交付。运行结束后,Runx 生成签名收据,可用 runx history 查看并用 runx verify 校验。

  1. 工程团队通过 github-issue-to-pr 将有界的代码计划接入仓库工作流,并保留运行收据。
  2. 发布负责人组合 release、文档和消息技能,先准备发布材料,再按审批要求推进发布。
  3. 营销团队用 lead-enrichment、lead-qualify 和 cold-outreach 汇总证据并准备一封待审邮件。
  4. 增长团队汇总 Search Console、GA4、PostHog 和站点证据,形成优先级与后续测量计划。
  5. 平台团队通过 MCP 将运行中的技能轮次交给现有 Agent 主机处理,并在收到结果后恢复同一运行。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npm install --global @runxhq/cli
  • curl -fsSL https://runx.ai/install | sh
配置文件
answers.json
运行环境
Node.js 20
安装说明涉及
macOS · Linux

如何安装或部署这个 Agent?

可用 npm 安装原生 CLI,或在 macOS/Linux 使用独立安装器。README 的本地示例还需要 Git 与 Node.js 20 或更高版本;该示例不需要 Runx 账户、模型或提供商密钥。安装器会从 runx.ai 获取内容,使用注册表、连接器或托管服务时则需相应网络和配置。

npm install --global @runxhq/cli

macOS/Linux 独立安装方式:

curl -fsSL https://runx.ai/install | sh

如何使用这个 Agent?

克隆仓库并运行随附的 hello-world 技能。该命令会执行仓库中的 Node.js 脚本并输出 JSON 结果与收据 ID;随后可查看运行记录并验证完整收据 ID。此示例不要求模型或提供商密钥。

git clone --depth 1 https://github.com/runxhq/runx.git
cd runx

runx skill ./examples/hello-world --run-id first-run \
  -i message="Hello, Runx." --json

runx history first-run --json
runx verify <receipt-id> --json

若要由现有 Agent 主机处理暂停的 Agent 轮次,可为某个运行提供 MCP 服务,再提交该运行待处理请求的答案:

runx mcp --run <run-id>
runx resume <run-id> answers.json --json

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

优点
  • CLI、MCP 和语言客户端共用同一 Rust 执行路径,方便接入已有 Agent 主机。
  • 调用按显式授权执行,凭据在操作传输边界交付,不进入技能指令或模型上下文。
  • Ed25519 收据可记录授权、执行结果、子运行链接和产物来源,并可独立验证。
  • 本地执行与状态不依赖托管服务;注册表、凭据托管和公证服务可选。
局限
  • 本地进程工具以主机操作系统权限运行,Runx 不提供可移植的 OS 级隔离。
  • 宿主负责取得人工决策;审批字段中的 JSON 本身不能证明审批者身份。
  • 实际连接器工作需要配置账户或凭据,测试夹具不代表真实提供商执行结果。
  • 最小仓库示例需要 Git 和 Node.js 20 或更高版本;完整接入还涉及技能包与权限配置。

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

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

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Runx 技能工作流运行时 当前 82 · 表现良好 命令行工具免费 ★ 104 1 天前 Rust —
REA 逆向工程助手 54 · 缺口较多 命令行工具免费 + 模型费 ★ 115 1 个月前 Rust Claude Code
Flow-Like 74 · 存在缺口 桌面应用免费版 + 付费版 ★ 981 1 天前 Rust —
Agency Orchestrator:一句话组队 AI 专家团队 71 · 存在缺口 命令行工具免费 + 模型费 ★ 2.5k 10 天前 TypeScript Codex · Claude Code · OpenAI API · Claude API

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
表现良好
82/ 100 五分制 4.1 / 5
信任安全 21/29
可靠稳定 9/14
适用触发 16/18
规范维护 16/18
有效结果 12/13
证据核验 8/8
查看各维度的扣分理由
信任安全21 / 29 · 3.6/5

材料说明权限随调用链收窄,凭据只在边界交付且收据排除原始秘密;流程、权限、数据流和外部副作用有细致说明,故这些方面得分高。审批由宿主取得,批准字段本身不能证明人的身份;进程工具以宿主操作系统权限运行且没有 OS 隔离。没有展示恢复或撤销外部副作用的完整机制,依赖安全材料也没有版本审计或漏洞状态证据,因此相应扣分。

可靠稳定9 / 14 · 3.2/5

CLI、客户端、运行时、收据和示例形成较连贯的产品描述,含结构化失败及离线验签说明。材料仍是片段,未提供依赖可用性或错误处理在运行中的证据;部分文档依赖托管服务及外部 CLI,故未给满分。

适用触发16 / 18 · 4.4/5

材料涵盖本地技能、工作流、MCP、客户端、托管连接器以及研究、发布和分析场景;明确列出进程工具、宿主隔离和托管服务的边界,也说明何时不该使用 Runx。对特定平台的覆盖有说明,但不能从样本确认所有环境支持,环境适配得分为2。

规范维护16 / 18 · 4.4/5

README、入门、凭据、安全、运行时契约等文档结构清晰;提供安装前提、命令示例、限制、Apache-2.0 许可证和滚动安全版本策略。包版本为0.0.0而 README 展示 npm 版本徽章,材料未提供清晰的变更日志或可验证维护者身份,因此命名、版本与维护责任未满分。

有效结果12 / 13 · 4.6/5

类型化输入输出、签名收据、授权证明和具体工作流示例使结果可供后续调用和审查,并提供了相对普通提示编排的治理与追溯价值。运行时、宿主和可选托管组件带来部署及配置成本;材料未提供成本量化,故成本效益未满分。

证据核验8 / 8 · 5.0/5

README 的关键声明可在安全策略、权限证明、入门文档和客户端/CLI 源码片段中交叉对应;材料区分了收据完整性、提供方真实结果和宿主身份验证的含义,也限定为本地与托管路径的不同保证。由于这是静态且不完整的样本,不能据此验证实际执行效果;本项评价的是陈述可追溯与事实/推断区分,而非运行正确性。

风险与缓解建议
  • 进程工具不受 Runx 的 OS 沙箱隔离;应按宿主操作系统权限审查本地命令。
  • 审批记录不证明批准者身份,需由宿主负责身份认证;收据签名仅在验证者信任对应签名密钥时有意义。
  • 本次审查仅基于静态文件样本,未执行项目或验证依赖、实际权限执行和外部副作用恢复。
证据充分度:低 评估于 2026年11月13日 审查版本 14cf84bcc80d 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

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

FARS

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

最近版本

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

  1. cli-v0.11.1
    发布说明摘录
    Runx CLI 0.11.1 Local registry refreshes now respect the existing record's write permissions while retaining atomic publication. This patch also updates transport dependencies and prepares distribution through the established trusted npm publisher. Highlights - A refused registry update leaves the existing record intact. - Updated MCP and HTTP dependencies retain the native execution boundary. Added - Windows coverage for atomic registry publication, retained readers, no-clobber creation and file access. Changed …
    在 GitHub 查看 ↗
  2. cli-v0.11.0
    发布说明摘录
    Runx CLI 0.11.0 Runx 0.11.0 keeps every secret in one place, runx secret, and a connector whose credential's variable is set needs no setup at all. A name without a version runs at the newest version your runx reads, so a package published for a newer runx no longer breaks an older one. What runx adds to a project now lives under .runx, apart from the skills and connectors you write. Connectors can run as a person's signed-in browser account, and the payment skills settle through Stripe and PayPal as well as x402. Highlights …
    在 GitHub 查看 ↗
  3. runx-py-v0.1.2
    发布说明摘录
    Full Changelog: https://github.com/runxhq/runx/compare/cli-v0.10.2...runx-py-v0.1.2
    在 GitHub 查看 ↗

常见问题

运行需要模型或 Runx 账户吗?
仓库的 hello-world 示例不需要 Runx 账户、模型或提供商密钥。使用 --drive 委托模型轮次时,需要配置模型提供商;真实连接器操作也需要相应账户或凭据。
人工审批由 Runx 验证身份吗?
不是。Runx 将审批与 Agent 答案分开并绑定到请求摘要,但由宿主取得人工决定;宿主提交 JSON 不构成身份验证。
收据能证明什么?
它记录技能和执行摘要、授权、执行结果及产物关系,并用内容寻址 ID 和签名支持校验。有效签名证明记录与可信签署者之间的完整性,不代表运行一定成功或外部操作已完成。
可以只在本机运行吗?
执行、状态与收据签名可本地运行;托管注册表、凭据托管和公证服务是可选项。安装器、远程技能、注册表或外部连接器会涉及网络。
Runx 技能工作流运行时 官网是什么?
Runx 技能工作流运行时 的 GitHub 仓库填写的官网是 https://runx.ai。这个链接由仓库作者设置;源码在 GitHub(runxhq/runx)。
Runx 技能工作流运行时 免费吗?
免费。Runx 技能工作流运行时 可以免费使用,不需要付费服务。
Runx 技能工作流运行时 开源吗?
开源。源码在 GitHub(runxhq/runx),许可证是 Apache-2.0。
Runx 技能工作流运行时 安全吗?
FollowAgents 的 FARS 评审(2026年11月13日)给 Runx 技能工作流运行时 的“信任与安全”打了 21/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
Runx 技能工作流运行时 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-20,在最近 30 天内。最新版本是 cli-v0.11.1(2026-11-02)。
Runx 技能工作流运行时 是谁开发的?
Runx 技能工作流运行时 由 GitHub 账号 runxhq 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

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

相关核心概念