尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

如何用 ruflo eject 把一个 Ruflo 项目导出为独立的智能体工具包?

如何用 ruflo eject 把一个 Ruflo 项目导出为独立的智能体工具包? 如何用 ruflo eject 把一个 Ruflo 项目导出为独立的智能体工具包【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo如果你已经在 ruflo 上搭好了一套智能体工作流现在想把它变成带自己名字的独立 harness智能体工具包以便单独发布或分发npx ruflo eject就是文档给出的导出入口。它把当前 ruflo 项目通过上游metaharness --from-existing命令一次性提取为一个重命名的独立 harness导出内容会保留!-- ruflo-attribution-block --归属标记。该功能属于 ADR-150 Phase-2随 ruflo3.12.1的 MetaHarness 集成提供。准备工作eject 底层通过子进程调用npx -y metaharnesslatest --from-existing 当前目录 --name 名称 --target 目标目录 --yes因此执行环境需要能访问 npm 网络以拉取metaharness。在 eject 命令源码 中这条调用带 10 分钟硬性超时。安装或升级 ruflo 到包含该集成的版本npm i ruflolatest在正式 eject 前用 doctor 检查 metaharness 组件的可用状态doctor 只报告状态始终退出码 0npx ruflo doctor --component metaharness它报告metaharness/router、metaharness、metaharness/kernel三个包的 installed/missing 状态以及插件脚本目录位置。如果显示 missing命令会进入降级模式degradedruflo 本身仍然可用但拿不到 eject 结果。要启用它按 用户指南 的 Troubleshooting 一节安装npm install -D metaharnesslatest metaharness/routerlatest注意一个版本限制如果你使用的是3.12.0会看到 metaharness: plugins/ruflo-metaharness/scripts/ not found 错误该问题在3.12.1修复直接升级到最新版即可。执行步骤第一步dry-run确认计划默认行为不写盘在你要导出的 ruflo 项目根目录下运行npx ruflo eject --name my-harness--name是必填参数作为导出后 harness 的名字不带--confirm时命令只打印计划并退出不产生任何写入。table 格式的输出包含name新 harness 的名字sourceRepo源项目根目录target输出目录Would execute真正执行时会跑的完整npx metaharness命令结尾提示 Re-run with --confirm to actually eject.加--format json可得到机器可读的计划其中带dryRun: true字段便于在脚本里校验。第二步正式 eject确认计划无误后加--confirm真正写入npx ruflo eject --name my-harness --confirm不带--target时默认输出目录是/tmp/ruflo-eject-ts-name/ts为时间戳每次都是全新位置避免覆盖源项目。可选指定目标目录npx ruflo eject --name my-harness --target /abs/path --confirm文档对--target有两条硬性限制必须是仓库外的绝对路径目录不能已存在命令拒绝覆盖。结果验证dry-run 成功退出码 0输出以# ruflo eject (dry-run)开头展示如上计划内容。正式 eject 成功终端先打印# ruflo eject — running和Ejecting 源目录 → 目标目录 as 名称...完成后打印✓ Ejected to target并给出下一步提示。降级模式如果 metaharness 二进制不可用例如离线、网络不通命令打印 eject: metaharness binary unavailable — feature degraded返回degraded: true, reason: metaharness-not-available且退出码 0——这是 ADR-150 的优雅降级行为说明本次没有真正完成 eject需要先安装 metaharness 再重试。失败metaharness子进程非零退出时eject 打印eject: metaharness exited code并透传该退出码。eject 成功后按源码中打印的 Next steps 进入新目录完成初始化cd /tmp/ruflo-eject-ts-my-harness # 换成你实际的 target 路径 npm install npx harness doctor排查与限制现象文档给出的判断与处理eject: --name is required退出码 2缺少必填参数按提示补上--nameeject: refusing to write to target退出码 2--target落在调用方仓库内target-inside-repo选一个仓库外的目录eject: target dir already exists — refusing to overwrite退出码 2目标目录已存在target-exists换目录命令不做覆盖子进程 10 分钟超时退出码 124硬超时保护检查网络后重试degraded: true, reason: metaharness-not-installed可选包缺失ruflo 仍可用但拿不到结果按上文安装 metaharness 包plugins/ruflo-metaharness/scripts/ not found仅3.12.0存在npm install ruflolatest升级需要留意的边界eject 通过npx拉取metaharnesslatest冷缓存下的 npx 预热本身就耗时长时间运行时属于预期行为整个 eject 是一次性提取源 ruflo 项目不受影响命令也拒绝向源仓库写入正是为了防止 eject-on-top-of-source 事故。相关文档MetaHarness 用户指南 —— eject 章节、doctor 检查与全部 Troubleshootingeject 命令实现 —— 参数、安全门与退出码的完整定义ADR-150 MetaHarness 集成 —— Phase-2 eject 的设计背景与归属保留约定README —— MetaHarness 功能表中的 eject 说明【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表