QQ-Bot · QQ 信息雷达

面向指定 QQ 群，自动接收消息、检查采集缺口、筛选科技 / AI / 网络 / 计算机技术相关信息，提供每小时整理、每日摘要与可追溯的消息来源。

当前状态

最新增量（2026-10-10）：TASK-004 合成数据离线 CLI 已实现，待甲方验收。可直接运行 python qq_bot.py --help，无需安装第三方包。完整步骤见 离线使用说明，实测结果见 验证记录。下文保留第一阶段历史；当前事实以 docs/status.md 为准。

TASK-013 后续增量：执行 python qq_bot.py demo，浏览器打开 http://127.0.0.1:8765 即可体验原文、嵌套转发、上下文与导入错误。演示全部为合成数据；运行与反馈路径见 网页体验说明，无真实 QQ / AI 接入或生产部署。

2026-10-10：第一阶段项目整理与目录初始化。尚未编写应用代码、安装依赖、接入 QQ 或 AI，也未进行部署。QQ-Bot 是工作目录名称；产品目标是聊天信息分析，不需要自主聊天。

本地开发目录：D:\WorkSpace\QQ-Bot。未来部署位置尚待确定；用户已有 2 核 / 2 GB 内存 / 40 GB 磁盘的云服务器。

目录

QQ-Bot/
├── README.md
├── docs/
│   ├── project_context.md   # 已确认需求、历史建议及证据缺口
│   └── development_plan.md  # 下一阶段开发计划与验收条件
├── src/
│   └── README.md            # 实现范围与建议模块
└── tests/
    └── README.md            # 后续测试重点

开发原则

• 先验证消息接入、历史补录和来源追溯，再扩展 AI 与通知功能。
• 区分用户确认的需求、历史助手建议和本阶段新建议。
• 原文 3 天、摘要 10 天已确认；收藏与媒体副本策略尚待确认；到期清理尚未实现。
• 保留已有文件，重大架构变更、真实账号接入及部署前先确认具体方案。
• ChatGPT 项目镜像中的同步资料属于只读参考，不在镜像中开发应用。

开始前先阅读 项目背景 与 开发计划。语言、框架、数据库与接入组件尚未正式锁定；本阶段没有可运行应用或可执行测试。

后续开发入口

最新文档与状态见 文档索引 和 Codex 交接；协作规则见根目录 AGENTS.md。2026-10-10 已完成官方组件核对并提交 MVP 与技术提案，仍待甲方确认；此 README 的第一阶段记录保留。

当前可运行增量（2026-10-11）

第一阶段说明中的“没有应用 / 测试”是历史状态；TASK-004、013 至 017 已实现待验收。运行 python qq_bot.py demo 后，可体验信息流、原文阅读、导入记录、Mock 摘要、保留预览和候选载荷检查。信息流说明见 jobs_usage.md，当前状态见 status.md。仍只使用合成数据，无真实 QQ / AI / 自动清理 / 部署。

TASK-023 至 025：jobs-schedule 可前台周期处理合成小时 / 日窗口，provider-preview 可本机预览 DeepSeek 候选请求；调度说明、接口说明、受控单次调用。deepseek-budget 可只读查看预算预留。网页摘要预览可查看候选请求文字、JSON 与哈希。当前完整 174 项本机 / 模拟测试通过；受控调用已实现，本机密钥配置后单次合成尝试因 TLS EOF 失败，GitHub 两系统 CI 仍待运行核验。