如何本地运行 Ruflo Web UIRuVocal源码进行开发调试【免费下载链接】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/rufloRuVocal 是 Ruflo 项目内置的 SvelteKit Web UI即ruflo/src/ruvocal目录下的子项目提供多模型 AI 聊天界面并集成约 210 个 MCP 工具调用。如果你要修改它的界面逻辑、MCP 集成或调试流式生成流程就需要在本地把这套源码跑起来。本文的完整路径是准备环境 → 配置.env.local接入模型端点 → 启动开发服务器 → 验证聊天与工具调用 → 使用项目自带的 check/test/build 命令做调试最后附上文档中列出的常见运行问题。准备条件已获取 Ruflo 仓库源码仓库中的 RuVocal 位于ruflo/src/ruvocalgit clone https://gitcode.com/GitHub_Trending/cl/ruflo cd ruflo/ruflo/src/ruvocal依赖管理package.json 中声明了packageManager: npm9.5.0使用 npm 执行安装即可。一个可用的 OpenAI 兼容模型端点及其 API Key下文给出各提供商的取值。数据库无需额外准备开发环境下不设置MONGODB_URL时应用自动回退到内嵌的MongoMemoryServer数据持久化到项目下的./db目录见 Database 说明。配置 .env.local 接入模型端点按照 CLAUDE.md 与 README 的说明先把默认配置复制出来再改cp .env .env.local模型列表不需要手动维护应用会自动从${OPENAI_BASE_URL}/models发现可用模型见 配置总览。最小可用配置只需两个变量OPENAI_API_KEY替换为你自己的密钥OPENAI_BASE_URLhttps://openrouter.ai/api/v1 OPENAI_API_KEYsk-or-v1-... # 替换为端点要求的密钥不同提供商的取值来自 READMEKey 列为你需要提供的密钥格式ProviderOPENAI_BASE_URLKeyOpenRouterhttps://openrouter.ai/api/v1sk-or-v1-...Hugging Face routerhttps://router.huggingface.co/v1hf_xxxllama.cpp serverhttp://127.0.0.1:8080/v1any stringOllama (OAI bridge)http://127.0.0.1:11434/v1ollamaPoehttps://api.poe.com/v1pk_...两个可选配置项按需添加# 指定内部任务如标题生成使用的模型不设置时使用当前会话模型 TASK_MODELqwen/qwen3.6-max-preview # 前端展示名称 PUBLIC_APP_NAMERuFlo启动开发服务器并验证npm install npm run dev开发服务器运行在http://localhost:5173带热重载见 Architecture 文档。本地运行文档给出的等价写法是npm run dev -- --open会同时打开浏览器。验证要点浏览器访问http://localhost:5173页面加载且模型选择器中出现模型说明${OPENAI_BASE_URL}/models拉取成功发送一条消息能收到流式回复即表示端点连通若要验证 MCP 工具链路在聊天输入框点开 MCP 面板 →Add Server填入一个 HTTP/SSE/stdio 端点运行Health Check验证连通性流程见 MCP Tools 文档。模型调用工具时消息中会显示带参数的卡片、运行进度条和结果同一回合的多个工具以并行执行分组展示README。管理端预置 MCP 服务器则通过环境变量配置开发调试自己的 MCP 集成时可以这样写MCP_SERVERS[ {name:My Local MCP,url:http://localhost:3000/mcp} ]开发调试常用命令以下命令来自 CLAUDE.md在ruflo/src/ruvocal目录下执行npm run check # TypeScript 校验svelte-kit sync svelte-check npm run lint # Prettier 格式检查 ESLint npm run format # Prettier 自动格式化 npm run test # Vitest 全量测试跑单个测试调试时更常用npx vitest run path/to/file.spec.ts # 指定测试文件 npx vitest run -t test name # 按测试名 npx vitest --watch path/to/file.spec.ts # 单文件 watch 模式测试按三种环境分组配置在vite.config.ts客户端测试为*.svelte.test.tsPlaywright 浏览器环境、SSR 测试为*.ssr.test.ts、服务端测试为*.test.ts/*.spec.tsNode 环境。验证生产构建是否正常npm run build npm run preview # 本地预览构建产物默认监听 http://localhost:4173改代码时按模块定位入口参考 CLAUDE.md 的目录说明src/routes/— SvelteKit 路由聊天页在conversation/[id]/REST API 在api/v2/src/lib/server/textGeneration/— LLM 流式生成管线src/lib/server/mcp/— MCP 客户端集成src/lib/server/router/— Omni 智能路由src/lib/components/— Svelte 组件chat/、mcp/、voice/、icons/。架构背景SvelteKit 2 Svelte 5 runes、MongoDB、TailwindCSS可查阅 developing/architecture.md 与 README 的 Architecture 一节。常见问题与限制以下是 common-issues.md 中列出的三项均与本地运行直接相关模型加载不出来文档给出的检查顺序为——确认OPENAI_BASE_URL正确且可访问确认OPENAI_API_KEY有效确认端点在${OPENAI_BASE_URL}/models返回模型列表。403: You dont have access to this conversation多发生在 HTTP无 HTTPS下 cookie 配置不当时。文档推荐的方案是配反向代理NGINX、Caddy处理 HTTPS若必须走 HTTP在.env.local中设置COOKIE_SECUREfalse COOKIE_SAMESITElax PUBLIC_ORIGINhttp://localhost:5173同时确保PUBLIC_ORIGIN与实际访问地址一致。数据库连接错误开发阶段可以直接不配MONGODB_URL应用回退到内嵌数据库生产使用独立 MongoDB 时需核对MONGODB_URL连接串、Atlas IP 白名单及用户读写权限。需要注意的边界Docker 镜像--build-arg INCLUDE_DBtrue可构建内嵌 MongoDB与 Google Cloud Run 部署属于部署路径而非本地调试主路径本文不展开参见 README 与 installation/docker.md。下一步跑通聊天与工具调用后若要继续深入开发README 指出的延伸阅读是 CLAUDE.mdClaude Code agent 开发指南和 ADR-033RuVocal/WASM-MCP 集成架构文档MCP 工具配置细节见 configuration/mcp-tools.md全部环境变量说明见 configuration/overview.md。【免费下载链接】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），仅供参考