Files
makemd/docs/01_Architecture/12_Operation_Agent.md
wurenzhi eafa1bbe94 feat: 添加货币和汇率管理功能
refactor: 重构前端路由和登录逻辑

docs: 更新业务闭环、任务和架构文档

style: 调整代码格式和文件结构

chore: 更新依赖项和配置文件
2026-03-19 19:08:15 +08:00

7.6 KiB
Raw Blame History

Operation-Agent 架构设计与实现

1. 核心架构

1.1 系统层级

前端管理面板 → 后端服务 → Operation-Agent → 平台 Adapter → 外部平台
      ↓                                    ↑
      ←---------- 数据回传 -----------------

1.2 核心组件

  • 前端管理面板:操作入口、状态展示、多店铺管理、数据可视化
  • 后端服务数据存储、业务逻辑、AI策略、报表系统
  • Operation-Agent:轻量化守护进程、核心操作、平台适配、监控能力
  • 平台Adapter:模块化设计、操作封装、数据标准化、异常处理

2. 浏览器插件实现方案

2.1 架构

浏览器插件 → 插件后台脚本 → 平台适配器 → 外部平台
     ↓                              ↑
     ←------------ 数据回传 ------------

2.2 核心组件

  • 插件后台脚本替代Operation-Agent的守护进程
  • 平台适配器:保留现有的IPlatformAdapter接口,扩展以支持浏览器环境
  • 数据存储:使用浏览器的chrome.storage存储配置和状态
  • 用户界面:实现浏览器插件的弹出页面

2.3 限制与解决方案

  • 截图限制:使用chrome.tabs.captureVisibleTab() API捕获当前标签页
  • 文件上传限制通过API发送到后端服务
  • 权限管理:明确权限申请,动态权限请求

3. 无界面后台服务实现

3.1 架构

后端服务 → Operation-Agent无界面后台服务 → 平台 Adapter → 外部平台
     ↑                                        ↓
     ←--------------- 数据回传与状态更新 ---------------

3.2 核心组件

  • 无界面后台服务使用Node.js构建的系统服务
  • 安全通信层与后端服务使用加密WebSocket连接
  • 任务执行引擎:队列化处理任务,支持任务优先级和依赖关系
  • 错误处理系统:自动捕获和处理错误,详细的错误日志和截图

3.3 技术实现

  • 无界面后台服务使用node-windows、systemd等实现系统服务
  • 安全通信加密WebSocket连接双向认证机制
  • 高权限操作:系统级权限,可执行全屏截图、系统操作等
  • 无界面浏览器自动化使用Puppeteer/Playwright进行无界面浏览器操作

4. 远程人工交互方案

4.1 架构

前端管理面板 ←→ 后端服务 ←→ Operation-Agent远程浏览器 ←→ 平台 Adapter ←→ 外部平台
     ↑                                      ↑
     ←-------- 实时屏幕传输与操作 ---------→

4.2 核心组件

  • 远程浏览器管理Operation-Agent启动受控浏览器实例捕获浏览器屏幕并编码传输
  • 实时通信层WebRTC或WebSocket实现实时屏幕传输
  • 前端交互界面:实时显示远程浏览器屏幕,捕获用户操作
  • 会话管理:远程交互会话的创建和管理,权限控制和安全验证

4.3 技术实现

  • 远程屏幕传输使用Puppeteer捕获屏幕压缩编码后传输
  • 前端交互界面React组件实现实时屏幕显示和操作捕获
  • 后端服务集成WebSocket处理会话管理和任务分发

4.4 其他方案

  • 基于云桌面的方案使用AWS WorkSpaces、阿里云无影等
  • 基于容器的方案使用Docker运行浏览器容器通过VNC提供Web界面
  • 基于API的方案为每个平台实现API调用逻辑
  • 混合方案:根据操作类型和平台特性选择最佳执行方式
  • 第三方服务集成使用BrowserStack、Sauce Labs等服务
  • 本地代理方案:在用户本地运行轻量级代理,通知用户完成操作

5. 多店铺管理与VPS控制

5.1 架构

前端管理面板 ←→ 后端服务 ←→ Agent管理服务 ←→ Operation-Agent实例集群
                                      ↓
                                 负载均衡/调度
                                      ↓
                        ┌─────────────┼─────────────┐
                        ↓             ↓             ↓
                VPS1 (IP1)     VPS2 (IP2)     VPS3 (IP3)
                ┌────────┐     ┌────────┐     ┌────────┐
                │Agent 1 │     │Agent 2 │     │Agent 3 │
                └────────┘     └────────┘     └────────┘
                    ↓               ↓               ↓
              多店铺管理       同平台隔离       多店铺管理

5.2 VPS控制模式

  • SaaS提供商控制全托管服务商家无需关心VPS配置和维护
  • 商家自行控制完全控制VPS配置、网络环境和安全策略
  • 混合控制模式关键业务使用自管VPS一般业务使用SaaS服务
  • 第三方代理控制由专业代理公司提供VPS管理服务

5.3 类SaaS多商户架构下的VPS管理

  • 平台运营方控制统一采购VPS建立总VPS池分配VPS资源
  • 假admin客户管理管理自己名下的终端商户在分配的VPS资源内为终端商户分配具体VPS
  • 终端商户使用在分配的VPS上管理自己的店铺执行商品采集、上架、调价等操作

5.4 技术实现

  • VPS管理系统:资源池管理、分配策略、隔离机制、自动化部署
  • 权限管理三级权限体系平台运营方、假admin客户、终端商户
  • 计费系统:多级计费,资源使用统计,账单自动生成
  • 监控与告警VPS状态监控异常告警性能分析
  • 灾备与恢复:数据备份,故障恢复,冗余机制

6. 实现建议

6.1 技术选型

  • 运行环境Node.js + Electron跨平台或独立的系统服务
  • 浏览器自动化Puppeteer支持Chrome/Chromium或Playwright支持多浏览器
  • 通信机制WebSocket + WebRTC实时屏幕传输
  • 数据存储本地数据库SQLite、LevelDB+ 与后端服务同步

6.2 安全考虑

  • 凭证管理加密存储店铺凭证按Agent实例隔离存储定期凭证轮换
  • 错误处理Agent故障自动检测和切换任务失败自动重试异常情况告警和人工干预
  • 监控与告警VPS资源监控Agent健康状态监控店铺操作异常告警

6.3 性能优化

  • 资源分配根据店铺需求和操作频率合理分配VPS资源
  • 任务调度:优化任务队列和执行顺序,提高并发处理能力
  • 网络优化使用CDN和缓存减少网络延迟
  • 代码优化:优化浏览器自动化脚本,减少资源消耗

6.4 扩展性

  • 模块化设计:平台适配器和任务执行引擎的模块化设计,便于添加新平台和功能
  • 水平扩展支持添加新的VPS和Agent实例应对业务增长
  • API设计提供标准化的API接口便于与其他系统集成

7. 总结

Operation-Agent是一个强大的跨境电商平台集成解决方案通过灵活的架构设计和多种实现方案可以满足不同场景下的需求。从浏览器插件到无界面后台服务从远程人工交互到多店铺管理Operation-Agent提供了一套完整的工具链帮助商家高效管理多平台店铺提高运营效率和竞争力。

在实际商业化运营中,需要根据具体的业务需求、技术能力和成本预算选择合适的实现方案,并不断优化和改进,以适应不断变化的市场环境和平台规则。