ruflo-rvf 插件实战指南基于 RVF 格式的便携式 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-rvf 是 Ruflo 生态中负责RVFRuVector FormatRuflo 向量格式便携式 Agent 记忆与会话持久化的官方插件它把 Agent 的向量记忆嵌入、元数据、因果图封装为可跨项目、跨机器迁移的 RVF 认知容器支持完整会话的快照保存与恢复并打通了 Claude Code 自动记忆的导入通道。读完本文你将掌握 RVF 格式的数据构成、会话保存/恢复的完整操作流程、跨项目知识迁移的命令用法以及静态加密ADR-096的开关与密钥配置方法。RVF 格式便携式认知容器的数据构成RVFRuVector Format是 ruflo-rvf 的核心载体被定义为“便携式向量记忆”portable vector memory。根据 rvf-manage 技能文档一个 RVF 文件内部存储四类数据数据类型说明向量嵌入384 维 ONNX 嵌入与.swarm/memory.db中 AgentDB 的记忆嵌入同维便于统一检索元数据时间戳、命名空间、标签等描述信息因果关系条目之间的因果关联图用于还原知识的推理链会话上下文会话状态与 Agent 作用域从语义上看RVF 是“带因果图的便携向量记忆”它不只是一个序列化文件而是一个自包含的认知容器——容器内既有可向量检索的嵌入又有可追溯的因果结构与元数据这为后续的跨项目导入、格式迁移和静态加密提供了统一载体。安装与兼容性约束ruflo-rvf 通过 Ruflo 的插件市场安装/plugin marketplace add ruvnet/ruflo /plugin install ruflo-rvfruflo该插件对宿主 CLI 有明确的版本约束pinned 到claude-flow/cliv3.6 的 majorminor见 README 的 Compatibility 小节。也就是说插件契约假设宿主 CLI 处于 v3.6 系升级主版本前应先通过下方 验证章节 的 smoke 契约做回归。会话持久化保存与恢复完整 Agent 会话会话持久化session persistence是 ruflo-rvf 的核心能力之一把一次对话的完整状态Agent 状态与配置、记忆条目与模式、学习轨迹与指标、任务进度与待办快照保存以便跨对话恢复或长时间任务中做检查点。session-persist 技能session-persist 技能 是完成该工作流的最高层入口其典型调用序列为保存会话— 调用mcp__plugin_ruflo-core_ruflo__session_save对当前状态做快照列出会话— 调用mcp__plugin_ruflo-core_ruflo__session_list查看所有已保存会话恢复会话— 调用mcp__plugin_ruflo-core_ruflo__session_restore恢复指定会话查看详情— 调用mcp__plugin_ruflo-core_ruflo__session_info获取会话详情与元数据清理— 调用mcp__plugin_ruflo-core_ruflo__session_delete删除过期会话该技能声明了明确的白名单工具allowed-toolssession_save、session_restore、session_list、session_info、session_delete、hooks_session-start、hooks_session-end、hooks_session-restore外加Bash——不存在通配工具授权这一约束也被 smoke 契约的第 10 项强制校验。会话钩子自动化的持久化时机除手动调用外会话持久化还通过三个会话钩子自动触发hooks_session-start— 对话开始时自动恢复上下文hooks_session-end— 对话结束时自动保存状态并导出指标hooks_session-restore— 按会话 ID 恢复指定会话会话专家 Agent插件还捆绑了一个 session-specialist Agent模型标注为haiku职责包括保存带完整状态快照的会话、恢复会话以带着全部上下文继续工作、用 RVF 格式跨项目迁移记忆、把 Claude 记忆导入 AgentDB 统一检索、管理会话与记忆条目的生命周期。其硬性约定是“确保关键状态在会话结束前总是被保存”Ensure critical state is always saved before session end。该 Agent 还会在任务完成后把成功模式写入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跨项目知识迁移与 Claude 记忆桥接跨项目传输rvf-managervf-manage 技能 面向“把 Agent 记忆导出为 RVF 做备份、跨项目迁移、或团队间共享知识”的场景标准流程为列出记忆—mcp__plugin_ruflo-core_ruflo__memory_list查看全部已存记忆导出— 通过mcp__plugin_ruflo-core_ruflo__hooks_transfer工具、store动作导出模式导入— 调用mcp__plugin_ruflo-core_ruflo__memory_import_claude从 Claude Code 记忆导入迁移— 调用mcp__plugin_ruflo-core_ruflo__memory_migrate做 RVF 格式升级统计— 调用mcp__plugin_ruflo-core_ruflo__memory_stats查看存储指标跨项目传输对应的 CLI 形式为npx claude-flow/clilatest hooks transfer store --pattern project-knowledge npx claude-flow/clilatest hooks transfer from-project --source /path/to/other/projectClaude 记忆桥接“Claude memory bridge”指把 Claude Code 的自动记忆auto-memories导入 AgentDB实现跨 Agent 工具的统一检索。这由memory_import_claude工具完成导入后记忆进入 AgentDB 的命名空间体系可被memory_*namespace-routed系列工具统一访问。静态加密会话与记忆数据的落盘保护ADR-096ruflo 3.6.25 起本插件持久化的会话数据落在.claude-flow/sessions/*.json写入时走fs-secure.writeFileRestricted({encrypt:true})依据 ADR-096加密静态存储 实现。门控行为Gate加密是**显式开启opt-in**的默认关闭关闭默认CLAUDE_FLOW_ENCRYPT_AT_REST未设置或为 falsy 时会话以明文 JSON 落盘文件权限 0600行为与 ruflo 3.6.24 及更早版本完全一致开启CLAUDE_FLOW_ENCRYPT_AT_REST1且CLAUDE_FLOW_ENCRYPTION_KEY已设置为 64 位 hex 或 44 位 base64 密钥时每次会话保存使用AES-256-GCM加密文件带RFE1magic 字节前缀会话恢复时通过 magic 嗅探透明解密旧版明文会话在迁移期仍可原样加载。文件格式加密文件布局为每个文件使用随机 12 字节 nonceGCM 16 字节认证标签追加在末尾----------------------------------------- | magic 4 | iv 12 | ciphertext N | tag 16 | ----------------------------------------- RFE1 random plaintext xor GCMRFE1Ruflo File Encrypted v1magic 的作用是让读取方自检——读到RFE1就解密否则按明文处理从而无需全仓迁移即可增量铺开启用加密后的首次写入即会把文件改写为加密格式。密钥来源与优先级fail-closedADR-096 定义了三级密钥解析优先级任一来源失败即按顺序回退全部失败则直接报错而非静默写明文fail-closed 姿态CLAUDE_FLOW_ENCRYPTION_KEY— base64 编码的 32 字节优先级最高适合 CI / 容器 / 已有密钥管理器的用户OS 密钥链 —keytar风格查找serviceclaude-flowaccountdefaultmacOS Keychain / Windows DPAPI / Linux libsecret为可选原生依赖不可用时回退到 3交互式口令 scrypt KDF — 派生密钥仅驻留进程内存、绝不落盘盐保存于~/.claude-flow/.kdf-salt16 字节随机0600。加密范围与迁移ADR-096 按敏感度把.claude-flow/下的存储分为三档会话 JSON、.swarm/memory.db、终端历史terminals/store.json属于High档会携带记忆快照、Agent 提示词、粘贴过的含密钥命令是 Phase 1 的加密对象Agent 注册表、任务存储等 Medium/Low 档在 Phase 1 保持明文。迁移是惰性的读取时嗅探 magic首次写入后自动改写为加密格式ruflo migrate encrypt子命令同为 opt-in可做一次性的急切迁移。可用ruflo doctor -c encryption确认当前门控状态。关键提示导出 RVF 跨机器传输时加密门控不作用于导出字节——加密是“源主机上的静态加密”若 RVF 本身敏感传输层安全sealed boxes / 签名 blob是 ADR 路线图中的下一阶段密钥丢失即数据不可恢复by design——ADR-096 明确将“密钥丢失导致记忆与会话不可恢复”列为头号风险启用前务必妥善保管密钥。命令与技能总览类型名称作用命令/rvf记忆统计、已保存会话、存储指标技能rvf-manage管理 RVF 文件实现便携式记忆import/export/list/migrate/stats/delete技能session-persist跨对话持久化与恢复 Agent 会话save/restore/listAgentsession-specialist会话持久化专家编排上述工具完成状态管理与记忆迁移/rvf命令的完整执行逻辑见 commands/rvf.md先调用mcp__plugin_ruflo-core_ruflo__memory_stats获取存储指标再调用mcp__plugin_ruflo-core_ruflo__session_list展示已保存会话最终呈现总条目数、命名空间、存储大小、已保存会话、上次备份时间。兼容性与验证smoke 即契约ruflo-rvf 把验证脚本当作插件契约bash plugins/ruflo-rvf/scripts/smoke.sh # Expected: 10 passed, 0 failedscripts/smoke.sh 共执行 10 项结构化检查覆盖契约的全部维度plugin.json声明版本0.2.1且包含mcp、cognitive-containers、lineage-tracking三个关键词两个技能rvf-manage、session-persist Agentsession-specialist 命令rvf齐备且 frontmatter 合法含name:与description:README 将claude-flow/clipinned 到 v3.6README 引用ruflo-agentdb的“Namespace convention”命名空间约定README 声明rvf-sessions命名空间归属README 存在对ruflo-browser会话的 RVF 交叉引用session 与 RVF 的关联表述README 存在对ruflo-ruvectorRVF 工具链的交叉引用ruvector rvf/ RVF tooling静态加密块完整含ADR-096引用、AES-256-GCM算法、RFE1magic 字节docs/adrs/0001-rvf-contract.md存在且status: Accepted技能allowed-tools中无通配符*授权。跨插件 RVF 所有权三插件分工RVF 认知容器在整个 Ruflo 生态中由三个插件共同承载各司其职Slice切片归属者职责便携式记忆 会话持久化ruflo-rvf本文插件高层技能保存/恢复、跨机器传输浏览器会话即 RVFruflo-browser ADR-0001每个浏览器会话在开始时被分配为一个 RVF 容器manifest、trajectory、screenshots、snapshots、cookies、findingsRVF 工具链10 个子命令ruflo-ruvector ADR-0001ruvector rvf create\|ingest\|query\|status\|segments\|derive\|compact\|export\|examples\|download本插件位于 ruvector 工具链之上消费其ruvector rvf *能力并向下游的 browser 会话即 RVF 模型供能。例如 ruflo-browser 把每个会话分配为rvf create --dimension 384 session-name.rvf容器、会话结束时执行rvf compact rvf export这正是 RVF 作为“可重放、可审计、可联邦共享”会话制品的基础设施详见 ruflo-browser ADR-0001。命名空间协调rvf-sessions本插件认领 AgentDB 的rvf-sessions命名空间kebab-case遵循 ruflo-agentdb ADR-0001 的命名空间约定。两个保留命名空间不可遮蔽pattern、claude-memories、default。rvf-sessions索引的是“已保存会话的 manifest 其 RVF 容器路径”通过memory_*namespace-routed系列工具访问。这套约定使插件对 AgentDB 的写入路径与索引语义可预测也为 smoke 第 4、5 项提供了校验依据。架构决策ADR-0001 契约ADR-0001ruflo-rvf 插件契约status: Accepted2026-05-04 提出 / 05-09 更新固化了本插件的身份定位RVF 表面的“便携式记忆 会话持久化”切片的 canonical owner。ADR 同时明确了README 需要包含兼容性 pinv3.6、跨插件 RVF 所有权表、命名空间协调、验证与架构决策章节插件元数据版本保持在0.2.0节奏关键词追加mcp、cognitive-containers、lineage-trackingscripts/smoke.sh的 10 项结构检查作为契约门禁正向后果插件纳入发布节奏跨插件 RVF 所有权故事被契约化文档化无实质性负面后果。相关插件速览ruflo-ruvector— 暴露本插件所依赖的ruvector rvf *工具链pin 到ruvector0.2.25见 其 ADR-0001ruflo-browser— 用 RVF 容器承载会话即技能制品其 ADR-0001ruflo-agentdb— 命名空间约定的所有者。三者构成 Ruflo 便携式认知的完整链路ruvector 提供底层 RVF 工具ruflo-rvf 提供可移植记忆与会话持久化的高层技能ruflo-browser 把浏览器会话包装成可重放、可共享的 RVF 制品。【免费下载链接】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），仅供参考