## 一、架构升级
开始升级前，请先将新版本仓库中的以下文件和目录同步到服务器对应位置：
- `.env`
- `bin/` 目录下的所有快捷脚本
将现有的服务的账号、密码、密钥、邮箱配置等数据，同步到.env中，例如：
1. `huasen-mongo/init-mongo-open.js`中用户数据库账号和密码；
2. `huasen-redis/conf/redis.open.conf`中密码；
3. `huasen-server/config.js`中对称密钥、邮箱配置等；
4. `docker-compose.yml`中数据库管理员账号和密码。
## 二、网链数据迁移说明
花森起始页早期版本中，订阅源、栏目、网链、Tag、Pin等数据存在一定程度的耦合关系。这种设计在早期版本中可以满足基础使用，但随着 AI 工作台版本对数据管理能力的增强，旧结构会带来以下问题：
- 订阅源、栏目、网链、Tag、Pin之间关系不清晰，数据维护成本较高
- 网链导入、导出能力受限
- Tag、Pin无法作为独立数据灵活管理
- 后续功能扩展困难
## 三、迁移脚本位置
迁移脚本位于后端目录：`huasen-server/mongodb/migration/V1.0.0升级V2.0.0数据迁移/`，包含以下脚本：
|执行顺序|脚本文件|说明|
|:-|:-|:-|
|1|journal2column.js|迁移订阅源与栏目的关系|
|2|column2site.js|迁移栏目与网链的关系|
|3|site2pin.js|迁移网链与标记的关系|
|4|site2tag.js|迁移网链与标签的关系|
|5|cleanup-old-fields.js|清理旧字段（建议观察一段时间后再执行）|
## 四、执行迁移
升级完成并确认后台可以正常登录后，进入后台管理界面，打开"动态代码执行器"。
务必按第三章的顺序打开以下脚本文件，将脚本内容粘贴到动态代码执行器中执行。检查每个脚本返回的结果。如果返回状态为成功，并且没有明显异常数据，即表示对应关系迁移完成。
## 五、升级完成后验证
迁移完成后，建议检查以下功能：
- 后台栏目管理是否正常
- 网链列表是否正常展示
- 网链与栏目关系是否正确
- 标签数据是否正常
- 标记数据是否正常
- 网链导入、导出功能是否符合预期
- 门户端起始页展示是否正常
确认以上功能正常后，即可完成从花森起始页正式版到 AI 工作台版本的升级。