01 · 安装与首次配置

目标:装好插件、打开控制台、完成主人权限与数据目录确认。


📦 安装插件

  1. 获取完整的 XiaoLin.ZLTimeAnnouncer.uniqq 插件包(官网或官方群下载)。

  2. 将插件包放入 UniQQ 的 Plugins 目录,或在插件管理中直接安装。

  3. 启动 / 重启 UniQQ,在插件管理中启用 ZL-自定义报时插件。

  4. 首次启用会自动在插件数据目录生成默认配置和数据库,无需手动建文件。

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

🖥️ 打开控制台

  • 入口:插件管理 → ZL-自定义报时插件 → 设置。

  • 控制台为独立窗口(WebView2),左侧导航共 10 页:

    • 📊 首页概览

    • ⏰ 报时任务

    • 📝 报时模板

    • 🎨 素材中心

    • 🌦️ 扩展内容

    • 👥 群组设置

    • 📤 导入导出

    • 📜 发送记录

    • ⚙️ 系统设置

    • ❓ 使用帮助

控制台页面空白或加载失败时,优先检查 WebView2 Runtime 是否安装。

👑 配置主人与管理员

  1. 进入 系统设置 页。

  2. 填写主人 QQ 号,可另加多个插件管理员 QQ。

  3. 点保存。

权限说明:

  • ✅ 主人 / 插件管理员:可使用 测试报时、开启本群报时、关闭本群报时 等高权限群指令。

  • ✅ 主人:拥有控制台全部权限,包括外部服务(天气 / TTS)、备份与数据管理。

  • 群内查询指令(报时状态、下次报时)默认全员可用,可在系统设置中关闭。

🗂️ 数据目录

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

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

💡 所有素材路径以数据目录为根;迁移服务器时整目录或 ZIP 备份均可(见 09-导入导出与发送记录.md)。

✅ 首次配置检查清单

  • 插件已启用,控制台能打开且页面不空白

  • 已填写主人 QQ

  • 机器人在线且已加入目标群

  • 在测试群执行一次"立即测试"能收到消息

  • 群内发送"报时状态"有回复

共 12 篇 ZL-自定义报时 / 安装与首次配置 0 字 0 行 zhangxiaolin
创建 2026-09-29T06:01:14.135749255Z 更新 2026-09-29T06:01:32.536247908Z