ruflo WASM 沙箱专家 Agent 实战指南隔离执行、生命周期管理与社区画廊【免费下载链接】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 仓库中wasm-specialist专家 Agent 定义为骨架系统讲解基于 WebAssembly 的沙箱 Agent 运行时如何创建隔离执行环境、管理 Agent 生命周期、配置沙箱内工具、监控资源占用并通过社区画廊发布与发现可复用的 Agent 配置。读完本文你将掌握wasm_agent_*/wasm_gallery_*十组 MCP 工具的完整调用链、沙箱信任模型与记忆学习闭环可直接在本地无密钥环境下运行不受信任的代码。一、角色定位WASM 沙箱专家负责什么wasm-specialist是 ruflo-agent 插件内置的专家 Agent其 frontmatter 声明于 plugins/ruflo-agent/agents/wasm-specialist.md模型档位为sonnet职责可归纳为五条主线创建沙箱 AgentCreate sandboxed agents——为不受信任的代码提供安全、隔离的执行环境管理 Agent 生命周期Manage agent lifecycle——覆盖从创建、导出到终止的完整流程策展社区画廊Curate gallery——发布并发现社区 Agent配置沙箱内工具Configure tools——决定每个沙箱 Agent 可用哪些工具监控资源占用Monitor resources——跟踪运行中 WASM Agent 的资源使用情况。该 Agent 的全部能力通过mcp__plugin_ruflo-core_ruflo__*前缀的 MCP 工具暴露其中生命周期工具wasm_agent_create/wasm_agent_terminate、交互工具wasm_agent_prompt/wasm_agent_tool、数据管理工具wasm_agent_files/wasm_agent_export以及画廊工具wasm_gallery_*构成了它的操作面。值得注意的角色底线约束是在运行不受信任代码之前必须先验证沙箱隔离性Always verify sandbox isolation before running untrusted code这条约束直接呼应了下文要展开的沙箱信任模型。二、底层能力10 个wasm_*MCP 工具全览wasm-specialist操作的一切能力都来自 ruflo-core 暴露的 10 个 WASM MCP 工具它们统一实现在 v3/claude-flow/cli/src/mcp-tools/wasm-agent-tools.ts并在插件契约 plugins/ruflo-agent/docs/adrs/0001-wasm-contract.md 中以表格形式固化工具用途源码要点wasm_agent_create创建沙箱 WASM Agent支持template/model/instructions/maxTurns参数可走createAgentFromTemplate或createWasmAgent两条路径wasm_agent_prompt向 Agent 发送提示词必填agentIdinput经promptWasmAgent返回文本wasm_agent_tool在沙箱内调用工具支持read_file、write_file、edit_file、write_todos、list_files使用扁平格式{tool, path, content, ...}wasm_agent_list列出运行中的 WASM Agent无参数返回{agents, count}wasm_agent_terminate终止 Agent 并释放资源必填agentId返回{success}wasm_agent_files读取/写入沙箱内文件返回可用工具、fileCount、turnCount等状态wasm_agent_export导出 Agent 状态为 RVF 容器为画廊发布做准备wasm_gallery_list浏览社区已发布 Agent画廊查询入口wasm_gallery_search按关键词搜索画廊与wasm_agent_create搭配用于找现成模板wasm_gallery_create发布 Agent 到画廊通常先wasm_agent_export打包从源码结构看wasm-agent-tools.ts这些工具统一通过loadAgentWasm()动态加载../ruvector/agent-wasm.js即ruvector/rvagent-wasm封装层每个 handler 在调用前都会先做输入校验——validateIdentifier对agentId、template、model、toolName与validateText对instructions、input非法输入直接返回结构化错误而非穿透到运行时。三、沙箱信任模型隔离是默认值不是可选项WASM 运行时rvagent的信任定位在 plugins/ruflo-agent/README.md 的运行时对照表中被明确标注为sandboxed——no host fs/net即沙箱 Agent 默认无法访问宿主机文件系统与网络wasm_agent_files暴露的仅是沙箱内的虚拟文件系统。这一承诺同时被smoke.sh的Sandbox isolation documented检查项检查 README 是否包含no host filesystem/virtual filesystem表述所强制。在实现层面wasm-agent-tools.ts还内置了破坏性工具闸门Destructive-tool gate与安全默认白名单SAFE_MCP_TOOLS破坏性模式DESTRUCTIVE_TOOL_PATTERNS覆盖memory_delete、federation_*、swarm_shutdown、agent_terminate、以及_delete/_remove/_drop/_shutdown后缀工具——它们需要显式 opt-inSAFE_MCP_TOOLS集合则放行如memory_search、embeddings_search、hooks_post_task、wasm_agent_files、wasm_gallery_list、agentdb_pattern_search、neural_predict等只读或受限工具作为wasm_agent_compose的默认 MCP 工具清单。对于沙箱输出回流到宿主 LLM 的提示词注入防御插件明确对齐了 plugins/ruflo-aidefence/docs/adrs/0001-aidefence-contract.md 中的3-gate 模式该交叉引用同样被smoke.sh第 9 项检查强制。这意味着隔离不只是跑在 WASM 里还包括对流出沙箱的内容做多道防线过滤。四、实战操作Agent 生命周期全流程配套技能 plugins/ruflo-agent/skills/wasm-agent/SKILL.md 给出了标准的七步生命周期wasm-specialist可以直接按此执行创建—— 调用mcp__plugin_ruflo-core_ruflo__wasm_agent_create传入 Agent 配置。核心参数来自工具 inputSchema参数类型说明templatestring画廊模板名coder、researcher、tester、reviewer、security、swarmmodelstring模型标识默认anthropic:claude-sonnet-4-6instructionsstringAgent 系统指令maxTurnsnumber最大对话轮数默认 50发送提示——mcp__plugin_ruflo-core_ruflo__wasm_agent_prompt必填agentId与input使用工具——mcp__plugin_ruflo-core_ruflo__wasm_agent_tool为 Agent 授予沙箱内特定工具read_file/write_file/edit_file/write_todos/list_files注意使用扁平格式传参管理文件——mcp__plugin_ruflo-core_ruflo__wasm_agent_files读写沙箱内文件导出——mcp__plugin_ruflo-core_ruflo__wasm_agent_export将 Agent 打包为可分享的 RVF 容器见仓库 data/clone-data.rvf 这类 RVF 产物形态列出——mcp__plugin_ruflo-core_ruflo__wasm_agent_list查看所有运行中的 Agent终止——mcp__plugin_ruflo-core_ruflo__wasm_agent_terminate停止 Agent 并释放资源。命令行层面插件提供/wasm命令定义见 plugins/ruflo-agent/commands/wasm.md执行三步wasm_agent_list列出运行中 Agent →wasm_gallery_list展示画廊可用 Agent → 汇总展示 Agent ID、状态与沙箱资源占用。五、画廊发布与发现社区 Agentwasm-specialist的第三项职责策展画廊由wasm-gallery技能plugins/ruflo-agent/skills/wasm-gallery/SKILL.md支撑其推荐流程为浏览——wasm_gallery_list查看可用 Agent搜索——wasm_gallery_search用关键词定位目标 Agent配合wasm_agent_create的template参数即可从模板直接起实例安装——wasm_agent_create传入画廊 Agent 的配置发布—— 先wasm_agent_export打包再wasm_gallery_create分享到社区。值得说明的是插件在命名空间协调上拥有wasm-gallery这个 AgentDB 命名空间kebab-case 规范遵循 plugins/ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md 的命名约定用于索引已发布 Agent 的 manifest、版本、签名与下载计数并通过memory_*命名空间路由访问同时必须避免遮蔽pattern、claude-memories、default等保留命名空间。六、记忆学习与神经学习让经验沉淀复用wasm-specialist文档特别规定了两种学习机制用于把成功的 Agent 配置沉淀为可检索的模式记忆学习Memory Learning—— 将成功的 WASM Agent 配置存入wasm-patterns命名空间并支持按任务检索npx claude-flow/clilatest memory store --namespace wasm-patterns --key agent-TYPE --value CONFIG_AND_PERFORMANCE npx claude-flow/clilatest memory search --query wasm agent for TASK --namespace wasm-patterns神经学习Neural Learning—— 任务完成后通过hooks post-task触发神经训练再从patterns命名空间检索同类模式npx claude-flow/clilatest hooks post-task --task-id TASK_ID --success true --train-neural true npx claude-flow/clilatest memory search --query TASK_TYPE patterns --namespace patterns这两条命令链路与SAFE_MCP_TOOLS白名单中的memory_store、hooks_post_task、neural_patterns等工具一一对应说明沙箱执行 记忆沉淀 神经训练在 ruflo 中是端到端打通的沙箱只负责安全地跑模式学习则由宿主侧的记忆与神经子系统承接。七、运行时依赖与优雅降级wasm_agent_*能否真正生效取决于 WASM 运行时包是否安装。依据 ADR-070 的集成方案ruvector/rvagent-wasm与ruvector/ruvllm-wasm被声明在claude-flow/cli的optionalDependencies中npm install即会拉取若包缺失全部wasm_agent_*工具会落入优雅降级路径返回 no-op 而非崩溃。这一点对wasm-specialist的排障至关重要工具没反应时先检查运行时包是否就位而非怀疑 Agent 逻辑。CLI 侧将claude-flow/cli固定在 v3.6 大版本小版本兼容。作为对照云运行时Claude Managed Agentsmanaged_agent_*六工具契约见 ADR-115需要ANTHROPIC_API_KEY或CLAUDE_API_KEY与 beta 访问权密钥缺失时每个managed_agent_*工具都会返回结构化错误并指向本地无密钥的wasm_agent_create回退方案。wasm-specialist所在的本地 WASM 运行时因此是无需密钥、快速、免费、可离线、可确定性重放的安全默认选择详见 plugins/ruflo-agent/skills/managed-agent/SKILL.md 的运行时对照表。八、契约验证smoke 即测试门禁插件把可验证性做成了硬契约运行 plugins/ruflo-agent/scripts/smoke.sh 即可完成 12 项结构检查ADR-0001 记录时是 11 项随云运行时加入扩展为 12 项覆盖插件版本与mcp、rvagent-wasm、ruvllm-wasm、managed-agents、anthropic关键字两个技能 wasm-specialistAgent /wasm命令的 frontmatter 完整性全部 10 个wasm_*工具被文档引用CLI v3.6 固定、命名空间协调、ADR-070 交叉引用、沙箱隔离文档化、AIDefence 3-gate 引用、ADR-0001 状态为 Accepted、技能无通配符工具授权、6 个managed_agent_*工具及其 wasm 回退引用。bash plugins/ruflo-agent/scripts/smoke.sh # 期望输出: 12 passed, 0 failed这套smoke-as-contract机制保证了wasm-specialist所依赖的工具面、文档面与安全承诺在每次改动后依然成立也让验证沙箱隔离后再运行不受信任代码从一句口头约束变成可执行的检查项。九、小结何时该用 WASM 沙箱专家一句话判断标准来自技能文档当你需要运行不受信任的代码、试验 Agent 配置、或构建可在任何 WASM 运行时上移植的 Agent时就应召唤wasm-specialist。它给出的价值是四重的——全沙箱隔离Agent 无法触碰宿主文件系统、可移植导出后在任何 WASM 运行时运行、可复现跨平台行为一致、安全Agent 行为不会损害系统。相比宿主任意执行的场景如本地仓库上的完整 Claude 循环属规划中的 SDK 运行时wasm_agent_*始终是 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ruflo WASM 沙箱专家 Agent 实战指南：隔离执行、生命周期管理与社区画廊
ruflo WASM 沙箱专家 Agent 实战指南隔离执行、生命周期管理与社区画廊【免费下载链接】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 仓库中wasm-specialist专家 Agent 定义为骨架系统讲解基于 WebAssembly 的沙箱 Agent 运行时如何创建隔离执行环境、管理 Agent 生命周期、配置沙箱内工具、监控资源占用并通过社区画廊发布与发现可复用的 Agent 配置。读完本文你将掌握wasm_agent_*/wasm_gallery_*十组 MCP 工具的完整调用链、沙箱信任模型与记忆学习闭环可直接在本地无密钥环境下运行不受信任的代码。一、角色定位WASM 沙箱专家负责什么wasm-specialist是 ruflo-agent 插件内置的专家 Agent其 frontmatter 声明于 plugins/ruflo-agent/agents/wasm-specialist.md模型档位为sonnet职责可归纳为五条主线创建沙箱 AgentCreate sandboxed agents——为不受信任的代码提供安全、隔离的执行环境管理 Agent 生命周期Manage agent lifecycle——覆盖从创建、导出到终止的完整流程策展社区画廊Curate gallery——发布并发现社区 Agent配置沙箱内工具Configure tools——决定每个沙箱 Agent 可用哪些工具监控资源占用Monitor resources——跟踪运行中 WASM Agent 的资源使用情况。该 Agent 的全部能力通过mcp__plugin_ruflo-core_ruflo__*前缀的 MCP 工具暴露其中生命周期工具wasm_agent_create/wasm_agent_terminate、交互工具wasm_agent_prompt/wasm_agent_tool、数据管理工具wasm_agent_files/wasm_agent_export以及画廊工具wasm_gallery_*构成了它的操作面。值得注意的角色底线约束是在运行不受信任代码之前必须先验证沙箱隔离性Always verify sandbox isolation before running untrusted code这条约束直接呼应了下文要展开的沙箱信任模型。二、底层能力10 个wasm_*MCP 工具全览wasm-specialist操作的一切能力都来自 ruflo-core 暴露的 10 个 WASM MCP 工具它们统一实现在 v3/claude-flow/cli/src/mcp-tools/wasm-agent-tools.ts并在插件契约 plugins/ruflo-agent/docs/adrs/0001-wasm-contract.md 中以表格形式固化工具用途源码要点wasm_agent_create创建沙箱 WASM Agent支持template/model/instructions/maxTurns参数可走createAgentFromTemplate或createWasmAgent两条路径wasm_agent_prompt向 Agent 发送提示词必填agentIdinput经promptWasmAgent返回文本wasm_agent_tool在沙箱内调用工具支持read_file、write_file、edit_file、write_todos、list_files使用扁平格式{tool, path, content, ...}wasm_agent_list列出运行中的 WASM Agent无参数返回{agents, count}wasm_agent_terminate终止 Agent 并释放资源必填agentId返回{success}wasm_agent_files读取/写入沙箱内文件返回可用工具、fileCount、turnCount等状态wasm_agent_export导出 Agent 状态为 RVF 容器为画廊发布做准备wasm_gallery_list浏览社区已发布 Agent画廊查询入口wasm_gallery_search按关键词搜索画廊与wasm_agent_create搭配用于找现成模板wasm_gallery_create发布 Agent 到画廊通常先wasm_agent_export打包从源码结构看wasm-agent-tools.ts这些工具统一通过loadAgentWasm()动态加载../ruvector/agent-wasm.js即ruvector/rvagent-wasm封装层每个 handler 在调用前都会先做输入校验——validateIdentifier对agentId、template、model、toolName与validateText对instructions、input非法输入直接返回结构化错误而非穿透到运行时。三、沙箱信任模型隔离是默认值不是可选项WASM 运行时rvagent的信任定位在 plugins/ruflo-agent/README.md 的运行时对照表中被明确标注为sandboxed——no host fs/net即沙箱 Agent 默认无法访问宿主机文件系统与网络wasm_agent_files暴露的仅是沙箱内的虚拟文件系统。这一承诺同时被smoke.sh的Sandbox isolation documented检查项检查 README 是否包含no host filesystem/virtual filesystem表述所强制。在实现层面wasm-agent-tools.ts还内置了破坏性工具闸门Destructive-tool gate与安全默认白名单SAFE_MCP_TOOLS破坏性模式DESTRUCTIVE_TOOL_PATTERNS覆盖memory_delete、federation_*、swarm_shutdown、agent_terminate、以及_delete/_remove/_drop/_shutdown后缀工具——它们需要显式 opt-inSAFE_MCP_TOOLS集合则放行如memory_search、embeddings_search、hooks_post_task、wasm_agent_files、wasm_gallery_list、agentdb_pattern_search、neural_predict等只读或受限工具作为wasm_agent_compose的默认 MCP 工具清单。对于沙箱输出回流到宿主 LLM 的提示词注入防御插件明确对齐了 plugins/ruflo-aidefence/docs/adrs/0001-aidefence-contract.md 中的3-gate 模式该交叉引用同样被smoke.sh第 9 项检查强制。这意味着隔离不只是跑在 WASM 里还包括对流出沙箱的内容做多道防线过滤。四、实战操作Agent 生命周期全流程配套技能 plugins/ruflo-agent/skills/wasm-agent/SKILL.md 给出了标准的七步生命周期wasm-specialist可以直接按此执行创建—— 调用mcp__plugin_ruflo-core_ruflo__wasm_agent_create传入 Agent 配置。核心参数来自工具 inputSchema参数类型说明templatestring画廊模板名coder、researcher、tester、reviewer、security、swarmmodelstring模型标识默认anthropic:claude-sonnet-4-6instructionsstringAgent 系统指令maxTurnsnumber最大对话轮数默认 50发送提示——mcp__plugin_ruflo-core_ruflo__wasm_agent_prompt必填agentId与input使用工具——mcp__plugin_ruflo-core_ruflo__wasm_agent_tool为 Agent 授予沙箱内特定工具read_file/write_file/edit_file/write_todos/list_files注意使用扁平格式传参管理文件——mcp__plugin_ruflo-core_ruflo__wasm_agent_files读写沙箱内文件导出——mcp__plugin_ruflo-core_ruflo__wasm_agent_export将 Agent 打包为可分享的 RVF 容器见仓库 data/clone-data.rvf 这类 RVF 产物形态列出——mcp__plugin_ruflo-core_ruflo__wasm_agent_list查看所有运行中的 Agent终止——mcp__plugin_ruflo-core_ruflo__wasm_agent_terminate停止 Agent 并释放资源。命令行层面插件提供/wasm命令定义见 plugins/ruflo-agent/commands/wasm.md执行三步wasm_agent_list列出运行中 Agent →wasm_gallery_list展示画廊可用 Agent → 汇总展示 Agent ID、状态与沙箱资源占用。五、画廊发布与发现社区 Agentwasm-specialist的第三项职责策展画廊由wasm-gallery技能plugins/ruflo-agent/skills/wasm-gallery/SKILL.md支撑其推荐流程为浏览——wasm_gallery_list查看可用 Agent搜索——wasm_gallery_search用关键词定位目标 Agent配合wasm_agent_create的template参数即可从模板直接起实例安装——wasm_agent_create传入画廊 Agent 的配置发布—— 先wasm_agent_export打包再wasm_gallery_create分享到社区。值得说明的是插件在命名空间协调上拥有wasm-gallery这个 AgentDB 命名空间kebab-case 规范遵循 plugins/ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md 的命名约定用于索引已发布 Agent 的 manifest、版本、签名与下载计数并通过memory_*命名空间路由访问同时必须避免遮蔽pattern、claude-memories、default等保留命名空间。六、记忆学习与神经学习让经验沉淀复用wasm-specialist文档特别规定了两种学习机制用于把成功的 Agent 配置沉淀为可检索的模式记忆学习Memory Learning—— 将成功的 WASM Agent 配置存入wasm-patterns命名空间并支持按任务检索npx claude-flow/clilatest memory store --namespace wasm-patterns --key agent-TYPE --value CONFIG_AND_PERFORMANCE npx claude-flow/clilatest memory search --query wasm agent for TASK --namespace wasm-patterns神经学习Neural Learning—— 任务完成后通过hooks post-task触发神经训练再从patterns命名空间检索同类模式npx claude-flow/clilatest hooks post-task --task-id TASK_ID --success true --train-neural true npx claude-flow/clilatest memory search --query TASK_TYPE patterns --namespace patterns这两条命令链路与SAFE_MCP_TOOLS白名单中的memory_store、hooks_post_task、neural_patterns等工具一一对应说明沙箱执行 记忆沉淀 神经训练在 ruflo 中是端到端打通的沙箱只负责安全地跑模式学习则由宿主侧的记忆与神经子系统承接。七、运行时依赖与优雅降级wasm_agent_*能否真正生效取决于 WASM 运行时包是否安装。依据 ADR-070 的集成方案ruvector/rvagent-wasm与ruvector/ruvllm-wasm被声明在claude-flow/cli的optionalDependencies中npm install即会拉取若包缺失全部wasm_agent_*工具会落入优雅降级路径返回 no-op 而非崩溃。这一点对wasm-specialist的排障至关重要工具没反应时先检查运行时包是否就位而非怀疑 Agent 逻辑。CLI 侧将claude-flow/cli固定在 v3.6 大版本小版本兼容。作为对照云运行时Claude Managed Agentsmanaged_agent_*六工具契约见 ADR-115需要ANTHROPIC_API_KEY或CLAUDE_API_KEY与 beta 访问权密钥缺失时每个managed_agent_*工具都会返回结构化错误并指向本地无密钥的wasm_agent_create回退方案。wasm-specialist所在的本地 WASM 运行时因此是无需密钥、快速、免费、可离线、可确定性重放的安全默认选择详见 plugins/ruflo-agent/skills/managed-agent/SKILL.md 的运行时对照表。八、契约验证smoke 即测试门禁插件把可验证性做成了硬契约运行 plugins/ruflo-agent/scripts/smoke.sh 即可完成 12 项结构检查ADR-0001 记录时是 11 项随云运行时加入扩展为 12 项覆盖插件版本与mcp、rvagent-wasm、ruvllm-wasm、managed-agents、anthropic关键字两个技能 wasm-specialistAgent /wasm命令的 frontmatter 完整性全部 10 个wasm_*工具被文档引用CLI v3.6 固定、命名空间协调、ADR-070 交叉引用、沙箱隔离文档化、AIDefence 3-gate 引用、ADR-0001 状态为 Accepted、技能无通配符工具授权、6 个managed_agent_*工具及其 wasm 回退引用。bash plugins/ruflo-agent/scripts/smoke.sh # 期望输出: 12 passed, 0 failed这套smoke-as-contract机制保证了wasm-specialist所依赖的工具面、文档面与安全承诺在每次改动后依然成立也让验证沙箱隔离后再运行不受信任代码从一句口头约束变成可执行的检查项。九、小结何时该用 WASM 沙箱专家一句话判断标准来自技能文档当你需要运行不受信任的代码、试验 Agent 配置、或构建可在任何 WASM 运行时上移植的 Agent时就应召唤wasm-specialist。它给出的价值是四重的——全沙箱隔离Agent 无法触碰宿主文件系统、可移植导出后在任何 WASM 运行时运行、可复现跨平台行为一致、安全Agent 行为不会损害系统。相比宿主任意执行的场景如本地仓库上的完整 Claude 循环属规划中的 SDK 运行时wasm_agent_*始终是 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考