Skip to content

安装与首次配置 ​

目标:装好插件、打开控制台、完成主人权限与数据目录确认,为后续配置打好基础。

📦 安装插件 ​

  1. 获取完整的 XiaoLin.ZLTimeAnnouncer.uniqq 插件包(官网或官方群下载)。
  2. 将插件包放入 UniQQ 的 Plugins 目录,或在插件管理中直接安装。
  3. 启动 / 重启 UniQQ,在插件管理中启用 ZL-自定义报时插件。
  4. 首次启用会自动在插件数据目录生成默认配置和数据库,无需手动建文件。

注意

必须使用完整插件包;运行环境要求 .NET 10 桌面运行时与 Microsoft Edge WebView2 Runtime,缺少时会在日志中提示。

🖥️ 打开控制台 ​

  • 入口:插件管理 → ZL-自定义报时插件 → 设置。
  • 控制台为独立窗口(WebView2),左侧导航共 10 页:
图标页面用途
📊首页概览今日统计、下一次报时倒计时、最近发送记录
⏰报时任务任务列表与五步编辑器
📝报时模板三栏模板编辑器
🎨素材中心图片、语音、名句、问候语、音乐五类素材
🌦️扩展内容天气、节日节气、纪念日、倒计时、TTS
👥群组设置分群开关、静默时段、模板覆盖
📤导入导出CSV 批量维护与 ZIP 完整备份
📜发送记录每次发送的结果与错误原因
⚙️系统设置权限、限速、指令开关与关键词
❓使用帮助控制台内置说明

页面空白怎么办

控制台页面空白或加载失败时,优先检查 Microsoft Edge WebView2 Runtime 是否安装,装好后重启 UniQQ。

👑 配置主人与管理员 ​

  1. 进入 系统设置 页。
  2. 填写主人 QQ 号,可另加多个插件管理员 QQ。
  3. 点保存。
身份权限范围
主人 / 插件管理员可使用 测试报时、开启本群报时、关闭本群报时 等高权限群内指令
主人拥有控制台全部权限,包括外部服务(天气 / TTS)、备份与数据管理
全员(默认)群内查询指令 报时状态、下次报时,可在系统设置中关闭

🗂️ 数据目录 ​

点击控制台顶部 打开数据目录 可直接定位:

text
数据目录/
├── config.json        # 全局设置、群组设置、外部服务
├── announcer.db       # 任务、模板、文案、发送记录(SQLite)
├── assets/            # 图片、语音、生成内容、TTS 缓存
├── imports/           # 导入临时文件
├── exports/           # 导出文件
├── backups/           # 自动与手动备份
└── logs/              # 运行日志

迁移提示

所有素材路径以数据目录为根;迁移服务器时整目录拷贝或使用 ZIP 完整备份均可,详见导入导出与发送记录。

✅ 首次配置检查清单 ​

  • [ ] 插件已启用,控制台能打开且页面不空白
  • [ ] 已填写主人 QQ
  • [ ] 机器人在线且已加入目标群
  • [ ] 在测试群执行一次「立即测试」能收到消息
  • [ ] 群内发送 报时状态 有回复

📚 下一节:控制台页面总览

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