升级备份与版本记录
本篇以升级前的备份与迁移操作为主,说明推荐升级步骤与配置兼容规则;各版本的具体更新内容请前往「更新记录」页查看。
💾 升级前备份
打开插件控制台,点击「数据目录」,备份以下内容:
| 文件 / 目录 | 说明 | 是否必须备份 |
|---|---|---|
config.json | 插件设置 | 建议 |
activity.json | 成员活跃记录 | 建议 |
template-preferences.json | 用户模板偏好 | 建议 |
avatar-cache | 头像缓存 | 可不备份,可重新生成 |
通常需要备份 config.json、activity.json 和 template-preferences.json,头像缓存可以重新生成。
🔄 推荐升级步骤
- 停用当前版本插件;
- 备份插件数据目录;
- 在插件管理中删除或替换旧安装包;
- 导入新版本
.uniqq文件; - 重新启用插件;
- 打开控制台检查群组范围和外观配置;
- 在测试群发送
资料卡验证。
运行期间禁止覆盖程序文件
不要在插件运行期间手动覆盖正在加载的 DLL。升级请按「先停用、再替换、后启用」的顺序操作。
✅ 升级后检查清单
| 检查项 | 操作 |
|---|---|
| 控制台打开 | 点击插件「设置」,确认左下角显示「插件运行中」 |
| 群组范围 | 核对群列表与各群开关状态 |
| 卡片外观 | 确认主题颜色与字段开关保留完整 |
| 群内测试 | 在测试群发送 资料卡 验证出图 |
备份文件如何恢复
升级完成并确认功能正常前,请保留备份文件。若升级后需要回退或配置丢失,可停用插件后,将备份的 config.json、activity.json、template-preferences.json 放回数据目录,再重新启用插件并检查配置。
获取新版本
新版 .uniqq 安装包可从官网获取,更新通知与下载协助可加入官方群 327942687;各版本更新内容详见更新记录。
🔗 配置兼容
升级后插件会保留以下配置:
- 启用状态;
- 触发指令;
- 查询权限;
- 群组范围;
- 缓存和等级参数;
- 主题颜色;
- 显示字段开关。
新版增加配置时会使用默认值补充,不需要手动修改 JSON。
📜 查看版本记录
插件从 0.0.1 首个正式版迭代至今,版本脉络简要如下:
| 阶段 | 版本 | 主线内容 |
|---|---|---|
| 当前 | v0.1.1 | 前景图层、名片卡自定义联系方式、控制台四页布局重构 |
| 图层编辑器 | v0.1.0 | 字体库、素材库、变量总表,名片卡四款专属模板 |
| 模板精修 | v0.0.5 ~ v0.0.8 | 模板头像参数、透明模板、蓝晶星轨与主题字体 |
| 奠基 | v0.0.1 ~ v0.0.4 | 资料卡查询、名片卡指令、透明 PNG 模板渲染 |
每个版本的完整更新内容(新增功能、体验优化与问题修复)请查阅更新记录;更早的历史版本信息可加入官方群 327942687 咨询。
📚 下一节:个人名片卡与自定义模板
