从旧版本升级
从 PicGo 迁移
在设置的同步页面选择 从 PicGo 迁移。PicList 会从 PicGo 的数据目录导入 data.json，并在存在 picgo.db 时将其导入为 piclist.db。导入会覆盖当前 PicList 的对应配置和相册，因此请先备份两个应用的数据目录。
导入成功后重启 PicList，检查图床配置并验证一次上传。插件仍需检查是否与当前版本兼容；迁移配置不会自动完成插件安装。
升级 Core 到 3.0
安装 Node.js 22.x，最低 22.13.0，然后运行：
bash
npm install -g [email protected]
picgo --version
picgo --helpCore 3.0 的主要变化：
| 旧用法或行为 | 当前用法 |
|---|---|
| ~/.piclist/config.json | 优先 data.json，旧文件作为回退 |
| picgo config-list / config-use | 使用 picgo config list / picgo config use |
| 默认直接使用构造函数 | 用 await PicGo.create() 完成初始化 |
| CommonJS require('piclist') | 使用动态 import('piclist') |
| 无参数命令 | 交互式终端中打开 TUI，非交互环境显示帮助 |
不要仅凭文件名推断实际配置。迁移脚本时用 -c 指定文件路径，以免误读同目录下的另一份配置。
验证清单
确认原图保留、目标正确、返回链接可访问、输出格式符合编辑器预期。使用私有存储时，也要验证签名链接的有效期。出现问题时见排查指南。