09 · 导入导出与发送记录
目标:批量维护内容、备份迁移数据、看懂发送记录排查问题。
📤 三种批量方式
| 方式 | 适用内容 |
|---|---|
| CSV 导入导出 | 名句、问候语、音乐条目、纪念日、倒计时等表格数据(UTF-8 with BOM,兼容 Excel / WPS) |
| 文件夹导入 | 批量图片和语音,可附带 assets.csv 描述文件名、显示名、标签、权重和启用状态 |
| ZIP 完整备份 | 全部配置、任务、模板、文案、素材一次打包迁移 |
CSV 示例(名句)
CSV 示例(音乐)
🔄 导入流程与冲突策略
流程:选择文件 → 安全扫描 → 解析校验 → 展示新增 更新 跳过 / 错误预览 → 选择冲突策略 → 自动备份 → 事务导入 → 生成结果报告。
冲突策略四种:
| 策略 | 行为 |
|---|---|
| 跳过 | 已有同 ID 或同内容时跳过 |
| 覆盖 | 保留 ID 并覆盖字段 |
| 另存为新条目 | 生成新 ID,引用关系随导入包重映射 |
| 合并 | 只填充目标空字段,标签取并集 |
存在错误行时默认只导入有效行,也可选择"任一错误则全部取消";导入结果报告可再次导出为 CSV。
💾 备份
自动备份:重大批量修改、完整导入、数据库迁移前自动创建,默认保留最近 10 份。
完整备份包:
ZL-TimeAnnouncer-Backup-时间戳.zip,含 manifest(版本、统计、校验值)+配置+素材文件。恢复:支持"清空并恢复",需二次确认,恢复前会再自动备份当前数据。
密钥不导出:天气 / TTS 密钥不随备份打包,恢复后需重新填写。
发送日志默认不进完整备份,可单独导出 CSV。
💡 迁移服务器:旧机导出 ZIP 完整备份 → 新机安装插件 → 导入备份 → 重新填写密钥。
📜 发送记录
发送记录 页可按群、任务、状态、日期筛选,每条记录包含:执行时间、任务、机器人、群、模板、选中素材、渲染文本、尝试次数和错误原因。
状态含义
| 状态 | 含义 |
|---|---|
| ✅ 成功 | 全部消息段正常发送 |
| ⚠️ 降级成功 | 按降级链发送(如语音失败转文字),内容不完整但已送达 |
| ❌ 失败 | 重试后仍失败,错误原因写在记录里 |
排查思路
🔒 日志默认按保留天数自动清理;消息正文有长度上限,避免数据库无限膨胀;密钥等敏感信息永不写入日志。
💡 备份文件建议定期复制到插件目录以外的位置,防止整目录误删。