09 · 导入导出与发送记录

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


📤 三种批量方式

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

CSV 示例(名句)

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

CSV 示例(音乐)

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

🔄 导入流程与冲突策略

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

冲突策略四种:

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

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

💾 备份

  • 自动备份:重大批量修改、完整导入、数据库迁移前自动创建,默认保留最近 10 份。

  • 完整备份包:ZL-TimeAnnouncer-Backup-时间戳.zip,含 manifest(版本、统计、校验值)+配置+素材文件。

  • 恢复:支持"清空并恢复",需二次确认,恢复前会再自动备份当前数据。

  • 密钥不导出:天气 / TTS 密钥不随备份打包,恢复后需重新填写。

  • 发送日志默认不进完整备份,可单独导出 CSV。

💡 迁移服务器:旧机导出 ZIP 完整备份 → 新机安装插件 → 导入备份 → 重新填写密钥。

📜 发送记录

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

状态含义

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

排查思路

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

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


💡 备份文件建议定期复制到插件目录以外的位置,防止整目录误删。

共 12 篇 ZL-自定义报时 / 导入导出与发送记录 0 字 0 行 zhangxiaolin
创建 2026-09-29T06:05:51.700354596Z 更新 2026-09-29T06:06:03.374477491Z