【免费下载链接】dr-clawA Super AI Lab with massive AI Doctors as Assistants. Best IDE for Research via AI Power.项目地址https://gitcode.com/gh_mirrors/dr/dr-claw点击查看免费下载Dr. Claw 是一款开源的全栈 AI 科研工作台支持 Claude Code、Codex、Gemini CLI、OpenRouter 等多家 AI 引擎协同工作。它的系统架构采用经典的 React 前端 Express 后端 WebSocket 实时通道三层设计并通过统一的多 Agent 流式调度层实现 7 种 AI 引擎的并行会话管理。本文将带你完整梳理这套架构的分工与数据流。三层架构总览各司其职Dr. Claw 的架构可以概括为一个入口、三条通道层核心技术职责关键入口前端React 18 Vite TailwindCSS聊天、研究看板、技能库、Git 面板等 UIsrc/App.tsx后端Express SQLite (better-sqlite3)REST API、认证、项目管理、技能路由server/index.js实时层ws (WebSocket)AI 流式输出、终端转发、会话状态同步server/index.js三者通过同一个 Node.js 进程协同Express 负责请求-响应类操作登录、项目列表、Git 提交WebSocket 负责长连接流式操作AI 逐字输出、终端输入输出前端通过 React Context 把两条通道统一封装给组件使用。React 前端层Provider 嵌套与懒加载前端入口 src/App.tsx 只有一棵简洁的 Provider 树I18nextProvider → ThemeProvider → AuthProvider → ProtectedRoute → AuthenticatedWorkspace这种嵌套保证了国际化、主题、认证状态在所有页面共享。工作区 src/components/app/AuthenticatedWorkspace.tsx 再叠加WebSocketProvider、TaskMasterProvider并挂载路由整个工作区组件本身也是懒加载的配合 src/utils/lazyWithRetry.tsx 的失败重试机制首次打开速度明显更快。WebSocket 连接管理的关键设计src/contexts/WebSocketContext.tsx 是前端实时通信的核心有三个值得学习的设计带 Token 的握手连接 URL 携带 JWT/ws?token...HTTPS 环境下自动升级为wss:见 buildWebSocketUrl消息队列防丢失AI 流式输出时消息到达极快React 状态更新可能跟不上。前端用一个messageQueueRef队列 setTimeout逐条排水drain保证每条消息都能触发一次渲染见 drainQueue断线重连与连接去重维护retryCountRef指数退避重连并在onopen中校验wsRef.current是否为最新 socket避免半开连接泄漏。会话历史加载则在 src/components/chat/hooks/useChatSessionState.ts 中实现了 LRU 消息缓存最多缓存 10 个会话切换会话标签时秒开这是多会话并行体验的关键。Express 后端层路由、认证与本地存储后端入口 server/index.js 在单进程内挂载了 20 多个 REST 路由覆盖项目管理、Git、MCP、技能、模型、计算节点、新闻等模块app.use(/api/projects, authenticateToken, projectsRoutes); app.use(/api/git, authenticateToken, gitRoutes); app.use(/api/skills, authenticateToken, skillsRoutes); app.use(/api/models, authenticateToken, modelsRoutes); app.use(/api/agent, agentRoutes); // 对外 Agent API所有/api/*路由先经过validateApiKey再叠加 JWT 中间件authenticateToken认证逻辑集中在 server/middleware/auth.js。数据存储选用本地SQLitebetter-sqlite3数据库初始化与迁移逻辑在 server/database/db.js支持通过DATABASE_PATH环境变量自定义位置并内置旧库自动迁移。另一个亮点是文件监听驱动的会话同步后端用 chokidar 监听~/.claude/projects、~/.codex/sessions等各引擎的会话目录见 PROVIDER_WATCH_PATHS任何 AI 工具在外部产生的新会话文件都会触发防抖广播让 Web 端侧边栏无刷新更新——这正是 Dr. Claw 能统一管理多家 AI 工具会话的基础。WebSocket 层一条通道服务三类流量Dr. Claw 只创建了一个WebSocketServerserver/index.js但通过消息类型type字段在同一连接上区分三类流量流量类别典型消息类型用途AI 会话claude-command、codex-command、gemini-command、abort-session发起/中止各引擎对话终端init、input、resizenode-pty 伪终端双向转发状态同步check-session-status、get-active-sessions、telemetry-settings查询活跃会话、埋点开关连接建立前会执行verifyClient校验 JWT未认证的连接直接被拒绝authenticateWebSocket。所有在线客户端保存在connectedClients集合中项目/会话变更时向全体客户端广播实现多标签页、多设备实时同步。多Agent流式调度一套管道接入7种AI引擎这是 Dr. Claw 架构中最值得拆解的部分。每种 AI 引擎对应一个独立的会话模块但都遵循同一个接口契约——启动函数(command, options, ws)AI 引擎调度模块接入方式Claude Codeserver/claude-sdk.jsClaude Agent SDK原生无子进程Cursorserver/cursor-cli.jsCLI 子进程Codexserver/openai-codex.jsCodex SDKGeminiserver/gemini-cli.js / server/gemini-api.jsCLI 或 REST API 双通道OpenRouterserver/openrouter.jsREST API本地 GPUserver/local-gpu.js本地推理Nano Claudeserver/nano-claude-code.js轻量内置引擎流式输出的三段式处理以 Claude 通道为例server/claude-sdk.js调度流程非常清晰捕获会话 ID首条消息带回session_id前端随即收到session-created事件侧边栏立即出现新会话逐条转发for await (const message of queryInstance)异步迭代器消费引擎输出每条消息经transformMessage归一化后以claude-response类型写入 WebSocket前端逐字渲染收尾事件回合结束时发送token-budgetToken 用量统计和claude-complete含退出码后台清理任务用Promise.allSettled延后执行不阻塞 UI 收尾。这套会话创建 → 流式转发 → 完成事件的协议对 7 种引擎完全一致前端因此无需为不同引擎写不同逻辑——换引擎就像换频道UI 无感知。双通道输出WebSocket 之外还有 SSE除了浏览器端的 WebSocketDr. Claw 还通过 server/routes/agent.js 暴露POST /api/agentREST 接口外部脚本可以用 API Key 触发任意引擎通过SSEServer-Sent Events接收流式结果甚至自动创建 Git 分支和 Pull Request。SSEStreamWriter与 WebSocket 的send接口签名一致因此同一套引擎代码可以无缝服务两种传输方式。一条消息的完整旅程把三层串起来你发出一条消息后发生的事情是前端聊天组件调用sendMessage({type: claude-command, command, options})经WebSocketProvider发出鉴权后端verifyClient在握手阶段已校验 JWT消息直接进入分发器调度分发器按type前缀路由到对应引擎模块claude-command→queryClaudeSDK并启动流式消费循环回流引擎输出逐条转换为claude-response经connectedClients精准回发给发起方同时向其他在线客户端广播会话状态变更落盘会话索引通过recordIndexedSession写入本地 SQLiteserver/utils/sessionIndex.js历史消息仍保留在引擎原生存储如~/.claude/projects由文件监听器兜底同步渲染前端消息队列逐条排水React 组件流式渲染文本、工具调用与 Token 预算。架构要点速查单进程多通道Express 与 WebSocketServer 共享一个 Node 进程状态活跃会话表、客户端集合无需跨进程同步架构简单且低延迟传输无关的引擎接口send()/end()/setSessionId()三个方法构成writer 契约WebSocket、SSE、响应收集器ResponseCollector都是它的适配器前后端解耦的状态同步REST 管 CRUDWebSocket 管实时文件监听管外部工具产生的会话三管齐下保证任意入口的状态最终一致桌面端零改造Electron 主进程electron/main.mjs只是把这套 Node 服务作为子进程拉起并加载到 BrowserWindow同一套代码同时服务于浏览器、PWA 与桌面应用。对新手而言Dr. Claw 的代码库是一个极佳的学习样本想学 React Context 与懒加载看 src/contexts/想学 Express 路由与 JWT 鉴权看 server/routes/想学 WebSocket 流式协议设计重点精读 server/index.js 的消息分发器和 server/claude-sdk.js 的调度循环即可。赞分享【免费下载链接】dr-clawA Super AI Lab with massive AI Doctors as Assistants. Best IDE for Research via AI Power.项目地址https://gitcode.com/gh_mirrors/dr/dr-claw点击查看免费下载相关推荐FIT 框架系统架构深度解析低代码编排、FEL 原语与 FIT 调度的三层协同设计FIT 框架系统架构深度解析低代码编排、FEL 原语与 FIT 调度的三层协同设计 本文基于 ModelEngine/fit framework 仓库的《Mo人工智能大模型AI 应用后端AI AgentRAG流程编排微服务Toonflow 决策层 Agent 调度机制解析六阶段制作流水线与三层 Agent 协作架构Toonflow 决策层 Agent 调度机制解析六阶段制作流水线与三层 Agent 协作架构 Toonflow 将小说/剧本 → 动画短剧的整个制作过程人工智能大模型AI 应用AI Agent媒体生成后端桌面应用Docker 部署 wvp-GB28181-pro首次构建 5~15 分钟交付带管理页的国标视频平台Docker 部署 wvp GB28181 pro首次构建 5~15 分钟交付带管理页的国标视频平台 用 Docker 部署 wvp GB28181 pro后端音视频前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考