01 · 安装与首次配置
目标:装好插件、打开控制台、完成主人权限与数据目录确认。
📦 安装插件
获取完整的
XiaoLin.ZLTimeAnnouncer.uniqq插件包(官网或官方群下载)。将插件包放入 UniQQ 的
Plugins目录,或在插件管理中直接安装。启动 / 重启 UniQQ,在插件管理中启用 ZL-自定义报时插件。
首次启用会自动在插件数据目录生成默认配置和数据库,无需手动建文件。
⚠️ 必须使用完整插件包;运行环境要求 .NET 10 桌面运行时与 Microsoft Edge WebView2 Runtime(缺一会在日志中提示)。
🖥️ 打开控制台
入口:插件管理 → ZL-自定义报时插件 → 设置。
控制台为独立窗口(WebView2),左侧导航共 10 页:
📊 首页概览
⏰ 报时任务
📝 报时模板
🎨 素材中心
🌦️ 扩展内容
👥 群组设置
📤 导入导出
📜 发送记录
⚙️ 系统设置
❓ 使用帮助
控制台页面空白或加载失败时,优先检查 WebView2 Runtime 是否安装。
👑 配置主人与管理员
进入 系统设置 页。
填写主人 QQ 号,可另加多个插件管理员 QQ。
点保存。
权限说明:
✅ 主人 / 插件管理员:可使用
测试报时、开启本群报时、关闭本群报时等高权限群指令。✅ 主人:拥有控制台全部权限,包括外部服务(天气 / TTS)、备份与数据管理。
群内查询指令(
报时状态、下次报时)默认全员可用,可在系统设置中关闭。
🗂️ 数据目录
点击控制台顶部 打开数据目录 可直接定位:
💡 所有素材路径以数据目录为根;迁移服务器时整目录或 ZIP 备份均可(见
09-导入导出与发送记录.md)。
✅ 首次配置检查清单
插件已启用,控制台能打开且页面不空白
已填写主人 QQ
机器人在线且已加入目标群
在测试群执行一次"立即测试"能收到消息
群内发送"报时状态"有回复