把 QQ 群里的通知，自动变成待办和日历。
从指定 QQ 群读取消息，过滤闲聊，提取通知、行动项和截止时间，集中到网页待办台，也可订阅手机日历。
下载正式版 v1.0.0 · 下载测试版 v1.1.0-beta.15 · 使用说明 · API 接入 · 安卓 App · NapCat 安装
🧪 v1.1.0 测试版（beta.15）已发布 — 查看说明并下载 →
- 日历订阅时间不再偏 8 小时：机器时区不是 +08:00（比如 Docker 默认 UTC）时，订阅到手机的日程会早 8 小时；现在统一换算到 Asia/Shanghai 再写入，已订阅的重新拉一次日历即可修正。
- 手机端 6 项：刘海屏标题不再被状态栏压住、键盘弹出不再挡按钮、待办前的圆圈改成「待处理」标签、长按返回改弹窗确认、离线时显示「显示 MM月DD日 HH:mm 的数据」、已配对时扫别人的二维码不再覆盖连接。
- 网页端 8 项：更新通道单选会正确选中、公告在页面任意位置按 Esc 都能关、平台磁贴点文字也能选、地址栏过期令牌自动抹掉、日历订阅卡的输入框/二维码/提示语统一用同一个地址、没选过主题时跟随系统深浅色、启动时间不再显示原始 ISO 串、空状态补了下一步指引。
- NapCat 安装有进度：下载显示「已下载/总大小（百分比）」，解压显示条目数，不再只有一句「请稍候」。
- 服务自检不再并发打两遍：页面加载只发一次
/api/selfcheck。 - 微信改过存储位置也能扫到：程序会读微信 4.x 自己记的存储位置；还找不到时，设置页「微信」里可以填存储位置目录（
D:\Wechat files、…\xwechat_files或账号下的…\db_storage都行），点「保存目录」立即生效，不用重启。 - 通知收件箱可以删了：每条通知除了「转成待办」，还能删除，点了会真删那条消息和收件箱记录（已经转好的待办保留），两段式确认防误点。
- 扫描按钮不再误报失败：已经在扫描时提示「扫描正在进行中」，没选群/没启用时提示「未开始扫描」并说明缺什么，只有真故障才报「扫描启动失败」。
- 访问令牌不再长期挂在地址栏：打开页面时用地址里的令牌换一次 HttpOnly 会话 Cookie，换完就把 token 从地址栏抹掉，也不再写进浏览器 localStorage。旧链接（带 token）仍然能用，第一次会换 Cookie 并自动重载一次。
- 安装包与更新包校验收紧：NapCat 安装包解压前校验指纹，第一次装需要你确认一次实算值，之后记住；解压有 800MB / 5000 项双上限。更新包只认 GitHub / Gitee 的下载域名，清单里的 sha256 必须存在，装机脚本里先复算哈希再解压。
- 数据库能自愈：库文件带版本号，启动时做完整性检查，真损坏就隔离成
.corrupt-<时间戳>再重建，并且每天自动快照、保留 7 份。 - 待办写入不再有并发竞态：同一条待办重复出现只留一行，你改过的状态（已处理 / 稍后提醒）不会被覆盖。
- 防火墙规则收窄：只对「专用 / 域网络」和本机网段放行，不再对任意来源开放；公用网络下手机连不上是刻意的限制。
- 健康检查说真话：数据打不开时返回故障状态，不再永远显示正常。
- 其它：配对来源 10 分钟最多 3 次并可一键清空待配对；连续输错令牌会被限速；HTTP 请求 30 秒超时、并发连接上限 64。
- 自动整理规则（实验室）：设置页能自己写规则（关键词 / 正则 / @我 / 指定人），命中的消息直接进待办；写错了会告你是第几条、为什么错，还能先「试跑一条消息」看会不会命中。
- 公网日历订阅：日历地址可以直接走公网（Tailscale Funnel），手机用流量也能订阅，不用连同一个 WiFi；订阅链接带 token，没 token 取不到。
- 截止时间补全：大模型没给出时间时，会从正文里补「明天下午三点」这类截止时间，纯闲聊仍然不进待办。
- 服务自检提速：同一批通道状态不再算两遍、Tailscale 子进程加了短缓存，本机从 32.7 秒降到 10 秒左右；超过 8 秒会提示「还在等结果」，不再干瞪眼。
- 社区在线数真的显示出来了：修了取数没带鉴权、上报挂在没人调的接口上、脚本跑得太早三个问题。
- 代码结构：
webapp.py拆出路由表、设置接口、更新接口三个模块，4403 行降到 3697 行，行为不变。
- 社区在线数：「关于与支持」面板显示在线人数与今日打开，匿名，拿不到显示「暂不可用」。
- 四条状态引导：钉钉可「重连监听」、微信失败给人话原因+「重试扫描」、日历优先公网地址并可一键开通、推送显示中文通道名。
- 二维码过期直接提示已过期。
- 防火墙提示需管理员确认。
- 修复：NapCat 3001 探测自相矛盾、微信 4.1 可手填密钥、各盘符微信目录发现。
- 提示「未找到电脑版 QQ」装不上：NapCat 只是壳、不含 QQ.exe 这件事现在写进提示里，并给「下载官方 QQ → 装完不用打开 → 重新检测」三步入口。
- QQ 检测更准：不再只认注册表和固定路径，会认腾讯自己写的
Install项并读运行中 QQ 的路径兜底，QQ 装在 D 盘、绿色版、装给别的 Windows 用户都能找到。 - 需管理员权限时单独提示：QQ 在
C:\Program Files时写加载器要管理员权限，这条单独提示，不再和「找不到 QQ」混在一起。 - 扫了二维码没反应：状态接口新增显式阶段（未安装 / 没启动 / 等你扫码 / 已登录）与「已等多久」，二维码过期或换新会提示，自己双击起过 NapCat 的不会再被误判成「没启动」而把二维码藏起来。
- 首装风险提示窗：去掉「我已阅读并理解 + 稍后再说」那种假装要同意、不同意也能用的两个按钮，只留一个「我知道了，开始使用」，关掉就记下。
- 托盘菜单不再锁死：托管操作卡住导致「重启并更新」永久变灰，现在 90 秒没返回就自动恢复。
- 公告栏：顶部「本地运行」左边多了铃铛和未读数字，可「全部标为已读」，Esc 关闭，手机窄屏占满宽度。
- 公告到得更快：检查间隔 6 小时 → 15 分钟，点「检查更新」或打开公告时顺手刷新。
- 手机连不上点一下就修：防火墙没放行直接弹管理员权限自动加规则，24 小时内最多弹一次；公网访问点「开通公网入口」会装好并拉起 Tailscale，登录这一步只能你自己来——浏览器会弹出 Tailscale 登录页，用你的账号登完，程序才会自动开 Funnel 并给出公网地址；不登录就只有局域网地址。
- 向导关闭后自动定位到二维码，NapCat 未启动时给「启动并获取二维码」按钮。
- 新增四个默认关闭的实验功能（在
.env里设QQ_DIGEST_LAB_SEARCH / REPLIES / EVENTS / RULES = 1后重启，设置页出现「实验室」；现在也可以直接在设置页打开实验室，不必改 .env）。 - 一键诊断包：
python main.py doctor --bundle。 - 修复批：学习通 Cookie 不再被误判过期；同一条群消息不再重复生成任务；摘要超长不再静默丢弃；任务统计与日历导出不再被 800 条截断。
- 自动检测 Windows 防火墙是否放行 8766。
- 局域网地址不再误选 Tailscale / VMware / WSL 等虚拟网卡。
更新仍校验 SHA-256，Linux / macOS 下载后需手动安装。
这是预发布版，稳定版仍是 v1.0.0；稳定版通道仍按版本筛选，不会自动升级到测试版。
如果作业、实验、报名和考试时间散在多个 QQ 群里，群务台会把需要你行动的内容集中到一个页面。消息、摘要和待办默认只存在你这台电脑上；只有你自己配的 AI 或推送通道会看到内容。
- 只收你勾选的群；闲聊自动降噪，拿不准的消息先让你确认，再进待办。
- 首次启动显示全屏接入向导，可稍后配置；主界面保留未完成提醒，设置页可重新运行向导。
- QQ 群列表在后台常驻刷新，默认每 5 分钟拉取；失败按 1、2、5 分钟退避，页面显示最近状态和下次计划时间。
- 待办按今天、本周、以后、已完成分组，支持完成、忽略、置顶和稍后提醒；网页含月历，也可订阅手机日历。
- 截止提醒、紧急事项可推送至 QQ 机器人、WxPusher、Server酱、PushPlus，或用自配 Webhook 发到任意 HTTP 端点；PDF、Office 文档、文本、压缩包和截图可解析并回溯原文。
- 设置页可一键备份数据库；ZIP 只包含 SQLite 数据库，不包含配置、令牌或日志。
- 设置页提供 QQ 接入向导、群选择和二维码登录；手机 App 支持扫码配对。网页也可通过 Tailscale 或配置后的公网入口访问。
- 钉钉接入读取本机数据库并接收通知，不支持直接发送钉钉消息；钉钉/微信来源的通知可通过自配 Webhook 转发到钉钉、企微、飞书等任意 HTTP 端点。学习通 Cookie 支持浏览器自动读取、托盘读取、手动粘贴三种方式。
- Windows 出货包采用 onedir：运行时文件放在
_internal等目录，启动时不再解压到临时目录。 - 更新校验 SHA-256；两个源版本与 SHA-256 一致时主下载走 Gitee 镜像、GitHub 兜底，不一致时保持 GitHub 主源。Linux / macOS 可检查和下载，但需手动安装。
- 打开 Releases，下载最新版本的
QQ-Notice-Hub.zip。 - 将 ZIP 解压到安装目录，例如
D:\notice-hub。目录里有启动器、服务程序以及_internal、_launcher_internal运行时目录；保持目录结构完整，不要在压缩包内运行 exe，也不要单独移动 exe。 - 在解压后的目录运行
QQ-Notice-Hub.exe。如有 Windows 安全提示，选择「仍要运行」；防火墙提示时允许专用网络。随后按网页向导配置接入。
源码运行并安装用户级 systemd 服务：
git clone https://github.com/ExpertKT/notice-hub.git ~/notice-hub
cd ~/notice-hub
bash packaging/linux/install.sh启用后在浏览器打开 http://127.0.0.1:8766/。NapCat 在 Docker 或其他外部环境运行；Linux 版没有托盘。详见 Linux 部署说明。
源码运行并安装用户级 LaunchAgent：
git clone https://github.com/ExpertKT/notice-hub.git ~/notice-hub
cd ~/notice-hub
bash packaging/macos/install.sh启动后在浏览器打开 http://127.0.0.1:8766/。NapCat 使用官方 Mac-Installer 或其他外部方式运行；群务台只连接 OneBot，不提供托盘。详见 macOS 部署说明。
- 在同一个 Releases 页面，下载
notice-hub-android-*.apk，传到手机上安装（安卓端本轮没有改动，与 beta.1 是同一份）。 - 电脑端页面打开「设置」，找到「手机 App」那一块，屏幕上会出现一个二维码。
- 用手机 App 扫这个二维码，地址和配对信息会自动填好。
- 二维码扫不动时，改用那一块里的 6 位数字配对码，手输进 App 即可。
- 手机和电脑连同一个 Wi-Fi 最省事；手机用流量时，先在电脑端设置里开通公网地址，或者让两端都连上同一个 Tailscale。
App 只是电脑端服务的外壳，消息和待办仍然存在电脑上；想自己编译见 docs/安卓App.md。
Windows PowerShell：
git clone https://github.com/ExpertKT/notice-hub.git
cd notice-hub
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
Copy-Item .env.example .env
.\.venv\Scripts\python.exe main.py doctor
.\.venv\Scripts\python.exe main.py rundoctor 检查配置和依赖，run 启动服务（默认网页端口 8766）。Linux 和 macOS 源码部署请按 Linux 部署说明 或 macOS 部署说明 操作。
| 能力 | Windows | Linux | macOS |
|---|---|---|---|
| 安装方式 | 安装包（双击） | 源码 + install.sh（systemd user） |
源码 + install.sh（LaunchAgent） |
| 网页界面 / 推送通道 | ✅ | ✅ | ✅ |
| QQ（NapCat）接入 | ✅ 内置一键接入 | ✅ 自行部署 NapCat（Docker/本机） | ✅ 自行安装 NapCat |
| 系统托盘 / 浮球 | ✅ 托盘；浮球已暂停 | ❌ | ❌ |
| 应用内自动更新 | ✅ 检查+下载+安装 | ❌ | |
| 读本机微信/钉钉数据库 | ✅ | ❌ | ❌ |
| 学习通 Cookie 自动读取 | ✅ | ❌ 需手动粘贴 | ❌ 需手动粘贴 |
| 学习通网页功能本身 | ✅ | ✅（粘一次 Cookie） | ✅（粘一次 Cookie） |
带 ❌ /
各平台的部署细节与差异见 Linux 部署说明 和 macOS 部署说明。
从 .env.example 复制 .env。首页只列高频项，完整说明请看 .env.example 和 docs/。
| 变量 | 作用 |
|---|---|
QQ_DIGEST_GROUPS |
要监控的群号，逗号分隔；留空则不处理群消息 |
QQ_DIGEST_ONEBOT_TOKEN |
与 NapCat OneBot HTTP 配置一致 |
QQ_DIGEST_WEB |
是否启用网页待办台 |
QQ_DIGEST_WEB_PORT |
网页端口，默认 8766 |
QQ_DIGEST_WEB_BASE_URL |
公网入口，供手机和推送链接使用 |
WXPUSHER_APP_TOKEN |
WxPusher 应用 Token（可选） |
WXPUSHER_UIDS |
WxPusher 接收人（可选） |
QQ_DIGEST_LLM_API_KEY |
可选模型 Key（旧名 DASHSCOPE_API_KEY 仍兼容）；不填则使用本地规则摘要 |
| 文件 | 作用 |
|---|---|
qq_digest.py |
消息过滤与摘要入口 |
qq_live_digest/receiver.py |
接收 NapCat OneBot v11 上报 |
qq_live_digest/store.py |
SQLite 存储、去重和恢复 |
qq_live_digest/summarizer.py |
提取待办、截止时间和推送文本 |
qq_live_digest/push.py |
推送通道与失败回退 |
qq_live_digest/service.py |
调度、补采、重试和服务生命周期 |
qq_live_digest/webapp.py |
待办台、月历、收件箱和设置页 |
qq_live_digest/napcat_admin.py |
NapCat 探测、启停、配置和登录二维码 |
qq_live_digest/hosting.py |
QQ/NapCat 托管切换与状态持久化 |
packaging/launcher.py |
出货包启动器、托盘和单实例互斥 |
main.py |
CLI 入口 |
main.py 当前注册的子命令：run、tick、preview、stats、show、tasks、catchup、doctor、send-test、attach-test。
# 全量测试（数字随改动增长，不在此写死）
.\.venv\Scripts\python.exe -m unittest discover -s tests -t .
# Windows 出货包
.\packaging\build.ps1Android 工程使用 Gradle，构建环境为 JDK 17 + Android SDK 35。发布时打 tag，再执行 gh release create 上传出货包和 APK。
连接检查失败 / 由于目标计算机积极拒绝（10061）
NapCat 或目标端口尚未运行。点「一键接入」或「启动并登录」，用手机 QQ 扫码，登录后刷新检测。
订阅读不到 / Failed to fetch
局域网地址只对同一网络有效。手机使用流量时，在设置页开通公网地址或配置 Tailscale，并重新复制带配对信息的订阅地址。开通公网要你在 Tailscale 的浏览器登录页用自己的账号登一次，这一步程序替不了；不登录就只有局域网地址，手机用流量打不开。
群里发了通知，网页没有
确认群在订阅白名单并已保存；再检查「待确认」分组。关机期间只补采最近 24 小时消息。
二维码过期 / 主号风控
登录二维码由 NapCat 自己每隔一段时间换新，点「刷新二维码」只是立刻重取当前那张；想立刻换一张就点「重启引擎」再扫。订阅二维码的内容是订阅地址本身，地址没变码就不会变，所以设置里的「刷新二维码」会在没变时直接告诉你「订阅地址没变」。NapCat 是第三方 QQ 协议客户端，登录主号有风控风险；本项目只读群消息，是否使用小号请自行判断。
不要提交 .env、日志、SQLite、附件缓存或任何含 Token、UID、API Key 的文件。提交 Issue 和截图前，请打码 QQ 号、群号、域名、本机路径与消息内容。若密钥泄露，应立即作废并重新生成。
- NapCat 和电脑端服务必须运行并保持登录，才能实时接收；关机期间依赖历史补采。
- Windows 提供桌面托盘与自动安装更新；Linux 和 macOS 使用源码服务模式，更新包需手动安装。Android App 是电脑端服务的手机客户端。
- 摘要默认由本地规则生成；可选模型失败时会自动回退。
基于上游 wc985732-lang/qq-live-digest 二次开发。上游部分及其派生部分适用 MIT；本人新增部分适用 PolyForm Noncommercial 1.0.0。
个人与非商业使用免费；商业使用请联系 jkl2755908073@qq.com 获取授权。详见 LICENSE、LICENSE-UPSTREAM 与 NOTICE。