🔧 React 组件跨环境开发工具链

dev-to

让第三方开发者在智能体容器中享受「本地级」的开发体验

npm create dev-to

传统开发模式的痛点

在 AI Agent 智能体容器中开发组件时,开发者常常遇到这些问题

🔒

宿主环境黑盒

组件必须部署到容器才能调试,开发者看不到宿主内部细节,开发调试极其困难

🐢

调试反馈慢

每次修改都要重新构建、部署,无法享受热更新(HMR),开发效率低下

🐛

生产环境难调试

线上问题无法像本地一样打断点、查看日志,排查问题如同大海捞针

💥

运行时冲突

资源路径 404、容器与组件的 React 实例冲突,导致 Hook 报错等问题

dev-to 的解决方案

一套完整的工具链,彻底解决智能体容器的组件开发难题

🐛

生产级调试

支持在生产环境容器中临时加载本地开发版组件,像本地一样打断点调试

🔗

标准化协议

统一的组件加载规范,容器和组件完全解耦,支持多团队跨组织协作

📦

完整工具链

内置调试面板、UMD 构建、快速脚手架,开箱即用的完整解决方案

🖼️

资源自动处理

CSS、图片、字体等资源自动重定向到 Vite Dev Server,告别 404

🔍

完全透明

组件内部断点、日志、源码映射完整可用,调试体验与本地无异

架构设计

容器与组件提供方的协作模式

🏗️ AI Agent 智能体容器
集团/平台侧
@dev-to/react-loader 动态加载远程组件
HTTP/S
HTTP/S
HTTP/S
📦 业务线 A
localhost:5173
@dev-to/react-plugin
客服卡片、订单卡片
📦 业务线 B
localhost:5174
@dev-to/react-plugin
报表卡片、审批卡片
🔌 第三方开发者
localhost:5175
@dev-to/react-plugin
天气插件、日历插件
开发模式 容器加载 localhost 上的组件 → 实时 HMR
生产模式 容器加载 CDN 上的 UMD 包 → 稳定运行
生产调试 临时切换到 localhost → 像本地一样调试

使用场景

适用于多种需要动态加载第三方组件的场景

🤖

AI Agent 智能体平台

集团构建统一的智能体平台,各业务线或第三方提供智能体卡片(客服助手、数据看板、工单处理等)

🏢

企业微前端平台

在主应用中动态加载子应用的 React 组件,各团队独立维护,互不干扰

🧩

低代码平台插件

平台提供基础能力,开发者提供自定义组件扩展,快速集成第三方功能

💻

Electron 桌面应用

在 Electron 主窗口中加载独立开发的插件组件,构建可扩展的桌面应用

核心

完整的工具链,覆盖组件开发全流程

快速开始

30 秒创建跨环境 HMR 组件,在任意容器中实时热更新

1

使用脚手架创建项目

# 一键创建项目,全自动配置
npm create dev-to

# 启动开发服务器,访问 http://localhost:5173
cd my-project && npm run dev

脚手架会自动安装依赖、配置 Vite 插件、生成 HelloWorld 组件,开箱即用

2

手动配置 可选

// vite.config.ts - 适合在已有项目中集成
import { devToReactPlugin } from '@dev-to/react-plugin'

export default defineConfig({
  plugins: [
    react(),
    devToReactPlugin({
      MyCard: 'src/components/MyCard.tsx',
    }),
  ],
})

如果你有现有项目,可以手动安装 @dev-to/react-plugin 并配置组件映射

3

宿主容器对接 容器侧

// 宿主应用代码,由容器团队维护
import { ReactLoader } from '@dev-to/react-loader'

<ReactLoader
  origin="http://localhost:5173"
  name="MyCard"
/>

组件开发者无需关心此步骤,这是容器/宿主团队的集成工作