Skip to content

导入导出与发送记录 ​

目标:批量维护内容、备份迁移数据,并看懂发送记录排查发送问题。

📤 三种批量方式 ​

方式适用内容
CSV 导入导出名句、问候语、音乐条目、纪念日、倒计时等表格数据(UTF-8 with BOM,兼容 Excel / WPS)
文件夹导入批量图片和语音,可附带 assets.csv 描述文件名、显示名、标签、权重和启用状态
ZIP 完整备份全部配置、任务、模板、文案、素材一次打包迁移

CSV 示例(名句) ​

csv
id,content,author,source,tags,weight,enabled
,人生没有彩排,每一天都是现场直播。,未知,,治愈|晚上,100,true

CSV 示例(音乐) ​

csv
id,platform,songId,title,artist,tags,enabled
,qq,0039MnYb0qxYhV,歌曲名,歌手,晚上|治愈,true

🔄 导入流程与冲突策略 ​

导入流程:选择文件 → 安全扫描 → 解析校验 → 展示新增 / 更新 / 跳过 / 错误预览 → 选择冲突策略 → 自动备份 → 事务导入 → 生成结果报告。

冲突策略四种:

策略行为
跳过已有同 ID 或同内容时跳过
覆盖保留 ID 并覆盖字段
另存为新条目生成新 ID,引用关系随导入包重映射
合并只填充目标空字段,标签取并集

存在错误行时默认只导入有效行,也可选择「任一错误则全部取消」;导入结果报告可再次导出为 CSV。

💾 备份与恢复 ​

项目说明
自动备份重大批量修改、完整导入、数据库迁移前自动创建,默认保留最近 10 份
完整备份包ZL-TimeAnnouncer-Backup-时间戳.zip,含 manifest(版本、统计、校验值)+配置+素材文件
恢复支持「清空并恢复」,需二次确认,恢复前会再自动备份当前数据
密钥天气 / TTS 密钥不随备份打包,恢复后需重新填写
发送日志默认不进完整备份,可单独导出 CSV

迁移服务器

旧机导出 ZIP 完整备份 → 新机安装插件 → 导入备份 → 重新填写密钥。备份文件建议定期复制到插件目录以外的位置,防止整目录误删。

📜 发送记录 ​

发送记录 页可按群、任务、状态、日期筛选,每条记录包含:执行时间、任务、机器人、群、模板、选中素材、渲染文本、尝试次数和错误原因。

状态含义 ​

状态含义
✅ 成功全部消息段正常发送
⚠️ 降级成功按降级链发送(如语音失败转文字),内容不完整但已送达
❌ 失败重试后仍失败,错误原因写在记录里

排查思路 ​

text
看状态和错误原因
    ↓
定位到具体任务和模板
    ↓
用"立即测试"复现(测试记录标为 test,不影响正式计划)
    ↓
修正配置后再次测试

日志安全

日志默认按保留天数自动清理;消息正文有长度上限,避免数据库无限膨胀;密钥等敏感信息永不写入日志。


📚 下一节:常见问题FAQ

薇薇官机平台 · ZL 系列插件