安装与首次配置
目标:装好插件、打开控制台、完成主人权限与数据目录确认,为后续配置打好基础。
📦 安装插件
- 获取完整的
XiaoLin.ZLTimeAnnouncer.uniqq插件包(官网或官方群下载)。 - 将插件包放入 UniQQ 的
Plugins目录,或在插件管理中直接安装。 - 启动 / 重启 UniQQ,在插件管理中启用 ZL-自定义报时插件。
- 首次启用会自动在插件数据目录生成默认配置和数据库,无需手动建文件。
注意
必须使用完整插件包;运行环境要求 .NET 10 桌面运行时与 Microsoft Edge WebView2 Runtime,缺少时会在日志中提示。
🖥️ 打开控制台
- 入口:插件管理 → ZL-自定义报时插件 → 设置。
- 控制台为独立窗口(WebView2),左侧导航共 10 页:
| 图标 | 页面 | 用途 |
|---|---|---|
| 📊 | 首页概览 | 今日统计、下一次报时倒计时、最近发送记录 |
| ⏰ | 报时任务 | 任务列表与五步编辑器 |
| 📝 | 报时模板 | 三栏模板编辑器 |
| 🎨 | 素材中心 | 图片、语音、名句、问候语、音乐五类素材 |
| 🌦️ | 扩展内容 | 天气、节日节气、纪念日、倒计时、TTS |
| 👥 | 群组设置 | 分群开关、静默时段、模板覆盖 |
| 📤 | 导入导出 | CSV 批量维护与 ZIP 完整备份 |
| 📜 | 发送记录 | 每次发送的结果与错误原因 |
| ⚙️ | 系统设置 | 权限、限速、指令开关与关键词 |
| ❓ | 使用帮助 | 控制台内置说明 |
页面空白怎么办
控制台页面空白或加载失败时,优先检查 Microsoft Edge WebView2 Runtime 是否安装,装好后重启 UniQQ。
👑 配置主人与管理员
- 进入 系统设置 页。
- 填写主人 QQ 号,可另加多个插件管理员 QQ。
- 点保存。
| 身份 | 权限范围 |
|---|---|
| 主人 / 插件管理员 | 可使用 测试报时、开启本群报时、关闭本群报时 等高权限群内指令 |
| 主人 | 拥有控制台全部权限,包括外部服务(天气 / TTS)、备份与数据管理 |
| 全员(默认) | 群内查询指令 报时状态、下次报时,可在系统设置中关闭 |
🗂️ 数据目录
点击控制台顶部 打开数据目录 可直接定位:
text
数据目录/
├── config.json # 全局设置、群组设置、外部服务
├── announcer.db # 任务、模板、文案、发送记录(SQLite)
├── assets/ # 图片、语音、生成内容、TTS 缓存
├── imports/ # 导入临时文件
├── exports/ # 导出文件
├── backups/ # 自动与手动备份
└── logs/ # 运行日志迁移提示
所有素材路径以数据目录为根;迁移服务器时整目录拷贝或使用 ZIP 完整备份均可,详见导入导出与发送记录。
✅ 首次配置检查清单
- [ ] 插件已启用,控制台能打开且页面不空白
- [ ] 已填写主人 QQ
- [ ] 机器人在线且已加入目标群
- [ ] 在测试群执行一次「立即测试」能收到消息
- [ ] 群内发送
报时状态有回复
📚 下一节:控制台页面总览
