BossAgents 版本切换指南

概述

BossAgents 项目支持新老版本共存，可以通过不同的 URL 路径访问不同版本。

版本说明

现代版 (推荐)

老版本 (兼容模式)

版本切换方法

方法一：URL 直接访问

# 访问现代版
http://localhost:3000/

# 访问老版本
http://localhost:3000/old

方法二：页面内切换

现代版侧边栏底部提供了版本切换入口：

1. 登录后在侧边栏找到 "🔄 版本切换" 区域
2. 点击 "切换到老版本" 即可跳转

方法三：登录页面切换

现代版登录页底部有老版本链接：

点击这里切换到老版本

服务器启动模式

开发模式

# 启动 Node.js 服务器（同时支持两个版本）
node server.js

# 或使用 npm 脚本
npm start

Vite 开发模式

# 启动 Vite 开发服务器（仅现代版）
npm run dev:vite

生产构建

# 构建现代版
npm run build

# 构建后启动
node server.js

目录结构

项目根目录/
├── index.html          # 现代版入口（开发模式）
├── dist/               # 现代版构建产物（生产模式）
│   └── index.html
├── src/                # 现代版源代码
│   ├── main.js         # 应用入口
│   ├── App.vue         # 根组件
│   ├── router/         # 路由配置
│   ├── views/          # 页面组件
│   └── assets/         # 静态资源
├── index-vue.html      # 老版本入口
├── frontend/           # 老版本相关资源
└── server.js           # 服务器配置

版本选择建议

| 场景 | 推荐版本 | 原因 |

|------|----------|------|

| 日常开发 | 现代版 | 组件化、易于维护 |

| 功能测试 | 现代版 | 新特性、更好的UI |

| 生产环境 | 现代版 | 更稳定、性能更好 |

| 兼容性验证 | 老版本 | 确保原有功能正常 |

| 问题排查 | 对比两个版本 | 定位问题来源 |

关键差异

迁移指南

从老版本迁移到现代版

1. 功能对比：检查现代版是否已包含所需功能
2. 数据迁移：确保数据在两个版本间兼容
3. 测试验证：在现代版中重新测试业务流程
4. 逐步切换：先在测试环境验证，再正式切换

注意事项

• 两个版本共享后端 API，数据保持一致
• 现代版使用 hash 路由（/#/path），不影响后端路由
• 建议在现代版稳定后逐步淘汰老版本

技术支持

如遇到版本切换问题，请检查：

1. 服务器是否正常启动
2. 端口是否被占用（默认 3000）
3. 浏览器缓存是否已清除
4. 控制台是否有错误信息

文档版本: v1.0

适用版本: BossAgents v1.0

最后更新: 2026年5月